2026-06-29 UI 预览门禁

用户目标

用户要求把此前确认的 TagLauncher UI 流程落地：非平凡 UI 改动前必须先有 UI 合约和高保真预览，用户确认视觉目标后才允许修改 SwiftUI / AppKit 源码；实现后必须用真实 App 截图、录屏、AX 或真实交互证据验收，不能用静态 QA 冒充视觉 PASS。

已完成事项

• 在项目入口 AGENTS.md 增加“UI 改动开工门禁”，让后续 Agent 进入项目时先看到该硬约束。
• 在 CODE_GOVERNANCE.md 新增 UI Preview Gate，定义触发范围、UI 合约字段、高保真预览、用户确认、实现后视觉验收证据。
• 新增 Docs/KM2.项目管理-非业务直接相关/UI合约模板.md，供后续 AppGrid / Settings / Theme / Pro / Quick Search / tips 等 UI 改动直接复用。

关键决策

• UI 规则不单独依赖某个 skill；baoyu-design、Penpot、Figma、用户标注图或真实参考截图都可以作为高保真预览来源。
• 没有 UI 合约、高保真预览和用户视觉确认时，非平凡 UI 改动不得进入生产 UI 源码修改。
• 静态 QA、构建通过、脚本 PASS 只能证明静态条件；没有真实渲染或真实交互证据，不得写视觉 PASS。
• throwaway 原型可以用于调查，但必须放在非生产路径并标记不可直接发布。

文件变更

• /Users/ar/Projects/Taglauncher/AGENTS.md
• /Users/ar/Projects/Taglauncher/CODE_GOVERNANCE.md
• /Users/ar/Projects/Taglauncher/Docs/KM2.项目管理-非业务直接相关/UI合约模板.md
• /Users/ar/Projects/Taglauncher/.codex-sessionhistory/2026-06-29-UI预览门禁.md

未决问题

• 是否在下一轮进一步安装 / 接入 baoyu-design、Penpot 或 Figma MCP，作为实际高保真预览生产工具。
• TagLauncher 本地 AGENTS.md / CODE_GOVERNANCE.md 仍保留早期 | head -c ... 命令输出示例；本轮未处理该非 UI 范围问题。

后续建议

• 下一次真实 UI 改动先复制 UI合约模板.md，用 baoyu-design 或 Penpot 产出 2-3 个候选 screen，再进入生产源码。
• 后续可把 AppGrid / Settings / Theme / Pro 四个高风险 surface 各补一份长期 UI 合约。