icebird1998/drawio-scientific-illustrator

Live MCP control of the visible draw.io canvas for step-by-step scientific illustration in Codex.

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 工具已載入。

典型工作流程

啟動 – drawio_live_launch 啟動或連接至可見的 draw.io 窗口。
就緒檢查 – drawio_live_status 確認圖模型已準備就緒。
繪製 – 使用 drawio_live_add_shape、drawio_live_add_edge 或 drawio_live_draw_sequence（可設定節奏）建立可編輯的基本元素。
檢查 – drawio_live_screenshot 捕獲畫布；代理可基於影像進行推理。
優化 – drawio_live_inspect / drawio_live_update_cell 修改標籤、樣式、位置。
適配視圖 – drawio_live_fit 保持演進中的圖表始終在視圖中。
儲存 – drawio_live_save_snapshot 將即時圖寫入 .drawio 檔案。
驗證與匯出 – 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 窗口，不連接任意瀏覽器標籤頁。
不包含遙測或雲端後端。
建議使用者審查安裝指令碼，僅執行可信版本。

授權

注意：此倉儲已歸檔，以支援活躍維護的 scientific-illustrator。新專案請使用該倉儲，而非此遺留版本。