2026-06-25 Mindraw 拖放

用户目标

继续推进 .mindraw Phase 2：验证并补齐 Tauri 目录包相关的选择、打开、保存、watch、拖放、路径校验和失败态，不进入全局链接 runtime 或 macOS package 注册。

已完成事项

• 补齐 Finder/Tauri drop 的文档路径分流：拖放路径中如果包含顶层 .mindraw 包或 .excalidraw 文件，先按文档打开；同批图片路径不再继续导入。
• 空画布状态也挂载 drop root，使没有 active file 时具备接收文档 drop 的前端路径。
• 增加自动化覆盖：
• getSupportedDroppedDocumentPaths() 保留顶层 .mindraw / .excalidraw，拒绝 .mindraw/drawing.excalidraw 内部路径并去重。
• openDroppedDocuments() 打开 .mindraw 包，且不会触发图片导入。
• 非文档路径返回 false，不调用 Tauri。
• 补强 Save As 失败态后端测试：
• 目标 .mindraw 已在其他 dirty tab 打开时拒绝覆盖。
• 无效 scene content 另存为 .mindraw 时不留下半包目录。
• 补齐 .mindraw 核心打开失败态文案：
• manifest 损坏提示 manifest missing/damaged/invalid。
• scene/hash 异常提示 scene damaged 或 hash mismatch。
• 非法资产路径提示 unsafe asset path。
• 保留后端 Details，失败时不切换当前 active tab。
• 重建本地 QA debug .app。
• 尝试真实 Finder 拖放 smoke：使用 /tmp/mindraw-phase2-drag-check、debug bundle、Finder reveal、cliclick 和 Computer Use 多次尝试；多屏坐标和工具 drag 接口未能稳定形成可被 Tauri 接收的 Finder 文件 drop 事件，因此该项未签 PASS。
• 完成原生 folder picker smoke：
• 直接输入 .mindraw 包路径会进入包目录内部，不能作为包路径返回。
• 回到父目录后选中 PickBoard.mindraw，Open 仍禁用，不能直接选择普通目录包。
• 选择父目录后，App 文件树显示 PickBoard，点击节点可成功打开 .mindraw tab。
• Picker smoke 清理时曾并行删除偏好备份导致自动恢复失败；随后已按 smoke 前可观察状态把 last_directory 修复为 /Users/ar/Desktop，并移除临时 recent 项。
• 完成 macOS 菜单结构修复：
• 发现 Tauri 自定义菜单首个 submenu 被 macOS 当作应用菜单，导致 Open Directory、Save、Save As... 误挂到 Mindraw 应用菜单下，菜单栏缺少独立 File。
• 在 src-tauri/src/menu.rs 新增标准 macOS app menu，把 File 放回独立菜单；macOS Quit 回到应用菜单。
• 验证 osascript 返回菜单栏 Apple, Mindraw, File, Edit, View, Window, Help，File 菜单含 Open Directory、New File、Save、Save As...、Export as Obsidian Excalidraw...、Recent Directories。
• 完成 Save As 原生面板 smoke：
• File > Save As... 可打开系统 Save sheet。
• Cmd+Shift+S 在 Computer Use smoke 中未打开 sheet，需后续真实键盘或更稳定自动化复测。
• Save sheet 中 SaveCopy.mindraw 保持 Save disabled，SaveCopy.excalidraw 可启用 Save；当前 .add_filter("Mindraw", ["mindraw"]) 不足以让用户通过原生 save panel 直接创建 .mindraw 包。

关键决策

• 不把自动化通过等同于真实 Finder 拖放 PASS；QA 报告中明确写为“真实 Finder 拖放 smoke 未可靠完成”。
• 不改变此前“不注册 macOS package、不提前 Phase 3.5”的边界；Finder / open -a 直接打开普通 .mindraw 目录包仍记录为 Phase 2 边界/后续 package 或 deep link 问题。

文件变更

• src/lib/imageDrop.ts
• src/lib/imageDrop.test.ts
• src/hooks/useMenuHandler.ts
• src/hooks/useMenuHandler.test.ts
• src/components/ExcalidrawEditor.tsx
• src-tauri/src/menu.rs
• 02-P/qa/mindraw-phase2-runtime-check.md
• 02-P/plan-progress.markdown
• CODEGRAPH.md

验证结果

• npm run test:run -- src/lib/imageDrop.test.ts src/hooks/useMenuHandler.test.ts src/lib/documentFormat.test.ts src/store/useStore.test.ts：PASS，4 个测试文件，64 个测试通过。
• cargo test --locked --manifest-path src-tauri/Cargo.toml mindraw_package_tests：PASS，17 个测试通过。
• cargo check --manifest-path src-tauri/Cargo.toml：PASS。
• npm run build：PASS。
• npm run tauri -- build --debug --bundles app：PASS，生成本地 QA debug .app；菜单修复后已重新运行。
• macOS 菜单结构 smoke：PASS，File 菜单恢复独立。
• Save As 原生面板 smoke：PARTIAL / FAIL，菜单项能打开 sheet，但 .mindraw 文件名不能启用 Save；Cmd+Shift+S 仍待复测。
• git diff --check：PASS。
• cargo fmt --manifest-path src-tauri/Cargo.toml：未执行成功，当前 stable toolchain 未安装 cargo-fmt / rustfmt。

未决问题

• 真实 Finder 拖放 .mindraw 到 App 仍需人工或更稳定 UI 自动化复测。
• 原生 Save As 直接创建 .mindraw 包已实测未达标，需要后续专门入口、默认保存策略或文件选择器方案。
• Cmd+Shift+S Save As 快捷键在本轮自动化 smoke 中未触发，需要真实键盘或更稳定自动化复测。
• 真实 Finder 拖放 smoke 和更完整失败态人工矩阵仍未完成。
• 原生 folder picker 直接选择 .mindraw 包已实测失败；后续若要直接选包，需要 macOS package 注册、deep link 或专门“Open Mindraw Package”入口。
• Finder / open -a 直接打开普通 .mindraw 目录包仍受“不注册 macOS package”的 MVP 边界限制。

后续建议

• 下一步优先收口 Phase 2 剩余可验证项：Save As .mindraw 原生面板方案、Cmd+Shift+S 复测、真实 Finder 拖放、失败态文案矩阵。
• 如果继续卡在真实 Finder 拖放自动化，应让人工手测补证据，或先建立可稳定触发 Tauri onDragDropEvent 的 UI 自动化方案。