2026-06-11 技术文档整理

用户目标

用户要求以新接手研发总监视角检视 TagLauncher 全部代码，整理核心架构、核心业务逻辑和重要专题文档；每份 Markdown 写明整理日期和依据产品版本，并配套 draw.io 图示；所有文档放在 /Users/ar/Projects/Taglauncher/Docs/KM02-技术。

已完成事项

• 读取并遵守项目治理规则、CODE_GOVERNANCE.md 和相关全局研发规则。
• 确认当前依据版本为 TagLauncher 7.8.26，Build 20260609.2004，来源为 src/Apptag/Info.plist、src/CHANGELOG.md 和 src/Release/AppStore-7.8.26-20260609.2004/QA_RELEASE_EVIDENCE.md。
• 只读检视核心 Swift 代码、资源目录、构建脚本、QA 脚本和发布证据。
• 新增技术知识库目录 Docs/KM02-技术。
• 新增 8 个 Markdown 文档：
• 00-阅读索引.md
• 01-核心架构与业务逻辑.md
• 02-多窗口显示关系.md
• 03-App名称抽取与QuickSearch.md
• 04-应用扫描索引与数据快照.md
• 05-标签数据模型与编辑流.md
• 06-SmartStart与Apple默认应用.md
• 07-构建发布与QA.md
• 新增 7 个 draw.io 图示：
• 01-核心架构与业务逻辑.drawio
• 02-多窗口显示关系.drawio
• 03-App名称抽取与QuickSearch.drawio
• 04-应用扫描索引与数据快照.drawio
• 05-标签数据模型与编辑流.drawio
• 06-SmartStart与Apple默认应用.drawio
• 07-构建发布与QA.drawio

关键决策

• 本次只新增 Docs/KM02-技术 下的技术文档和图示，不修改 App 源码、构建脚本、QA 脚本、发布资料或既有网站文件。
• 保留用户/其他 Agent 先前对 docs/index.html 的未提交改动，不触碰、不回滚。
• 文档按“总览 + 关键专题”组织，重点覆盖窗口栈、名称抽取、扫描 snapshot、标签数据、Smart Start/Apple catalog、构建发布 QA。

验证结果

• find Docs/KM02-技术 -maxdepth 1 -type f | sort 确认 15 个目标文件已生成。
• rg 检查每份 Markdown 均包含 整理日期：2026-06-11 和 依据产品版本：TagLauncher 7.8.26，Build 20260609.2004。
• Python 链接检查结果：missing-links []，Markdown 中相对链接均能找到目标文件。
• Python XML 解析检查结果：bad-xml []，draw.io 文件基础 XML 可解析。
• git status --short 显示既有 docs/index.html 修改仍存在，新增目录为 Docs/KM02-技术/，未发现源码改动。

未决问题

• 本轮未执行 App 构建或 QA 脚本，因为任务是代码检视和文档整理，未改动运行时代码。
• 如后续要提交，需要用户决定是否一并处理既有 docs/index.html 改动；本轮没有归属该改动。

后续建议

• 后续修改窗口栈、Quick Search、名称解析、Smart Start、Apple 默认应用资源或构建发布流程时，同步更新对应专题文档和 draw.io。