520kiss/xianyan
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
f7520b17b254c2f97af6eee1a945ef225e50d962
xianyan/CHANGELOG.md
Developer f7520b17b2 win提交
2026-06-22 03:50:59 +08:00

35 KiB
Raw Blame History

Changelog

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

保留最近 10 个版本（v6.89.1 ~ v6.96.0）。更早版本（v6.87.0 ~ v6.89.0）的特性已合并进软件特性功能文档，详见各版本条目。

[v6.96.0] - 2026-06-22

✨ 新增（Windows 桌面端）

窗口大小预设菜单（3×2 网格）

  • 功能: 点击窗口标题栏"口"按钮（最小化与关闭之间），在按钮下方弹出 3 列 × 2 行的窗口大小预设网格菜单
  • 预设尺寸: 小窗 800×600 / 标准 1024×768 / 宽屏 1280×720 / 大屏 1440×900 / 全高清 1920×1080 / 最大化·还原
  • 交互:
    • 弹出位置自动右对齐按钮，带边界自适应（防止溢出屏幕）
    • 入场动画：缩放 + 淡入（从右上角展开，180ms easeOutCubic）
    • 退出动画：缩放 + 淡出（120ms）
    • 点击外部区域自动关闭
    • 每个单元格悬停时高亮（accent 色 14% 背景 + 45% 边框）
  • 设计: iOS 26 Liquid Glass 风格 — Alert 层级毛玻璃（blur 40px）、圆角 16px、GlassTokens 边框 + 阴影
  • 技术方案:
    • 提取共享组件 shared/widgets/window_size_popup.dart，供 DesktopWindowTitleBar 和 AdaptiveNavBar 复用
    • 使用 OverlayEntry + Positioned 实现精确定位弹出
    • _WindowsControlButton.onPressed / _WindowControlBtn.onPressed 签名改为 void Function(BuildContext) 以传递按钮自身 context 用于定位
  • 文件:
    • lib/shared/widgets/window_size_popup.dart（新增）
    • lib/features/desktop/desktop_window_title_bar.dart（"口"按钮改为弹出菜单）
    • lib/app/layout/adaptive_nav_bar.dart（引用共享组件，删除本地重复定义）

[v6.95.0] - 2026-06-21

🐛 修复（鸿蒙端专项）

鸿蒙端横屏翻转失效

  • Issue: 鸿蒙端横屏时软件没有翻转，安卓/iOS 正常
  • 根因：EntryAbility.ets 注册了 flutter/platform 通道拦截器，其 default 分支调用 result.notImplemented()，导致 SystemChrome.setPreferredOrientations 等平台方法全部失效
  • 修复：移除 flutter/platform 通道拦截器，由 Flutter 鸿蒙引擎原生 PlatformChannel.ets 处理所有平台方法
  • 文件：ohos/entry/src/main/ets/entryability/EntryAbility.ets

鸿蒙端复制粘贴不生效

  • Issue: 点击复制按钮显示成功但实际未复制；输入框长按粘贴无反应
  • 根因1（复制）：同上，flutter/platform 拦截器覆盖了引擎原生 Clipboard.setData 实现
  • 根因2（粘贴）：READ_PASTEBOARD 为 system_basic 级系统权限，普通应用无法通过 requestPermissionsFromUser 申请；引擎原生 getClipboardData 因权限缺失返回 null
  • 修复：
    • 复制：移除拦截器后由引擎原生 PlatformChannel.ets 处理 Clipboard.setData（无需权限）
    • 粘贴：创建 CustomPlatformPlugin.ets 中间件，继承 PlatformPlugin 和 PlatformPluginCallback，覆盖 getClipboardData 方法，使用系统安全控件 PasteButton 获取临时剪贴板读取授权（点击后授权持续到灭屏/切后台/退出）
    • 覆盖 clipboardHasStrings 返回 true，确保输入框工具栏粘贴按钮显示
    • 在 EntryAbility.ets 覆盖 providePlatformPlugin 返回 CustomPlatformPlugin
  • 架构亮点：不修改 SDK 源码，通过继承实现中间件过渡层，SDK 升级不受影响
  • 文件：ohos/entry/src/main/ets/entryability/CustomPlatformPlugin.ets（新增）、ohos/entry/src/main/ets/entryability/EntryAbility.ets

鸿蒙端设备信息显示"未知设备"

  • Issue: 我的设备页面鸿蒙端显示"未知设备"，安卓/iOS 正常
  • 根因：DeviceMethodHandler.ets 返回鸿蒙原生字段名（manufacture、marketName、productModel 等），与 AndroidDeviceInfo.fromMap 期望的 Android 字段名（manufacturer、name、model 等）不匹配
  • 修复：
    • 在 DeviceMethodHandler.ets 增加 Android 兼容字段映射，保留原生鸿蒙字段的同时补充 board/bootloader/brand/device/display/fingerprint/hardware/host/id/manufacturer/model/product/name/tags/type/isPhysicalDevice 等字段
    • 在 AndroidDeviceInfo.fromMap 增加防御性默认值（?? ''、?? 0、?? true），防止 type 'Null' is not a subtype of type 'String' 崩溃
  • 文件：packages/device_info_plus/ohos/.../DeviceMethodHandler.ets、packages/device_info_plus/lib/src/model/android_device_info.dart

