# 📦 闲言APP — 三方库清单

> 更新: 2026-05-18 | 作用: 全部三方库选型与版本 + 跨平台标注 + 鸿蒙适配状态 + 集成状态
> 上次更新: 版本号同步pubspec.yaml + 新增文件传输层/音视频层/安全层 + 鸿蒙30包适配标注

---

## 一、核心框架层

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| flutter_riverpod | ^3.0.0 | 状态管理 + 依赖注入 | 全平台 | ✅ 纯Dart | P0 |
| riverpod_annotation | ^4.0.0 | Riverpod 代码生成注解 | 全平台 | ✅ 纯Dart | P0 |
| go_router | ^17.2.3 | 声明式路由 | 全平台 | ✅ 纯Dart | P0 |
| dio | ^5.4.0 | 网络请求 | 全平台 | ✅ 纯Dart | P0 |
| drift | ^2.16.0 | SQLite 数据库 | 全平台 | ✅ 纯Dart | P0 |
| freezed | ^3.2.0 | 不可变数据模型 | 全平台 | ✅ 纯Dart | P0 |
| json_serializable | ^6.11.0 | JSON 序列化 | 全平台 | ✅ 纯Dart | P0 |
| hive | ^2.2.3 | 高性能 NoSQL 数据库 | 全平台 | ✅ 纯Dart | P0 |
| hive_flutter | ^1.1.0 | Hive Flutter 适配 | 全平台 | ✅ 纯Dart | P0 |

---

## 二、UI 设计系统层

### iOS 26 Liquid Glass

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| liquid_glass_widgets | v0.11.0-ohos.1 | 26个 Glass 组件 + Shader 渲染 | 全平台 | ✅ 本地化 | P0 |
| liquid_glass_easy | v1.1.1 | 液态玻璃透镜特效 | 全平台 | ✅ 本地化 | P1 | ✅ 已集成-4种预设 |
| stupid_simple_sheet | v0.9.1+1 | iOS 26 Glass/Cupertino Sheet | 全平台 | ✅ 纯Dart | P0 |
| heroine | ^0.7.2 | Hero 弹簧动画替代 | 全平台 | ✅ 纯Dart | P0 |

### 动画与交互

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| flutter_animate | ^4.5.0 | 声明式动画 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成-入场动画+庆祝 |
| lottie | ^3.3.0 | 空状态/庆祝矢量动画 | 全平台+WASM | ✅ 纯Dart | P0 | ✅ 已集成-6种本地动画 |
| confetti | ^0.8.0 | 点赞/创作完成撒花 | 全平台+WASM | ✅ 纯Dart | P0 | ✅ 已集成-导出庆祝 |
| animate_do | ^5.1.0 | 列表交错入场动画 | 全平台+WASM | ✅ 纯Dart | P0 | ✅ 已集成 |
| custom_refresh_indicator | ^4.0.1 | 液态玻璃风格下拉刷新 | 全平台 | ✅ 纯Dart | P0 |
| animations | ^2.0.11 | Material 转场动画 | 全平台 | ✅ 纯Dart | P1 |
| flutter_tilt | ^4.0.0 | 3D 倾斜交互效果 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| flutter_card_swiper | v7.2.0 | 卡片滑动切换 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| flutter_spritesheet_animation | v1.0.2 | 精灵图帧动画 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成

### 基础 UI 组件

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| google_fonts | ^8.1.0 | 字体加载管理 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成-15种字体 |
| cached_network_image | ^3.3.0 | 图片缓存加载 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成-6类36张贴纸 |
| shimmer | ^3.0.0 | 骨架屏 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| flutter_svg | ^2.0.0 | SVG 渲染 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成-8种本地SVG+分类图标 |
| fl_chart | ^1.2.0 | 图表绘制 | 全平台 | ✅ 纯Dart | P2 |
| adaptive_palette | ^3.0.0 | 图片主色提取+流体背景 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成-句子卡片取色 |
| badges | v3.2.0 | 角标/徽章组件 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| flutter_staggered_grid_view | ^0.7.0 | 瀑布流网格 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| visibility_detector | ^0.4.0+2 | 组件可见性检测 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成

