2026-06-30 MEXP08B 写回

用户目标

以 coder2@mindraw 身份领取并完成 MD-MEXP08B-01：让 Mindraw 侧支持外部模型 image result package 通过 App API / controlled mutation 写回 source Frame 右侧 result Frame，并进入 Mindraw-controlled .assets 链路。

已完成事项

• 扩展 createAiResultFrame mutation，新增可选 imageResult.kind="external-image-result"。
• imageResult 校验 base64 image dataURL、mime、尺寸、byteLength / sha256、raw bytes 上限和本机路径泄漏。
• 成功写回时创建右侧 result Frame、image element 和 referenced files[fileId]。
• file metadata 标记 source.kind="ai-generation"、privacy="no-original-path"，保存仍走 saveTab() / save_mindraw_package，由既有 AssetStore dual 路径登记 .assets。
• App API capability 增加非破坏性 createAiResultFrameImageResult="write"。
• Transport request body 上限从 1 MiB 提升到 8 MiB，覆盖已验收 PNG base64 JSON-RPC 请求体。
• 新增 QA 证据 02-P/qa/mindraw-mexp08b-external-image-writeback-check.md / .json。
• 同步 INDEX.md、CODEGRAPH.md、CHANGELOG.md 和 02-P/plan-progress.markdown。

关键决策

• 不新增任意 JSON patch 或直接 .assets API；继续复用既有 read / lease / controlled commit / save path。
• m4c 最小 contract 是既有 mindraw.app.commit_write_result，mutation kind 仍为 createAiResultFrame，新增 imageResult 字段。
• m4c 不需要 .assets 路径，只提交 sanitized image bytes package；Mindraw 是唯一权威资产写入者。

验证

• npm run test:run -- src/lib/mindrawAppWriteMutation.test.ts src/lib/mindrawAppWriteApi.smoke.test.ts src/lib/mindrawAppApiTransport.test.ts src/lib/mindrawAppReadApi.test.ts：PASS，4 files / 34 tests。
• cargo test --manifest-path src-tauri/Cargo.toml app_api_transport：PASS，5 tests。
• cargo test --manifest-path src-tauri/Cargo.toml mexp05_save_preserves_simulated_generated_asset_source_kind：PASS。
• cargo check --manifest-path src-tauri/Cargo.toml：PASS。
• npm run doctor:mindraw:test：PASS，15 tests。
• npm run build：PASS，仅既有 Vite warning。
• 已验收 MEXP08A PNG：854506 bytes；JSON-RPC body 约 1139615 bytes，小于 8 MiB transport 上限。

未决问题

• 需要 PM 通知 m4c 基于新 capability 复跑 M4C-MEXP08B-01 runner / writeback。
• PM-MEXP08B-GATE 仍由 PM 收敛；coder2 不直接宣布端到端 Gate 通过。