Prepare TagLauncher 8.3.2 App Store candidate

Ariver

2026-07-02 b2a06ec5ebc86c0241e635782ae5a032ab5aad0a

 CODEGRAPH.md

@@ -1,6 +1,6 @@
# TagLauncher CODEGRAPH

最后更新：2026-06-30
最后更新：2026-07-01

用途：本文件是 TagLauncher 的长期工程地图。修改用户可见行为、状态模型、构建/发布入口、核心源码或 QA 入口前，应先读本文件，再读指向的真实源码。若本文件与源码不一致，以源码为准，并在同一任务内更新本文件。

@@ -36,14 +36,14 @@
- `src/Apptag/PreferencesView.swift`
  - `PreferencesView`：设置窗口、语言、通用、主题、快捷键、标签、数据、Pro、关于等设置页。
  - 顶部设置页签必须保持 8 个标签总宽不超过旧 7 标签宽度；图标统一使用线型 SF Symbols，`Pro` 页签位于数据之后、关于之前，使用线型皇冠。
  - 设置页签下方按页签渲染统一固定位置的 `settingsFixedProHeader`：通用 / 主题 / 快捷键 / 标签 / 数据 / Pro 页显示该行且位置不漂移；语言和关于页不显示该 Pro 引导行。免费态显示当前 tab 对应购买引导和解锁/恢复按钮；Pro 已解锁态只显示权益状态说明，不显示恢复购买按钮。
  - 设置页签下方按页签渲染统一固定位置的 `settingsFixedProHeader`：语言 / 通用 / 主题 / 快捷键 / 标签 / 数据 / Pro / 关于 8 个页签都显示该行且位置不漂移。免费态左侧状态用“当前免费版用户”完整句而不是“免费版”胶囊；通用 / 主题 / 快捷键 / 标签 / 数据页显示当前 tab 对应购买引导和解锁/恢复按钮，语言和关于页只显示状态与操作按钮，不显示购买说明文字；已解锁 Pro 时，语言 / Pro / 关于页统一居中显示 `Pro 已解锁` 胶囊加 `settings.proStatus.proUser` 文案，不显示恢复购买按钮，且 `settings.proStatus.proUser` 本地化文字不再内置皇冠图标。
  - Pro 专属主题、彩色容器 / 彩色网格、自定义快捷键、自定义标签颜色和数据导入导出入口即使已解锁，也应保留皇冠 Pro 标识。
  - Language tab 去掉重复标题说明，语言矩阵在主内容区域上下左右居中；About tab 应用信息块也在主内容区域居中。
  - Theme tab 只写视觉偏好 `appGridThemeID` 和炫彩主题调色值，炫彩滑轨只能影响 AppGrid 背景，不得改变标签、排序、备注或分类数据。
  - 免费用户预览 Pro 主题时，Theme tab 状态行和当前预览主题卡片显示基于 `ProThemePreviewState.endsAt` 推导的 `MM:SS` 倒计时；倒计时到期只退出预览，不弹阻塞提示。
  - Pro tab 展示免费版 / Pro 版对比表；对比表不显示独立标题，Pro 列标题前必须有线型皇冠标识。
  - Pro tab 对比表包含自定义标签颜色、彩色容器 / 彩色网格、高级主题、自定义快捷键、自定义应用备注和数据导入导出 / 分类与布局备份恢复；免费列锁定功能显示“不可用”，彩色容器 / 彩色网格和高级主题显示“只可预览 5 分钟”，备注显示“免费 3 个”；Pro 列未购买时显示带勾的“支持”，备注行显示带勾的“无限备注”，已购买后功能行显示带勾的“已解锁”。表格内所有状态胶囊使用与“免费 3 个”一致的中性样式，不显示皇冠图标或黄色 Pro 背景。
  - About tab 只保留应用信息、帮助文档和联系信息，不放 Pro 汇总卡或免费 / Pro 差异表。
  - Pro tab 对比表包含自定义标签颜色、彩色容器 / 彩色网格、高级主题、自定义快捷键、自定义应用备注和数据导入导出 / 分类与布局备份恢复；免费列锁定功能显示“不可用”，彩色容器 / 彩色网格和高级主题显示“只可预览 5 分钟”，备注显示“免费 3 个”；Pro 列未购买时显示带勾的“支持”，备注行显示带勾的“无限备注”，已购买后功能行显示带勾的“已解锁”。表格内免费列和 Pro 列的表头及状态胶囊都在列内左对齐；所有状态胶囊使用与“免费 3 个”一致的中性样式，不显示皇冠图标或黄色 Pro 背景。
  - About tab 保留顶部固定 Pro 状态行；主内容只保留应用信息、帮助文档和联系信息，不放 Pro 汇总卡或免费 / Pro 差异表。