### 列表交互与布局增强

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| flutter_slidable | ^4.0.3 | 列表项滑动操作 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成-AppSlidable封装 |
| flutter_sticky_header | ^0.8.0 | 粘性分组头 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成-AppStickyHeader封装 |
| value_layout_builder | ^0.5.0 | 布局阶段值传递 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成(sticky_header依赖) |
| pull_down_button | ^0.10.1 | iOS 下拉菜单按钮 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成-AppPopupMenu封装 |
| sliver_tools | ^0.2.12 | Sliver 工具集 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| bot_toast | ^4.1.0 | Toast/通知弹窗 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成-AppToast封装

### 内容渲染

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| flutter_markdown_plus | ^1.0.1 | Markdown 渲染 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成-AppMarkdown封装 |
| flutter_html | ^3.0.0-beta.2 | HTML 内容渲染 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| pinyin | ^3.3.0 | 汉字转拼音 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成-汉语工具

### 编辑器组件

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| pro_image_editor | v12.4.4 | 专业图片编辑器 (Frosted Glass 主题) | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-本地源码 |
| flutter_quill | v11.5.0 | 富文本编辑器 (Delta格式) | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-编辑器富文本 |
| dotted_border | ^3.1.0 | 虚线边框 (拖拽描边) | 全平台 | ✅ 纯Dart | P2 | ✅ 已集成 |
| image | ^4.3.0 | 图片底层处理 (缩放/裁剪/压缩/格式转换) | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成 |
| gal | v2.3.0-ohos.1 | 保存图片到相册 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |
| flex_color_picker | v3.8.0 | HSL色轮颜色选择器 | 全平台 | ✅ 本地化 | P1 | ✅ 已集成-色轮+色板 |
| flutter_screenutil | ^5.9.0 | 屏幕适配 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| flutter_shaders_ui | v0.1.1 | GLSL Shader效果渲染 (模糊/发光/噪点) | 全平台 | ✅ 本地化 | P1 | ✅ 已集成 |

### 3D引擎

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 | 状态 |
|----|------|------|------|:----:|--------|------|
| flutter_3d_controller | 2.3.0 | 3D模型交互预览 (WebView+model-viewer) | Android+iOS+Web | ❌ | P0 | ✅ 已集成-3D贴纸+3D预览页 |
| flutter_scene | — | 3D GPU渲染 (Impeller) | macOS+iOS | ❌ | P0 | ❌ v0.23.0已移除，统一flutter_3d_controller |
| device_info_plus | v13.1.0 | 设备信息+低端设备检测 | 全平台 | ✅ 本地化 | P1 | ✅ 已集成-3D降级检测 |

### 图片处理

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 | 状态 |
|----|------|------|------|:----:|--------|------|
| image_size_getter | v2.4.1 | 图片尺寸/格式检测 (读文件头) | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-ImageInfoService |
| extended_image | v10.0.1 | 增强图片组件+裁剪编辑器+内存优化 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-裁剪+大图优化 |
| photo_view | v0.15.0 | 图片缩放查看器+画廊 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-全屏预览+画廊 |
| flutter_image_compress | v2.4.0 | 原生图片压缩 (JPEG/WebP/PNG/HEIC) | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-导出压缩+缩略图 |

> **编辑器说明**: pro_image_editor 已重新集成 (v12.4.4)，采用 Frosted Glass 主题 + 自定义 ActionBar + WidgetLayer 扩展 (液态玻璃/Lottie/SVG/网络贴纸)。

---

## 三、平台能力层

