diag-weaver

图编辑器为核，MCP 为手。用户继续用 Cursor / Claude Code 里已经在用的 Agent；本项目只提供 活画布 + 少量 tools + 简单快照。

用户 ──UI──┐
            ├──► 图编辑器 ──autosave / snapshot──► 版本库
Agent ──MCP┘

不做独立对话 Agent，不内嵌 LLM，不扫整个工作区当第二个大脑。

第一期形态

• 真源：draw.io XML / 画布（官方 embed mode：embed=1&proto=json，autosave，layout，Mermaid descriptor）。

• 编辑器宿主：本机 127.0.0.1 HTTP 页里的 iframe。接口是 EditorHost；第一期是 BrowserHost。以后换成 IDE Webview / MCP Apps 时 不改 MCP 工具名。

• 存储：用户数据目录下的 current.drawio + snapshots/<时间>-<标签>.drawio。默认 Windows %APPDATA%\diag-weaver。进程握手、tools/list、空 diagram_read 不会 mkdir，也不会在 Agent cwd 建 graph-store。

• 工具面刻意少：editor_ensure、diagram_replace、diagram_read、diagram_patch、diagram_snapshot、diagram_restore、diagram_export。

社区复用：画布用官方 embed.diagrams.net，不自研 mxGraph，不把 lgazo 的 30+ 格子级工具暴露给 Agent。lgazo / 官方 @drawio/mcp 负责「遥控格子 / 打开看看」；这里负责同一张图的本地生命周期（可见、可手改、可快照、不污染工作区）。

安装与 MCP 配置

npm install
npm test
npm run build

在 Cursor 的 MCP 配置里（路径改成你的绝对路径）：

{
  "mcpServers": {
    "diag-weaver": {
      "command": "node",
      "args": ["D:/Projects/diag-weaver/dist/index.js"]
    }
  }
}

开发时可改用 npx tsx src/index.ts。接上浏览器后可用 node scripts/smoke-embed.mjs 走一遍 Mermaid → 活画布（默认会等画布连上）。环境变量：

启动后 stderr 会打印编辑器 URL。editor_ensure 或第一次 diagram_replace 会打开浏览器。用户在画布上拖节点后，Agent 再 diagram_read 应能看到新位置。

只有 diagram_export 在被明确给出路径时才往工作区写 .drawio。

明确不做

• 编辑器内聊天窗口 / 自配 API Key

• Draft / Stage / Commit、游标、graph_nudge_*

• 把 Graph JSON 当真源再 roundtrip

• 第一期绑死某个 IDE 的 Webview

许可

MIT。draw.io 编辑器由 iframe 加载官方 embed 服务，不 vendoring 其源码。