xianyan/CHANGELOG.md

Changelog

所有重要变更均记录于此文件。格式基于 Keep a Changelog。

---

[v6.16.3] - 2026-06-04

🛡️ 系统性稳定性加固与审计修复（v6.16.0 ~ v6.16.3 合并）

审计修复 — 5类系统性风险26处加固

基于验收审计发现的87个潜在问题，优先修复26处高危问题：

• gal插件ArgumentError捕获（5处）— iOS模拟器objective_c库异常时降级为友好提示
• path_provider异常降级（8处）— 失败时降级使用Directory.systemTemp
• Hive.openBox ArgumentError捕获（2处）— 降级打开fallback box
• addPostFrameCallback mounted检查（6处）— 回调开头添加mounted保护
• 页面级pop canPop()保护（5处）— 不可pop时降级导航到首页

Hive系统级联崩溃根因修复（v6.16.2 + v6.16.3）

• 根因： Hive.initFlutter()在iOS模拟器因objective_c库问题失败后，导致整个Hive系统瘫痪
• 影响范围： KvStorage、WallpaperFavoriteService、WallpaperHealthService、SettingsChangeLogger等全部初始化失败
• 修复： HiveSafeAccess.ensureInitialized() — 失败时降级使用Hive.init()+手动路径获取；各服务添加全异常捕获优雅降级

引导页 & 小部件修复（v6.16.1）

• 引导页重复显示 — 将判断从initialLocation移到redirect回调，改用isOnboardingCompleted
• 桌面小部件framework断言 — CupertinoSliverNavigationBar补充largeTitle参数

修改文件：

• hive_safe_access.dart, kv_storage.dart, wallpaper_favorite_service.dart, wallpaper_health_service.dart, settings_change_logger.dart
• share_sheet.dart, leisure_share_sheet.dart, progress_share_card.dart, chat_video_bubble.dart, china_colors_page.dart
• export_io_native.dart, font_download_service.dart, logger.dart, sentence_detail_actions.dart, account_export_info_sheet.dart, voice_recorder_sheet.dart, ohos_compatibility_helper.dart, general_fields_provider.dart
• progress_beautify_page.dart, signin_page.dart, app_lock_pattern_setup.dart, image_cache_page.dart, chat_flow_page.dart, weather_settings_page.dart
• hot_search_page.dart, security_question_page.dart, change_password_page.dart, sentence_detail_sheet.dart
• app_router.dart, widget_management_page.dart

---

[v6.15.0] - 2026-06-04

🐛 10项Bug修复 + 验收审计举一反三

#	问题	根因	修改文件
1	了解我们页面微信搜索无法单独操作	标签合并导致	learn_us_widgets.dart
2	权限管理摇一摇开关关闭无反应	refresh()销毁开关组件	permission_management_page.dart, permission_service.dart
3	日签卡片一直转圈loading	API请求无超时保护	daily_card_provider.dart, daily_card_service.dart
4	进度保存图片失败	objective_c库gal抛ArgumentError	export_io_native.dart, progress_beautify_page.dart
5	数据管理页文档目录异常	safeAppDirPath null无降级	backup_service.dart, data_management_page.dart
6	缓存管理AppBar标题多余"图片"	翻译文案问题	zh_cn.dart, zh_tw.dart
7	个人中心Hive缓存报错	HiveCacheStore打开Box异常	cache_config.dart
8	iOS长按App icon无返回按钮	QuickActions用go()替换路由	app.dart（3处go→push）
9	清理后台重开显示引导页	路由判断用isFirstLaunch误判	app_router.dart, onboarding_provider.dart
10	桌面小部件framework断言	initState异步访问ref	widget_management_page.dart

🔍 验收审计 - 举一反三分析

风险类别	高危	中危	低危	合计
异步生命周期(mounted保护)	11	20	9	42
Hive/Path/Gal缺少ArgumentError捕获	9	10	4	29
路由导航(go应改push)	4	4	2	10
KvStorage关键标志位默认值	4	2	0	6

注：v6.16.0已修复上述审计建议的高危问题

---

[v6.14.0] - 2026-06-04