### 存储与文件

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| shared_preferences | v2.5.5 | 轻量 KV 存储 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |
| flutter_secure_storage | v9.2.4 | 加密存储 | 全平台(Web内存模拟) | ✅ 本地化 | P0 | ✅ 已集成 |
| path_provider | v2.1.5 | 文件路径管理 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |
| archive | ^4.0.0 | ZIP 压缩/解压 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成-.xycard导出 |
| crypto | ^3.0.0 | SHA-256 校验 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成 |
| encrypt | ^5.0.3 | 对称/非对称加密 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成 |
| sqflite | v2.4.1-ohos.1 | SQLite 轻量数据库 | 全平台 | ✅ 本地化 | P1 | ✅ 已集成-鸿蒙端数据库 |

### 分享与导出

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| share_plus | v13.1.0 | 系统分享 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |
| qr_flutter | ^4.1.0 | 二维码生成 | 全平台 | ✅ 纯Dart | P1 |
| receive_sharing_intent | v1.8.1 | 接收外部分享内容 | Android+iOS | ✅ 本地化 | P1 | ✅ 已集成 |

### 系统能力

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| permission_handler | v12.0.1 | 权限管理 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-PermissionService |
| url_launcher | v6.3.2 | 打开外部链接 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |
| package_info_plus | v10.1.0 | 应用版本信息 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |
| connectivity_plus | v7.1.1 | 网络状态检测 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-工具状态监测 |
| device_info_plus | v13.1.0 | 设备信息+低端设备检测 | 全平台 | ✅ 本地化 | P1 | ✅ 已集成-3D降级检测 |
| image_picker | v1.2.2 | 相册/相机选图 | Android+iOS+Web | ✅ 本地化 | P0 | ✅ 已集成-ImageImportService |
| file_picker | v8.3.7 | 文件选择器 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |
| app_links | v7.0.0-ohos.1 | 深度链接处理 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-DeepLinkService |
| local_auth | v3.0.1 | 生物识别认证 | Android+iOS | ✅ 本地化 | P1 | ✅ 已集成-应用锁 |
| battery_plus | v7.0.0-ohos.1 | 电池状态监听 | 全平台 | ✅ 本地化 | P2 | ✅ 已集成

### 通知与后台

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| flutter_local_notifications | v21.0.0 | 本地通知 | Android+iOS | ✅ 本地化 | P1 | ✅ 已集成 |
| home_widget | v0.9.1 | 桌面小组件 | Android+iOS | ✅ 本地化 | P1 | ✅ 已集成 |
| wakelock_plus | v1.4.0-ohos.1 | 屏幕常亮控制 | 全平台 | ✅ 本地化 | P1 | ✅ 已集成

### 音视频

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| audioplayers | v6.5.0-ohos.1 | 音频播放 | 全平台 | ✅ 本地化 | P2 | ✅ 已集成 |
| record | v6.0.0-ohos.1 | 录音 | Android+iOS+Web | ✅ 本地化 | P2 | ✅ 已集成-语音消息 |
| video_player | v2.10.0-ohos.1 | 视频播放 | 全平台 | ✅ 本地化 | P2 | ✅ 已集成 |
| video_compress | v3.1.2-ohos.1 | 视频压缩 | Android+iOS | ✅ 本地化 | P2 | ✅ 已集成

### 异常捕获

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| catcher_2 | v2.1.9 | 全局异常捕获+上报 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |

---

## 四、文件传输层

### 传输核心

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| shelf | ^1.4.0 | HTTP 服务器框架 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成 |
| shelf_router | ^1.1.0 | 路由中间件 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成 |
| shelf_web_socket | ^3.0.0 | WebSocket 支持 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成 |
| web_socket_channel | ^3.0.3 | WebSocket 客户端 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成 |
| mime | ^2.0.0 | MIME 类型识别 | 全平台 | ✅ 纯Dart | P0 | ✅ 已集成 |
| basic_utils | ^5.7.0 | 通用工具集 (Base64/ASN1) | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |
| cross_file | any | 跨平台文件抽象 | 全平台 | ✅ 纯Dart | P1 | ✅ 已集成 |

