edit | blame | history | raw

2026-07-06 MEXP14 设计检查

用户目标

PMO 派工 DESIGN-EDC-01，Plan ID P-20260706-external-distribution-candidate。以设计总监身份检查 MEXP14 外部分发候选在外部安装、first-run、sidebar 状态和截图说明上是否容易让普通用户误解，并在需要时最小回写设计事实源。

已完成事项

  • 按顺序读取 /Users/ar/Projects/Mindraw/AGENTS.md、INDEX.md、02-P/plan-progress.markdown 中 P-20260706-external-distribution-candidate。
  • 读取 02-P/MEXP14-ExternalDistributionCandidate/pm/mexp14-round-spec-20260706.md。
  • 读取 02-P/MEXP14-ExternalDistributionCandidate/pm/mexp14-role-dispatch-briefs-20260706.md 中 DESIGN-EDC-01 任务段。
  • 读取并审查 02-P/ui/design-spec.md。
  • 在 02-P/ui/design-spec.md 增补 MEXP14 外部分发候选 UX 说明。
  • 在 02-P/plan-progress.markdown 标记 DESIGN-EDC-01 已完成设计检查并追加 Progress Log。

核心事实 / 变更快照

  • 变更对象：Mindraw sidebar / App 设计事实源的外部分发候选说明。
  • 事实来源：02-P/plan-progress.markdown 的 P-20260706-external-distribution-candidate、MEXP14 Round Spec、MEXP14 角色派工简报、既有 02-P/ui/design-spec.md。
  • 变更前：02-P/ui/design-spec.md 主要覆盖 MEXP13 内部 sidebar / App 行为，并明确不覆盖正式 installer / release / notarized package 用户引导。
  • 变更后：新增 External Distribution Candidate UX Notes，覆盖候选语义、外部说明截图清单、first-run / install 可见性、sidebar READY / loading / blocked / source required / stale / document mismatch / target unsupported / edit handoff / save refresh 的误解风险和设计表达要求。
  • 范围边界：本轮不做视觉重设计、不改代码、不扩大 target link 范围、不替 PMO / QA / 发布角色下 Gate 结论。
  • 验证证据：通过 rg 核对新增设计段落、DESIGN-EDC-01 台账勾选和 Progress Log 均已存在。

关键决策

  • 需要补设计事实源，因为 MEXP14 进入外部分发候选语境，而原设计规格只覆盖 MEXP13 内部路径。
  • READY 只能表达当前 sidebar preview source 可用，不能被解释为正式发布、跨机器验收完成或 target link 已支持。
  • 外部说明必须使用截图降低误解风险，尤其是未公证安装、first-run App 可见性、plugin 可见、sidebar 状态、edit handoff 和保存刷新。
  • 状态错误必须 fail-closed；不能展示旧图并让用户以为成功。

文件变更

  • 修改 /Users/ar/Projects/Mindraw/02-P/ui/design-spec.md。
  • 修改 /Users/ar/Projects/Mindraw/02-P/plan-progress.markdown。
  • 新增 /Users/ar/Projects/Mindraw/.codex-sessionhistory/2026-07-06-MEXP14设计检查.md。

未决问题

  • 外部候选包、plugin 候选包、fresh machine / clean profile 证据和安装说明仍需对应角色继续产出。
  • 未 notarized / Gatekeeper 风险需要运营 / 发布和架构角色在外部说明中清楚处理。
  • target link sidebar entry 仍是后续独立需求，不在本轮。

后续建议

  • PMO 收敛 PO-EDC-01、ARCH-EDC-01、MD-EDC-01、M4C-EDC-01、QA-EDC-01、OPS-EDC-01 后再进入 PM-EDC-GATE。
  • 运营 / 发布制作外部说明时应按设计事实源中的截图清单逐项配图。
  • QA 在 fresh machine / clean profile 验证时应覆盖 READY、loading、blocked、source required、stale、edit handoff 和 save refresh / fail-closed。