From 2309264ee94daca4b9abe3592d84602c98b77690 Mon Sep 17 00:00:00 2001 From: Ariver <shanghai3168@gmail.com> Date: Thu, 02 Jul 2026 11:16:52 +0800 Subject: [PATCH] Freeze TagLauncher 8.3.5 release artifacts --- CODEGRAPH.md | 20 +++++++++++++------- 1 files changed, 13 insertions(+), 7 deletions(-) diff --git a/CODEGRAPH.md b/CODEGRAPH.md index 814eaab..a2bc896 100644 --- a/CODEGRAPH.md +++ b/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 对比表包含可维护标签数量、容器内 App 图标位置排序、自定义标签颜色、彩色容器 / 彩色网格、高级主题、自定义快捷键、自定义应用备注和数据导入导出 / 分类与布局备份恢复；标签列表自身顺序不列入 Pro 对比，因为免费用户也可持久保存。免费列锁定功能显示“不可用”，彩色容器 / 彩色网格和高级主题显示“只可预览 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` @@ -198,7 +202,7 @@ - `src/Scripts/pro_localization_qa.sh` - Pro 文案 29 语种静态门禁；检查 `pro.*`、设置页 Pro 状态/对比表、自定义标签颜色、Quick Search 快捷键页和气泡提示设置键完整、占位符完整、无生成污染和非英文语言无英文兜底复制。 - `src/Scripts/pro_feature_gate_qa.sh` - - Pro 功能源码门禁；检查 StoreKit 权益、老用户自动 Pro、主题门禁、导入导出硬拦截、3 条备注额度、自定义标签颜色、自定义快捷键、排序预览、Pro UI 提示、设置页线型图标、轻量 Pro 权益行、Pro 页签、免费列“不支持”状态和 About 页不回归 Pro 汇总卡。 + - Pro 功能源码门禁；检查 StoreKit 权益、老用户自动 Pro、主题门禁、导入导出硬拦截、3 条备注额度、自定义标签颜色、自定义快捷键、容器内 App 排序预览、Pro UI 提示、设置页线型图标、轻量 Pro 权益行、Pro 页签、免费列“不支持”状态和 About 页不回归 Pro 汇总卡。 - `src/Scripts/pro_theme_preview_countdown_qa.sh` - Pro 主题 / 彩色显示模式预览倒计时门禁；检查状态行倒计时、当前预览卡片 `MM:SS`、到期清理、29 语种 `%time%` 占位符和禁止写死体验时长。 - `src/Scripts/pro_display_mode_preview_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 排序数据持久化回归。 @@ -221,11 +227,11 @@ - 不得擅自改变源码根目录边界：App 源码只在 `src/` 下维护。 - 不得把主题、视觉偏好、窗口状态混入 `TagDatabase` 的分类/标签业务数据。 - 主题变化只允许影响 AppGrid 视觉，不得改变标签数据、排序、备注、SmartStart/category scheme、Quick Search、拖拽语义或导入导出。 -- Pro 门禁不得写脏免费用户真实数据：主题预览不写 `appGridThemeID`，排序预览不写 `containerAppOrder`，第 6 个新备注不写 `appNotes` / `appNoteMetadata`，导入 / 导出拦截必须早于文件面板和文件读写。 +- Pro 门禁不得写脏免费用户真实数据：主题预览不写 `appGridThemeID`，容器内 App 排序预览不写 `containerAppOrder`，第 6 个新备注不写 `appNotes` / `appNoteMetadata`，导入 / 导出拦截必须早于文件面板和文件读写。 - 自定义标签颜色是 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 容器保持统一半透明玻璃面板，不做容器内部渐变。 -- Gitblit v1.9.3