鸿蒙端搜索页 flutter_keyboard_visibility 崩溃

  • Issue: 搜索页面报 MissingPluginException(No implementation found for method listen on channel flutter_keyboard_visibility)
  • 根因：flutter_keyboard_visibility 插件无鸿蒙原生实现，EventChannel.listen 抛出 MissingPluginException
  • 修复：KeyboardManager 延迟初始化 KeyboardVisibilityController 并捕获异常，鸿蒙端降级为 MediaQuery.of(context).viewInsets.bottom > 0 检测键盘可见性
  • 文件：lib/shared/widgets/adaptive/keyboard_safe_sheet.dart

鸿蒙端安装失败（READ_PASTEBOARD 权限）

  • Issue: 声明 ohos.permission.READ_PASTEBOARD 后安装失败，报 grant request permissions failed
  • 根因：READ_PASTEBOARD 为 system_basic 级权限，普通应用无法通过 module.json5 的 requestPermissions 声明
  • 修复：从 module.json5 移除 READ_PASTEBOARD 权限声明，改用 PasteButton 安全控件获取临时授权
  • 文件：ohos/entry/src/main/module.json5

新特性轮播正则表达式崩溃

  • Issue: FormatException: Range out of order in character class ^([\u{1F300}-\u{1FAFF}\u{2600}-\u{27BF}]+)\s*
  • 根因：Dart raw string (r'...') 中 \u{1F300} 不会被解析为 Unicode 转义，导致正则引擎看到无效字符范围
  • 修复：改用 Runes 逐字符检测 code point 范围，避免正则 Unicode 转义兼容性问题
  • 文件：lib/features/home/presentation/widgets/new_features_dialog.dart

🔧 架构改进

SDK 零修改原则

  • 原则：所有鸿蒙端修复均不修改 Flutter 鸿蒙 SDK 源码（e:\sdk\flutter-ohos\），通过项目内中间件继承实现
  • 中间件：CustomPlatformPlugin.ets 继承 PlatformPlugin + PlatformPluginCallback，覆盖剪贴板方法
  • 优势：SDK 升级时无需合并冲突，中间件代码完全在项目可控范围内

[v6.94.5] - 2026-06-19

🐛 修复

工作台设置页 Slider 报错（No Material widget found）

  • Issue: 工作台设置页打开即崩溃，报 "No Material widget found. Slider widgets require a Material widget ancestor"：WorkbenchSettingsPage 使用 CupertinoPageScaffold（无 Material 祖先），但 _SliderTile 使用 Material 组件 Slider，导致断言失败。
    • 修复：将 Slider 替换为 CupertinoSlider，符合项目规则"优先使用 Cupertino 组件"，并使用 ext.accent 作为激活色保持主题一致
    • 文件：lib/features/settings/presentation/workbench/workbench_settings_page.dart

移动端横屏工作台布局空白问题

  • Issue: 移动端横屏工作台模式中栏左右两边有空白，要求缩短空白用来显示中栏页面：
    • 根因1：双栏模式中栏宽度被 * 0.75 缩放，导致中栏宽度不足，页面内容两侧出现空白
    • 根因2：中栏内嵌页面（HomePage/DiscoverPage 等）使用 SafeArea(bottom: false)，横屏时 left/right 默认为 true，会添加水平 padding 导致左右空白
    • 修复1：移除双栏模式 * 0.75 缩放，中栏使用完整宽度（与三栏模式一致）
    • 修复2：_buildMiddlePanel 使用 MediaQuery.removePadding 移除水平 SafeArea padding，避免横屏时左右空白
    • 文件：lib/core/layout/workbench/workbench_layout.dart

[v6.94.4] - 2026-06-19

🐛 修复

