edit | blame | history | raw

M4C-BUNDLE-02 预览复验

日期：2026-07-02

用户目标

以 Coder@m4c 身份领取并完成 M4C-BUNDLE-02：在 MD-BUNDLE-02 修复 Mindraw App 侧 high-fidelity PNG preview artifact 后，复跑 mindraw@personal Codex plugin 的 source / installed cache 展示、HTTP/sidebar、MCP、SkillSpector、截图和敏感信息检查，并回写主项目统一台账。

已完成事项

  • 复核 MD-BUNDLE-02 输入：Mindraw preview source 已变为 mindraw-full-canvas-excalidraw-png-preview-v1，artifact 为 preview/preview.png。
  • 复跑 source plugin validation、npm run check、lifecycle / HTTP / MCP smoke，全部 PASS。
  • 复跑 installed cache validation、npm run check、lifecycle / HTTP / MCP smoke，全部 PASS。
  • 复跑 source / installed SkillSpector，均为 SAFE、score 0、LOW、0 issues。
  • 新增 live PNG preview smoke，证明 source 与 installed cache 均能通过 /api/state 表达 mimeType=image/png，并通过 /api/preview stream 输出 PNG。
  • 保存 Safari cropped sidebar 截图，证明 sidebar 中不再是灰色 image 占位框。
  • 写入 m4c 正式 QA 文档并提交 m4c 03-O。
  • 回写主项目统一台账 P-20260701-app-codex-plugin-acceptance-bundle 的 M4C-BUNDLE-02 任务卡和 Progress Log。

核心事实 / 变更快照

  • 变更对象：mindraw@personal 对 Mindraw App preview artifact 的消费结论。
  • 事实来源：
  • p.mindrawforcodex/03-O/K2.项目管理/联调QA/2026-07-02-M4C-BUNDLE-02PreviewFidelity.md
  • p.mindrawforcodex/02-P/MEXP13-AcceptanceBundle/qa/m4c-bundle-02-source-live-png-preview.json
  • p.mindrawforcodex/02-P/MEXP13-AcceptanceBundle/qa/m4c-bundle-02-installed-live-png-preview.json
  • m4c 03-O commit：2d23380d63151608beb90ec91781e496dfa58de9
  • 变更前：MEXP13 用户验收失败，原因是 sidebar preview 与 Mindraw desktop 视觉差异过大；旧 1.2.0 / Build202607020214 DMG 内的 preview 实现仍会产生低保真 SVG 近似结果。
  • 变更后：MD-BUNDLE-02 live runtime 下，source / installed plugin 均可消费 PNG high-fidelity artifact。
  • PNG 元数据：MIME image/png，source mindraw-full-canvas-excalidraw-png-preview-v1，尺寸 647 x 556，byteLength 31919，SHA256 d59c7b4954e1ebc17e8ffa462a0f1abe33978f57017229930f5296cadb41e3bb。
  • 范围边界：本轮未修改 plugin source、skill 或 manifest；未刷新 cachebuster；installed cache 继续使用 0.1.0+codex.20260701174929；未重打 Mindraw App DMG。
  • 发布边界：旧 1.2.0 / Build202607020214 DMG 不包含 MD-BUNDLE-02 修复，不能直接回到用户验收；下一步需要 PM 决定并派发 refreshed DMG / bundle rebuild。

文件变更

  • 新增：p.mindrawforcodex/03-O/K2.项目管理/联调QA/2026-07-02-M4C-BUNDLE-02PreviewFidelity.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
  • 新增过程证据：p.mindrawforcodex/02-P/MEXP13-AcceptanceBundle/qa/m4c-bundle-02-*.json
  • 新增截图：p.mindrawforcodex/02-P/MEXP13-AcceptanceBundle/qa/browser-m4c-bundle-02/source-safari-sidebar.png

可复用命令 / Runbook

用途：复跑 mindraw@personal source / installed cache 的 MEXP13 preview fidelity 基础验证。

前置条件：

  • Mindraw live runtime 已包含 MD-BUNDLE-02 修复。
  • ~/plugins/mindraw 与 installed cache ~/.codex/plugins/cache/personal/mindraw/0.1.0+codex.20260701174929 存在。
  • QA 输出目录为 p.mindrawforcodex/02-P/MEXP13-AcceptanceBundle/qa/。

基础验证命令：

QA=/Users/ar/Projects/ExcalidrawX/p.mindrawforcodex/02-P/MEXP13-AcceptanceBundle/qa

python3 /Users/ar/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py /Users/ar/plugins/mindraw
npm run --prefix /Users/ar/plugins/mindraw check
node /Users/ar/plugins/mindraw/scripts/mindraw-canvas-service.mjs smoke-lifecycle --report "$QA/m4c-bundle-02-source-lifecycle-smoke.json"
node /Users/ar/plugins/mindraw/scripts/mindraw-canvas-service.mjs smoke-http --report "$QA/m4c-bundle-02-source-http-smoke.json"
node /Users/ar/plugins/mindraw/scripts/mindraw-canvas-service.mjs smoke-mcp --report "$QA/m4c-bundle-02-source-mcp-smoke.json"

CACHE=/Users/ar/.codex/plugins/cache/personal/mindraw/0.1.0+codex.20260701174929
python3 /Users/ar/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py "$CACHE"
npm run --prefix "$CACHE" check
node "$CACHE/scripts/mindraw-canvas-service.mjs" smoke-lifecycle --report "$QA/m4c-bundle-02-installed-lifecycle-smoke.json"
node "$CACHE/scripts/mindraw-canvas-service.mjs" smoke-http --report "$QA/m4c-bundle-02-installed-http-smoke.json"
node "$CACHE/scripts/mindraw-canvas-service.mjs" smoke-mcp --report "$QA/m4c-bundle-02-installed-mcp-smoke.json"

skillspector scan /Users/ar/plugins/mindraw/skills/mindraw-open-canvas --no-llm --format json --output "$QA/m4c-bundle-02-source-skillspector.json"
skillspector scan "$CACHE/skills/mindraw-open-canvas" --no-llm --format json --output "$QA/m4c-bundle-02-installed-skillspector.json"

live PNG preview smoke 本轮使用临时 Node 脚本完成，关键断言为：

  • source 与 installed ok=true
  • /api/state.preview.mimeType=image/png
  • /api/state.preview.source=mindraw-full-canvas-excalidraw-png-preview-v1
  • /api/preview SHA256 等于 d59c7b4954e1ebc17e8ffa462a0f1abe33978f57017229930f5296cadb41e3bb
  • 报告不保存 raw bytes、data URL、loopback URL、runtime capability path 或 bearer value。

未决问题

  • 需要 PM 决定并派发新的 Mindraw App DMG / bundle rebuild；旧 Build202607020214 不包含预览修复。
  • 浏览器证据使用 Safari cropped screenshot 替代 Playwright，原因是当前机器 Playwright Chromium binary 缺失且 Safari WebDriver 未启用。

后续建议

  • PM 收敛 M4C-BUNDLE-02 后，派发 Mindraw 侧 refreshed DMG 任务。
  • 新 DMG 产出后，再派 m4c 做新的 bundle runbook / re-Gate，而不是复用旧 Build202607020214 的验收结论。