From b2a06ec5ebc86c0241e635782ae5a032ab5aad0a Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Thu, 02 Jul 2026 02:43:51 +0800
Subject: [PATCH] Prepare TagLauncher 8.3.2 App Store candidate

---
 src/TODO.md |   57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 57 insertions(+), 0 deletions(-)

diff --git a/src/TODO.md b/src/TODO.md
index 16c985e..48ba903 100644
--- a/src/TODO.md
+++ b/src/TODO.md
@@ -11,7 +11,21 @@
 
 ## In Progress
 
+- [2026-06-24] 8.0.0 App Grid 主题系统。
+  - 目标: 在设置页新增“主题”页签,提供默认、深蓝、黑色、粉色、紫色、绿色、蓝色、炫彩 8 个主题;主题只改变 App Grid 全屏背景渐变,容器保持统一半透明玻璃面板,并按主题明暗自动适配玻璃明暗。
+  - 范围: App Grid 背景、容器玻璃适配、设置页主题选择、旧 `useDarkAppGrid` 偏好迁移、29 语种主题文案、主题 QA 脚本。
+  - 不做: 不新增容器玻璃深浅独立开关;不改标签/拖拽/排序/Quick Search/数据结构功能语义;不改浅色默认主题视觉。
+  - 当前状态: 已完成代码实现、29 语种文案和确定性 QA;已按用户反馈将黑色改为纯黑,并将粉色/绿色/紫色/蓝色/炫彩改为更明亮且有辨识度的版本;等待用户视觉体验验收后决定是否继续冻结/打包。
+  - 文档: `Docs/Requirements/2026-06-24-app-grid-theme-system-todo.md`、`Docs/Requirements/2026-06-24-app-grid-theme-system-worklog.md`。
+
 ## Todo
+
+- [Backlog][2026-07-02] Raycast Extension 搜索 TagLauncher 标签与备注。
+  - 状态: 仅需求备忘,今天不开发。
+  - 目标: 未来通过官方 Raycast Extension,让用户在 Raycast 中搜索 TagLauncher 的 App、标签和备注,并回车启动目标 App。
+  - 当前决策: 推荐“TagLauncher 导出本地只读 JSON 索引 + Raycast Extension 读取索引”;不让 Raycast 直接读取 TagLauncher 主数据库。
+  - 计划: `/Users/ar/Projects/Taglauncher/src/.hermes/plans/2026-07-02-raycast-extension-search-backlog.md`。
+  - PRD: `/Users/ar/Projects/Taglauncher/src/Docs/Requirements/2026-07-02-raycast-extension-search-prd.md`。
 
 - [发布后独立任务] 设置页 tab 容器 AppKit/自控化评估与实现。
   - 决策: 当前发布前 No-Go;保留 SwiftUI `TabView`,不改 QA 脚本。
@@ -23,6 +37,49 @@
 
 ## Done
 