工作台布局修复（3处）

  • Issue1: 拖拽宽度 clamp 逻辑冗余且极端小屏可能抛异常：_onDragUpdate 两次 clamp 冗余（先 clamp 到屏幕允许值，再 clamp 到硬编码 _maxMiddleWidth），且极端小屏（screenMax < _minMiddleWidth）时第一次 clamp 上限 < 下限会抛 ArgumentError。
    • 说明：原 Issue 描述"第二次 clamp 反向扩大宽度导致溢出"有误——Dart clamp 不会扩大值，只限制值。真正问题是冗余 + 极端小屏异常。
    • 修复：合并为单次 clamp，取 screenMax 与 _maxMiddleWidth 的较小值作为有效上限，并用 safeMax 保护下限（避免 ArgumentError）
    • 文件：lib/core/layout/workbench/workbench_layout.dart
  • Issue2: 双栏模式注释与实现不符：注释称"隐藏中栏"，但实际代码显示中栏（宽度*0.75）。
    • 修复：更新注释为"中栏紧凑显示（宽度*0.75）+ 分割条 + 右栏"，匹配实际实现
    • 文件：lib/core/layout/workbench/workbench_layout.dart
  • Issue3: pop 操作未检查 canPop 导致根级页面被意外弹空：pop 仅检查 entries.isEmpty，栈深 1 时 canPop=false 但 pop 仍执行 removeLast 导致栈变空，与 canPop 判断不一致。
    • 修复：pop 改为 if (!currentStack.canPop) return，与 canPop 保持一致
    • 联动修复：v6.94.2 的 Issue3（构建失败移除无效条目）原直接调用 pop，在栈深 1 时会因 canPop 检查不执行导致无效条目残留。改为 canPop 时 pop、否则 clear（栈深 1 的无效条目即根级，清空回仪表盘）
    • 文件：lib/core/layout/workbench/right_panel_navigator.dart、lib/core/layout/workbench/workbench_layout.dart

[v6.94.3] - 2026-06-19

🐛 修复

工作台模式白屏问题（搜索取消导致根栈弹空）

  • Issue: 仪表盘点搜索→取消后白屏：工作台模式下，搜索页通过 rightPanelStackProvider 推入右栏嵌套栈渲染（非 GoRouter Navigator），但页面内取消按钮调用 Navigator.pop(context) 误弹根 GoRouter 栈，触发 currentConfiguration.isNotEmpty 断言错误，导致白屏。
    • 根因：右栏页面直接使用 Navigator.pop(context) 操作根 GoRouter Navigator，而非右栏嵌套栈
    • 修复：在 AppNavExtension 新增工作台感知的 appPop()/appCanPop() 方法（宽屏工作台模式 pop 右栏栈，否则回退 Navigator.pop）；同步在 WorkbenchNavExtension 新增 WidgetRef 版本
    • 文件：lib/core/router/app_nav_extension.dart
  • AdaptiveBackButton 工作台感知：统一返回按钮组件接入 appCanPop/appPop，正确感知右栏栈状态
    • 文件：lib/shared/widgets/adaptive/adaptive_back_button.dart
  • SearchPage 取消按钮：改用 context.appPop() 替代 Navigator.pop(context)
    • 文件：lib/features/search/presentation/search_page.dart
  • 举一反三（12处页面级返回按钮）：批量修复 member_page、category_detail_page、article_edit_page、article_detail_page、screen_share_page、crash_log_page、ctc_note_list_page、tool_bottom_bar、qrcode_login_page、qr_code_tab、device_pairing_page、study_plan_page 的页面级返回按钮（仅页面级，对话框/sheet 内的 pop 保持不变）
    • 文件：见上述各文件

闲情逸致页面卸载后 ref 报错

  • Issue: 闲情逸致页面报错 "Using ref when widget is about to or has been unmounted"：_scrollToToday 在 Future.delayed 回调中使用 ref.read() 未检查 mounted，widget 卸载后 ref 不安全。
    • 修复：_scrollToToday 和 _scrollToDate 异步回调前增加 mounted 检查
    • 文件：lib/features/tool_center/leisure/presentation/pages/leisure_timeline_page.dart

[v6.94.2] - 2026-06-19

🐛 修复

右栏返回栈行为修复（3处同源问题）

  • Issue1: 返回按钮行为不符合预期：原 _onRightPanelPop 误用 clear 清空整个栈，导致已打开页面全部丢失，与"逐步返回上一页"预期不符。
    • 根因：_onRightPanelPop 误用 clear 而非 pop，无论栈深多少都一次清空
    • 修复：拆分为双按钮交互（左侧按钮组，栈深>1 时显示）：
      • 返回上一页（CupertinoIcons.back chevron 图标）：调用 pop 逐页返回，符合 iOS UINavigationController 标准语义
      • 回仪表盘（CupertinoIcons.house_fill 房子图标）：调用 clear 快捷回根，解决栈深较大时多次点击痛点
    • 文件：lib/core/layout/workbench/workbench_layout.dart
  • Issue2: 快捷键返回行为错误：_RightPanelBackAction.invoke（Ctrl/Cmd+←、Esc）同样误用 clear，与返回按钮同源问题。
    • 修复：改为 pop 逐页返回，与 UI 返回按钮语义保持一致
    • 文件：lib/app/layout/app_shell.dart
  • Issue3: 页面构建失败保留无效条目：pageWidget == null 时仅返回默认面板，但无效条目残留在栈中，导致后续返回行为异常（脏栈）。
    • 修复：构建失败时通过 WidgetsBinding.instance.addPostFrameCallback 延迟 pop 无效条目（避免 build-during-build 异常），再返回默认面板
    • 文件：lib/core/layout/workbench/workbench_layout.dart

