edit | blame | history | raw

2026-06-24 Mindraw 脚本能力

用户目标

用户询问未来是否能吸收 Excalidraw scripts / ExcalidrawAutomate 的能力,并确认该能力不会改变 .mindraw 前四期路径后,要求更新已经写好的计划和过程文档。

已完成事项

  • 已在 02-P/plan.markdown 中补充 Phase 5.5:Automation / Script Engine Spike
  • 已在 ADR-001-mindraw-format-contract.md 中补充 scripts / automation 的架构位置、安全原则和不做范围。
  • 已在 manifest-schema-draft.md 中补充 automation.scripts 远期扩展字段草案。
  • 已在 compatibility-matrix.md 中补充 Automation / scripts 的降级导出策略和兼容策略。
  • 已在 fixtures-plan.md 中补充未来 automation 占位包 fixture 设计。

关键决策

  • Excalidraw scripts / ExcalidrawAutomate 属于自动化运行时能力,不是 .mindraw 基础文件格式能力。
  • 该能力不会改变 .mindraw 前四期路径:格式契约、文档容器抽象、兼容包 MVP、资产外置权威化仍按原顺序推进。
  • 未来在 Phase 5 之后增加 Phase 5.5:Automation / Script Engine Spike
  • 脚本应通过 MindrawAutomationAPI 操作画布,不能直接绕过文档模型。
  • 打开 .mindraw 文件不得自动执行脚本。
  • 文档内嵌脚本属于高风险能力,默认禁用或必须显式授权。
  • 导出 .excalidraw / .excalidraw.md 时不携带可执行脚本,只保留脚本执行后的画布结果或说明。

文件变更

  • 修改:02-P/plan.markdown
  • 修改: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/fixtures-plan.md

后续建议

  1. 后续评审 Phase 5.5 时,需要单独设计 MindrawAutomationAPI
  2. 兼容 ExcalidrawAutomate 应作为降低迁移成本的方向,不作为第一版承诺。
  3. 需要在安全设计中明确内置脚本、用户本地脚本、文档内嵌脚本三类权限模型。