+- [2026-06-25] 使用技巧关闭提醒箭头与正文补修。
+  - 结果: 设置页预览里的蓝色说明整体右移,箭头指向“隐藏使用技巧”的勾选框;提醒正文说明字号提升到 17pt semibold,并以 70% 白色保持次级层级。
+  - 范围: 只改 `UsageTipsCloseReminderBubble` / `UsageTipsCloseReminderSettingsPreview` 排版、版本号/changelog 和专项 QA 断言;不改关闭状态机、不改 tips 横幅、不改主题逻辑。
+  - 验证: `usage_tips_close_reminder_qa.sh`、`usage_tips_qa.sh`、`macos14_availability_typecheck_qa.sh`、完整构建和 build metadata QA。
+  - 版本: `8.0.5 (20260625.1726)`。
+
+- [2026-06-25] 使用技巧关闭提醒视觉补修。
+  - 结果: 设置页预览中的高亮说明改为居中显示;“不再提醒”选项与确认按钮改为同一底部操作行,字体提升为 13pt semibold 并与确认按钮底部对齐。
+  - 范围: 只改 `UsageTipsCloseReminderBubble` 排版、版本号/changelog 和专项 QA 断言;不改关闭状态机、不改 29 语种文案。
+  - 验证: `usage_tips_close_reminder_qa.sh`、`usage_tips_qa.sh`、`macos14_availability_typecheck_qa.sh`、完整构建和 build metadata QA。
+  - 版本: `8.0.4 (20260625.1655)`。
+
+- [2026-06-25] 使用技巧关闭提醒。
+  - 结果: 点击 App Grid 使用技巧关闭按钮时先弹出提醒,说明可在“设置 > 通用”取消“隐藏使用技巧”重新查看;用户确认后才隐藏 tips,勾选“不再提醒”后后续关闭直接隐藏。
+  - 范围: 关闭按钮链路、提醒弹窗、本地化设置页预览、`skipUsageTipsCloseReminder` 偏好、29 语种提醒文案、专项 QA。
+  - 不改范围: tips 默认仍显示;8 条教学内容、主题/拖拽/排序/Quick Search 功能不变。
+  - 验证: `usage_tips_qa.sh`、`usage_tips_close_reminder_qa.sh`、`theme_settings_qa.sh`、`macos14_availability_typecheck_qa.sh`、`git diff --check`、`APP_BUILD=20260625.1615 bash src/build.sh`、`macos14_build_metadata_qa.sh src/build/TagLauncher.app` 通过。
+  - 版本: `8.0.3 (20260625.1615)`。
+  - 文档: `Docs/Requirements/2026-06-25-usage-tips-close-reminder-todo.md`、`Docs/Requirements/2026-06-25-usage-tips-close-reminder-worklog.md`。
+
+- [2026-06-25] App Grid 解除标签碎纸预览动效。
+  - 结果: 拖动应用到容器外/容器之间空白区域时,拖拽浮层进入原生 Core Animation 碎纸切片预览;离开该区域恢复正常。
+  - 范围: 只改拖拽浮层视觉反馈和空白 drop 预览资格判断;不改标签数据、不改容器内空白语义、不改放手后的解除标签确认流程。
+  - 验证: `Scripts/macos14_availability_typecheck_qa.sh`、`APP_BUILD=20260625.1500 bash src/build.sh`、`Scripts/macos14_build_metadata_qa.sh src/build/TagLauncher.app` 和 `git diff --check` 通过。
+
+- [2026-06-11] 7.9.0 容器内 App 手动拖拽排序。
+  - 结果: 同一容器内拖动 App 可改变显示顺序;排序保存为分类与布局方案的一部分,刷新、重启、语言切换、导入导出、恢复上一方案和 SmartStart 替换按统一规则保留、迁移或清理。
+  - 范围: 新增稳定 `containerAppOrder`、容器 ID、排序持久化 helper、分类方案 fingerprint、App Grid 同容器插入位置提示和 `ContentView` 保存回调;跨容器移动、Option 复制、拖空白移除、Apple 内置保护、Quick Search 排名均不改。
+  - 文档: `../docs/7.90/README.md`、`../docs/7.90/01-容器内App手动排序-TODO.md`、`../docs/7.90/07-实现与QA记录.md`。
+  - 验证: `Scripts/app_ordering_data_qa.sh`、macOS 14 typecheck/build metadata、Quick Search 名称回归、SmartStart catalog QA、`Scripts/window_logic_qa.sh` 通过。
+  - 版本: `7.9.0 (20260611.2212)`。
+
+- [2026-06-09] 多语种 App 显示名通用加固。
+  - 结果: 新增统一 `AppDisplayNameResolver`;App Grid 与 Quick Search 标题优先走当前语种/同语系/系统可见名/英文官方名/基础 bundle 名 fallback,内部 bundle 名和 bundle id 只作为搜索别名;`7.8.26` 进一步加固 `/Wrapper/`、`/Contents/Helpers/`、`.app/.../*.app` 内部 helper 过滤。
+  - 范围: `AppInfo` 增加系统显示名与 bundle 显示名候选;App 扫描层和 Quick Search 文档层都过滤内部 helper;Quick Search 文档使用 resolver 生成别名;版本更新为 `7.8.26 (20260609.2004)`。
+  - 不改范围: 未做第三方 App 名称机器翻译,未改 Quick Search 排名算法、App Grid 布局、窗口层级或 Smart Start 分类规则。
+  - 验证: `APP_BUILD=20260609.2004 bash build.sh`、`codesign --verify --deep --strict src/build/TagLauncher.app`、`Scripts/quick_search_app_name_qa.sh`、`Scripts/quick_search_system_app_qa.sh` 通过;构建产物 Info.plist 为 `7.8.26 (20260609.2004)`。
+
+- [2026-06-09] 修复首安 Smart Start 提示确认后 App Grid 消失的问题。
+  - 结果: Smart Start 自动整理完成提示出现期间会抑制 AppKit 级 backdrop dismiss;点击“OK/好的”只关闭提示弹窗,不再关闭整个 App Grid。
+  - 范围: 只改 `ContentView.swift` 的 modal interaction 发布状态,不改 Smart Start 分类规则、不改 App Grid 布局、不改窗口层级。
+  - 验证: `APP_BUILD=20260609.1221 bash build.sh`、`codesign --verify --deep --strict build/TagLauncher.app`、版本/build/category 检查、Apple 默认资源 QA、SmartStart catalog QA 通过;首安真实点击路径待最终视觉验收。
+
 - [2026-06-08] 修复 App Grid 顶部 tag hover 触发自动滚动导致的抖动。
   - 结果: hover 只保留 tag 高亮/填色,不再自动滚动;点击 tag 仍滚动到对应分组。
   - 范围: 只改 `Apptag/ContentView.swift` 的 tag hover 处理,不改 App Grid 布局算法、不改拖拽、不改点击导航语义。

--
Gitblit v1.9.3