[v6.94.1] - 2026-06-19

✨ 交互增强与类型安全巡检（6项）

新功能

  • 富媒体新功能弹窗：引导页"了解新功能"弹窗重构为图文卡片轮播（PageView），支持 emoji 解析+关键词图标匹配+光晕效果+动态主题色+手势滑动+页码指示器
  • 动态主题色图标组件：新增 ThemedIcon 组件（shared/widgets/display/themed_icon.dart），支持 15 种颜色映射+圆形背景+光晕效果，随主题动态变化
  • 壁纸离线浏览：壁纸画廊新增"💾 已缓存"离线模式，无网络环境下可浏览已加载壁纸，支持空状态提示+动态标题+自动退出离线模式

功能完善

  • 稍后读批量管理持久化：toggleRead/markAllRead/markSelectedRead 从仅内存更新升级为持久化到 DB（调用 ChatMessageService.markIsRead），采用乐观更新策略+Future.wait 并行执行
  • Provider 生命周期修复：修复 5 个非 autoDispose provider 重复进入页面不刷新的隐患：
    • chatMessagesProvider：普通会话进入时主动 reload（原仅稍后读会话 reload）
    • chatAttachmentProvider：进入聊天页时主动 loadAttachments
    • chatSessionProvider：发现页 initState 主动 refresh
    • translateRecordListProvider/ttsRecordListProvider：插件页 initState 主动 refresh
    • readLaterProvider：稍后读页 initState 主动 loadItems(refresh: true) 兜底

类型安全巡检（139处修复）

  • 根因：PHP/JSON 返回的数字可能被解析为 int 或 double(num)，直接 as int / as int? 会崩溃（?? 0 无法挽救，因为强转在 ?? 之前已抛异常）
  • 修复模式：统一使用 SafeJson.parseInt()（core/utils/safe_json.dart）替代 as int / as int?
  • P0 高风险修复（60处）：task_core.dart(10)、daily_task_page.dart(2)、cloud_cache_record.dart(5)、cloud_cache_service.dart(1)、signaling_service.dart(2)、input_action.dart(2)、transfer_task.dart(1)、anonymous_submit_page.dart(2)、interaction_provider.dart(1)、offline_manager.dart(1)、spotlight_search_provider.dart(1)、chat_session_provider.dart(2)、weather_settings_page.dart(1)、poetry_settings_page.dart(1)、theme_sections_preview.dart(3)、image_cache_models.dart(2)、pomodoro_core.dart(1)、image_cache_metadata_service.dart(1)、permission_service.dart(1)、kv_storage.dart(1)、notification_center.dart(6)、solar_term_core.dart(12)
  • P1 中风险修复（79处）：user_center_models.dart(4)、user_stats_provider.dart(9)、user_center_service.dart(7)、favorite_repository.dart(4)、correction_provider.dart(4)、ctc_api_client.dart(2)、ctc_note_provider.dart(4)、interaction_provider.dart(1)、coin_provider.dart(1)、public_profile_page.dart(1)、learning_progress_page.dart(3)、learning_center_page.dart(7)、statistics_page.dart(14)、leisure_card.dart(2)、wallpaper_health_service.dart(2)、settings_change_logger.dart(1)、cache_config.dart(5)、weather_provider.dart(2)、appbar_date_display.dart(1)、qrcode_scanner_page.dart(1)、user_model.dart(4)

涉及文件

模块 文件 变更类型
新功能弹窗 new_features_dialog.dart 重构为图文卡片轮播
主题色图标 themed_icon.dart(新) 新增动态主题色图标组件
壁纸离线 wallpaper_gallery_view.dart, wallpaper_source_bar.dart 离线模式+缓存chip
稍后读持久化 readlater_provider.dart 批量已读持久化到DB
Provider生命周期 chat_flow_page.dart, discover_page.dart, translate_plugin_page.dart, tts_plugin_page.dart, readlater_page.dart initState主动reload
类型安全P0 22个文件 as int → SafeJson.parseInt()
类型安全P1 21个文件 as int? → SafeJson.parseInt()

[v6.94.0] - 2026-06-19

🔧 批量Bug修复与功能增强（16项）

新功能

  • 引导页新功能开关：引导页第三页（个性化设置）新增"了解 V{版本号} 新功能"开关（默认关闭），开启后进入主页弹出当前版本更新日志弹窗，支持动态主题和14种多语言
  • 闲情逸致emoji统一替换：将闲情逸致页面（含设置页、聊天气泡、输入面板）约55处emoji替换为CupertinoIcons，保留社交互动（❤️点赞、⭐收藏）和个性化按钮的emoji

