edit | blame | history | raw

2026-07-01 MCPE 插件重试

用户目标

以 Coder@m4c 身份领取统一台账 P-20260701-mindraw-codex-plugin-entry 中的 M4C-MCPE-02，在 MD-MCPE-01 已 PASS 后更新 ~/plugins/mindraw，让插件实际消费 Mindraw create / preview / open capability。完成后回写台账、输出 QA 证据、运行 plugin validation / SkillSpector，并保持 m4c 03-O Git 边界。

已完成事项

  • 更新 ~/plugins/mindraw：
  • inspectProjectCanvas() 调用 mindraw.app.create_blank_package 创建项目画布。
  • inspectProjectCanvas() 调用 mindraw.app.get_preview_snapshot 获取 approved full-canvas preview artifact。
  • openCanvasInMindraw() 调用 mindraw.app.open_package，不再用 macOS open fallback。
  • 保留 MindrawCanvas/ latest-created registry、重复打开不新建、显式新建递增、mtime 不影响选择、registry 丢失恢复、非规范 .mindraw warning、防覆盖。
  • sidebar 保持只读 preview，支持 pan / zoom / reset / 编辑 / double-click。
  • MCP stdio tool 保留 inspect_mindraw_project_canvas / open_mindraw_project_canvas。
  • 更新 Codex plugin 元数据：
  • .codex-plugin/plugin.json cachebuster 更新为 0.1.0+codex.20260701142826。
  • mindraw@personal 已通过 codex plugin add mindraw@personal 安装并 enabled。
  • 产出 QA 证据：
  • p.mindrawforcodex/02-P/MEXP10-CodexPluginEntry/qa/m4c-mcpe-02-plugin-retry-smoke.json
  • p.mindrawforcodex/02-P/MEXP10-CodexPluginEntry/qa/m4c-mcpe-02-mcp-smoke.json
  • p.mindrawforcodex/02-P/MEXP10-CodexPluginEntry/qa/m4c-mcpe-02-http-smoke.json
  • p.mindrawforcodex/02-P/MEXP10-CodexPluginEntry/qa/m4c-mcpe-02-installed-cache-smoke.json
  • p.mindrawforcodex/02-P/MEXP10-CodexPluginEntry/qa/m4c-mcpe-02-skillspector.md
  • 产出正式 m4c QA 文档：
  • p.mindrawforcodex/03-O/K2.项目管理/联调QA/2026-07-01-M4C-MCPE-02PluginRetry.md
  • 同步索引：
  • p.mindrawforcodex/03-O/C1.source/CODEGRAPH.md
  • p.mindrawforcodex/03-O/K2.项目管理/README.md
  • p.mindrawforcodex/INDEX.md
  • 02-P/plan-progress.markdown
  • m4c 03-O commit：
  • 64832c2 docs: record M4C MCPE plugin retry

关键决策

  • 不把 contract/mock smoke 冒充为真实 live Mindraw App Gate PASS。
  • 当前标准 Mindraw runtime capability 文件不存在，所以本轮结论是：
  • PASS_FOR_M4C_PLUGIN_CONSUMER_CONTRACT
  • PARTIAL_FOR_LIVE_RUNTIME
  • PM 可进入 PM-MCPE-GATE live runtime precheck，但必须先刷新 / 启动 Mindraw QA App，让标准 runtime capability 暴露 createBlankPackage / previewSnapshot / openPackage。
  • 如果 live capability 仍缺失，阻塞归 Mindraw runtime availability，不归 m4c plugin implementation。

核心事实 / 变更快照

  • 变更对象：Codex plugin ~/plugins/mindraw
  • 事实来源：
  • 插件源码：~/plugins/mindraw
  • Codex installed cache：~/.codex/plugins/cache/personal/mindraw/0.1.0+codex.20260701142826
  • m4c 正式 QA commit：64832c2
  • Mindraw App capability 基线：MD-MCPE-01 commit 662333ba15c7c0f6d584d41113ca69e7cbcefbed
  • 变更前：
  • 插件壳能创建 registry / sidebar shell，但空项目或显式新建只返回 create blocker。
  • preview 只消费已存在 artifact。
  • desktop handoff 使用本地 open fallback 或能力 blocker。
  • 变更后：
  • create 使用 mindraw.app.create_blank_package。
  • preview 使用 mindraw.app.get_preview_snapshot。
  • open 使用 mindraw.app.open_package。
  • public state 脱敏 preview artifact path，不保存 raw bytes / dataURL。
  • mindraw@personal 安装启用，版本 0.1.0+codex.20260701142826。
  • 范围边界：
  • 未改 Mindraw 主仓源码。
  • 未安装、覆盖或替换 /Applications/Mindraw.app。
  • 未做完整 browser editor。
  • 未把 p.mindrawforcodex/02-P 纳入 m4c Git。
  • 未 direct package write，未手写 .mindraw / .assets。
  • 验证证据：
  • plugin validation PASS。
  • SkillSpector SAFE，score 0/100。
  • source plugin check/smoke PASS。
  • MCP stdio smoke PASS。
  • HTTP sidebar/API smoke PASS。
  • installed cache check/smoke PASS。
  • 本轮新增 QA 证据敏感扫描 PASS。

