edit | blame | history | raw

Mindraw 插件入口 MEXP10 Dev Brief 收口

日期：2026-07-01

用户目标

用户选择进入 goal 模式并选择选项 1：完成 PM-MCPE-01，为 P-20260701-mindraw-codex-plugin-entry 产出 MEXP10 Dev Brief，并更新统一台账。PM 身份本轮只做项目管理、规格、风险和 QA / Gate 文档，不直接修改源码、构建脚本或用户可见运行时行为。

已完成事项

  • 新增 MEXP10 PM 派工材料目录：02-P/MEXP10-CodexPluginEntry/pm/。
  • 新增 mexp10-dev-brief-20260701.md，把 ~/plugins/mindraw 插件壳、Open the Mindraw canvas for this project.、项目根 MindrawCanvas/、YY.MMDD-NN.mindraw、重复打开规则、Git 忽略策略、侧边栏只读预览和 SkillSpector / QA 要求写成可派发规格。
  • 新增 mexp10-architecture-review-20260701.md，明确采用薄插件 + Mindraw App 权威模型，列出 .mindraw 内部写入、预览来源、mtime 误判、Git 污染、project root 误判、skill 安全和 preview 变 editor 等风险。
  • 新增 mexp10-qa-gate-plan-20260701.md，定义 MEXP10 Gate 测试矩阵、GO / NO-GO 条件和 worker 交付证据要求。
  • 更新 02-P/plan-progress.markdown：PM-MCPE-01 标为 Complete / READY_FOR_DISPATCH；M4C-MCPE-01 与 MD-MCPE-01 保持 Ready for dispatch / no active assignment，尚未派发。
  • 更新 INDEX.md：登记 02-P/MEXP10-CodexPluginEntry/ 和三份 PM 文档。

关键决策

  • Mindraw 桌面 App 是唯一完整编辑器；Codex 侧边栏第一版只提供完整画布预览、状态、打开 / 编辑入口和 agent 协作触发。
  • 首版不复刻完整 browser editor，不形成 Mindraw desktop / browser 两个长期功能分支。
  • MindrawCanvas/ 固定在当前 Codex 项目根目录。
  • 重复执行 Open the Mindraw canvas for this project. 时，永远打开最后 / 最新创建的 .mindraw；只有无可打开画布或用户明确新建时才创建下一个文件。
  • 侧边栏预览必须是完整只读预览，支持移动视口、放大和缩小；双击预览或点击 编辑 进入 Mindraw 桌面 App 编辑同一个文件。
  • MindrawCanvas/ 建议不纳入 Git；MEXP10 worker 需给出 .gitignore / 用户提示策略，但不得静默重写任意项目 Git 配置。
  • 新增 / 修改 plugin、skill、MCP agent 工具时，SkillSpector / agent-skill-security 是硬门；DO_NOT_INSTALL 不得安装、发布或分享。

文件变更

  • 02-P/MEXP10-CodexPluginEntry/pm/mexp10-dev-brief-20260701.md
  • 02-P/MEXP10-CodexPluginEntry/pm/mexp10-architecture-review-20260701.md
  • 02-P/MEXP10-CodexPluginEntry/pm/mexp10-qa-gate-plan-20260701.md
  • 02-P/plan-progress.markdown
  • INDEX.md
  • .codex-sessionhistory/COMMANDS.md
  • .codex-sessionhistory/2026-07-01-Mindraw插件入口-03.md

核心事实 / 变更快照

  • 变更对象：计划项 P-20260701-mindraw-codex-plugin-entry 的 MEXP10 准备状态。
  • 事实来源：02-P/plan-progress.markdown 中 P-20260701-mindraw-codex-plugin-entry 段落；本轮新增三份 PM 文档。
  • 变更前：PM-MCPE-01 为待办；下一步是先写 MEXP10 Dev Brief；无可派发 MEXP10 worker 规格。
  • 变更后：PM-MCPE-01 为 Complete / READY_FOR_DISPATCH；MEXP10 Dev Brief、架构风险评审、QA / Gate 草案已存在；M4C-MCPE-01 与 MD-MCPE-01 处于可派发但未派发状态。
  • 映射 / 归并 / 删除：没有删除旧任务；PM-MCPE-01 的讨论结论进入三份 MEXP10 PM 文档；M4C-MCPE-01 与 MD-MCPE-01 仍需 PM 后续正式派发并登记 active assignment。
  • 范围边界：本轮未修改 Mindraw 源码、m4c 源码、plugin runtime、skill 实现、构建配置或 02-P/pmo-active-assignments.json。
  • 验证证据：git diff --check 对 INDEX.md、02-P/plan-progress.markdown 和三份 MEXP10 PM 文档通过。

可复用命令 / Runbook

用途：检查 MEXP10 PM 文档、统一台账和索引的 Markdown diff 基础格式，不验证代码功能。

前置条件：在 /Users/ar/Projects/ExcalidrawX 项目根目录执行；本命令适用于 MEXP10 PM 文档和台账收口。

设置命令：

git diff --check -- INDEX.md 02-P/plan-progress.markdown 02-P/MEXP10-CodexPluginEntry/pm/mexp10-dev-brief-20260701.md 02-P/MEXP10-CodexPluginEntry/pm/mexp10-architecture-review-20260701.md 02-P/MEXP10-CodexPluginEntry/pm/mexp10-qa-gate-plan-20260701.md

验证步骤：命令退出码为 0 且无输出，表示没有 trailing whitespace、冲突标记或 diff check 基础问题。

清理 / 恢复命令：无，本命令只读检查工作区 diff。

搜索关键词：PM-MCPE-01、MEXP10 Dev Brief、MEXP10-CodexPluginEntry、READY_FOR_DISPATCH。

未决问题

  • 是否立即派发 M4C-MCPE-01 与 MD-MCPE-01，需要 PM / 用户下一步确认。
  • MEXP10 worker 实作时若 Mindraw 当前没有官方 blank .mindraw 创建 API 或 preview source，必须明确返回 blocker，不得由插件手写 .mindraw 内部结构。
  • 侧边栏完整预览的具体技术路径仍待 worker spike / 实作验证。

后续建议

下一步由 PM 正式派发 M4C-MCPE-01 和 MD-MCPE-01：派发时需要更新 02-P/pmo-active-assignments.json，绑定真实 thread / session，并要求 worker 回写 QA、CODEGRAPH / INDEX / changelog 决策和 SkillSpector 证据。