Bug修复

  • Beta页面问卷按钮：增加右上角可关闭小角标，点击后临时隐藏问卷入口
  • Windows分发渠道文案：软件信息页平台兼容卡片点击Windows的toast改为"由Microsoft Store分发"（14种语言同步）
  • 稍后读不显示：修复主页卡片详情添加稍后读后，发现-稍后读页面不显示的问题（ChatFlowPage每次进入主动reload + notifyReadlaterRefresh确保执行）
  • 情景诗词无响应：修复输入框发送内容页面无变化、收藏与分享按钮无响应（接入诗词刷新+本地DB收藏+ShareSheet分享）
  • 日签卡片换一句无响应：添加isRefreshing加载态、错误反馈、空内容检查，接入频道句子切换
  • 使用报告数据为空：修复阅读趋势和活跃热力图数据解析（传year参数、多键名兼容、字段名兼容、List包装）
  • 阅读目标无变化：重写reading_goal_provider，从本地DB获取今日进度（viewsToday/favoritesToday），添加连续天数更新逻辑
  • 灵感朗读音频无关：修复TTS朗读音频与实际内容无关（_mySpokenText文本匹配 + 先stop再speak）
  • 壁纸筛选不一致：添加supportsCategory getter区分源是否支持分类筛选，客户端二次过滤确保结果一致
  • 取消收藏数据仍在：增强setFavoriteFlagForTarget第三种匹配策略（feedType+ID后缀），mergeWithLocalDb改为追加尾部
  • 密保问题设置失败：修复_parseSecQuestion类型安全（int vs num），添加_toSafeInt安全转换，refreshUser错误处理增强

涉及文件

模块 文件 变更类型
Beta页面 experimental_features_page.dart 添加关闭角标
引导页 onboarding_provider.dart, personalization_page.dart, t_onboarding.dart 新功能开关
引导页弹窗 new_features_dialog.dart(新), home_page.dart, kv_storage.dart 弹窗+触发逻辑
闲情逸致 21个chat相关文件 emoji→CupertinoIcons
稍后读 chat_flow_page.dart, home_interaction_mixin.dart reload+通知修复
情景诗词 poetry_page.dart 发送/收藏/分享实现
日签卡片 daily_card_provider.dart, daily_card_page.dart 加载态+错误反馈
使用报告 reading_report_core.dart 数据解析修复
阅读目标 reading_goal_provider.dart 完全重写
灵感TTS inspiration_detail_sheet.dart 文本匹配修复
壁纸 template_models.dart, wallpaper_gallery_view.dart 分类筛选修复
收藏 app_database.dart, favorite_repository.dart 匹配策略增强
密保 user_model.dart, security_question_page.dart 类型安全修复
多语言 14个语言文件 Windows文案+knowNewFeatures

[v6.93.1] - 2026-06-19

🔧 MethodChannel 命名风格统一

将所有自定义 MethodChannel/EventChannel 名称统一为 apps.xy.xianyan/{feature} 风格，与应用包名 apps.xy.xianyan 保持一致。

变更清单

旧名称 新名称 涉及文件
com.xianyan.macos apps.xy.xianyan/macos macos_platform_service.dart + MainFlutterWindow.swift
com.xianyan.macos.app apps.xy.xianyan/macos.app macos_platform_service.dart + AppDelegate.swift
com.xianyan.windows apps.xy.xianyan/windows windows_platform_service.dart + flutter_window.cpp
com.xianyan.clipboard apps.xy.xianyan/clipboard clipboard_bridge.dart
xianyan/usb_transport apps.xy.xianyan/usb_transport usb_transport_service.dart
xianyan/usb_events apps.xy.xianyan/usb_events usb_discovery_service.dart
com.xianyan.touchbar.* apps.xy.xianyan.touchbar.* MainFlutterWindow.swift (NSTouchBar 标识符)

不变项

  • Android 通道 apps.xy.xianyan/{feature} — 已是正确风格
  • 鸿蒙通道 plugins.flutter.io/{plugin}_ohos — 模拟 Flutter 标准插件，保持不变

影响

  • 功能无影响：MethodChannel 名称只需 Dart 端与原生端一致即可
  • 可维护性提升：消除 4 种命名风格混用，统一为 apps.xy.xianyan/{feature}

[v6.93.0] - 2026-06-19

🖥️ 桌面端原生功能扩展（第二批）

剪贴板富文本（HTML）支持

  • lib/core/utils/platform/clipboard_bridge.dart 新增 setRichText({text, html}) / getHtml() / hasHtml() 三个方法
  • 桌面端通过 com.xianyan.clipboard MethodChannel 调用原生 NSPasteboard/CF_HTML
  • 移动端/Web 降级为纯文本（_htmlToPlainText 工具方法去除标签+反转义实体）
  • 鸿蒙端仅支持纯文本，HTML 读写返回 null/false
  • 保持隐私协议守卫（读操作需同意协议）

