edit | blame | history | raw

Mindraw 插件入口 MD-MCPE-01 暂停记录

用户目标

本轮原目标是由 coder2@mindraw 领取 MD-MCPE-01，补齐 Mindraw App 对 ~/plugins/mindraw 所需的最小 create / preview / open capability。执行中 PM 紧急改派：由于 MEXP09 视觉价值链路发现 bytesIncluded=false、pixelsIncluded=false、auxiliaryOcr.available=false，不能证明 agent 像收到 PNG 一样看到目标 Frame 内截图细节，因此 MD-MCPE-01 不得继续推进到 commit、m4c retry 或 PM-MCPE-GATE。

已完成事项

  • 已形成本地未提交草稿：mindraw.app.create_blank_package、mindraw.app.get_preview_snapshot、mindraw.app.open_package。
  • capability 草稿新增：createBlankPackage="write"、previewSnapshot="read"、openPackage="write"、deepLinkOpen="open"。
  • Tauri 草稿使用 Mindraw 受控 .mindraw 包创建路径，拒绝覆盖已有同名包，并生成 preview/preview.svg approved preview artifact。
  • doctor 草稿能检测 project canvas create / preview / open capability。
  • 按 PM 暂停指令，在当前 debug app bundle build 自然结束后停止；未提交 commit，未打 DMG，未安装或覆盖 /Applications/Mindraw.app。

核心事实 / 变更快照

  • 变更对象：MD-MCPE-01 状态。
  • 事实来源：02-P/plan-progress.markdown 的 P-20260701-mindraw-codex-plugin-entry；当前工作区未提交草稿。
  • 变更前：MD-MCPE-01 原目标为补齐 MEXP10 create / preview / open capability，并准备 m4c retry / Gate。
  • 变更后：PARTIAL / PAUSED_ON_MEXP09B / worker checkpoint reached / draft uncommitted。
  • 范围边界：草稿可作为后续恢复依据，但不得作为验收依据；不得进入 PM-MCPE-GATE；不得派发 m4c retry；下一步归属 PM 立 MEXP09B：Target Frame Pixel Payload / Vision Input Delivery。
  • 验证证据：目标测试和构建命令见下方 Runbook；当前旧运行 runtime 的 doctor 仍显示 project canvas capability invalid，符合“未刷新/未验收”边界。

文件变更

本轮新增 / 修改的本任务草稿文件：

  • src/lib/mindrawProjectCanvasApi.ts
  • src/lib/mindrawAppReadApi.ts
  • src/lib/mindrawAppApiTransport.ts
  • src/lib/mindrawAppReadApi.test.ts
  • src/lib/mindrawAppApiTransport.test.ts
  • src-tauri/src/lib.rs
  • src-tauri/src/app_api_transport.rs
  • scripts/mindraw-doctor.mjs
  • scripts/mindraw-doctor.test.mjs
  • 02-P/plan-progress.markdown

当前工作区还存在其他非本轮 dirty / untracked 文件，未在本轮回滚或提交。

可复用命令 / Runbook

用途：恢复 MD-MCPE-01 草稿后，复验 Mindraw App create / preview / open capability 的基础测试与构建。

前置条件：在 /Users/ar/Projects/ExcalidrawX，确认 PM 已解除 PAUSED_ON_MEXP09B 并重新派发 Mindraw MD-* 任务。

设置命令：

npm test -- --run src/lib/mindrawAppReadApi.test.ts src/lib/mindrawAppApiTransport.test.ts
node --test scripts/mindraw-doctor.test.mjs
cargo test --manifest-path src-tauri/Cargo.toml project_canvas
cargo test --manifest-path src-tauri/Cargo.toml creates_blank_package_and_approved_preview_artifact
npm run build
git diff --check
npm run tauri -- build --debug --bundles app
npm run doctor:mindraw -- --pretty

验证步骤：

  • 前六条应 PASS。
  • debug bundle build 只生成本地 QA App，不安装、不覆盖 /Applications/Mindraw.app。
  • 若未启动新 runtime，doctor 仍可能显示 project canvas create / preview / open invalid；这不是通过证据，只是旧 runtime 边界。

清理 / 恢复：

  • 不需要清理 /Applications/Mindraw.app，本轮未覆盖。
  • 如后续启动 debug App，应由恢复任务明确记录 PID、capability path 和 redacted capability snapshot。

搜索关键词：MD-MCPE-01、PAUSED_ON_MEXP09B、create_blank_package、previewSnapshot、openPackage、MEXP09B pixel payload。

未决问题

  • MEXP09B 必须先解决 target Frame pixel payload / vision input delivery，不能继续用 bytesIncluded=false / pixelsIncluded=false 的旧 visual package 宣称 UI 视觉理解。
  • MD-MCPE-01 草稿尚未提交、未创建正式 QA md/json、未刷新 live runtime、未进入 m4c retry。

后续建议

  • PM 先立并派发 MEXP09B。
  • MEXP09B 有可验收 pixel payload 后，再决定是否恢复 MD-MCPE-01 草稿并补齐正式 QA / CODEGRAPH / CHANGELOG / commit。