edit | blame | history | raw

Phase 3.6.1 收尾

日期：2026-06-26

用户目标

用户确认先做 Phase 3.6.1。目标是继续补齐 .mindraw native 文件体验：active .mindraw 的普通 Save As... 应创建新的 .mindraw 目录包，并提供原生 picker 直接打开 .mindraw package document。

已完成事项

  • 版本提升到 0.8.2。
  • 新增 File > Open Mindraw Package... 菜单项。
  • 新增 Tauri command select_mindraw_package，原生 picker 可返回 .mindraw package path。
  • 新增前端 openMindrawPackageFromPicker()，picker 选包后走 openDirectoryOrDocument() 打开。
  • 新增 saveCurrentFileAs()，active .mindraw 普通 Save As... 分流到 save_mindraw_package_as；普通 .excalidraw 仍走 save_file_as。
  • 为 Save As 增加安全建议文件名：.mindraw 使用 原名 copy.mindraw，.excalidraw 使用 原名 copy.excalidraw；后端只接收文件名，不接收路径片段。
  • 补齐前端和 Rust 回归测试。
  • 更新 CHANGELOG.md、CODEGRAPH.md、INDEX.md、02-P/plan-progress.markdown、03-O/C2.builds/README.md。
  • 新增 QA 报告：02-P/qa/mindraw-phase361-native-file-polish-check.md。
  • 生成并安装本机 DMG：03-O/C2.builds/releases/Build202606260113/Mindraw_0.8.2_aarch64-Build202606260113.dmg。
  • 创建冻结提交和 tag：
  • Commit: 7d93c4d，Release 0.8.2 native file polish
  • Tag: v0.8.2-Build202606260113

关键决策

  • Phase 3.6.1 作为 Phase 3.6 后的小阶段记录，不改写 Phase 3.6 的历史边界。
  • Open Mindraw Package... 不替代 Open Directory；它是专门选择 .mindraw package document 的 native 文件入口。
  • 专用 Save As Mindraw Package... 保留，用于从 .excalidraw 显式转存 .mindraw；active .mindraw 下普通 Save As... 直接走 package save flow。
  • release 仍为本地 ad-hoc 签名测试包，不是 Developer ID 签名或公证包。

文件变更

  • src/hooks/useMenuHandler.ts
  • src/hooks/useMenuHandler.test.ts
  • src-tauri/src/lib.rs
  • src-tauri/src/menu.rs
  • package.json
  • src-tauri/Cargo.toml
  • src-tauri/tauri.conf.json
  • CHANGELOG.md
  • CODEGRAPH.md
  • INDEX.md
  • 02-P/plan-progress.markdown
  • 02-P/qa/mindraw-phase361-native-file-polish-check.md
  • 03-O/C2.builds/README.md
  • 03-O/C2.builds/releases/Build202606260113/release-manifest.txt（构建产物目录记录，未纳入 Git）

验证结论

  • npm run test:run -- src/hooks/useMenuHandler.test.ts：PASS，24 个测试通过。
  • npm run test:run -- src/store/useStore.test.ts src/hooks/useKeyboardShortcuts.test.tsx src/lib/mindrawDeepLink.test.ts src/lib/documentFormat.test.ts：PASS，49 个测试通过。
  • 合并目标前端回归：PASS，5 个测试文件 / 73 个测试通过。
  • cargo test --manifest-path src-tauri/Cargo.toml：PASS，38 个测试通过。
  • cargo check --manifest-path src-tauri/Cargo.toml：PASS。
  • npm run build：PASS，仍有既有字体、dialog dynamic/static import 和 chunk size warning。
  • BUILD_ID=202606260113 npm run package:mindraw：PASS。
  • release .app 经 ad-hoc 重签名后 codesign --verify --deep --strict：PASS。
  • /Applications/Mindraw.app 安装版版本为 0.8.2，strict codesign：PASS。
  • .mindraw package mdls 显示 com.mindraw.document，type tree 包含 com.apple.package：PASS。
  • 安装版 active .mindraw 普通 Save As... 生成新 .mindraw 包：PASS。
  • 安装版 Open Mindraw Package... picker 可直接选择 .mindraw package 并返回主窗口打开：PASS。
  • DMG SHA256：8833797e7c00bbe7751e5745ce91e3bec0708ed980eab316364901ec1a4210be。

未决问题

  • cargo fmt --manifest-path src-tauri/Cargo.toml -- --check 仍因本机 stable toolchain 未安装 rustfmt 未执行成功。
  • cargo test --locked --manifest-path src-tauri/Cargo.toml 因版本提升后本地 ignored Cargo.lock 需要更新而未执行成功，已用非 locked Rust 全量测试替代。
  • Finder 真实拖放 .mindraw 文档 smoke 仍只保留自动化覆盖，后续需要更稳定 UI 自动化或人工补证据。
  • release 包仍未 Developer ID 签名、公证，也未做 fresh machine 验证。
  • Windows / PC 文件关联、协议注册和安装器仍未开始。

后续建议

  • 下一阶段建议进入 Phase 3.7 Companion App Distribution：最低版本检测、安装引导、协议/文件关联诊断、m4c doctor 接口。
  • 若继续打磨 native 文件体验，优先补 Finder 真实拖放 smoke、签名公证 fresh machine 验证，以及 TCC 权限提示的首次使用说明。