edit | blame | history | raw

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 第一版采用目录包方向。
  • 第一版倾向结构为:
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、拖放、文件关联。