feat: 发布v5.3.0正式版本,完善跨平台适配与功能优化

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

160
README.md
View File

@@ -5,20 +5,20 @@
</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对话` `国学经典` `成就系统`
`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 模型交互和完整导出链路。同时构建了句子阅读、知识探索、成就激励、创作分享等完整内容生态,是一个功能完备的图文创作与知识探索工具。
闲言是一款以句子阅读和图文创作为核心的跨平台应用,源自一个 Lua 原生项目65 文件 15000+ 行),经过全面 Flutter 重写,采用 iOS 26 Liquid Glass 设计语言,覆盖 Android、iOS、macOS、Windows、Linux、Web 和鸿蒙 7 大平台。核心编辑器模块基于 pro_image_editor 深度定制,集成 8 个子编辑器、7 类贴纸系统、3D 模型交互和完整导出链路。同时构建了句子阅读、知识探索、成就激励、创作分享、文件传输、协作画布等完整内容生态,是一个功能完备的图文创作与知识探索工具。
---
@@ -34,6 +34,7 @@
- **全局搜索**:模糊搜索 + 热搜榜 + 用户偏好记忆 + 搜索缓存
- **国学经典**11 部经典典籍(论语/黄帝内经/史记/孙子兵法/墨子/庄子/左传/三国志/金匮要略/战国策/万历野获编),支持分类检索
- **健康生活**6 大分类(药品查询/中草药/食物相克/偏方大全/药茶养生/疾病自查)
- **知识图谱**:句子/诗词/成语关联关系可视化
### 🎮 互动游戏与趣味
@@ -69,14 +70,44 @@
- **每日签到**:日历签到 + 连续签到奖励 + 补签
- **金币系统**:金币流水 + 收支统计 + 趋势图 + 来源筛选 + 日期分组
- **积分等级**:新手→学徒→熟练工→达人→专家→大师
- **排行榜**:多维度排名展示
### 👤 个人中心
- **用户资料**:头像/昵称/个性签名/可编辑信息
- **学习中心**:仪表盘 + 每日推荐 + 热力图 + 7 日趋势 + 统计网格
- **学习进度**:进度追踪 + 可视化图表
- **数据统计**:站点总览 + 签到趋势图 + 金币分布 + 内容饼图 + 增长趋势
- **足迹整合**:浏览/点赞/收藏/稍后读/笔记 5 Tab
- **公开主页**:用户公开信息展示
- **阅读报告**:周/月/年阅读数据洞察
### 📁 文件传输与协作
- **多通道传输**WiFi Direct / 蓝牙 / NFC / USB OTG / WebRTC / LocalSend / WebSocket 中继
- **设备发现**LAN 扫描 / 热点 / QR 配对 / USB 检测 / 蓝牙发现 / NFC 触碰
- **传输聊天**:实时消息 + 文件传输 + 语音消息 + 送达回执
- **断点续传**WebSocket 分块传输 + 断点恢复 + 校验
- **云端暂存**:离线消息缓存 + 云端中转
- **安全传输**ECDH 密钥交换 + 端到端加密 + TLS 安全通道
- **协作画布**CRDT 实时协同绘图 + 笔迹同步 + 多人光标
- **屏幕共享**:远程屏幕查看 + 输入控制
- **剪贴板同步**:跨设备剪贴板实时同步
### ⏰ 时间与生活
- **番茄钟**:阅读专注计时 + 统计
- **倒计时**:纪念日/节日倒计时 + 配句
- **节气日历**:二十四节气 + 物候 + 诗词
- **每日运势**:每日运势卡片 + 个性化设置
- **天气联动**:天气信息 + 诗词推荐
### 📋 学习与计划
- **学习计划**:自定义学习计划 + 进度追踪 + 提醒
- **每日任务**:任务系统 + 完成追踪
- **诗词专题**:诗词深度阅读与赏析
- **壁纸模板**:预设壁纸模板 + 一键生成 + 壁纸画廊
### ✏️ 专业图文编辑器
@@ -111,24 +142,25 @@ lib/
├── main.dart # 入口 + 设备能力检测初始化
├── app/ # MaterialApp.router + GlassTheme + Riverpod
├── core/ # 基础设施层
│ ├── router/ # go_router + ShellRoute 声明式路由 (50+ 路由)
│ ├── layout/ # AppShell + GlassBottomBar 统一布局
│ ├── router/ # go_router + ShellRoute 声明式路由 (100+ 路由) + OhosNavBridge
│ ├── layout/ # AppShell + GlassBottomBar + OhosAppShell 统一布局
│ ├── theme/ # 设计令牌 (颜色/圆角/阴影/间距/排版/Glass)
│ ├── network/ # Dio + Interceptor + ApiException
│ ├── storage/ # KvStorage + SecureStorage + Drift 4 表
│ ├── services/ # 深链接/权限/Token 服务
── utils/ # 动画/日志/平台检测/权限/扩展
│ ├── 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 + ImageCompressService
│ ├── services/image/ # ImageImportService + ImageInfoService + GlassRenderService
│ ├── services/3d/ # Platform3DService + Flutter3DControllerFactory
│ ├── pages/ # ProEditorPage + MiniEditor(3模式) + 工具页(裁剪/预览/3D)
│ └── widgets/ # 图层面板/颜色选择器/取色器/渐变编辑器/3D面板/水印面板等
├── features/ # 功能模块 (Feature-first 架构)
│ ├── 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/ # 发现页 + 分类浏览 + 每日推荐
@@ -138,21 +170,37 @@ lib/
│ ├── health/ # 健康生活 (6 大分类)
│ ├── game/ # 游戏中心 (成语接龙/诗词填空/谜语)
│ ├── check/ # 内容查重 (4 种模式)
│ ├── achievement/ # 成就中心 + 学习打卡
│ ├── achievement/ # 成就中心 + 学习打卡 + 徽章墙
│ ├── signin/ # 每日签到
│ ├── user_center/ # 个人中心 + 学习中心 + 金币记录 + 公开主页
│ ├── auth/ # 登录注册 + 邮箱验证 + 安全设置
│ ├── user_center/ # 个人中心 + 学习中心 + 金币记录 + 公开主页 + 标签云
│ ├── auth/ # 登录注册 + 邮箱验证 + 安全设置 + 二维码登录
│ ├── note/ # 笔记系统
│ ├── share/ # 分享系统 (10 种目标 + 自定义排序)
│ ├── share/ # 分享系统 (10 种目标 + 自定义排序 + 历史记录)
│ ├── statistics/ # 数据统计 (站点/用户/签到/金币/内容)
│ ├── profile/ # 个人资料页
│ ├── member/ # 会员
│ ├── source/ # 来源管理
│ ├── settings/ # 主题/通用/账户/密码/数据/字体 设置
── correction/ # 内容纠错
│ ├── 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 扩展
└── widgets/ # GlassContainer/Skeleton/EmptyState/BottomSheet/ShareSheet/Slidable
├── extensions/ # Context 扩展 + 导航扩展 (appPush/appGo)
└── widgets/ # GlassContainer/Skeleton/EmptyState/BottomSheet/ShareSheet/Slidable/WallpaperGallery/TabIconSprite/LevelCard/RankItemCard 等
```
---
@@ -161,16 +209,18 @@ lib/
| 层级 | 技术 |
|------|------|
| 框架 | Flutter 3.24+ / Dart 3.9+ |
| 状态管理 | Riverpod 2.5+ (StateNotifier + 依赖注入) |
| 路由 | go_router 14.0+ (ShellRoute + 深链接) |
| 数据库 | Drift 2.16+ (SQLite 类型安全 + 响应式查询) |
| 数据模型 | freezed 2.5+ (不可变 + JSON 序列化) |
| 框架 | 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 + 端到端加密 |
---
@@ -184,7 +234,7 @@ lib/
| Windows | ✅ | 完整支持 (3D 仅静态) |
| Linux | ✅ | 完整支持 (3D 仅静态) |
| Web | ✅ | 完整支持 (压缩有限制) |
| 鸿蒙 (OpenHarmony) | ✅ | 适配中 |
| 鸿蒙 (OpenHarmony) | ✅ | 30 个三方包已适配,液态玻璃已恢复 |
---
@@ -207,23 +257,29 @@ lib/
| pull_down_button | iOS 风格下拉菜单 |
| flutter_slidable | 列表滑动操作 |
| flutter_markdown_plus | Markdown 渲染 |
| flutter_webrtc | WebRTC 音视频通信 |
| nearby_service | 近场设备发现 (WiFi P2P) |
| nfc_manager | NFC 读写 |
| flutter_blue_plus | 蓝牙 BLE 通信 |
---
## 项目规模
- **297 个 Dart 文件** (核心代码 lib/)
- **50+ 路由页面** (编辑器 8 页 + 功能 40+ 页)
- **619 个 Dart 文件** (核心代码 lib/)
- **100+ 路由页面** (编辑器 8 页 + 功能 90+ 页)
- **8 个设计令牌文件** (颜色/圆角/阴影/间距/排版/Glass/主题)
- **27 个编辑器服务** (core 9 + export 8 + image 8 + 3d 5)
- **20 个功能模块** (Feature-first 架构)
- **6 个共享组件** (GlassContainer/Skeleton/EmptyState/BottomSheet/ShareSheet/Slidable)
- **37 个功能模块** (Feature-first 架构)
- **30 个鸿蒙适配三方包** (联合插件 + 直接插件)
- **7 个传输通道** (WiFi Direct/蓝牙/NFC/USB OTG/WebRTC/LocalSend/WebSocket)
- **3 个协作功能** (画布/剪贴板/屏幕共享)
---
## 开发进度
> 当前版本: v1.55.1
> 当前版本: v5.2.0
| Phase | 内容 | 状态 |
|-------|------|:----:|
@@ -239,8 +295,19 @@ lib/
| Phase 2.3 | 文章广场 + 内容查重 + 分享系统 | ✅ |
| Phase 2.4 | 成就中心 + 学习打卡 + 金币系统 + 数据统计 | ✅ |
| Phase 2.5 | 个人中心 + 学习中心 + 公开主页 | ✅ |
| Phase 3 | 壁纸 + 会员 + 通知 | 🔲 |
| Phase 4 | AI 增强 + 个性化推荐 | 🔲 |
| 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 增强 + 个性化推荐 | 🔲 |
---
@@ -264,8 +331,6 @@ lib/
| 方向 | 说明 | 优先级 |
|------|------|:------:|
| 知识图谱 | 句子/诗词/成语之间的关联关系可视化 | ⭐⭐⭐⭐⭐ |
| 学习计划 | 自定义学习计划 + 进度追踪 + 提醒 | ⭐⭐⭐⭐ |
| 诗词地图 | 按地理/朝代/作者维度浏览诗词 | ⭐⭐⭐⭐ |
| 每日一题 | 诗词/成语/国学每日挑战 + 排行榜 | ⭐⭐⭐⭐ |
| 书法欣赏 | 名家书法作品展示 + 临摹模式 | ⭐⭐⭐ |
@@ -275,7 +340,6 @@ lib/
| 方向 | 说明 | 优先级 |
|------|------|:------:|
| 壁纸模板 | 预设壁纸模板 + 一键生成 | ⭐⭐⭐⭐⭐ |
| 日签/卡片 | 每日句子日签卡片生成 + 分享 | ⭐⭐⭐⭐⭐ |
| 诗词排版 | 古诗词竖排/横排精美排版 | ⭐⭐⭐⭐ |
| AI 配图 | 根据句子内容自动匹配/生成配图 | ⭐⭐⭐⭐ |
@@ -286,29 +350,17 @@ lib/
| 方向 | 说明 | 优先级 |
|------|------|:------:|
| 阅读报告 | 周/月/年阅读报告 + 数据洞察 | ⭐⭐⭐⭐⭐ |
| 习惯追踪 | 阅读习惯分析 + 最佳阅读时间推荐 | ⭐⭐⭐⭐ |
| 个性化推荐 | 基于行为的句子/文章/分类推荐 | ⭐⭐⭐⭐ |
| 数据导出 | 笔记/收藏/历史导出为 PDF/Markdown | ⭐⭐⭐⭐ |
| 云同步 | 多设备数据同步Supabase | ⭐⭐⭐⭐ |
| Widget 小组件 | iOS/Android 桌面小组件显示每日句子 | ⭐⭐⭐ |
### 🛠️ 工具扩展
| 方向 | 说明 | 优先级 |
|------|------|:------:|
| 天气 + 诗词 | 天气联动推荐诗词/句子 | ⭐⭐⭐⭐ |
| 番茄钟 | 阅读专注计时 + 统计 | ⭐⭐⭐⭐ |
| 倒计时 | 纪念日/节日倒计时 + 配句 | ⭐⭐⭐⭐ |
| 诗词接龙 | 多人对诗非社交AI 对手) | ⭐⭐⭐ |
| 字典工具 | 古汉语字典 + 成语词典 | ⭐⭐⭐ |
| 节气日历 | 二十四节气 + 物候 + 诗词 | ⭐⭐⭐ |
| 习惯追踪 | 阅读习惯分析 + 最佳阅读时间推荐 | ⭐⭐⭐ |
### 🔔 系统增强
| 方向 | 说明 | 优先级 |
|------|------|:------:|
| 推送通知 | 定时推送句子/打卡提醒 | ⭐⭐⭐⭐⭐ |
| 推送通知增强 | 定时推送句子/打卡提醒 + 智能推送 | ⭐⭐⭐⭐⭐ |
| 深色模式增强 | 更多深色主题变体 + 跟随系统 | ⭐⭐⭐⭐ |
| 无障碍 | 语义化标签 + 字体缩放 + 高对比度 | ⭐⭐⭐⭐ |
| 快捷指令 | iOS Shortcuts / Android Shortcuts 集成 | ⭐⭐⭐ |