Taglauncher QA 审查记录 - 2026-06-08

用户目标

用户要求以 QA 视角审查 /Users/ar/Projects/Taglauncher-7.8.15-source 中 Apple 系统自带 App 默认备注本地化方案，只做方案审查和测试设计，不改代码。关注文件：DataLayer.swift、SmartStartService.swift、L10n.swift、ContentView.swift、AppleDefaultAppNotes.swift。

已完成事项

• 读取项目规则与 QA/交付门禁规则，确认本轮只做审查与测试设计。
• 审查默认备注数据模型：AppNoteOrigin 包含 catalogDefault、appleDefault、manual，appNoteMetadata 保存 provenance 与 fingerprint。
• 审查语言切换路径：L10n.switchTo / switchToAutomatic 发送 .appLanguageDidChange；ContentView 收到后异步调用 SmartStartService.relocalizeDefaultNotesForCurrentLanguage(apps:) 并刷新 UI。
• 审查保护逻辑：relocalizeDefaultNotesForCurrentLanguage 只覆盖 origin == .catalogDefault 且当前文本 fingerprint 与旧 catalog provenance 匹配的备注；手写编辑通过 TagEditor.setAppNote 写为 manual。
• 审查 SmartStart catalog 资源：base catalog 有 29 种语言、77 个 com.apple.* 条目；所有 Apple 条目在 29 种 notes JSON 中均有非空备注。

关键结论

• 新 catalog 默认备注的语言切换保护机制方向正确：catalog 默认可跟随语言切换，manual 不应被覆盖。
• 主要风险是旧路径仍存在：DataLayer.reconcileScannedApps 初次扫描仍调用 seedDefaultAppleAppNotes，该函数从 AppleDefaultAppNotes.swift 写入中文硬编码备注并标记 origin: appleDefault；当前语言切换刷新函数不处理 appleDefault，老数据或首次扫描路径可能不会随语言切换。
• SmartStartService.applyDraft 允许覆盖 “knownDefaultNotes” 或 catalog default，但其候选集当前只包含当前语言的默认备注，不能天然识别旧中文 appleDefault 是否应迁移为 catalog default。
• 需要补自动化覆盖 store 迁移、manual 保护、catalog 完整性、构建资源完整性和真实 UI smoke。

文件变更

未改项目源码。仅新增本轮会话记录文件：

• /Users/ar/Projects/X-sessionhistory/Taglauncher/2026-06-08-02.md

未决问题

• 是否计划移除或迁移 AppleDefaultAppNotes.swift 的中文默认备注来源，尚未从代码中看到完整迁移实现。
• 是否已有外部 QA 脚本未放在源码目录内，当前源码目录未发现针对 app note 本地化的测试脚本。

后续建议

• 发布前补 appNoteMetadata 迁移/保护单测或脚本测试。
• 补构建产物资源校验，确保 .app/Contents/Resources 含 29 个 SmartStartUltimateDefaultCatalog.notes.*.json.deflate。
• 真机 smoke 必须覆盖旧中文默认备注、手写备注、删除备注、语言快速切换、自动语言模式。