2026-06-13 AppGrid 使用技巧

用户目标

• 在 AppGrid 底部增加固定悬浮使用技巧，用户滚动 AppGrid 时仍可见。
• tips 编号从 1 开始。
• 长本地化文案需要可横向查看。
• 通用设置中增加“隐藏使用技巧”开关，默认不隐藏。
• 技术实现必须兼容 macOS 14。

已完成事项

• 新增 AppGridUsageTipsBar，放在 AppGrid 区域底部 overlay，右侧/左侧标签栏不被覆盖。
• AppGrid layout 增加 bottomContentPadding，tips 显示时预留底部滚动空间。
• tips 正文使用横向 ScrollView，鼠标悬停时显示滚动指示，长文案可查看。
• tips 左右切换按钮和页码圆点已实现。
• 拖拽应用时 tips overlay 不拦截 hit testing，避免影响 AppGrid 拖放。
• AppDefaults 注册 hideUsageTips = false。
• 设置页通用 tab 增加 隐藏使用技巧 toggle，并将通用页主体顶部略向下移动。
• 29 个语言 JSON 均补齐设置开关、上一条/下一条、8 条 tips 标题与正文。
• 新增 src/Scripts/usage_tips_qa.sh 静态 QA，覆盖默认值、设置开关、tips overlay、macOS 14 兼容实现和 29 语言 key 完整性。

QA 证据

• git diff --check：通过。
• bash Scripts/usage_tips_qa.sh：通过。
• bash Scripts/app_ordering_data_qa.sh：通过。
• bash Scripts/macos14_availability_typecheck_qa.sh：通过，arm64-apple-macosx14.0。
• APP_BUILD=20260613.1508 bash build.sh：通过。
• bash Scripts/macos14_build_metadata_qa.sh：通过，LSMinimumSystemVersion=14.0 minos=14.0 arches=arm64。
• 视觉 smoke：
• 主界面截图：/tmp/taglauncher-usage-tips-smoke-3.png，确认 tips 固定在 AppGrid 底部且编号从 1 开始。
• 设置页截图：/tmp/taglauncher-usage-tips-settings-smoke-2.png，确认通用页出现“隐藏使用技巧”开关。

Git 与范围

• 工作分支：codex/appgrid-usage-tips。
• 本次应提交范围：
• src/Apptag/AppDefaults.swift
• src/Apptag/AppGridCollectionView.swift
• src/Apptag/ContentView.swift
• src/Apptag/PreferencesView.swift
• src/Apptag/Localization/*.json
• src/Scripts/usage_tips_qa.sh
• 未处理且未纳入本次范围的既有脏文件保持原样：
• docs/index.html
• src/Release/AppStore-7.8.15-20260605.2337/Screenshots/... 删除记录
• Docs/KM02-技术/...
• Docs/X-Op资料/Screenshots/...

后续建议

• 如果要发布给外部测试，应基于本分支重新出 dmg，并在 macOS 14 真机上复核：滚动、tips 左右切换、长文案横向滚动、设置开关隐藏/恢复。