edit | blame | history | raw

2026-06-30 MEXP08B m4c 收口

用户目标

以 Coder@m4c 身份领取统一台账 P-20260630-mexp08b-external-model-writeback 的 M4C-MEXP08B-01，完成 m4c 侧外部模型 PNG 结果包 / writeback runner：消费已确认的 frame-only context 与 MEXP08A 已验收 PNG，生成 sanitized writeback request/package；Mindraw capability 可用时只能通过 Mindraw App API / lease 发起写回，不得 direct-write .mindraw 或手写 .assets。

已完成事项

  • 新增 m4c runner：p.mindrawforcodex/03-O/C3.tools/scripts/m4c-external-image-writeback-runner.mjs。
  • runner 支持 build、run、smoke、help：
  • build 生成 m4c.externalImageResultWriteback.v1 sanitized package。
  • run 读取当前 Mindraw runtime capability、检查 health/capabilities，并仅在图片 result writeback capability 存在时走 App API。
  • smoke 生成过程 QA JSON / check Markdown 与正式 QA checklist。
  • 生成过程证据：
  • p.mindrawforcodex/02-P/MEXP08B-ExternalModelWriteback/qa/m4c-mexp08b-01-sanitized-writeback-package.json
  • p.mindrawforcodex/02-P/MEXP08B-ExternalModelWriteback/qa/m4c-mexp08b-01-external-image-writeback-runner.json
  • p.mindrawforcodex/02-P/MEXP08B-ExternalModelWriteback/qa/m4c-mexp08b-01-external-image-writeback-runner-check.md
  • 生成正式 QA 记录：
  • p.mindrawforcodex/03-O/K2.项目管理/联调QA/2026-06-30-M4C-MEXP08B-01ExternalImageWriteback.md
  • 同步 m4c 索引 / 工程地图：
  • p.mindrawforcodex/03-O/C3.tools/README.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-MEXP08B-01 标记为完成，但结论为 PREPARED_BLOCKED_BY_MD_MEXP08B_01_IMAGE_WRITEBACK_API。

关键决策

  • m4c 只产出 sanitized package 和 App API 调用路径，不在 capability 不足时绕过 Mindraw。
  • 当前 live Mindraw capability 只有既有 createAiResultFrame / lease / live context 能力，未声明 externalImageResultFrame.write 或等价图片 result 写回能力。
  • 因此 m4c 返回精确 blocker：MINDRAW_IMAGE_RESULT_WRITEBACK_UNAVAILABLE，下一步归属 MD-MEXP08B-01。

QA 结论

  • node --check p.mindrawforcodex/03-O/C3.tools/scripts/m4c-external-image-writeback-runner.mjs：PASS。
  • node p.mindrawforcodex/03-O/C3.tools/scripts/m4c-external-image-writeback-runner.mjs help：PASS。
  • node p.mindrawforcodex/03-O/C3.tools/scripts/m4c-external-image-writeback-runner.mjs smoke：PASS，结论为预期 blocker MINDRAW_IMAGE_RESULT_WRITEBACK_UNAVAILABLE。
  • package 断言：readScope=frame-only、outsideTextIncluded=false、fallbackToDocumentRead=false、documentReadFallbackAllowed=false、不包含图片 bytes、本机输入路径、runtime endpoint 或 token。
  • 泄漏扫描：过程 QA / 正式 QA 中未发现 bearer token、runtime endpoint、capability path、private key、API key、.p12、图片 base64 或 PNG bytes。
  • git -C p.mindrawforcodex/03-O diff --check：PASS。

Git 证据

  • m4c 03-O commit：54f3f1e5cb613b4741cb8227d2e14c7614983d57。
  • commit message：feat: add MEXP08B external image writeback runner。
  • commit 后 m4c 03-O 工作区 clean。

未决问题

  • Mindraw 侧 MD-MEXP08B-01 仍需补外部 PNG result Frame 写回 capability / controlled mutation，并解决图片传输与 .assets 权威写入。
  • PM-MEXP08B-GATE 仍需等待 Mindraw 侧完成后再执行，不能因 m4c package builder 完成而提前 Gate。

后续建议

  • MD-MEXP08B-01 完成后，PM 可要求 m4c 复跑同一 runner；若 capability 增加 externalImageResultFrame.write 或等价能力，m4c 才能进入 App API 写回路径。
  • 复跑时继续使用现有 sanitized package / QA 路径，避免重新引入 direct package write 或 .assets 手写路径。