# 2026-06-25 Mindraw选择

## 用户目标

继续向 Phase 3.5 前的完整 `.mindraw` 格式推进；本轮聚焦 Phase 2 剩余的目录包选择、系统打开边界和失败态状态保护。

## 已完成事项

- 新增 `openDirectoryOrDocument()` store 入口：
  - 普通目录继续执行 `loadDirectory()`。
  - `.mindraw` 路径按文档打开，调用 `read_mindraw_package`，随后加载父目录，避免浏览包内部。
- 菜单 `Open Directory`、快捷键 `Cmd/Ctrl+O`、侧边栏目录选择按钮均接入 `openDirectoryOrDocument()`。
- 侧边栏空目录提示从 “No .excalidraw files found” 改为 “No Mindraw documents found”。
- 新增自动化测试：
  - 普通目录选择仍加载目录。
  - `.mindraw` 目录包选择会打开包文档且不对包内部执行 `get_file_tree`。
  - damaged `.mindraw` 打开失败时保持当前 tab / active file 不变，并弹出失败提示。
- 本地 debug app smoke：
  - `.excalidraw` 文件可通过 `open -n -a .../Mindraw.app Legacy.excalidraw` 进入 opened-files 链路并打开。
  - `.mindraw` 普通目录包通过同一 `open -a` 方式未进入 Tauri `Opened` 文档事件，符合当前“不注册 macOS package”的 MVP 边界。

## 关键决策 / 边界

- 本轮不注册 macOS package，不修改 `tauri.conf.json` 的 `.mindraw` file association。
- Finder / `open -a` 直接打开普通 `.mindraw` 目录包目前不能视为完成；该体验需要后续 macOS package 注册或 Phase 3.5 deep link 方案继续验证。
- 目录选择器返回 `.mindraw` 的路径已在应用层补齐，属于 Phase 2 可推进范围。

## 文件变更

- `src/store/useStore.ts`
- `src/store/useStore.test.ts`
- `src/components/Sidebar.tsx`
- `src/hooks/useMenuHandler.ts`
- `src/hooks/useKeyboardShortcuts.ts`
- `02-P/qa/mindraw-phase2-runtime-check.md`
- `02-P/plan-progress.markdown`
- `CODEGRAPH.md`

## 验证结果

- `npm run test:run -- src/lib/documentFormat.test.ts src/store/useStore.test.ts`：PASS，36 个测试通过。
- `npm run test:run -- src/hooks/useMenuHandler.test.ts src/lib/documentFormat.test.ts src/store/useStore.test.ts`：PASS，51 个测试通过。
- `npm run tauri -- build --debug --bundles app`：PASS，生成本地 QA debug `.app`。
- `git diff --check`：PASS。
- 本轮 debug app 验证后已停止 App、恢复 preferences、删除临时验证目录。

## 未决问题

- 仍需真实原生 folder picker 点击选择 `.mindraw` 包的人工验证；自动化已覆盖同一结果路径。
- Finder 直接打开 `.mindraw` 普通目录包未完成，需后续 package 注册或 deep link spike。
- Finder 拖放 `.mindraw` 到 App、完整 damaged manifest / hash mismatch / illegal asset path UI 文案矩阵仍未完成。

## 后续建议

继续 Phase 2：补 Save As 弹窗过滤器人工验证、Finder 拖放行为、失败态人工矩阵。Phase 2 结论收口后再进入 Phase 3 导出互通；Phase 3.5 全局链接仍保持后置。