侧边栏折叠记忆

  • SplitViewState 新增 navBarCollapsed (bool) / navBarWidth (double) / tabSplitRatios (Map<int,double>) 三个字段
  • SplitViewNotifier 新增 setNavBarCollapsed / toggleNavBarCollapsed / setNavBarWidth / saveCurrentTabSplitRatio / setCurrentTabWithMemory 方法
  • adaptive_nav_bar.dart 垂直导航栏支持折叠态（48px 仅图标）/ 展开态（72px 图标+文字），底部新增折叠按钮
  • 折叠状态持久化到 KvStorage（nav_bar_collapsed / workbench_nav_bar_width）

分屏记忆

  • 每个 Tab 独立分屏比例，切换 Tab 时自动保存当前比例并恢复目标 Tab 比例
  • tabSplitRatios 以 JSON 序列化存储到 tab_split_ratios key
  • setCurrentTabWithMemory(index) 方法实现保存+恢复逻辑

可拖拽导航栏宽度

  • workbench_layout.dart 的 _navBarWidth() 改为从 splitViewProvider 读取动态宽度
  • 折叠态 48px / 展开态使用持久化的 navBarWidth（默认 72px，范围 48~240px）
  • _assembleLayout 垂直导航栏 SizedBox 改用动态宽度

Windows Mica Alt 特效

  • windows_acrylic_service.dart 新增 _isMicaAltSupported() 方法，检测 Win11 build >= 22621
  • applyEffect 新增 Mica Alt 分支（优先级：Mica Alt → Mica → Acrylic，自动降级）
  • 使用 WindowEffect.tabbed 作为 Mica Alt 等价实现（flutter_acrylic 1.1.4 的最接近选项）
  • effectName getter 新增 windows_mica_alt 标识
  • buildNumber 检测结果缓存，避免重复读取

Spec 文档

  • 新增 docs/desktop_native_expansion_spec.md（14 项功能实施方案，开发完成后删除）

[v6.92.0] - 2026-06-19

🍎 macOS 原生功能扩展（5 项）

Touch Bar 支持（NSTouchBar）

  • MainFlutterWindow.swift 新增 setTouchBarItems 方法，创建 NSTouchBar + NSButton 项
  • 按钮点击通过 channel.invokeMethod("touchBarAction", action) 回调 Dart
  • 仅带 Touch Bar 的 MacBook 显示，无 Touch Bar 设备自动忽略
  • MainFlutterWindow 实现 NSTouchBarDelegate，按索引创建按钮

NSSharingService 共享面板

  • MainFlutterWindow.swift 新增 showShareSheet 方法，弹出 NSSharingServicePicker
  • 支持 text/url/imageBytes 三种内容类型组合
  • 图片通过 FlutterStandardTypedData → NSImage 转换

NSDockTile 徽章

  • AppDelegate.swift 新增 setDockBadge 方法，设置 Dock 图标数字徽章
  • count <= 0 时清除徽章

NSStatusItem 菜单栏金句

  • AppDelegate.swift 新增 updateStatusBarSentence 方法，菜单栏显示金句
  • 超过 30 字符截断显示，前缀 💬 emoji
  • 点击金句复制完整内容到剪贴板（currentSentence 属性存储完整内容）
  • statusItem 强引用持有，防止被释放

CoreSpotlight 索引

  • AppDelegate.swift 新增 indexSpotlightItems / clearSpotlightIndex 方法
  • 使用 CSSearchableIndex.default() 索引条目（id/title/content/type）
  • 沙盒内可直接使用，无需额外 entitlements
  • 异步操作，不阻塞 UI

应用级通道架构

  • 新增 com.xianyan.macos.app MethodChannel（AppDelegate 注册）
  • applicationShouldTerminateAfterLastWindowClosed 改为 false，支持托盘常驻
  • MacosPlatformService 新增 _appChannel 常量 + 6 个静态方法

[v6.91.2] - 2026-06-19

🔗 深度链接服务完善 — xianyan:// scheme 跳转

  • lib/core/services/network/deep_link_service.dart 新增 _preResolve 预解析方法，处理需要特殊路由映射的 scheme：
    • xianyan://note/{id} → /notes/edit?id={id}（笔记编辑页用 query param，无法通过配置驱动解析器的子路径匹配处理）
    • xianyan://note → /notes（笔记列表页）
    • xianyan://sentence/{id} → /home（句子详情 Sheet 需 HomeSentence 对象，暂导航到首页）
  • lib/core/router/route_registry.dart 稍后阅读路由新增 xianyan://readlater 别名
  • macos/Runner/Info.plist 新增 CFBundleURLTypes 注册 xianyan URL Scheme（此前 macOS 端未注册）
  • ios/Runner/Info.plist 在现有 CFBundleURLSchemes 数组中追加 xianyan scheme（此前仅注册 ShareExtension）
  • Android 端 AndroidManifest.xml 已有 xianyan scheme intent-filter，无需修改
  • DeepLinkService.init() 已在 main.dart:236 调用，无需重复初始化

[v6.91.1] - 2026-06-19

