# 2026-06-24 Mindraw 定义启动

## 用户目标

用户要求把 `.mindraw` 自定义格式建设方案和分期计划落成正式 Markdown 文档，更新到：

- `/Users/ar/Projects/ExcalidrawX/02-P/plan.markdown`

同时启动第一期工作，并将过程文档放到：

- `/Users/ar/Projects/ExcalidrawX/02-P/Round01-mindraw-defstart/`

## 已完成事项

- 已将 `.mindraw` 自定义格式建设方案和分期计划追加到 `02-P/plan.markdown`。
- 已创建 Round01 过程文档目录。
- 已创建第一期定义工作文档：
  - `02-P/Round01-mindraw-defstart/README.md`
  - `02-P/Round01-mindraw-defstart/ADR-001-mindraw-format-contract.md`
  - `02-P/Round01-mindraw-defstart/manifest-schema-draft.md`
  - `02-P/Round01-mindraw-defstart/compatibility-matrix.md`
  - `02-P/Round01-mindraw-defstart/qa-entry-checklist.md`
  - `02-P/Round01-mindraw-defstart/fixtures-plan.md`
- 已根据项目规则同步更新 `INDEX.md`，登记新的 Round01 过程文档。

## 关键决策

- 第一阶段是格式定义启动期，不做业务代码实现。
- `.mindraw` 第一版采用目录包方向。
- 第一版倾向结构为：

```text
Board.mindraw/
  manifest.json
  drawing.excalidraw
  .assets/
```

- 第一版 `.mindraw` 作为显式另存/导出格式，不自动替代 `.excalidraw`。
- 第一阶段不做 zip、runtime embed、旧文件自动迁移、图片/PDF 导入重写。

## 文件变更

- 修改：`02-P/plan.markdown`
- 修改：`INDEX.md`
- 新增：`02-P/Round01-mindraw-defstart/README.md`
- 新增：`02-P/Round01-mindraw-defstart/ADR-001-mindraw-format-contract.md`
- 新增：`02-P/Round01-mindraw-defstart/manifest-schema-draft.md`
- 新增：`02-P/Round01-mindraw-defstart/compatibility-matrix.md`
- 新增：`02-P/Round01-mindraw-defstart/qa-entry-checklist.md`
- 新增：`02-P/Round01-mindraw-defstart/fixtures-plan.md`

## 未决问题

- `drawing.excalidraw` 是否作为主 scene 文件名最终定稿。
- `.assets` 是否作为资产目录名最终定稿。
- 第一版 `.mindraw` 是否只作为另存/导出，还是允许新建时直接选择。
- 是否注册 macOS package 展示。
- Obsidian `.excalidraw.md` 导出目标插件版本。
- 默认是否允许任何图片压缩。

## 后续建议

1. 先评审 ADR 与 manifest schema 草案。
2. 再按 fixtures 计划构造 2-3 个样例 `.mindraw` 包。
3. 然后做 Tauri 目录包 spike，验证选择、打开、保存、watch、拖放、文件关联。