edit | blame | history | raw

2026-06-27 MEXP01 演示准备

用户目标

以 Coder@mindraw 身份从统一台账 P-20260626-m4c-handshake-coordination 领取 MD-MEXP01-01，围绕当前唯一目标 M-体验01：AI Frame 本机 Alpha 写回演示 准备 Mindraw 侧真实 App / demo 包 / 体验证据。不得切换 H7/H8，不做完整 .assets 权威实现，不改 m4c 03-O，不绕过 Mindraw App 直接写包。

已完成事项

  • 重新读取 /Users/ar/.codex/AGENTS.md、项目 AGENTS.md、INDEX.md、CODEGRAPH.md 和统一台账相关 M-体验01 / MD-MEXP01-01 / M4C-MEXP01-01 / PM-MEXP01-GATE 内容。
  • 创建用户可体验安全副本：02-P/demo/mexp01/MEXP01-ai-frame-demo.mindraw，源自 H5 fixture annotated-frame-h5-copy.mindraw，原 fixture 未改动。
  • 用真实本机 debug App /Users/ar/Projects/ExcalidrawX/src-tauri/target/debug/bundle/macos/Mindraw.app 打开 demo 包，当前 live capability 为 h5-md-h5-05-canonical-v1。
  • 外部 Node JSON-RPC smoke 验证 /health、/capabilities、JSON-RPC get_capabilities、get_open_document_state、get_live_frame_context、lease acquire/release 和受控 commit_write_result(createAiResultFrame)。
  • 在 demo 包内生成 result Frame：frame_result_md-mexp01-01-demo-alpha / MEXP01 AI Frame Alpha Result。
  • 确认 source Frame frame_ai_annotation_001 / AI Annotation Source 的用户可见语义字段 preserved；raw digest 差异来自 Excalidraw 保存归一化。
  • 输出最短用户体验说明草案 02-P/demo/mexp01/README.md。
  • 输出 QA 报告和 JSON 证据：02-P/qa/mindraw-mexp01-demo-readiness.md、02-P/qa/mindraw-mexp01-demo-readiness.json。
  • 同步 INDEX.md、CODEGRAPH.md 和 02-P/plan-progress.markdown，把 MD-MEXP01-01 标为完成并回写 Progress Log。

关键决策

  • 本体验里程碑先走 inline-compatible，不等待完整 Phase 4 .assets 权威实现，也不宣传 .assets 权威化完成。
  • m4c 后续必须实时读取 ~/Library/Application Support/com.mindraw.desktop/runtime/write-api.json；PID、端口和 token 都是运行态临时值，不得复用本轮证据中的旧值。
  • PM-MEXP01-GATE 仍由 PM 收敛；Mindraw 不领取 PM-* / H*。

文件变更

  • 新增：02-P/demo/mexp01/README.md
  • 新增：02-P/demo/mexp01/MEXP01-ai-frame-demo.mindraw/
  • 新增：02-P/qa/mindraw-mexp01-demo-readiness.md
  • 新增：02-P/qa/mindraw-mexp01-demo-readiness.json
  • 更新：INDEX.md
  • 更新：CODEGRAPH.md
  • 更新：02-P/plan-progress.markdown

验证

  • open -a /Users/ar/Projects/ExcalidrawX/src-tauri/target/debug/bundle/macos/Mindraw.app /Users/ar/Projects/ExcalidrawX/02-P/demo/mexp01/MEXP01-ai-frame-demo.mindraw
  • 外部 Node JSON-RPC smoke：PASS，结论 PASS_FOR_MD_MEXP01_01_DEMO_READINESS
  • node -e 解析 02-P/qa/mindraw-mexp01-demo-readiness.json 并确认 summaryStatus=PASS
  • rg -n "MD-MEXP01-01|MEXP01-ai-frame-demo|mindraw-mexp01-demo-readiness|PASS_FOR_MD_MEXP01_01" 命中台账、索引、工程地图、README 和 QA 报告
  • git diff --check 无输出
  • 当前 live /health 返回 ok=true

未决问题

  • M4C-MEXP01-01 仍需 m4c 侧完成 demo runner 和用户可运行命令。
  • PM-MEXP01-GATE 仍需 PM 收敛 MD-MEXP01-01 与 M4C-MEXP01-01 后判定是否交给用户体验。
  • 当前使用本机 debug live App，不是 H8 发布包；App 退出后 capability 可能 stale，必须用 /health 判定。