2026-06-28 UI 教训复盘

用户目标

用户要求以 PMO 视角拉 UI 设计师、架构师和代码审核员，回顾 TagLauncher 项目从开始到现在所有 UI 类问题，重点总结用户因字体大小、边距、行距、布局、视觉和交互问题提出抱怨后团队做过的修正，并落成文档。

已完成事项

• 读取项目入口、代码治理、会话记忆、项目治理和经验教训规则。
• 确认项目没有统一计划台账；本轮按知识沉淀任务处理，不新增活跃计划。
• 检索 .codex-sessionhistory、legacy 会话记录、Docs、src/Docs/Requirements 和相关技术文档。
• 启动并汇总三个只读角色：
• UI 设计师：归类视觉、排版、交互问题。
• 架构师：分析 SwiftUI/AppKit/NSPanel、主题矩阵和验收链路造成的结构性风险。
• 代码审核员：总结静态 QA 替代真实视觉验收的漏项和 code review checklist。
• 新增专题复盘文档：
• Docs/KM2.项目管理-非业务直接相关/关于TagLauncher所有UI类问题的经验与教训.md
• 按经验教训规则新增设计类经验文档：
• Docs/KM2.项目管理-非业务直接相关/设计工作-经验与教训.md

关键结论

• UI 返工集中在 usage tips 横幅、设置页尺寸与密度、主题材质、AppGrid hover/拖拽热区、底部特殊容器、Pro 状态层级。
• 根因不是单一审美问题，而是设计口径分散、混合 UI 架构复杂、主题/Pro/多语言状态矩阵扩大、真实视觉 gate 后置。
• 静态 QA 只能证明源码规则存在，不能证明真实渲染、点击、hover、拖拽和视觉层级通过。
• 以后没有截图、录屏、AX 或真实交互证据时，只能写“静态 QA PASS，视觉未验收”，不得写“视觉 PASS”。

文件变更

• 新增：Docs/KM2.项目管理-非业务直接相关/关于TagLauncher所有UI类问题的经验与教训.md
• 新增：Docs/KM2.项目管理-非业务直接相关/设计工作-经验与教训.md
• 新增：.codex-sessionhistory/2026-06-28-UI教训复盘.md

未决问题

• 本轮只做复盘文档，不修改源码、不补 QA 脚本、不生成截图矩阵。
• 后续可单独把专题文档中的 checklist 转成发布 checklist 或代码审核模板。

后续建议

• 为 AppGrid、Settings、Theme、Pro 四个 UI surface 各补一份轻量 UI 合约。
• 稳定化 window_logic_qa.sh，避免 GUI 基础设施不稳定继续削弱 UI 验收证据。
• 建立长语种、长标签名、长备注、Pro 状态、倒计时的固定视觉 fixture。