项目决策记录（DECISIONS.md）
由指定架构负责人统一维护，用于记录每个版本的需求背景和决策过程。
其他角色不得直接编辑本文件；只能提出记录建议、修订建议或补充材料，由架构负责人写入最终记录。

## 2026-05-21 — `Decisions.md` 由架构负责人唯一维护

- 背景：全局工作规范要求架构决策更新 `Decisions.md`，但需要进一步明确文件维护权，避免多角色并行编辑导致决策记录口径不一致。
- 结论：`Decisions.md` 只能由指定架构负责人更新。Product Manager、Coder、QA、Ops、Reviewer 以及未明确以 Architect 身份工作的 agent 均不得直接编辑本文件。
- 允许行为：其他角色可以在自己的 `Docs/01GTD/<role-folder>/02worklog.md`、评审意见、需求讨论或直接请求中提出记录建议。
- 执行方式：最终是否写入、如何表述、放在哪个决策条目下，由架构负责人统一判断并写入。
- 处理结果：已将该规则写入 `Docs/00ProjectManagement/Apptag_Development_Workflow_Standard_v1.0.md`；流程标准版本更新为 1.5。

## 2026-05-21 — Smart Start 首发采用扩展分类体系与按语言拆分资源

- 背景：新版 `SmartStart_UltimateDefaultCatalog.json` 已扩大到约 11MB，包含 3531 条 entry 和 29 种语言 notes。用户确认 App 尚未发布到市场，没有真实用户和历史升级包袱。
- 产品决策：正式扩展 App 分类体系，而不是把生成脚本映射回旧分类。
- 架构决策：首发运行时采用 split Smart Start resources：base catalog、manifest、每语言 notes JSON。旧单体 JSON/CSV 不作为首发运行时 fallback。
- 数据安全决策：虽然没有旧用户迁移负担，但首发后必须保护用户手写备注；系统默认 note 写入时记录来源 metadata，语言切换只更新仍匹配系统默认来源的 note。
- 工程门禁：Smart Start 生成器必须校验 catalog tags 与 Swift `SmartCategoryID` runtime 兼容，未知分类不得被静默丢弃。
- 取代事项：该决策取代 2026-05-20 “Smart Start notes 按语言拆分暂缓到后续版本”的临时结论，因为文件体积、CPU/内存风险和“无历史用户”前提已经改变。

## 2026-05-21 — 建立五角色分工与 GTD 工作记录规则

- 背景：项目新增 `Docs/01GTD/` 角色工作区，按 `00-ProductManager`、`01-Architect`、`02-Coder`、`03-QA`、`04-op` 划分职责。
- 结论：五个角色必须各行其责；可以对其他角色的工作提出意见和建议，但不得静默代替其他角色执行其核心职责。
- 新增规则：每个角色每批工作开始前必须在自己的角色文件夹维护 `01Todolist.md`，工作完成后必须维护 `02worklog.md`。
- 处理结果：已将角色职责、工作边界、GTD 目录规则写入 `Docs/00ProjectManagement/Apptag_Development_Workflow_Standard_v1.0.md`；流程标准版本更新为 1.4。

## 2026-05-20 — 新增目标导向沟通与阻塞上报规则

- 背景：项目成员在执行任务时，可能遇到工具、翻译接口、自动化脚本、数据源或环境问题。此时允许停下来报告客观困难，但不允许用过程性表达、无关解释或含糊状态掩盖目标没有完成。
- 结论：在 `Docs/ProjectManagement/Apptag_Development_Workflow_Standard_v1.0.md` 中新增“Goal-Oriented Communication And Blocker Reporting”规则。
- 核心要求：任何状态汇报必须明确说明目标是 `Completed`、`Partially completed`、`Blocked` 还是 `Not started`；如果未完成，必须说明缺口、证据、影响和下一步选项。
- 特别约束：当工具、API、模型、翻译服务、自动化脚本、数据源或本地环境失败并导致目标无法完成时，成员必须直接说明，不得编造结果、静默替换不可验证结果，或回避目标是否完成。
- 处理结果：流程标准版本更新为 1.3。

## 2026-05-20 — 撤销“翻译必须使用本地 Ollama”的项目硬性规则

- 背景：在 Smart Start 目录补充 29 种语言默认备注时，本地 Ollama `translatege` 在手工短句翻译中可用，但在脚本化批量翻译中反复卡住，无法稳定产出。
- 结论：撤销“所有多语言翻译任务必须使用本地 Ollama、禁止在线翻译”的项目级硬性规则。
- 处理结果：已从 `.hermes.md` 和 `Docs/ProjectManagement/Apptag_Development_Workflow_Standard_v1.0.md` 中移除该硬性规则；流程标准版本更新为 1.2。
- 后续策略：翻译任务应以可复现、可验证、可完成为准；若使用在线翻译或其他自动化翻译方式，必须在任务记录、生成脚本或 QA 报告中说明来源与风险。

## 2026-05-20 — Smart Start notes 按语言拆分暂缓到后续版本

- 产品方向：长期看，Smart Start 基础目录与多语言 notes 分离是合理方向；基础目录保留语言无关字段，notes 可按语言独立资源加载。
- 架构评估结论：当前临近市场发布，不建议在本版执行该结构性拆分，除非有明确包体或启动性能阻塞。
- 关键风险：语言切换时默认备注识别依赖 `matched.notes.values`；若只加载当前语言 notes，可能导致默认备注不重本地化，或误覆盖用户手写备注。
- 当前决策：本版继续使用单 JSON 结构完成 CSV 吸收、多语言翻译 QA、构建和发布；notes 按语言拆分作为后续资源格式升级。
- 详细评估记录见：`Research/SmartStart/SmartStart_NotesLanguageSplit_ArchitectureReview_20260520.md`。

## 2026-05-20 — 工作流程规范收口为单一权威文档

- 新增唯一权威流程文档：`Docs/ProjectManagement/Apptag_Development_Workflow_Standard_v1.0.md`。
- 该文档统一收口项目级工作流程、文档更新责任、QA 门槛、版本管理、构建规则、发布门槛与冲突处理规则。
- `.hermes.md` 现在只作为入口指针，不再单独维护散落的流程规则。
- 明确将“build 过程不得回写受版本控制的源码文件”升级为硬性规则。
- 当前 `build.sh` 回写 `Apptag/Info.plist` 的做法被定义为流程缺陷；治本要求是只改产物中的 `Info.plist`，不改仓库工作区。
- 后续任何 coder（包括 AI coder）如果收到与流程规范冲突的指令，必须指出违反的具体条款，而不能静默执行。
- 已在 `build.sh` 落地第一步修复：打包时先复制源码 `Info.plist` 到 `.app` 包内，再只修改产物中的 `CFBundleVersion`。
- 验收结果：`build/TagLauncher.app/Contents/Info.plist` 的 `CFBundleVersion` 可独立刷新，而源码 `Apptag/Info.plist` 在构建后保持不变。

## 2026-05-10 — 无色容器交互锁定

- 「无色容器」是 App 列表第 2 种视图样式，对应 `displayMode == "container"`。
- 固定交互：hover 标签或对应容器区域时，容器保持标签色填充；鼠标移开后不自动清除。
- 清除方式：再次点击同一标签，或点击对应容器内部空白处。
- 后续迭代新增/修改其他样式时，不应改变以上无色容器交互逻辑；「彩色容器」应使用独立交互状态。