### 近场通信

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| network_info_plus | v8.1.0-ohos.1 | WiFi 网络信息 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成 |
| wifi_iot | v0.3.19-ohos.1 | WiFi IoT 设备连接 | Android | ✅ 本地化 | P1 | ✅ 已集成 |
| flutter_blue_plus | v2.1.0-ohos.1 | 蓝牙 BLE 通信 | Android+iOS | ✅ 本地化 | P1 | ✅ 已集成-蓝牙配对 |
| flutter_nfc_kit | v3.6.0-rc.6-ohos | NFC 读写 | Android+iOS | ✅ 本地化 | P2 | ✅ 已集成-NFC配对 |
| mobile_scanner | v7.1.4-ohos.1 | 二维码/条形码扫描 | 全平台 | ✅ 本地化 | P0 | ✅ 已集成-QR配对 |
| nearby_service | v0.2.1 | 近场设备发现+通信 | Android+iOS | ✅ 本地化 | P1 | ✅ 已集成

### 远程传输

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| flutter_webrtc | v1.4.0-ohos.1 | WebRTC 音视频通信 | Android+iOS+Web+macOS | ✅ 本地化 | P0 | ✅ 已集成-WebRTC传输 |

---

## 五、数据与网络层

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| uuid | ^4.5.0 | UUID 生成 | 全平台 | ✅ 纯Dart | P0 |
| intl | ^0.20.2 | 国际化/日期格式化 | 全平台 | ✅ 纯Dart | P0 |
| logger | ^2.5.0 | 日志记录 | 全平台 | ✅ 纯Dart | P0 |
| collection | ^1.19.0 | 集合操作扩展 | 全平台 | ✅ 纯Dart | P1 |
| supabase_flutter | ^2.8.0 | Supabase 客户端 | 全平台 | ✅ 纯Dart | P0 |
| flutter_cache_manager | ^3.3.0 | 文件缓存管理 | 全平台 | ✅ 纯Dart | P1 |
| mailer | ^7.1.0 | SMTP 邮件发送 | 全平台 | ✅ 纯Dart | P2 |
| vector_math | any | 向量数学运算 | 全平台 | ✅ 纯Dart | P1 |
| timezone | any | 时区数据库 | 全平台 | ✅ 纯Dart | P1 |

---

## 六、扩展功能层（P2-P3）

| 库 | 版本 | 用途 | 平台 | 鸿蒙 | 优先级 |
|----|------|------|------|:----:|--------|
| just_audio | ^0.9.0 | 音频播放 | Android+iOS+macOS | ❌ | P2 |
| flutter_tts | ^4.0.0 | 文字转语音 | Android+iOS | ❌ | P3 |
| in_app_purchase | ^3.2.0 | 应用内支付 | Android+iOS | ❌ | P1 |
| table_calendar | ^3.1.0 | 日历组件 | 全平台 | ✅ 纯Dart | P2 |

---

## ⚠️ 已移除的不跨平台库

| 库 | 原用途 | 移除原因 | 替代方案 |
|----|--------|----------|----------|
| image_gallery_saver | 保存到相册 | 仅 Android+iOS | `gal` (全平台+鸿蒙) |
| flutter_wallpaper_manager | 设置壁纸 | 仅 Android，iOS 系统限制 | 暂不实现 |
| workmanager | 后台定时任务 | 仅 Android+iOS，暂无需求 | 暂不实现 |
| flutter_scene | 3D GPU渲染 | v0.23.0统一3D路径，WebView方案更稳定 | `flutter_3d_controller` (WebView) |

---

## 📦 归档列表

> 已完成集成的三方库，记录集成版本、产出文件和状态

