From 77896f65b92c756da699e84499b180d35b0f8835 Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Thu, 25 Jun 2026 18:52:06 +0800
Subject: [PATCH] Merge dark glass 8.0.5 freeze

---
 src/Docs/Requirements/2026-06-24-app-grid-theme-system-todo.md |   47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 47 insertions(+), 0 deletions(-)

diff --git a/src/Docs/Requirements/2026-06-24-app-grid-theme-system-todo.md b/src/Docs/Requirements/2026-06-24-app-grid-theme-system-todo.md
new file mode 100644
index 0000000..43b1836
--- /dev/null
+++ b/src/Docs/Requirements/2026-06-24-app-grid-theme-system-todo.md
@@ -0,0 +1,47 @@
+# 8.0.0 App Grid 主题系统 TODO
+
+## 目标
+
+- 在设置页新增独立“主题”页签。
+- 提供 8 个 App Grid 背景主题：默认、深蓝、黑色、粉色、紫色、绿色、蓝色、炫彩。
+- 主题只改变 App Grid 全屏背景渐变；单个容器继续使用统一半透明玻璃面板。
+- 默认主题保持原浅色毛玻璃体验；深蓝和黑色使用深色玻璃容器，粉色、紫色、绿色、蓝色、炫彩使用浅色玻璃容器以保持明亮干净。
+- 文案覆盖 29 个语种。
+
+## 不做范围
+
+- 不新增“容器玻璃深浅”独立设置。
+- 不改变标签、拖拽、排序、Quick Search、数据导入导出、SmartStart 分类逻辑。
+- 不改变默认浅色主题的既有视觉。
+- 不在容器内部增加每个容器自己的渐变。
+
+## TODO
+
+- [x] 新增 `AppGridTheme` 统一主题模型。
+- [x] 定义 8 个主题的背景渐变 token、预览色和容器玻璃适配策略。
+- [x] 将 App Grid 背景渲染改为读取主题偏好。
+- [x] 容器玻璃按主题明暗自动适配：深蓝/黑色为暗玻璃，亮色主题为浅玻璃。
+- [x] 按用户视觉反馈二次调色：黑色改为纯黑背景；粉色、绿色、紫色、蓝色、炫彩改为更明亮且互相有辨识度的渐变。
+- [x] 编辑模式做减法：进入编辑后临时使用默认浅色毛玻璃主题，退出后恢复用户原主题。
+- [x] 设置页新增“主题”页签和 8 主题选择卡片。
+- [x] 旧 `useDarkAppGrid` 偏好迁移到 `deepBlue`。
+- [x] 补齐 29 个语种的主题文案。
+- [x] 移除旧“启用深色视图”设置入口和本地化文案。
+- [x] 新增主题设置 QA 脚本。
+- [x] 更新 changelog、TODO 和工作日志。
+- [x] 使用技巧横幅重设计：按分区式教学横幅落地，亮色主题用浅玻璃，深蓝/黑色主题用深玻璃和白字。
+- [x] 使用技巧新增弱视觉关闭按钮，hover 后清晰，关闭后持久写入 `hideUsageTips`。
+- [x] 使用技巧 QA 增加分区布局、主题配色、关闭动作、全宽事件拦截和 29 语种 `usageTips.close` 检查。
+- [x] 使用技巧标题区视觉优化：标题放大加粗、按主题使用高对比 accent、按技巧类型切换语义 icon。
+- [x] 使用技巧正文多段说明改为编号步骤；第 1 条改为“编辑标签”，并补充双击标签快速进入标签编辑页。
+- [x] 同步更新第 1 条使用技巧 29 个语种文案，并把标题字号、语义 icon、编号步骤和双击标签说明纳入 `usage_tips_qa.sh`。
+- [ ] 用户视觉体验验收。
+- [ ] 通过验收后再决定是否冻结、打包、创建正式 release tag。
+
+## 完成标准
+
+- 默认主题和 7.9.4 的浅色 App Grid 观感一致。
+- 8 个主题切换只影响 App Grid 背景与自动玻璃适配，不影响功能行为。
+- 所有 29 个语种都能显示主题页签和主题名称，不出现裸 key。
+- 旧版已启用深色视图的用户升级后进入深蓝主题，未启用的用户保持默认主题。
+- 构建、签名、macOS 14 metadata/typecheck、主题 QA、核心数据/搜索/使用技巧回归通过。

--
Gitblit v1.9.3