edit | blame | history | raw

M4C-GH-02 人工 GUI 闭环

用户目标

由固定 QA 准备 A/B QA-only 画布，Owner 只负责在 WebView 手工输入并保存不同 marker；QA 完成 preview refresh、A/B 内容隔离、provenance 和现场清理，给出正式终态。

已完成事项

  • Project A / B 均通过 GH-02 候选真实 openPackage API 打开。
  • Owner 分别保存 M4C-GH02-A-260713 与 M4C-GH02-B-260713。
  • App 真实 previewSnapshot 对 A/B 均返回 READY，full-canvas PNG 与 Owner 截图一致。
  • A-only/B-only marker 隔离、不同 path/document ID/hash 与无 stale service 串线均 PASS。
  • App 正常退出，进程为 0，runtime capability 已清理。
  • 正式 QA 报告/JSON 与统一台账更新为 PASS。

关键决策

marker 是自由手绘 strokes，不能用 literal string grep 判断内容；采用 Owner 保存截图 + App 生成 full-canvas preview PNG 的双重视觉复核，并辅以 path、document ID、source-content SHA 和 preview SHA 证明项目隔离。

核心事实 / 变更快照

  • 任务终态：PM_NOTIFY_READY QA-M4C-GH-02-OWNER-GUI-ASSIST RESULT=PASS。
  • A：mdoc_18c1bc161e6522d0_17b85；preview SHA 9846fd40ba735139c43b21d2f5061ac4d01b0989abb4c31bcd6f7bd69910d59e；source SHA 8e975f7a2f194d050befc4cefb807e64184ac38f194bc6dfdb0f79824bac1971。
  • B：mdoc_18c1bc161f0c7e90_17b85；preview SHA fe754fe7a5b9387c772a89f53ce7f9361ca3356ade3259cd5a9c8bcc616f9495；source SHA 500222a6605c37b2e8775d34a2592f5030fccd6d3eba5402f0b0056b94b093af。
  • 变更前：正式 public candidate QA 为 PARTIAL，缺 save-refresh 与 marker isolation。
  • 变更后：正式 public candidate QA 为 PASS；仍不代表 PMO release GO 或 GitHub publication。
  • 证据：02-P/M4C-GitHubOpenSource/qa/qa-m4c-gh-02-public-candidate-evidence-20260712/owner-gui-assist-20260713/。

文件变更

更新正式 QA 报告/JSON、02-P/plan-progress.markdown、02-P/PMO_INBOX.md；新增 QA 证据和本会话记录。未改源码、candidate、App、DMG 或 GitHub。

可复用命令 / Runbook

用途：对既有 QA-only Project A/B 调用真实 App preview，并确认现场恢复。前置条件是 Mindraw 1.2.4 / Build202607071930 已启动且 capability healthy。

LIB='/Users/ar/Projects/Mindraw/P2.mindrawforcodex/03-O/C2.builds/M4C-GitHubOpenSource/mindraw4agent-0.1.3-public-source-candidate-GH20260712135055-M4C-GH-02/source/plugins/mindraw/lib/project-canvas.mjs'
node --input-type=module -e 'const {inspectProjectCanvas}=await import(process.argv[1]); console.log(JSON.stringify(await inspectProjectCanvas({projectRoot:process.argv[2],createNew:false}),null,2))' "$LIB" '/private/tmp/qa-m4c-gh-02-real-app-20260713/project-a'
node --input-type=module -e 'const {inspectProjectCanvas}=await import(process.argv[1]); console.log(JSON.stringify(await inspectProjectCanvas({projectRoot:process.argv[2],createNew:false}),null,2))' "$LIB" '/private/tmp/qa-m4c-gh-02-real-app-20260713/project-b'

验证：两份 JSON 的 status 均为 READY，且 path/document ID/preview SHA/source-content SHA 分别独立。清理：正常退出 Mindraw，然后确认 App 进程为 0、~/Library/Application Support/com.mindraw.desktop/runtime/write-api.json 不存在。

搜索关键词：QA-M4C-GH-02-OWNER-GUI-ASSIST、previewSnapshot、M4C-GH02-A-260713、M4C-GH02-B-260713。

未决问题与后续建议

QA 无未决缺口。下一步由 PMO 消费 PASS 并执行 PM-M4C-GH-GATE；不得把 QA PASS 直接等同于 release GO。