edit | blame | history | raw

2026-06-26 Phase 3.7 分发契约

用户目标

  • 用户确认可以推进 Phase 3.7。
  • 用户同意第一批范围限定为：Companion App Distribution Spec、QA/doctor 检测契约、plan-progress 更新。
  • 明确不进入生产代码、不重新打包、不做签名公证、不做 Windows 安装器。

已完成事项

  • 新增 02-P/功能任务/companion-app-distribution-spec.md，定义 Mindraw companion app 分发边界、最低版本、平台支持状态、m4c 依赖契约、安装/升级引导和 fresh machine gate。
  • 新增 02-P/qa/mindraw-phase37-companion-doctor-contract.md，定义 doctor/preflight 输出结构、诊断码、macOS 检测路径、场景矩阵和用户修复文案。
  • 更新 02-P/plan-progress.markdown：
  • Phase 3.7 从 Backlog 调整为 Active 的第一批契约。
  • 最低候选基线锁到 0.8.3 / Build202606261221。
  • 记录当前 build 号不能从安装后的 App 元数据稳定读取，只能从 DMG 文件名或 release manifest 作为证据判断。
  • 下一步改为基于契约实现 doctor/preflight POC。
  • 更新 INDEX.md，新增两份 3.7 文档入口。

关键决策

  • m4c 首版不静默同装 Mindraw App，不自动下载或替换 /Applications/Mindraw.app。
  • m4c / doctor 最低 Mindraw 依赖建议为 0.8.3+，因为 0.8.3 已包含 .mindraw package、deep link、native picker、Save As 分流和 Finder 双击热修。
  • Phase 3.7 当前只解决“检测、引导、证据和边界”，不解决 Phase 3.8 的 App 写入协调 / document lease，也不解决 Phase 4 AssetStore。
  • Windows / PC 暂不声明正式支持，直到有安装器、协议注册、文件关联、UAC、路径/Unicode、卸载和真实机 smoke 证据。

文件变更

  • 02-P/功能任务/companion-app-distribution-spec.md
  • 02-P/qa/mindraw-phase37-companion-doctor-contract.md
  • 02-P/plan-progress.markdown
  • INDEX.md

验证结论

  • git diff --check -- 02-P/功能任务/companion-app-distribution-spec.md 02-P/qa/mindraw-phase37-companion-doctor-contract.md 02-P/plan-progress.markdown INDEX.md 通过。
  • 本轮未修改 src/、src-tauri/，未重新打包，未执行生产代码测试。

未决问题与后续建议

  • 下一步可以进入 doctor/preflight POC，只读检测 /Applications/Mindraw.app、版本、bundle id、URL scheme 和 .mindraw document type。
  • 真实 open <file>.mindraw 与 open "mindraw://..." smoke 应只在 QA 模式或用户明确触发时执行。
  • 若未来需要让 doctor 精确判断 build，Mindraw App 需要新增安装后可读的 build/capability metadata。
  • 工作区仍有非本轮改动和未跟踪项，尤其是 INDEX.md 中 m4c 目录说明已有改动；本轮未回退这些内容。