icebird1998/drawio-scientific-illustrator

Draw.io Scientific Illustrator（遗留版本）

是什么 – 一个 Codex 插件，允许 AI 代理在 draw.io（也称为 diagrams.net）的桌面版中 实时 创建科学图表。该插件通过本地 MCP（多通道插件）服务器调用 draw.io 自身的图模型 API，使代理能够添加形状、标签、箭头，设置样式，并在画布上即时查看结果。它不使用操作系统级别的鼠标/键盘自动化，也不先生成 XML 文件。

为何重要 – 它展示了将基于大语言模型的代理（Codex）与实时图形编辑器结合的具体方法，将文本提示逐步转化为可编辑的矢量科学插图。

---

核心组件

组件	作用
drawio-live MCP 服务器	启动或连接到可见的 draw.io 窗口，并实时操作其图模型（添加形状、边、更新单元格、截取屏幕截图、保存快照）。
drawio-file-utils MCP 服务器	验证已保存的 .drawio 文件，并将其导出为 PNG、SVG、PDF 或 JPG。
Codex 技能	编码代理遵循的工作流程：检查参考图像，将其分解为基本元素，以可配置的节奏绘制，审查、优化，最后保存/导出。
本地 Codex 市场入口	将上述工具打包，可通过一条 codex plugin add 命令安装。

---

要求

• Codex 桌面应用或支持插件的 CLI。
• draw.io 桌面版 已在本地安装（支持 Windows、macOS 或 Linux）。
• Git。
• Node.js（v22 或更高版本），若在 Codex 的捆绑运行时之外运行 MCP 服务器则需要。

---

安装（快速入门）

# Windows – 一行命令（请先查看 install.ps1）
$p="$env:TEMP\drawio-scientific-install.ps1"; 
Invoke-WebRequest https://raw.githubusercontent.com/icebird1998/drawio-scientific-illustrator/main/install.ps1 -OutFile $p; 
powershell -ExecutionPolicy Bypass -File $p

# macOS / Linux – 一行命令（请先查看 install.sh）
curl -fsSL https://raw.githubusercontent.com/icebird1998/drawio-scientific-illustrator/main/install.sh | bash

两个脚本均安装 遗留 插件。README 建议选择更新的项目 scientific-illustrator 用于活跃开发。

手动安装（可审计）

git clone https://github.com/icebird1998/drawio-scientific-illustrator.git
cd drawio-scientific-illustrator
codex plugin marketplace add "$(pwd)"
codex plugin add drawio-scientific-illustrator@drawio-scientific-tools

（在 PowerShell 中请将 $(pwd) 替换为 (Get-Location).Path）

安装后，重启 Codex 并启动新任务，以确保技能和 MCP 工具已加载。

---

典型工作流程

1. 启动 – drawio_live_launch 启动或连接到可见的 draw.io 窗口。
2. 就绪检查 – drawio_live_status 确保图模型已准备就绪。
3. 绘制 – 使用 drawio_live_add_shape、drawio_live_add_edge 或 drawio_live_draw_sequence（可配置节奏）创建可编辑的基本元素。
4. 检查 – drawio_live_screenshot 捕获画布；代理可基于图像进行推理。
5. 优化 – drawio_live_inspect / drawio_live_update_cell 修改标签、样式、位置。
6. 适配视图 – drawio_live_fit 保持演进中的图表始终在视图中。
7. 保存 – drawio_live_save_snapshot 将实时图写入 .drawio 文件。
8. 验证与导出 – drawio_validate 和 drawio_export 生成 PNG、SVG、PDF 或 JPG。

README 提供了推荐的英文提示；也支持等效的中文版本。

---

配置（可选环境变量）

变量	含义	默认值
DRAWIO_PATH	draw.io 可执行文件的显式路径。	自动检测
DRAWIO_LIVE_PORT	MCP 服务器的首选本地端口。	9333（或附近空闲端口）
DRAWIO_LIVE_PROFILE	用于实时实例的独立 Electron 配置目录。	~/.drawio-live-mcp/<port>

---

限制与已知问题

• 遗留 – 不再更新；仅 Windows v1.0.0 为官方测试平台。macOS/Linux 以尽力而为方式支持。
• 内容范围 – 实时 API 专为可编辑的 draw.io 基本元素设计。密集的显微图像、热图或复杂图表可能需要未来的图像插入工具。
• 保真度 – 最终视觉质量取决于参考图像的分辨率以及能否用 draw.io 形状准确表达图形。
• 端口冲突 – 若 DRAWIO_LIVE_PORT 已被占用，服务器将选择附近空闲端口。

---

安全与隐私

• MCP 服务器仅绑定到 127.0.0.1；从不暴露公共端点。
• 仅连接到 draw.io/diagrams.net 窗口，不连接任意浏览器标签页。
• 不包含遥测或云后端。
• 建议用户审查安装脚本，仅运行可信版本。

---

许可证

MIT © 2026 icebird1998。

---

注意：此仓库已归档，以支持活跃维护的 scientific-illustrator。新项目请使用该仓库，而非此遗留版本。