edit | blame | history | raw

2026-07-04 MD-BUNDLE-06

用户目标

作为 Mindraw 项目的 coder，按项目入口规则接手 MD-BUNDLE-06，修复 MEXP13 中 sidebar 编辑后 Mindraw App 不前置 / 聚焦，以及 App 保存后 sidebar preview 继续消费旧图的问题。

已完成事项

  • 读取并按顺序确认 AGENTS.md、INDEX.md、02-P/plan-progress.markdown、CODEGRAPH.md、MD-BUNDLE-06 派工，以及研发项目相关全局规则。
  • App 侧实现完成：activate_mindraw_window 尽力 show / unminimize / focus，并请求 informational user attention；mindraw.app.open_package 返回更完整 focus diagnostics。
  • Preview refresh source 完成：full-canvas PNG preview artifact 继续按 source hash 写入 preview/preview-<sourceHash>.png，返回 / manifest 写入 cacheKey；native PREVIEW_SOURCE_STALE 等 freshness 错误码透传为 JSON-RPC error.code。
  • 已创建 QA 证据 02-P/MEXP13-AcceptanceBundle/qa/md-bundle-06-app-focus-preview-refresh-check-20260702.md 和 .json。

关键决策

  • 不把本轮实现声明为项目交付或 PM Gate 通过；Review Gate crg-a9477db1d447 尚未 PASS，因此 PM_NOTIFY_READY 保持 withheld。
  • 不在本轮重打 DMG；如后续 PM 派发 packaging，目标版本按规则不得低于 1.2.3。
  • Rust 验证使用 fresh CARGO_TARGET_DIR=/tmp/mindraw-md-bundle-06-cargo-target，避开既有 src-tauri/target 中残留的旧 /Users/ar/Projects/ExcalidrawX generated path。

文件变更

  • src-tauri/src/lib.rs
  • src/lib/mindrawProjectCanvasApi.ts
  • src/lib/mindrawAppApiTransport.test.ts
  • CHANGELOG.md
  • CODEGRAPH.md
  • 02-P/plan-progress.markdown
  • 02-P/MEXP13-AcceptanceBundle/qa/md-bundle-06-app-focus-preview-refresh-check-20260702.md
  • 02-P/MEXP13-AcceptanceBundle/qa/md-bundle-06-app-focus-preview-refresh-check-20260702.json
  • 删除未跟踪 AppleDouble 元数据 src-tauri/capabilities/._default.json，用于解除 Tauri capability 读取阻塞。

验证结论

  • PASS: npm run test:run -- src/lib/mindrawAppApiTransport.test.ts
  • PASS: CARGO_TARGET_DIR=/tmp/mindraw-md-bundle-06-cargo-target cargo test --manifest-path src-tauri/Cargo.toml preview
  • PASS: npm run test:run -- src/lib/mindrawProjectCanvasPreview.test.ts src/lib/mindrawAppApiTransport.test.ts src/lib/mindrawAppReadApi.test.ts
  • PASS: CARGO_TARGET_DIR=/tmp/mindraw-md-bundle-06-cargo-target cargo test --manifest-path src-tauri/Cargo.toml app_api_transport
  • PASS: npm run build
  • PASS with existing Git metadata warnings: git diff --check

未决问题

  • Review Gate crg-a9477db1d447 仍需代码审核员给出 PASS / CHANGES_REQUESTED / BLOCKED。
  • M4C-BUNDLE-06 仍需 PMO 真实投递并核验，sidebar live refresh / edit focus feedback 不能由 Mindraw App 侧单独宣布完成。
  • 当前 worktree 有大量既有脏改与 AppleDouble / Git metadata warnings，本轮只处理阻塞验证的单个未跟踪 capability 元数据文件。

后续建议

  • Review Gate PASS 后，由 PM 决定是否派发 refreshed DMG packaging；若派发，新版本目标不低于 1.2.3。
  • PM 收齐 Mindraw App 侧 review、QA 和 m4c 侧证据后，再做 MEXP13 Go / No-Go 与用户复验安排。