📝 笔记编辑页 — 桌面端拖拽文件接入

  • 笔记编辑页（lib/features/note/presentation/note_edit_page.dart）接入 desktop_drop，桌面端（pu.isDesktop）支持拖拽文件到笔记
  • 拖拽视觉反馈：半透明遮罩 + 虚线边框（_DashedBorderPainter）+ "拖放文件到笔记"提示，AnimatedContainer 200ms 过渡，Positioned.fill + IgnorePointer 不阻挡正常操作
  • 文件处理逻辑（_handleDrop）：
    • 图片（.png/.jpg/.jpeg/.gif/.webp）：读取为 base64，插入 Markdown 图片语法 ![文件名](data:image/png;base64,...)
    • 文本（.txt/.md）：读取内容追加到笔记末尾
    • 其他文件：插入 Markdown 链接 [文件名](file:///路径)
  • 错误处理：读取失败时 AppToast.showError 提示
  • 移动端不包裹 DropTarget，不影响现有自动保存/Markdown 预览功能

[v6.91.0] - 2026-06-18

📦 依赖同步修复

  • pubspec.ohos.yaml 补齐 tray_manager/macos_window_utils/flutter_acrylic 三库声明
  • 原因：Dart 编译时静态解析 import 链（app.dart → desktop_service_registry.dart → 实现文件 → 三库），鸿蒙端虽 no-op 但必须声明，否则报 Target of URI doesn't exist
  • iOS_macOS_Developer_Guide.md §5.5 新增特殊案例说明 + §5.6 新增常见问题条目

🖥️ 桌面端原生增强（macOS/Windows）

系统托盘（tray_manager）

  • 跨平台系统托盘服务：图标 + Tooltip + 未读角标 + 右键菜单
  • 托盘右键菜单 4 组分隔线分组：主操作/快速访问(最近阅读子菜单)/模式切换/系统
  • 未读角标：合并稍后阅读 + 每日拾句未读数，macOS setTitle 数字显示
  • 每日拾句未读概念：DailySentenceViewedService 本地存储已查看 id 列表
  • 托盘事件处理：单击切换窗口可见性、双击聚焦、右键弹出菜单
  • 托盘图标：自绘 SVG + Pillow 生成 PNG（浅色/深色两套，16x16/32x32）
  • 多语言支持：TrayMenuLabels（zhCN/enUS）

macOS 原生菜单栏（PlatformMenuBar）

  • MacosMenuBarWrapper：6 个顶级菜单（闲言/文件/编辑/视图/窗口/帮助）
  • 业务功能入口：新建笔记/灵感、打开稍后阅读、偏好设置、每日拾句
  • 模式切换：深色模式、工作台模式（带勾选状态）
  • 系统标准项：关于/隐藏/退出/全屏/最小化/缩放（PlatformProvidedMenuItem）

自定义窗口标题栏（软件样式）

  • DesktopWindowTitleBar：替代系统默认标题栏，支持动态主题+动态样式
  • macOS 风格：左侧红黄绿三圆点按钮（hover 显示图标）
  • Windows 风格：右侧最小化/最大化/关闭方按钮（hover 背景变化）
  • 毛玻璃效果（BackdropFilter）、双击最大化/还原、拖拽移动窗口
  • DesktopTitleBarStyle：动态样式配置（高度/透明度/模糊/按钮大小等）
  • main.dart：titleBarStyle: TitleBarStyle.hidden 隐藏系统标题栏
  • macOS 原生：titlebarAppearsTransparent=true + 隐藏系统红黄绿按钮

Windows 原生侧能力补齐（6 个 MethodChannel 方法）

  • setWindowTitle：SetWindowTextW 设置窗口标题
  • setFullscreen/isFullscreen：保存/恢复窗口 RECT+样式，全屏切换
  • setMinSize：WM_GETMINMAXINFO 处理最小尺寸限制（DPI 缩放）
  • performHapticFeedback：MessageBeep 模拟触觉反馈（4 种类型）
  • getSystemAppearance：读取注册表 AppsUseLightTheme

窗口特效（毛玻璃/亚克力）

  • macOS：MacosWindowEffectService 标题栏融合 + 侧边栏毛玻璃（NSVisualEffectView sidebar 材质）
  • Windows 11：WindowsAcrylicService Mica 背景
  • Windows 10：Acrylic 效果（深色 0xCC1F1F1F / 浅色 0xCCF3F3F3）
  • Win11 版本检测：解析 operatingSystemVersion（build>=22000）
  • 主题切换时同步窗口特效（build + didChangePlatformBrightness）

动态主题

  • 窗口特效随主题变化：DesktopWindowEffectService.applyEffect(isDark)
  • 托盘图标随主题变化：macOS isTemplate 自动反色，Windows 明暗两套图标
  • 标题栏随主题变化：深色/浅色/AMOLED 三种背景色

依赖变更

  • 新增：tray_manager ^0.5.3 / macos_window_utils ^1.9.1 / flutter_acrylic ^1.1.4
  • 移除：nearby_connections ^4.1.1（三处模板同步：pubspec.yaml/pubspec.ohos.yaml/pubspec.macos.yaml）

新增文件

文件 作用
lib/core/services/desktop/desktop_tray_service.dart 托盘服务抽象 + TrayMenuItem 模型
lib/core/services/desktop/desktop_window_effect_service.dart 窗口特效服务抽象
lib/core/services/desktop/desktop_service_registry.dart 服务注册表（按平台注入实现）
lib/core/services/desktop/desktop_tray_menu_builder.dart 托盘菜单构建器（4 组分隔线分组）
lib/core/services/desktop/daily_sentence_viewed_service.dart 每日拾句已查看服务
lib/core/services/desktop/implementations/tray_manager_tray_service.dart tray_manager 托盘服务实现
lib/core/services/desktop/implementations/macos_window_effect_service.dart macOS 窗口特效实现
lib/core/services/desktop/implementations/windows_acrylic_service.dart Windows Acrylic/Mica 实现
lib/features/desktop/desktop_tray_controller.dart 托盘控制器（整合服务+菜单+未读数）
lib/features/desktop/macos_menu_bar_wrapper.dart macOS 原生菜单栏包装器
lib/features/desktop/desktop_window_title_bar.dart 自定义窗口标题栏 Widget
lib/features/home/presentation/providers/readlater/tray_unread_count_provider.dart 托盘未读数 Provider
assets/svgs/tray_icon.svg 托盘图标 SVG 源文件
scripts/generate_tray_icons.py 托盘图标 PNG 生成脚本

修改文件

文件 变更
lib/main.dart 新增 titleBarStyle: TitleBarStyle.hidden
lib/app/app.dart 初始化桌面服务、窗口特效、托盘控制器、MacosMenuBarWrapper、主题同步
lib/app/layout/app_shell.dart 集成 DesktopWindowTitleBar
lib/core/services/device/windows_platform_service.dart 新增 6 个 MethodChannel 方法
macos/Runner/MainFlutterWindow.swift titlebarAppearsTransparent=true + 隐藏系统按钮
windows/runner/win32_window.h 新增 6 个方法声明 + 全屏状态成员变量
windows/runner/win32_window.cpp 实现 6 个方法 + WM_GETMINMAXINFO
windows/runner/flutter_window.cpp 扩展 MethodChannel 处理 6 个方法
pubspec.yaml/pubspec.ohos.yaml/pubspec.macos.yaml 新增 3 库 + 移除 nearby_connections

工作台设置页（P0-8）

  • 新增独立页面 WorkbenchSettingsPage：整合 4 项迁移设置 + 7 项交互/视觉增强
  • 迁移项：工作台模式开关、分屏开关、导航栏位置、分屏比例
  • 新增交互增强（持久化）：专注阅读模式、右栏分屏、拖拽出窗（占位）、右栏标签页（占位）、中栏拖拽排序
  • 新增视觉增强（持久化）：工作台毛玻璃背景、空状态动画
  • SplitViewState 扩展 7 个 freezed 字段 + 对应 setter（KvStorage 持久化）
  • 通用设置"显示"组：移除 4 项迁移项，新增"工作台模式"导航入口
  • 路由注册：AppRoutes.workbenchSettings + route_registry.dart + deepLink xianyan://settings/workbench
文件 变更
lib/features/settings/presentation/workbench/workbench_settings_page.dart 新增工作台设置页（4 组设置 + 私有组件）
lib/core/router/app_routes.dart 新增 workbenchSettings 路由常量
lib/core/router/route_registry.dart 注册 workbench-settings 路由
lib/core/providers/split_view_provider.dart 扩展 7 个交互增强字段 + setter
lib/core/providers/split_view_provider.freezed.dart 同步 freezed 生成代码
lib/features/settings/presentation/general/general_settings_sections.dart 移除 4 项迁移项 + 新增导航项
lib/features/settings/presentation/general/general_settings_page.dart _onNavigate 新增 workbench_settings case

v6.90.1 及更早版本（v6.87.0 ~ v6.90.1）已归档至软件特性功能文档。 主要特性概览：

  • v6.90.1: 工作台模式多语言支持 + 中栏宽度 KvStorage 持久化
  • v6.90.0: PC工作台布局重构（微信PC式三栏 WorkbenchLayout + RightPanelStackNotifier + 路由拦截）
  • v6.89.1: macOS MissingPluginException 修复 + Expanded 布局错误修复
  • v6.89.0: 评分弹窗商店名称多语言 + Beta问卷按钮隐藏跨平台修复
  • v6.88.0: 闲情逸致价格档位扩展（6档）+ 纠错历史本地缓存（drift）+ 学习计划详情页 + 闲情逸致全模块多语言
  • v6.87.0: 多平台应用商店统一服务（AppStoreService）+ 学习计划重构预告 + 闲情逸致"免费"改"平价" + 纠错页全面多语言
Reference in New Issue View Git Blame Copy Permalink