# 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。