| 库 | 集成版本 | 产出文件 | 状态 | 归档日期 |
|----|---------|---------|------|---------|
| flutter_advanced_canvas_editor | v0.20.0 | LayerManagerService, LayerSnapshotService, LayerPanel | ✅ 核心92% | 2026-04-24 |
| flutter_3d_controller | v0.21.0 | Model3DPreviewPage, Sticker3DPanel, Flutter3DViewer | ✅ 核心85% | 2026-04-24 |
| flutter_scene | v0.23.0 | 已移除，统一flutter_3d_controller | ✅ 已移除 | 2026-04-27 |
| image_size_getter | v0.22.0 | ImageInfoService, ImageInfoPanel, EditorStatusBar | ✅ 100% | 2026-04-25 |
| extended_image | v0.22.0 | ImageCropPage, ExtendedResizeImage, ImageImportService | ✅ 100% | 2026-04-25 |
| photo_view | v0.22.0 | ImagePreviewPage, ImageGalleryPage | ✅ 100% | 2026-04-25 |
| flutter_image_compress | v0.22.0 | ImageCompressService, ExportService压缩集成 | ✅ 100% | 2026-04-25 |
| flutter_slidable | v1.9.0 | AppSlidable, SlideActionConfig, DeleteConfirm | ✅ 100% | 2026-04-29 |
| flutter_sticky_header | v1.9.0 | AppStickyHeaderSliver, 分类吸顶 | ✅ 100% | 2026-04-29 |
| flutter_markdown_plus | v1.9.0 | AppMarkdownBody, AppMarkdown | ✅ 100% | 2026-04-29 |
| pull_down_button | v1.9.0 | AppPopupMenu | ✅ 100% | 2026-04-29 |
| sliver_tools | v1.9.0 | SliverPinnedHeader, AppToast | ✅ 100% | 2026-04-29 |

---

## 📊 鸿蒙适配统计

### 30包适配清单

| # | 包名 | 适配模式 | 鸿蒙子包 |
|---|------|---------|---------|
| 1 | shared_preferences | 联合插件 | shared_preferences_ohos |
| 2 | path_provider | 联合插件 | path_provider_ohos |
| 3 | url_launcher | 联合插件 | url_launcher_ohos |
| 4 | image_picker | 联合插件 | image_picker_ohos |
| 5 | local_auth | 联合插件 | local_auth_ohos |
| 6 | video_player | 联合插件 | video_player_ohos |
| 7 | permission_handler | 直接插件 | permission_handler_ohos |
| 8 | flutter_secure_storage | 联合插件 | flutter_secure_storage_ohos |
| 9 | share_plus | 联合插件 | share_plus_ohos |
| 10 | battery_plus | 联合插件 | battery_plus_ohos |
| 11 | connectivity_plus | 联合插件 | — |
| 12 | flutter_local_notifications | 直接插件 | — |
| 13 | file_picker | 直接插件 | — |
| 14 | receive_sharing_intent | 直接插件 | — |
| 15 | wakelock_plus | 联合插件 | — |
| 16 | mobile_scanner | 联合插件 | — |
| 17 | wifi_iot | 联合插件 | — |
| 18 | audioplayers | 联合插件 | audioplayers_ohos |
| 19 | record | 联合插件 | record_ohos |
| 20 | sqflite | 联合插件 | sqflite_ohos |
| 21 | fluttertoast | 联合插件 | fluttertoast_ohos |
| 22 | video_compress | 联合插件 | — |
| 23 | flutter_blue_plus | 联合插件 | flutter_blue_plus_ohos |
| 24 | gal | 联合插件 | — |
| 25 | network_info_plus | 联合插件 | network_info_plus_ohos |
| 26 | app_links | 联合插件 | app_links_ohos |
| 27 | pro_image_editor | 直接插件 | — |
| 28 | home_widget | 直接插件 | — |
| 29 | nfc_manager | 联合插件 | nfc_manager_ohos |
| 30 | nearby_service | 直接插件 | — |

### 适配模式说明

- **联合插件模式**: ohos 原生代码在独立 `*_ohos` 子包，主包声明 `default_package`
- **直接插件模式**: ohos 原生代码在主包 `ohos/` 目录，pubspec 声明 `pluginClass`

---

> **平台标注说明**: "全平台" = Android + iOS + Web + macOS + Windows + Linux + 鸿蒙
> "WASM" = 支持 WebAssembly 运行时
> "本地化" = packages/ 目录本地引用，已做鸿蒙适配