# 2026-06-28 MEXP03 Gate

## 用户目标

先完成 MEXP02 后的代码冻结基线，再以 `M-体验03：Mindraw 内置 AI Frame MVP` 为目标持续推进：不靠外部命令，在 Mindraw 内选中 Frame，直接发起 AI，并在右侧生成 result Frame。

## 已完成事项

- MEXP02 本地冻结基线已确认存在：Mindraw tag `mindraw-freeze-20260628-mexp02-alpha-user-accepted`，m4c tag `m4c-freeze-20260628-mexp02-alpha-user-accepted`。
- 原 Mindraw worker 卡在空的 `inProgress` turn 后，PM 记录恢复检查并重派 `MD-MEXP03-01` 到 recovery worker。
- Mindraw coder 完成 `MD-MEXP03-01`：App 内 `AI Frame` 入口、prompt 面板、本地 Alpha provider、workflow facade、测试、QA 和文档。
- 独立 reviewer 未发现阻断级安全或逻辑问题；非阻断建议已由 coder 最小补强。
- PM 复测通过并将 `PM-MEXP03-GATE` 收敛为 `GO for user hands-on`。
- 已提交实现基线：`422c15e feat: add in-app AI frame MVP`。

## 关键决策

- `M-体验03` 只交付本地 Alpha MVP，不宣称真实 AI provider release。
- 本 Gate 不包含 H8 / formal release、不生成 DMG、不递增版本号、不做正式 MCP server、不做 Phase 4 `.assets` 权威化、不新增 m4c 任务。
- dirty `.mindraw` 继续阻断，用户需先保存再运行 AI Frame。

## 文件变更

- 新增 `src/components/AiFramePanel.tsx`。
- 新增 `src/lib/mindrawAiFrameWorkflow.ts` 与 `src/lib/mindrawAiFrameWorkflow.test.ts`。
- 更新 `src/components/ExcalidrawEditor.tsx`、`src/index.css`。
- 更新 `CHANGELOG.md`、`CODEGRAPH.md`、`INDEX.md`、`02-P/plan-progress.markdown`。
- 新增 QA / Gate 证据：`02-P/qa/mindraw-mexp03-ai-frame-mvp-check.md`、`.json`、`mindraw-mexp03-pm-gate.md` 和两张 smoke 截图。

## 验证结论

- `npm run test:run -- src/lib/mindrawAiFrameWorkflow.test.ts src/lib/mindrawAppWriteApi.smoke.test.ts src/lib/mindrawAppWriteMutation.test.ts src/lib/mindrawAppWriteLease.test.ts src/lib/mindrawAppReadApi.test.ts`：42 tests PASS。
- `npm run test:run -- src`：210 tests PASS。
- `npm run doctor:mindraw:test`：14 tests PASS。
- `npm run build`：PASS，仅既有 font resolve / chunk-size warnings。
- `npm run tauri -- build --debug --bundles app`：PASS。
- `git diff --check`：PASS。
- PM 复核 smoke 截图和磁盘文件：source Frame preserved，旧 result `x=840`，新 result `x=1640`，保存重开可见。

## 未决问题

- 真实 AI provider、账号 / 密钥 / 云端调用仍未实现。
- H8 / formal release、DMG、版本递增仍未做。
- Phase 4 `.assets` 权威化仍未做。
- macOS 打开安全副本可能出现文件夹访问权限弹窗；这是系统权限提示，不是 AI Frame 写回失败。

## 后续建议

- 用户先按 PM Gate 提供的步骤体验本地 QA debug App。
- 用户验收通过后，再决定是否进入可安装版 / 正式 provider / H8 release 方向。