edit | blame | history | raw

2026-07-01 Mindraw 插件入口 01

用户目标

用户继续确认 Mindraw Codex 插件入口的第一批产品规则,特别是项目画布目录、.mindraw 文件命名、重复打开行为、Git 策略和侧边栏预览能力。

已完成事项

  • 解释“重复打开规则”的含义:同一项目中多次执行 Open the Mindraw canvas for this project. 时,默认打开已有当前 / 最近画布,而不是每次新建文件。
  • 更新统一台账 P-20260701-mindraw-codex-plugin-entry 的已确认项目画布规则。
  • 明确侧边栏第一版必须提供完整画布预览图,并支持移动视口、放大、缩小;但不能编辑。
  • 执行 git diff --check -- 02-P/plan-progress.markdown,无输出,空白检查通过。

关键决策

  • MindrawCanvas/ 固定在当前 Codex 项目根目录。
  • 首次创建项目画布时使用 YY.MMDD-NN.mindraw 命名,例如 26.0701-01.mindraw
  • 同一日期新建多个画布时按 -01-02-03 递增,永不覆盖。
  • 重复打开默认打开已有当前 / 最近 .mindraw;只有没有可打开画布或用户明确要求新建时,才创建下一个 YY.MMDD-NN.mindraw
  • MindrawCanvas/ 建议不纳入 Git;MEXP10 需要设计 .gitignore / 用户提示策略,但不得擅自改所有项目 Git 配置。
  • 侧边栏第一版不是纯 launcher / status,必须有完整预览图、可移动、可缩放,但不支持编辑。

核心事实 / 变更快照

  • 变更对象:02-P/plan-progress.markdownP-20260701-mindraw-codex-plugin-entry
  • 变更前:下一步仍列出四个未决产品决策:MindrawCanvas/ 是否固定项目根、命名 / 重复打开规则、Git 策略、侧边栏第一版范围。
  • 变更后:四个决策已确认,并写入“已确认项目画布规则”。
  • 路线图影响:
  • MEXP10 需覆盖 MindrawCanvas/ 创建与重复打开策略。
  • MEXP11 需覆盖项目画布生命周期、递增、防覆盖、Git / ignore 策略。
  • MEXP12 需覆盖完整预览图、视口移动、放大、缩小和非编辑边界。
  • 范围边界:侧边栏仍不是完整编辑器;完整编辑继续进入 Mindraw 桌面 App;插件不得手写 .mindraw 包内部结构。

文件变更

  • 修改:/Users/ar/Projects/ExcalidrawX/02-P/plan-progress.markdown
  • 新增:/Users/ar/Projects/ExcalidrawX/.codex-sessionhistory/2026-07-01-Mindraw插件入口-01.md

未决问题

  • MEXP10 具体实现中如何识别“当前 / 最近”画布:使用插件 registry、最近修改时间,还是二者组合。
  • 建议 Git 忽略策略是自动提示用户添加 .gitignore,还是插件仅展示建议并等待确认。
  • 完整预览图的生成来源:Mindraw App API 生成 preview、插件本地读取 preview,还是由 Mindraw 包内维护 preview artifact。

后续建议

下一步执行 PM-MCPE-01,将上述规则写成 MEXP10 Dev Brief,并拆出 m4c 插件壳任务和 Mindraw App 最小能力核对任务。派发 worker 前必须登记 02-P/pmo-active-assignments.json