文件变更

  • ~/plugins/mindraw/lib/project-canvas.mjs
  • ~/plugins/mindraw/scripts/mindraw-canvas-service.mjs
  • ~/plugins/mindraw/mcp/server.mjs
  • ~/plugins/mindraw/skills/mindraw-open-canvas/SKILL.md
  • ~/plugins/mindraw/README.md
  • ~/plugins/mindraw/.codex-plugin/plugin.json
  • p.mindrawforcodex/03-O/K2.项目管理/联调QA/2026-07-01-M4C-MCPE-02PluginRetry.md
  • p.mindrawforcodex/03-O/C1.source/CODEGRAPH.md
  • p.mindrawforcodex/03-O/K2.项目管理/README.md
  • p.mindrawforcodex/INDEX.md
  • 02-P/plan-progress.markdown

未决问题

  • 标准 Mindraw runtime capability 在本轮最终复核时不存在，未完成真实 live App retry。
  • PM-MCPE-GATE 需要 PM 刷新 / 启动 Mindraw QA App 后复验用户触发语：
  • Open the Mindraw canvas for this project.
  • 若 live capability 仍缺 createBlankPackage / previewSnapshot / openPackage，下一步归属 Mindraw。

可复用命令 / Runbook

用途：复跑 M4C-MCPE-02 plugin retry 的 m4c 侧验证。

前置条件：

  • ~/plugins/mindraw 存在。
  • 需要 node、npm、codex CLI、skillspector。
  • 若要做真实 live Gate，先由 PM / Mindraw 刷新运行中的 Mindraw QA App，让标准 runtime capability 可用。

设置与验证命令：

npm run --prefix /Users/ar/plugins/mindraw check
node /Users/ar/plugins/mindraw/scripts/mindraw-canvas-service.mjs smoke --report /Users/ar/Projects/ExcalidrawX/p.mindrawforcodex/02-P/MEXP10-CodexPluginEntry/qa/m4c-mcpe-02-plugin-retry-smoke.json
node /Users/ar/plugins/mindraw/scripts/mindraw-canvas-service.mjs smoke-mcp --report /Users/ar/Projects/ExcalidrawX/p.mindrawforcodex/02-P/MEXP10-CodexPluginEntry/qa/m4c-mcpe-02-mcp-smoke.json
node /Users/ar/plugins/mindraw/scripts/mindraw-canvas-service.mjs smoke-http --report /Users/ar/Projects/ExcalidrawX/p.mindrawforcodex/02-P/MEXP10-CodexPluginEntry/qa/m4c-mcpe-02-http-smoke.json
python3 /Users/ar/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py /Users/ar/plugins/mindraw
skillspector scan /Users/ar/plugins/mindraw/skills/mindraw-open-canvas --no-llm --format markdown --output /Users/ar/Projects/ExcalidrawX/p.mindrawforcodex/02-P/MEXP10-CodexPluginEntry/qa/m4c-mcpe-02-skillspector.md
codex plugin add mindraw@personal
python3 /Users/ar/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py /Users/ar/.codex/plugins/cache/personal/mindraw/0.1.0+codex.20260701142826
npm run --prefix /Users/ar/.codex/plugins/cache/personal/mindraw/0.1.0+codex.20260701142826 check
node /Users/ar/.codex/plugins/cache/personal/mindraw/0.1.0+codex.20260701142826/scripts/mindraw-canvas-service.mjs smoke --report /Users/ar/Projects/ExcalidrawX/p.mindrawforcodex/02-P/MEXP10-CodexPluginEntry/qa/m4c-mcpe-02-installed-cache-smoke.json

敏感信息扫描：

rg -n "m4c-mcpe-02-mock-token|Bearer |Authorization|127\\.0\\.0\\.1:[0-9]+|mock-write-api\\.json|write-api\\.json|data:image|base64,|BEGIN (RSA|OPENSSH|PRIVATE)|app-specific|\\.p12" /Users/ar/Projects/ExcalidrawX/p.mindrawforcodex/02-P/MEXP10-CodexPluginEntry/qa/m4c-mcpe-02-plugin-retry-smoke.json /Users/ar/Projects/ExcalidrawX/p.mindrawforcodex/02-P/MEXP10-CodexPluginEntry/qa/m4c-mcpe-02-mcp-smoke.json /Users/ar/Projects/ExcalidrawX/p.mindrawforcodex/02-P/MEXP10-CodexPluginEntry/qa/m4c-mcpe-02-http-smoke.json /Users/ar/Projects/ExcalidrawX/p.mindrawforcodex/02-P/MEXP10-CodexPluginEntry/qa/m4c-mcpe-02-installed-cache-smoke.json /Users/ar/Projects/ExcalidrawX/p.mindrawforcodex/02-P/MEXP10-CodexPluginEntry/qa/m4c-mcpe-02-skillspector.md /Users/ar/Projects/ExcalidrawX/p.mindrawforcodex/03-O/K2.项目管理/联调QA/2026-07-01-M4C-MCPE-02PluginRetry.md

清理 / 恢复：

  • smoke 默认删除临时项目目录。
  • 若安装了新插件版本，可用 codex plugin list 确认 mindraw@personal 当前 enabled 版本。

搜索关键词：M4C-MCPE-02、Mindraw Codex plugin retry、createBlankPackage、previewSnapshot、openPackage、SkillSpector SAFE。

后续建议

  • PM 运行 PM-MCPE-GATE 前先确认 Mindraw live runtime 已刷新。
  • Gate 复验应覆盖真实用户触发语、项目根 MindrawCanvas/、首次创建、重复打开、preview、pan / zoom、编辑 / double-click。