Files
xianyan/README.md
Developer a60957cc0e feat: 发布v5.3.0正式版本,完善跨平台适配与功能优化
本次更新包含多项核心改进:
1. 新增统一跨平台导航扩展,替换原有GoRouter调用,适配鸿蒙平台路由逻辑
2. 重构状态初始化逻辑,使用Future.microtask避免BuildContext异常
3. 完善Linux桌面端支持,添加桌面文件、AppData配置与WSL构建脚本
4. 修复鸿蒙平台动画渲染异常问题,移除平台特判逻辑
5. 优化NFC配对扫描参数,精简不必要的配置项
6. 更新依赖版本与项目版本号
7. 修复Drift数据库缓存问题,移除冗余的表检测逻辑
8. 添加路由观察者日志,优化鸿蒙端路由调试体验
9. 完善签到与文章发布后的用户数据刷新逻辑
10. 删除冗余的子模块与日志文件,清理项目结构
2026-05-18 08:58:36 +08:00

409 lines
21 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 闲言 WordsLeisure
<p align="center">
<strong>文字阅读更纯粹</strong>
</p>
<p align="center">
句子阅读 · 壁纸制作 · 图文创作 · 知识探索 · 文件传输 · 全平台7端
</p>
---
## 关键字
`Flutter` `iOS 26 Liquid Glass` `专业编辑器` `3D贴纸` `液态玻璃` `SVG动画` `全平台7端` `鸿蒙` `Frosted Glass` `Riverpod` `Drift` `freezed` `go_router` `pro_image_editor` `AI对话` `国学经典` `成就系统` `文件传输` `协作画布` `WebRTC`
---
## 项目简介
闲言是一款以句子阅读和图文创作为核心的跨平台应用,源自一个 Lua 原生项目65 文件 15000+ 行),经过全面 Flutter 重写,采用 iOS 26 Liquid Glass 设计语言,覆盖 Android、iOS、macOS、Windows、Linux、Web 和鸿蒙 7 大平台。核心编辑器模块基于 pro_image_editor 深度定制,集成 8 个子编辑器、7 类贴纸系统、3D 模型交互和完整导出链路。同时构建了句子阅读、知识探索、成就激励、创作分享、文件传输、协作画布等完整内容生态,是一个功能完备的图文创作与知识探索工具。
---
## 核心特性
### 📖 句子阅读与内容流
首页句子卡片流,接入 Hitokoto API 支持 12 种句子类型(动画/漫画/游戏/文学/原创/网络/其他/影视/诗词/网易云/哲学/抖机灵),支持每日一卡、快速卡片预览、收藏/点赞/稍后阅读/离线模式,阅读历史自动记录,缓存管理支持一键清理。
### 🔍 知识发现与搜索
- **发现页**:今日一读推荐 + 44 个数据源分类浏览 + 关联推荐
- **全局搜索**:模糊搜索 + 热搜榜 + 用户偏好记忆 + 搜索缓存
- **国学经典**11 部经典典籍(论语/黄帝内经/史记/孙子兵法/墨子/庄子/左传/三国志/金匮要略/战国策/万历野获编),支持分类检索
- **健康生活**6 大分类(药品查询/中草药/食物相克/偏方大全/药茶养生/疾病自查)
- **知识图谱**:句子/诗词/成语关联关系可视化
### 🎮 互动游戏与趣味
游戏中心集成 3 类互动玩法:
- **成语接龙**:成语链式挑战
- **诗词填空**:古诗词互动填空
- **谜语/脑筋急转弯/歇后语**:揭晓答案式互动答题
### 💬 智能会话流
灵感页面采用联系人列表布局,会话流支持关键词触发 AI 回复(推荐/爱情/励志/自然/文学/影视定时推送句子消息持久化AppKVStore导入导出。长按弹出菜单支持置顶/备注/已读/免打扰,毛玻璃搜索栏实时搜索。
### 🛠️ 工具中心
- **汉字查询**:笔画/部首/拼音检索
- **计算器**:科学计算器
- **中国传统色**:色彩查询与收藏
- **OCR 文字识别**:图片文字提取
- **图片压缩**:多格式压缩导出
### 📝 文章创作与分享
- **文章广场**:公开文章流 + 分类筛选 + 搜索 + 点赞收藏
- **文章编辑**Markdown 编辑 + 封面图 + 标签
- **我的文章**:已发布/草稿管理 + Slidable 操作 + 统计头部
- **内容查重**4 种模式(精确/模糊/相似度/综合)+ 多数据源 + 风险可视化 + 匹配详情
- **分享系统**10 种分享目标(复制/链接/系统分享/二维码/卡片/微信/QQ/微博/笔记)+ 自定义排序 + 历史记录
### 🏆 成就与激励体系
- **成就中心**:成就展示/领取 + 头衔进度 + Confetti 庆祝动画 + 进度环图
- **学习打卡**6 类打卡(诗词/成语/故事/名言/游戏/国学)+ 连击效果 + 光晕动画
- **每日签到**:日历签到 + 连续签到奖励 + 补签
- **金币系统**:金币流水 + 收支统计 + 趋势图 + 来源筛选 + 日期分组
- **积分等级**:新手→学徒→熟练工→达人→专家→大师
- **排行榜**:多维度排名展示
### 👤 个人中心
- **用户资料**:头像/昵称/个性签名/可编辑信息
- **学习中心**:仪表盘 + 每日推荐 + 热力图 + 7 日趋势 + 统计网格
- **学习进度**:进度追踪 + 可视化图表
- **数据统计**:站点总览 + 签到趋势图 + 金币分布 + 内容饼图 + 增长趋势
- **足迹整合**:浏览/点赞/收藏/稍后读/笔记 5 Tab
- **公开主页**:用户公开信息展示
- **阅读报告**:周/月/年阅读数据洞察
### 📁 文件传输与协作
- **多通道传输**WiFi Direct / 蓝牙 / NFC / USB OTG / WebRTC / LocalSend / WebSocket 中继
- **设备发现**LAN 扫描 / 热点 / QR 配对 / USB 检测 / 蓝牙发现 / NFC 触碰
- **传输聊天**:实时消息 + 文件传输 + 语音消息 + 送达回执
- **断点续传**WebSocket 分块传输 + 断点恢复 + 校验
- **云端暂存**:离线消息缓存 + 云端中转
- **安全传输**ECDH 密钥交换 + 端到端加密 + TLS 安全通道
- **协作画布**CRDT 实时协同绘图 + 笔迹同步 + 多人光标
- **屏幕共享**:远程屏幕查看 + 输入控制
- **剪贴板同步**:跨设备剪贴板实时同步
### ⏰ 时间与生活
- **番茄钟**:阅读专注计时 + 统计
- **倒计时**:纪念日/节日倒计时 + 配句
- **节气日历**:二十四节气 + 物候 + 诗词
- **每日运势**:每日运势卡片 + 个性化设置
- **天气联动**:天气信息 + 诗词推荐
### 📋 学习与计划
- **学习计划**:自定义学习计划 + 进度追踪 + 提醒
- **每日任务**:任务系统 + 完成追踪
- **诗词专题**:诗词深度阅读与赏析
- **壁纸模板**:预设壁纸模板 + 一键生成 + 壁纸画廊
### ✏️ 专业图文编辑器
内置 8 个子编辑器画笔、文字、裁剪旋转、色调调整、滤镜、模糊、Emoji、贴纸。支持 5 种画布比例切换9:16/3:4/1:1/4:3/16:9、三等分/点阵网格参考线、智能对齐吸附、取色器(实时预览+放大镜+HEX、多节点渐变编辑器、操作历史树形面板。编辑器采用 Frosted Glass 毛玻璃主题,所有 UI 组件统一圆角阴影风格。
### 🎨 七类贴纸系统
液态玻璃贴纸8 种预设liquid_glass_widgets Shader 渲染、轻量玻璃贴纸4 种预设liquid_glass_easy 透镜特效、SVG 矢量贴纸8 种本地 SVG、Lottie 动画贴纸6 种本地动画、网络贴纸6 类 36 张在线资源、形状贴纸4 种基础几何、3D 模型贴纸(几何体/装饰/自然 3 分类 10+ 模型flutter_3d_controller WebView 实时渲染)。所有贴纸均可拖拽、缩放、旋转,导出时通过 RepaintBoundary 预渲染合成。
### 🧊 3D 内容引擎
统一使用 flutter_3d_controllerWebView + model-viewer作为唯一 3D 渲染路径。支持 .glb 模型在线 CDN 加载,独立 3D 预览页面支持动画播放控制、自动旋转、相机重置。低端设备自动检测Android API<28 / iOS<15并展示降级提示。3D 贴纸导出采用静态快照方案解决 WebView 无法 RepaintBoundary 截图的限制。
### 📤 完整导出链路
高分辨率 PNG 保存到相册gal、系统分享share_plus、.xycard 源文件格式ZIP 压缩/解压可再编辑、JPEG/WebP 压缩导出flutter_image_compress体积减少 70%+、GIF 逐帧导出、草稿自动保存与恢复、导出格式选择+质量滑块。
### 🖼️ 图片处理增强
图片尺寸/格式检测image_size_getter读文件头零解码、EXIF 旋转自动校正、全屏大图预览photo_view缩放+旋转+双击循环+Hero 动画、多图画廊PhotoViewGallery、裁剪编辑器extended_image自由/1:1/4:3/16:9 + 旋转翻转 + undo/redo、大图内存优化ExtendedResizeImage 降采样)。
### 🪟 iOS 26 Liquid Glass 设计语言
全套设计令牌系统(颜色/间距/圆角/阴影/字体/毛玻璃6 套主题配置日夜双主题自动切换自适应主题色从图片提取调色板Cupertino 优先的组件风格。底部面板采用 stupid_simple_sheet 弹簧动画,页面转场使用 heroine 弹簧物理效果替代 Hero。
---
## 架构设计
```
lib/
├── main.dart # 入口 + 设备能力检测初始化
├── app/ # MaterialApp.router + GlassTheme + Riverpod
├── core/ # 基础设施层
│ ├── router/ # go_router + ShellRoute 声明式路由 (100+ 路由) + OhosNavBridge
│ ├── layout/ # AppShell + GlassBottomBar + OhosAppShell 统一布局
│ ├── theme/ # 设计令牌 (颜色/圆角/阴影/间距/排版/Glass)
│ ├── network/ # Dio + Interceptor + ApiException + ConnectivityProvider
│ ├── storage/ # KvStorage + SecureStorage + Drift (4 表 + 鸿蒙适配)
│ ├── services/ # 深链接/权限/Token/通知/稍后读/剪贴板/智能模式 服务
│ ├── registry/ # PageRegistry 页面注册中心
│ └── utils/ # 动画/日志/平台检测/权限/扩展/Sheet动画
├── editor/ # 编辑器核心模块
│ ├── models/ # freezed 数据模型 + LayerInfo sealed class
│ ├── providers/ # Riverpod StateNotifier
│ ├── mixins/ # 编辑器行为混入 (7 个)
│ ├── services/core/ # ProEditorBridge + StickerConfigBuilder + WidgetLayerFactory
│ ├── services/export/ # ExportService + XycardService + DraftService + GifExport + RichText
│ ├── services/image/ # ImageImportService + ImageInfoService + GlassRenderService + Watermark
│ ├── services/3d/ # Platform3DService + Flutter3DControllerFactory + Scene3D
│ ├── pages/ # ProEditorPage + MiniEditor(3模式) + 工具页(裁剪/预览/3D/草稿)
│ └── widgets/ # 图层面板/颜色选择器/取色器/渐变编辑器/3D面板/水印面板/精灵图等
├── features/ # 功能模块 (Feature-first 架构, 37 个模块)
│ ├── home/ # 首页句子卡片流 + Hitokoto API + 收藏/历史/点赞/稍后读/离线/缓存
│ ├── inspiration/ # 灵感页(联系人列表) + 会话流 + 工具中心 + 足迹
│ ├── discover/ # 发现页 + 分类浏览 + 每日推荐
│ ├── search/ # 全局搜索 + 热搜榜 + 用户偏好
│ ├── article/ # 文章广场 + 编辑 + 我的文章 + 详情
│ ├── classics/ # 国学经典 (11 部典籍)
│ ├── health/ # 健康生活 (6 大分类)
│ ├── game/ # 游戏中心 (成语接龙/诗词填空/谜语)
│ ├── check/ # 内容查重 (4 种模式)
│ ├── achievement/ # 成就中心 + 学习打卡 + 徽章墙
│ ├── signin/ # 每日签到
│ ├── user_center/ # 个人中心 + 学习中心 + 金币记录 + 公开主页 + 标签云
│ ├── auth/ # 登录注册 + 邮箱验证 + 安全设置 + 二维码登录
│ ├── note/ # 笔记系统
│ ├── share/ # 分享系统 (10 种目标 + 自定义排序 + 历史记录)
│ ├── statistics/ # 数据统计 (站点/用户/签到/金币/内容)
│ ├── profile/ # 个人资料页
│ ├── member/ # 会员
│ ├── source/ # 来源管理 + 混合源配置
│ ├── settings/ # 主题/通用/账户/密码/数据/字体/通知/隐私/权限/日志 设置
│ ├── correction/ # 内容纠错
│ ├── file_transfer/ # 文件传输 (7 通道 + 设备发现 + 聊天 + 语音 + 统计 + 云端)
│ ├── collaboration/ # 协作 (画布CRDT + 剪贴板同步 + 屏幕共享)
│ ├── countdown/ # 倒计时 (纪念日/节日)
│ ├── daily_card/ # 每日一卡 (卡片渲染 + 风格选择)
│ ├── daily_fortune/ # 每日运势 (运势卡片 + 个性化设置)
│ ├── knowledge_graph/ # 知识图谱 (关联关系可视化)
│ ├── poetry/ # 诗词专题
│ ├── pomodoro/ # 番茄钟 (专注计时 + 统计)
│ ├── progress/ # 学习进度 (进度追踪 + 可视化)
│ ├── rank/ # 排行榜
│ ├── reading_report/ # 阅读报告 (周/月/年数据洞察)
│ ├── solar_term/ # 节气日历 (二十四节气 + 物候 + 诗词)
│ ├── study_plan/ # 学习计划 (自定义计划 + 进度追踪)
│ ├── task/ # 每日任务 (任务系统 + 完成追踪)
│ ├── template/ # 壁纸模板 (预设模板 + 壁纸画廊)
│ └── weather/ # 天气 (天气信息 + 诗词推荐)
└── shared/ # 共享组件
├── extensions/ # Context 扩展 + 导航扩展 (appPush/appGo)
└── widgets/ # GlassContainer/Skeleton/EmptyState/BottomSheet/ShareSheet/Slidable/WallpaperGallery/TabIconSprite/LevelCard/RankItemCard 等
```
---
## 技术栈
| 层级 | 技术 |
|------|------|
| 框架 | Flutter 3.41+ / Dart 3.11+ |
| 状态管理 | Riverpod 3.0+ (Notifier + 依赖注入) |
| 路由 | go_router 17.0+ (ShellRoute + 深链接 + OhosNavBridge) |
| 数据库 | Drift 2.16+ (SQLite 类型安全 + 响应式查询 + 鸿蒙适配) |
| 数据模型 | freezed 3.0+ (不可变 + JSON 序列化) |
| 网络 | Dio 5.4+ (拦截器 + 请求取消) |
| 后端 | Supabase (Auth + Database + Storage) |
| 图表 | fl_chart 0.69+ (折线图/柱状图/饼图/仪表盘) |
| 动画 | flutter_animate + animate_do + confetti + lottie |
| 设计语言 | iOS 26 Liquid Glass (Cupertino 优先) |
| 实时通信 | WebRTC + WebSocket + SignalingService |
| 加密 | ECDH 密钥交换 + TLS + 端到端加密 |
---
## 平台支持
| 平台 | 状态 | 说明 |
|------|:----:|------|
| Android | ✅ | 完整支持 |
| iOS | ✅ | 完整支持 |
| macOS | ✅ | 完整支持 |
| Windows | ✅ | 完整支持 (3D 仅静态) |
| Linux | ✅ | 完整支持 (3D 仅静态) |
| Web | ✅ | 完整支持 (压缩有限制) |
| 鸿蒙 (OpenHarmony) | ✅ | 30 个三方包已适配,液态玻璃已恢复 |
---
## 核心依赖
| 库 | 用途 |
|----|------|
| pro_image_editor | 专业图片编辑引擎 (Frosted Glass 主题定制) |
| liquid_glass_widgets / liquid_glass_easy | iOS 26 液态玻璃组件 + 透镜特效 |
| flutter_3d_controller | 3D 模型交互预览 (WebView + model-viewer) |
| flutter_svg / lottie | SVG 渲染 / Lottie 矢量动画 |
| google_fonts | 15 种字体 (中 6 + 英 9) |
| photo_view / extended_image | 图片缩放查看 / 裁剪编辑 + 内存优化 |
| flutter_image_compress | 原生图片压缩 (JPEG/WebP/PNG/HEIC) |
| image_size_getter | 图片尺寸/格式检测 (零解码) |
| adaptive_palette | 自适应主题色提取 + 流体背景 |
| heroine / stupid_simple_sheet | 弹簧 Hero 动画 / iOS 26 Glass Sheet |
| fl_chart | 数据可视化 (折线图/柱状图/饼图) |
| flutter_animate / animate_do / confetti | 入场动画 / 交互动画 / 庆祝特效 |
| pull_down_button | iOS 风格下拉菜单 |
| flutter_slidable | 列表滑动操作 |
| flutter_markdown_plus | Markdown 渲染 |
| flutter_webrtc | WebRTC 音视频通信 |
| nearby_service | 近场设备发现 (WiFi P2P) |
| nfc_manager | NFC 读写 |
| flutter_blue_plus | 蓝牙 BLE 通信 |
---
## 项目规模
- **619 个 Dart 文件** (核心代码 lib/)
- **100+ 路由页面** (编辑器 8 页 + 功能 90+ 页)
- **8 个设计令牌文件** (颜色/圆角/阴影/间距/排版/Glass/主题)
- **27 个编辑器服务** (core 9 + export 8 + image 8 + 3d 5)
- **37 个功能模块** (Feature-first 架构)
- **30 个鸿蒙适配三方包** (联合插件 + 直接插件)
- **7 个传输通道** (WiFi Direct/蓝牙/NFC/USB OTG/WebRTC/LocalSend/WebSocket)
- **3 个协作功能** (画布/剪贴板/屏幕共享)
---
## 开发进度
> 当前版本: v5.2.0
| Phase | 内容 | 状态 |
|-------|------|:----:|
| Phase 0 | 基础设施搭建 | ✅ |
| Phase 1 | 编辑器核心 + 首页句子流 | ✅ |
| 编辑器: 图层管理 | LayerPanel + UndoRedo + 图层 CRUD | ✅ |
| 编辑器: 3D 引擎 | 3D 贴纸 + 3D 预览 + 平台调度 | ✅ |
| 编辑器: 图片处理 | 压缩 + 预览 + 裁剪 + 信息读取 | ✅ |
| 编辑器: 3D 修复 | 统一渲染 + 图层模型统一 + bridge 拆分 | ✅ |
| Phase 2 | 内容发现 + 搜索 + 灵感 | ✅ |
| Phase 2.1 | 灵感页联系人列表重构 + 会话流 + 足迹 | ✅ |
| Phase 2.2 | 国学经典 + 健康生活 + 游戏中心 | ✅ |
| Phase 2.3 | 文章广场 + 内容查重 + 分享系统 | ✅ |
| Phase 2.4 | 成就中心 + 学习打卡 + 金币系统 + 数据统计 | ✅ |
| Phase 2.5 | 个人中心 + 学习中心 + 公开主页 | ✅ |
| Phase 2.6 | 番茄钟 + 倒计时 + 节气日历 + 每日运势 + 天气 | ✅ |
| Phase 2.7 | 学习计划 + 学习进度 + 阅读报告 + 排行榜 + 每日任务 | ✅ |
| Phase 2.8 | 知识图谱 + 诗词专题 + 壁纸模板 | ✅ |
| Phase 3 | 文件传输 + 协作画布 + 屏幕共享 + 剪贴板同步 | ✅ |
| Phase 3.1 | 7 通道传输 + 设备发现 + 传输聊天 + 语音消息 | ✅ |
| Phase 3.2 | 送达回执 + 断点续传 + 文件分流 + 云端暂存 | ✅ |
| Phase 3.3 | USB OTG 有线传输 | ✅ |
| Phase 4 | 鸿蒙全量适配 | ✅ |
| Phase 4.1 | 30 个三方包鸿蒙适配 | ✅ |
| Phase 4.2 | 液态玻璃效果恢复 + 全量导航修复 | ✅ |
| Phase 4.3 | 数据库迁移修复 + Riverpod 反模式修复 | ✅ |
| Phase 5 | 会员 + 通知增强 + 壁纸系统完善 | 🔲 |
| Phase 6 | AI 增强 + 个性化推荐 | 🔲 |
---
## 可扩展方向
> 暂不开发社交功能,以下方向均围绕个人知识管理与创作展开
### 🤖 AI 智能增强
| 方向 | 说明 | 优先级 |
|------|------|:------:|
| AI 句子推荐 | 基于阅读偏好智能推荐句子,替代当前关键词匹配 | ⭐⭐⭐⭐⭐ |
| AI 写作助手 | 文章编辑时提供续写/润色/改写建议 | ⭐⭐⭐⭐ |
| AI 摘要生成 | 长文自动生成摘要,快速了解内容 | ⭐⭐⭐⭐ |
| AI 翻译 | 句子/文章多语言翻译 | ⭐⭐⭐ |
| AI 语音朗读 | TTS 语音播报句子和文章 | ⭐⭐⭐ |
| 智能标签 | 自动为文章/笔记生成标签 | ⭐⭐⭐ |
| OCR 增强 | 手写识别 + 表格识别 + 公式识别 | ⭐⭐ |
### 📚 知识体系深化
| 方向 | 说明 | 优先级 |
|------|------|:------:|
| 诗词地图 | 按地理/朝代/作者维度浏览诗词 | ⭐⭐⭐⭐ |
| 每日一题 | 诗词/成语/国学每日挑战 + 排行榜 | ⭐⭐⭐⭐ |
| 书法欣赏 | 名家书法作品展示 + 临摹模式 | ⭐⭐⭐ |
| 朗读社区 | 语音朗读作品展示(非社交,单人展示) | ⭐⭐ |
### 🎨 创作能力扩展
| 方向 | 说明 | 优先级 |
|------|------|:------:|
| 日签/卡片 | 每日句子日签卡片生成 + 分享 | ⭐⭐⭐⭐⭐ |
| 诗词排版 | 古诗词竖排/横排精美排版 | ⭐⭐⭐⭐ |
| AI 配图 | 根据句子内容自动匹配/生成配图 | ⭐⭐⭐⭐ |
| 视频卡片 | 句子 + 音乐 + 动效 = 短视频卡片 | ⭐⭐⭐ |
| 手写输入 | 手写板输入 + 笔迹美化 | ⭐⭐ |
### 📊 数据与个性化
| 方向 | 说明 | 优先级 |
|------|------|:------:|
| 个性化推荐 | 基于行为的句子/文章/分类推荐 | ⭐⭐⭐⭐ |
| 数据导出 | 笔记/收藏/历史导出为 PDF/Markdown | ⭐⭐⭐⭐ |
| 云同步 | 多设备数据同步Supabase | ⭐⭐⭐⭐ |
| Widget 小组件 | iOS/Android 桌面小组件显示每日句子 | ⭐⭐⭐ |
| 习惯追踪 | 阅读习惯分析 + 最佳阅读时间推荐 | ⭐⭐⭐ |
### 🔔 系统增强
| 方向 | 说明 | 优先级 |
|------|------|:------:|
| 推送通知增强 | 定时推送句子/打卡提醒 + 智能推送 | ⭐⭐⭐⭐⭐ |
| 深色模式增强 | 更多深色主题变体 + 跟随系统 | ⭐⭐⭐⭐ |
| 无障碍 | 语义化标签 + 字体缩放 + 高对比度 | ⭐⭐⭐⭐ |
| 快捷指令 | iOS Shortcuts / Android Shortcuts 集成 | ⭐⭐⭐ |
| 多语言 | UI 国际化 (en/zh/ja/ko) | ⭐⭐⭐ |
| Apple Watch | 手表端每日句子 + 打卡 | ⭐⭐ |
---
## 快速开始
```bash
# 克隆项目
git clone <repo-url>
cd xianyan
# 安装依赖
flutter pub get
# 生成代码 (freezed / drift / json_serializable)
dart run build_runner build --delete-conflicting-outputs
# 运行
flutter run
```
---
## 文档索引
| 文档 | 说明 |
|------|------|
| [CHANGELOG.md](CHANGELOG.md) | 版本变更记录 |
| [AGENTS.md](AGENTS.md) | AI 开发指引 |
| [docs/01_项目总览.md](docs/01_项目总览.md) | 项目概述 + 架构 + 开发阶段 |
| [docs/07_三方库清单.md](docs/07_三方库清单.md) | 全部三方库选型与版本 |
| [docs/08_编辑器功能清单.md](docs/08_编辑器功能清单.md) | 编辑器架构 + 功能 + 路线图 |
| [docs/09_三方库扩展功能开发文档.md](docs/09_三方库扩展功能开发文档.md) | 7 库接口分析 + 扩展功能 |
| [docs/10_三方库扩展开发计划勾选表.md](docs/10_三方库扩展开发计划勾选表.md) | 按 Phase 细分开发任务 |
| [docs/11_编辑器空壳功能诊断与修复计划.md](docs/11_编辑器空壳功能诊断与修复计划.md) | 3D 空壳功能诊断 + 修复记录 |
---
## License
Private — 仅供学习参考