# 2026-06-25 Mindraw 实现

## 用户目标

用户要求继续推进 `.mindraw` 格式建设；当前重点是不要停留在 Tauri 目录包 spike，而是向“Mindraw 格式 + 全局链接”目标继续开工。

## 已完成事项

- 完成 `.mindraw` Phase 1/2 初始生产实现：
  - 新增前端文档格式识别模块，识别顶层 `.excalidraw` 文件和 `.mindraw` 目录包。
  - 明确拒绝 `.mindraw` 包内 `drawing.excalidraw` / `.assets/*` 作为独立文档打开。
  - 前端打开链路可对 `.mindraw` 包调用后端 `read_mindraw_package`。
  - 前端保存链路可对 dirty `.mindraw` tab 调用后端 `save_mindraw_package`。
  - 后端新增 `.mindraw` 包读取、manifest / scene hash 校验、资产 warning、保存时 scene hash 更新。
  - 后端文件树和系统打开入口已识别 `.mindraw` 目录包，并把包显示为单个文档节点，不展开内部 scene 文件。
  - Save As 已支持创建新 `.mindraw` 目录包，生成新的 `documentId`、ISO 时间、`manifest.json`、`drawing.excalidraw` 和 `.assets/`。
- 同步更新工程地图和计划进度：
  - `CODEGRAPH.md`
  - `INDEX.md`
  - `02-P/plan-progress.markdown`

## 关键决策

- `.mindraw` 仍按普通目录包处理，不注册 macOS package。
- `.mindraw` 包内 `drawing.excalidraw` 是实现细节，不暴露为独立文档入口。
- 当前支持既有 `.mindraw` 包的读取/保存，以及 Save As 新 `.mindraw` 包；旧 `.excalidraw` 自动迁移、全局链接 runtime 仍后置。

## 文件变更

- 新增：
  - `src/lib/documentFormat.ts`
  - `src/lib/documentFormat.test.ts`
- 修改：
  - `src/types/index.ts`
  - `src/store/useStore.ts`
  - `src/store/useStore.test.ts`
  - `src-tauri/src/lib.rs`
  - `src-tauri/Cargo.toml`
  - `src-tauri/Cargo.lock`
  - `CODEGRAPH.md`
  - `INDEX.md`
  - `02-P/plan-progress.markdown`

## 验证结果

- `npm run test:run -- src/lib/documentFormat.test.ts src/store/useStore.test.ts`：2 个测试文件，30 个用例通过。
- `cargo test --locked --manifest-path src-tauri/Cargo.toml mindraw_package_tests`：12 个用例通过。
- `npm run build`：通过；仍存在既有 Assistant 字体解析 warning、Tauri dialog 动静态 import warning、chunk size warning。
- `cargo fmt --manifest-path src-tauri/Cargo.toml` 未运行成功：当前 Rust toolchain 缺少 `cargo-fmt` 组件；已手动检查新增 Rust 段落。

## 未决问题

- 还需要真实 App 验证目录包选择、Save As 弹窗过滤器、Finder 打开、watch 刷新、拖放和失败态文案。
- Phase 3.5 全局链接 runtime 尚未开始；当前只保留到后续 spike。

## 后续建议

下一步做真实 App 入口验证；通过后进入 Phase 3 / Phase 3.5 前置设计，为后续 `mindraw://` 全局链接定位打基础。