🎴 日签卡片 AR 3D 展示效果 (Issue #9)

采用伪AR方案 — Flutter 3D变换 + 设备传感器模拟AR体验：

• 3D卡片渲染 — Matrix4透视投影变换，设备感应倾斜偏移（sensors_plus）
• 景深效果 — RadialGradient深空背景 + 动态星空粒子 + ShaderMask暗角
• 光影动画 — 4秒周期LinearGradient光影流动覆盖层
• 截图分享 — RepaintBoundary截取PNG → share_plus系统分享
• 6套AR主题 — 宇宙深空🌌 / 极光幻境🌈 / 落日余晖🌅 / 森林秘境🌿 / 深海探幽🌊 / 水晶殿堂💎
• 手势控制 — 拖拽旋转 / 双击重置(触觉反馈) / 捏合缩放(0.6x-2.0x)
• Cupertino风格控制面板 — GlassContainer底部面板（截图/主题切换/自动旋转/重置）

新增文件： lib/features/daily_card/presentation/daily_card_ar_view.dart

修改文件： daily_card_page.dart, app_routes.dart, route_registry.dart

---

[v6.13.0] - 2026-06-04

🔧 鸿蒙原生层修复 + iOS Widget深度定制 + 基础设施

A. 鸿蒙原生层修复 (Issue #2)

• 所有FormPage添加.bindContextMenu()长按上下文菜单（6个卡片页面各自定制操作菜单）
• 日签卡片保存按钮OHOS兼容 — gal不支持OHOS，降级为系统分享方案

B. iOS Widget深度定制 — AppIntent交互式按钮 (Issue #8)

• 新增7种AppIntent定义（刷新/点赞/分享/切换/签到/打开页面/保存卡片）
• 6个Widget View添加iOS 17+ Button(intent:)交互式按钮，iOS 14-16降级为Link方式
• Flutter端更新home_widget_service.dart处理新Intent类型

C. 基础设施 (Issue #3, #4)

• Hive安全访问单例 — 新建hive_safe_access.dart，统一lazy-init守卫、Box缓存、并发锁、重试机制；KvStorage/CrashMonitor/CacheConfig/RssService全部接入
• 设备发现去重增强 — deviceId+IP组合键去重 + 30秒心跳超时清理定时器

新增文件： hive_safe_access.dart, XianyanWidgetIntents.swift 修改文件： 6个FormPage.ets, XianyanWidget.swift, home_widget_service.dart, export_io_native.dart, ohos_compatibility_helper.dart, kv_storage.dart, lan_discovery_service.dart, device_discovery_provider.dart

---

[v6.11.0] - 2026-06-04

📷 集成真实扫码SDK + 鸿蒙端全面修复

扫码功能完善

• 创建通用扫码页面qrcode_scanner_page.dart，集成mobile_scanner: ^7.1.4
• 完整流程：相机权限 → 动画扫描线 → URL/文本/Email/电话/WiFi/vCard分类处理 → 智能结果处理
• 闪光灯开关、相册识别辅助功能，Cupertino风格界面支持动态主题

鸿蒙端兼容性修复（9项）

• ✅ 相机权限缺失 → AndroidManifest.xml添加CAMERA
• ⚠️ 文件传输设备列表重复 → 已有去重逻辑，建议增加IP组合键
• ⚠️ 长按桌面图标无按钮列表 → 鸿蒙原生限制需改.ets代码
• ✅ HiveError Box not found → OhosCompatibilityHelper.safeOpenBox()
• ⚠️ 日签保存无反应 → gal不支持OHOS，降级为分享
• ✅ 输入框不弹输入法 → requestKeyboardFocus()增强方法
• ✅ 数据管理显示0B → safeGetDirectorySize()安全读取
• ✅ 设备信息unknown → getEnhancedPlatform()/getEnhancedDeviceModel()
• ✅ OhosCompatibleState Mixin快速集成

新增文件： qrcode_scanner_page.dart, ohos_compatibility_helper.dart 修改文件： profile_page.dart, app_routes.dart, route_registry.dart, AndroidManifest.xml

---

[v6.10.5] - 2026-06-02

🏗️ 架构优化 + 多语言全覆盖 + 构建修复（v6.10.0 ~ v6.10.5 合并）

架构优化 (v6.10.0)

• MacosPlatformService统一 — 分散MethodChannel统一为新服务，Swift端扩展为10个方法处理器
• 二维码WebSocket长连接 — QrcodeWsService双通道架构（WS优先+HTTP轮询降级）+ 中继服务器
• RSS全文阅读 — Readability算法提取全文 + 图片画廊阅读模式
• 灵动岛倒计时聚焦模式 — startCountdownActivity/update/endCountdownActivity
• 自定义Lint规则 — double_angle_brackets / hardcoded_color / hardcoded_chinese
• 应用图标和名称 — 全平台图标更新，iOS/macOS名称改为中文「闲言」

多语言全覆盖 (v6.10.3 + v6.10.4)

• 6页面全量i18n — 账户设置(18key)、数据管理(33key)、来源(40key)、收藏(68key)、离线(67key)
• 翻译字段补全 — roleNative + 7个分发渠道字段，12种语言补全
• 覆盖14种语言 — zh_cn/en/ja/zh_tw/ko/de/it/es/ar/bn/hi/pt/ru/fr

构建修复 (v6.10.1 + v6.10.2 + v6.10.5)

• Syncfusion Chart崩溃 — DeferredBuilder包裹35处图表延迟渲染，21个文件
• 扫码登录自动跳转 — HTTP轮询(3s) + WebSocket双通道监听 + 自动tokenLogin
• pubspec.yaml双模板 — 拆分pubspec.ohos.yaml/pubspec.macos.yaml，tools/setup_pubspec.ps1自动生成
• AppBar标题/返回按钮修复 — 7个页面统一CupertinoNavigationBar风格

涉及文件： macos平台服务、路由注册、扫码登录、多语言系统(5新模块+14语言)、图表组件、pubspec模板、7个页面导航栏

---

[v6.9.28] - 2026-06-01

🏗️ 路由架构重构 + 基础设施建设（v6.9.19 ~ v6.9.51 合并）

路由架构重构 (v6.9.28) — Single Source of Truth

• 新增统一路由注册表route_registry.dart（~1000行），消除6-8个文件手动同步鸿蒙配置
• 自动生成GoRoute和OhosRouteEntry，ohos_nav_bridge从1188行缩减至245行
• 新增5个核心文件：route_def/route_registry/route_builders/ohos_route_types/ohos_placeholders

数据同步架构 (v6.9.23) — DataSyncEventBus

• 统一事件总线替代分散StreamController，零破坏性迁移（compat兼容层）
• 支持readlater/favorite两种事件类型，source追踪便于调试

Supabase SDK移除 (v6.9.41) — 全面切换自建API

• 移除supabase_flutter依赖，5个服务重写为ApiClient调用
• PHP后端新增22个接口（Readlater 15 + FontSync 2 + PluginUpdate 5）
• Admin管理后台新增5组CRUD模块（FastAdmin）

句子详情面板重构 (v6.9.47 + v6.9.48)

• 1252行拆分为3个文件（panel/content/actions），Riverpod Notifier消除prop drilling
• TTS关闭按钮、相关推荐、卡片分享图片、AnimatedSwitcher过渡动画

主题系统 & UI修复 (v6.9.22 + v6.9.36)

• context.isDark/context.ext便捷扩展；Sheet/Dialog硬编码颜色全面修复（7个文件）
• 21项批量UI修复：emoji清理、按钮溢出、协作画布绘制bug、Android快捷方式、16KB页面支持

多语言 & 功能 (v6.9.27 + v6.9.33 + v6.9.34 + v6.9.37 + v6.9.49)

• 登录/注册95key i18n(TAuth)、会话流100key i18n(TChatFlow)、备案信息i18n
• 功能分级标准FeatureAccessLevel（localOnly/cloudWithCloudSync/cloudRequired）
• 贡献者头像墙首字占位、阅读报告本地化、内容纠错邮箱验证码

鸿蒙适配 & 开发工具 (v6.9.20 + v6.9.24 + v6.9.38 + v6.9.40 + v6.9.42 + v6.9.51)

• module.json5权限审计（移除9个system级权限）、schema校验修复、receive_sharing_intent配置
• bitsdojo_window→window_manager迁移、win32 6.x API迁移、Swift条件编译修复
• Android配置一致性检查脚本、翻译覆盖率检测Python脚本（1304键基准）、CanvasProvider单元测试（42用例）