## AppGrid 显示与交互

@@ -183,6 +183,10 @@
  - Quick Search 系统应用回归。
- `src/Scripts/quick_search_launch_contract_qa.sh`
  - Quick Search 启动路径静态门禁；检查 in-app mouse monitor 不吞结果行点击、面板是激活 key panel、panel-level `sendEvent` 点击兜底存在、Return submit fallback 存在、点击 / submit 都接到 `NSWorkspace.openApplication` 启动路径。
- `src/Scripts/windowserver_event_safety_qa.sh`
  - WindowServer / TextInput 事件安全静态门禁；检查 Quick Search marked-text 输入保护、composition 期间不响应鼠标 / 背景关闭、面板置前去重，以及 TagNavigation 阻塞式事件循环兜底退出。
- `src/Scripts/app_note_bubble_input_qa.sh`
  - App note 泡泡输入框 IME 安全门禁；检查备注泡泡使用原生 `NSTextField` 桥接、marked text 期间不覆盖/截断/提交，最终提交仍受备注长度上限约束。
- `src/Scripts/pro_custom_hotkeys_qa.sh`
  - Pro 自定义快捷键静态与 Carbon 运行时门禁；检查 Pro gate、录制期间暂停/恢复全局快捷键、事务式注册保存、重复校验、禁用重权限键盘 API、设置页 Pro 按钮组合和 29 语种文案。
- `src/Scripts/pro_tag_custom_color_qa.sh`
@@ -213,6 +217,8 @@
  - 使用技巧关闭提醒、modal 防穿透、设置页预览、29 语种文案回归。
- `src/Scripts/window_logic_qa.sh`
  - 窗口层级、显示隐藏、Dock/菜单栏相关逻辑回归；Dock 项断言按当前 QA 构建路径过滤，避免本机固定正式版 App 时误判重复图标。
- `src/Scripts/settings_language_title_qa.sh`
  - 设置窗口标题栏语言刷新静态门禁；检查创建标题、语言切换通知和恢复窗口 `onAppear` 都回写本地化 `NSWindow.title`。
- `src/Scripts/app_ordering_data_qa.sh`
  - App 排序数据持久化回归。

@@ -225,7 +231,7 @@
- 自定义标签颜色是 Pro 功能：免费用户可继续使用基础色，已有自定义色继续显示，不能新增或修改为新自定义色；改回基础色必须允许且会清除 `customColor`。
- Pro 状态 UI 必须优先使用设置页签下方固定位置的统一 header；不得在各 tab 内重复塞第二条 Pro 引导。About 不承载 Pro 汇总卡或免费 / Pro 差异说明，Data 不承载营销式大卡，避免挤压数据管理布局。
- 免费主题固定为默认、深蓝、黑色；其它主题只能预览或在 Pro 解锁后持久化。
- `originalAppVersion` 早于免费 + Pro 首个版本的历史用户必须自动获得 Pro；`originalPurchaseDate` 只能作为版本不可判断时的兜底。
- `originalAppVersion` 早于免费 + Pro 首个版本的历史用户必须自动获得 Pro；`originalPurchaseDate` 只能作为版本不可判断时的兜底。当前免费 + Pro 首个版本边界由 `ProEntitlementConfig.firstFreeProVersion` 统一维护为 `8.3.2`，用于保护 8.2.9 及更早付费下载用户。
- 默认主题必须保留原浅色毛玻璃 AppGrid。
- 黑色主题背景必须为 100% 纯黑；深蓝和黑色使用深色玻璃；粉色、紫色、绿色、蓝色、炫彩使用浅色玻璃以保证明亮和可读。
- 单个 AppGrid 容器保持统一半透明玻璃面板，不做容器内部渐变。