# 使用技巧关闭提醒 TODO ## 目标 - 用户点击 App Grid 底部“使用技巧”关闭按钮时,先显示提醒弹窗。 - 弹窗说明:后续可在“设置 > 通用”取消“隐藏使用技巧”后再次查看 tips。 - 用户确认后才真正关闭 tips,并写入 `hideUsageTips`。 - 用户勾选“下次关闭时不要再提醒我”后,后续关闭 tips 不再弹提醒。 - 提醒内容和设置页预览必须覆盖 29 个语种。 ## 不做范围 - 不改变 tips 默认展示:新用户仍默认显示。 - 不改变 8 条 tips 的教学文案、布局和翻页逻辑。 - 不改变设置页结构,只复用已有“隐藏使用技巧”开关。 - 不新增 29 张静态截图资源;用运行时本地化的设置页预览组件展示同等指引信息。 ## TODO - [x] 新增 `skipUsageTipsCloseReminder` 默认值和持久化偏好。 - [x] 将原生 AppKit tips 关闭按钮改为请求关闭,不再直接隐藏横幅。 - [x] 在 `ContentView` 中新增关闭提醒弹窗状态、确认/取消处理和 modal hit-testing。 - [x] 新增 `UsageTipsCloseReminderBubble`,复用黑底白字提醒风格。 - [x] 新增本地化设置页预览,高亮“隐藏使用技巧”开关。 - [x] 补齐 29 个语种的关闭提醒文案。 - [x] 更新 `usage_tips_qa.sh`,把关闭链路检查改为提醒链路。 - [x] 新增 `usage_tips_close_reminder_qa.sh` 专项门禁。 - [x] 自动化 QA 与构建验证。 - [ ] 用户体验验收后再决定是否冻结/打包。 ## 完成标准 - 第一次点击 tips 关闭按钮时弹出提醒;取消后 tips 保持显示。 - 确认后 tips 关闭,并与设置页“隐藏使用技巧”保持一致。 - 勾选“不再提醒”后,后续点击关闭按钮直接隐藏 tips。 - 弹窗出现期间不穿透 AppGrid,不触发底层应用点击、气泡或拖拽。 - 29 个语种不缺 key、不显示裸 key,非中文语言不混入中文提醒正文。 ## QA 结果 - `bash src/Scripts/usage_tips_qa.sh`:通过。 - `bash src/Scripts/usage_tips_close_reminder_qa.sh`:通过。 - `bash src/Scripts/theme_settings_qa.sh`:通过。 - `bash src/Scripts/macos14_availability_typecheck_qa.sh`:通过。 - `git diff --check`:通过。 - `APP_BUILD=20260625.1615 bash src/build.sh`:通过,产物为 `src/build/TagLauncher.app`。 - `bash src/Scripts/macos14_build_metadata_qa.sh src/build/TagLauncher.app`:通过。 - 构建版本:`8.0.3 (20260625.1615)`。