# Taglauncher 会话记录 2026-06-08

## 用户目标

用户要求以架构师视角审查 `/Users/ar/Projects/Taglauncher-7.8.15-source`，只讨论方案、不改代码。核心目标是让 Apple 系统自带应用默认备注随界面语言显示本语言；当且仅当用户手动改过某条备注，该条不再随语言变化。用户明确说明目前没有真实老用户，老用户只有 owner 本人，因此不要以兼容旧 `appleDefault` 中文备注为核心约束。

## 已完成事项

- 读取项目规则：`work-continuity.md`、`delivery-gate.md`。
- 审查 `Apptag/AppleDefaultAppNotes.swift`，确认其包含约 72 条中文硬编码备注和 familiar Apple app 白名单。
- 审查 `Research/SmartStart/UltimateDefaultCatalog`，确认 base catalog 中有 77 个 `com.apple.*` 条目，29 个 notes 语言文件存在。
- 审查 `Apptag/SmartCategorization/SmartStartService.swift`，确认 `.catalogDefault` 备注已有按 `L10n.currentCode` 加载、fallback、metadata provenance、语言切换重定位逻辑。
- 审查 `Apptag/DataLayer.swift`，确认当前 Apple 初始备注通过 `seedDefaultAppleAppNotes` 写入 `.appleDefault`，不会被 `relocalizeDefaultNotesForCurrentLanguage` 更新。
- 审查 `TagEditor.setAppNote`，确认用户非空编辑会写入 `.manual`，清空会删除备注和 metadata。
- 审查 `L10n.swift`、`ApptagApp.swift`、`ContentView.swift`，确认语言切换入口会发 `.appLanguageDidChange`，ContentView 收到后触发 catalog 默认备注重定位。
- 审查 `build.sh` 与 catalog 构建脚本，确认 build 会复制 base/manifest 并压缩所有 notes 资源；Research 生成脚本仍从 `AppleDefaultAppNotes.swift` 抽取 Apple fallback。

## 关键决策建议

- 长期推荐把 Apple 自带 App 默认备注统一纳入 SmartStart catalog 体系，不再在运行时使用独立 `AppleDefaultAppNotes.swift` 作为备注来源。
- `AppNoteOrigin.appleDefault` 应迁移/降级为历史兼容枚举值；新写入的系统默认备注统一使用 `.catalogDefault`。
- `metadata.catalog` 应成为判断“仍跟随默认”的唯一依据：包含 `entryID`、实际语言、`notesVersion` 和 fingerprint。
- 用户手动编辑非空备注继续标记 `.manual`；语言切换只更新 `.catalogDefault` 且当前文本 fingerprint 仍匹配旧默认的条目。
- 清空备注的语义建议定义为“恢复默认跟随”，而不是“手动保持为空”；如产品需要永久空备注，应另设显式操作。
- Research 构建脚本应停止解析 Swift 运行时代码，Apple 中文源备注应保留在 catalog CSV 或专用 seed JSON 中。

## 文件变更

无。用户明确要求只讨论方案、不改代码。

## 未决问题

- 是否需要提供一个“保持为空/隐藏默认备注”的显式 UI 语义；若没有真实用户，建议暂不引入。
- 是否在下一版本做一次 store migration，把 owner 机器上 `.appleDefault` 且 fingerprint 匹配旧硬编码的备注迁到 `.catalogDefault`。

## 后续建议

- 实现时优先修改默认备注来源和 migration，再调整清空备注语义。
- 发布前应验证 29 种语言的 Apple 默认备注、语言切换后 `.manual` 不变、清空后恢复跟随默认、build bundle 内包含所有压缩 notes 资源。