# 2026-06-30 MEXP08B m4c 复跑补证

## 用户目标

用户要求 Coder@m4c 领取统一台账 `P-20260630-mexp08b-external-model-writeback` 的 `M4C-MEXP08B-03`，基于 Mindraw `MD-MEXP08B-02` 刷新后的 live capability，完成外部 PNG result Frame live writeback retry。若当前 TL 目标包仍因 source Frame 本体缺失而无法写回，则使用包含有效 source Frame 的 demo 安全副本完成端到端能力闭环。

## 已完成事项

- 读取并遵守主项目与 m4c 本地规则、统一台账、Mindraw `MD-MEXP08B-02` capability refresh QA、m4c 现有 runner 与 MEXP08B-02 证据。
- 确认 Mindraw live capability 当前暴露 `createAiResultFrameImageResult="write"`。
- 增强 m4c runner `m4c-external-image-writeback-runner.mjs`：
  - 支持 `M4C-MEXP08B-03` 默认 QA / checklist 路径。
  - 支持 `--live-context` 从 Mindraw live frame-only DTO 构建 sanitized writeback package。
  - 支持显式 `--package` / `--document-id` / `--source-frame-id` 目标参数。
  - commit 前后计算安全副本 digest，记录 resultFrameId、createdFileIds、savedByMindrawAppApi。
  - 修正路径脱敏，避免把布尔字段误替换为 `<redacted-path>`。
- 使用 demo 安全副本完成端到端写回：
  - 安全副本：`p.mindrawforcodex/02-P/MEXP08B-ExternalModelWriteback/work/m4c-mexp08b-03-20260630030553/MEXP01-ai-frame-demo-safe-copy.mindraw`
  - documentId：`mdoc_m4c_annotated_frame_20260626`
  - sourceFrameId：`frame_ai_annotation_001`
  - resultFrameId：`frame_result_m4c-mexp08b-03-1782759960777`
  - createdFileIds：`file_result_m4c-mexp08b-03-1782759960777`
  - 结论：`PASS_APP_API_WRITEBACK`
- 只读重读安全副本，确认 result Frame、result image、created file dataURL 和 `.assets` 中的 PNG hash / byte size 存在。
- 更新统一台账 `M4C-MEXP08B-03` 与 Progress Log。
- 提交 m4c `03-O` 正式输出区 commit：`988c0267ebb485bce824dac92a0decb9acc6ac29`。

## 关键决策

- 旧 TL 目标包当前问题不再归因于 image result capability；它是 target fixture / document-state 风险。若要验证旧 TL 包本身，需要 PM / 用户提供仍含 source Frame 本体的有效包或重新选择 source Frame。
- 本轮 PASS 证明 m4c + Mindraw App API 的外部 PNG result writeback 能力闭环成立，但不等同于旧 TL 包已可写。
- m4c 未 direct-write `.mindraw` 或 `.assets`，未把整份 `.mindraw` 作为 promptable context。

## 文件变更

- `p.mindrawforcodex/03-O/C3.tools/scripts/m4c-external-image-writeback-runner.mjs`
- `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/03-O/K2.项目管理/联调QA/2026-06-30-M4C-MEXP08B-03LiveImageWriteback.md`
- `p.mindrawforcodex/INDEX.md`
- `02-P/plan-progress.markdown`

## 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 --task-id M4C-MEXP08B-03 --live-context --package <safe-copy.mindraw> --document-id mdoc_m4c_annotated_frame_20260626 --source-frame-id frame_ai_annotation_001`：PASS
- `git -C p.mindrawforcodex/03-O diff --check`：PASS
- `git -C p.mindrawforcodex/03-O diff --cached --check`：PASS
- 本轮 MEXP08B-03 QA 窄范围敏感扫描：PASS，无 bearer token、authorization 明文、runtime endpoint、base64 image bytes、私钥或 `.p12` 泄漏。
- `p.mindrawforcodex/03-O` 状态：clean。

## 未决问题

- 旧 TL 目标包 `/Users/ar/Desktop/26.0629.2133-TL-优化.mindraw` 仍需 PM / 用户提供有效 source Frame 本体后，才能做该包自己的 live writeback 验收。
- `p.mindrawforcodex/02-P` 过程证据仍按规则不纳入 m4c Git。
- `p.mindrawforcodex/INDEX.md` 位于 m4c `03-O` Git 根之外，本轮按项目索引更新但未纳入 m4c commit。

## 后续建议

- PM 可进入 `PM-MEXP08B-GATE` 复核能力闭环证据。
- 如 PM 要验收旧 TL 包，应先派出或要求提供新的有效 source Frame / 安全副本，再由 m4c 使用同一 runner 复跑。