Draw.io Scientific Illustrator — плагин
Плагин Codex перерисовывает научный рисунок по образцу на живом холсте draw.io шаг за шагом, затем проверяет файл и экспортирует PNG, SVG, PDF или JPG
- 1 460 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает draw.io с локальным портом отладки и два сервера Node.js на вашем компьютере
- Читает приложенный образец и пишет файлы `.drawio` и экспорты на диск
- Установщик можно получить одной командой из сети и запустить через оболочку
Установка
- Работает в
Ручная установка
git clone https://github.com/icebird1998/drawio-scientific-illustrator.gitНужны Codex с поддержкой плагинов, настольный draw.io, Git и Node.js (рекомендуют 22 или новее). Есть и установщики `install.sh` и `install.ps1`, прочитайте их до запуска.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает draw.io с локальным портом отладки и два сервера Node.js на вашем компьютере
- Читает приложенный образец и пишет файлы `.drawio` и экспорты на диск
- Установщик можно получить одной командой из сети и запустить через оболочку
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Draw.io Scientific Illustrator — плагин для Codex, который перерисовывает научный рисунок в окне настольного draw.io: фигуры, подписи и стрелки появляются на холсте по одной, и за этим можно следить. Вы прикладываете образец (PNG, JPEG, SVG или страницу PDF, переведенную в картинку), называете плагин в задаче и задаете паузу между шагами и нужные форматы вывода. Мышь и клавиатуру системы плагин не трогает и XML заранее не собирает: его MCP-сервер `drawio-live` запускает draw.io с локальным портом отладки и вызывает встроенный API модели графа. Скилл ведет агента по порядку. Агент разбирает образец на редактируемые части (панели, узлы, текст, стрелки, легенду), запускает редактор через `drawio_live_launch` и ждет готовности графа. Дальше он добавляет формы и связи через `drawio_live_add_shape` и `drawio_live_add_edge` или серией `drawio_live_draw_sequence` с ненулевой паузой. После каждого раздела делает `drawio_live_screenshot`, сравнивает с образцом и правит подписи, стили и размеры через `drawio_live_inspect` и `drawio_live_update_cell`. Файл `.drawio` сохраняется только когда рисунок на холсте закончен (`drawio_live_save_snapshot`). Второй MCP-сервер, `drawio-file-utils`, проверяет сохраненный документ (`drawio_validate`) и экспортирует PNG, SVG, PDF или JPG (`drawio_export`). Для просмотра скилл просит PNG шириной 2000 пикселей без встроенного XML, а для итоговых файлов включает встроенный XML draw.io там, где формат это допускает.
Для кого. Для исследователей, аспирантов и научных редакторов, которые работают с Codex и хотят получить редактируемую схему вместо картинки, и для тех, кто готовит иллюстрации к статьям и докладам.
Подходит, если
- Есть растровая схема из статьи, которую нужно пересобрать редактируемыми фигурами, текстом и стрелками
- Хочется видеть, как агент строит рисунок, и вмешиваться по ходу дела
- Готовую диаграмму надо поправить в открытом draw.io: подписи, цвета, размеры, положение элементов
- Нужен итог в виде `.drawio`, PNG, SVG, PDF или JPG, причем структуру файла надо проверить автоматически
Не подходит, если
- Нужны микроскопические снимки, фотографии, тепловые карты или плотные графики данных: плагин строит редактируемые фигуры draw.io, а вставки изображений в живом режиме у него пока нет
- Вы работаете не в Codex: плагин собран как плагин Codex с собственным каталогом установки, про другие агенты в документации ничего нет
- Нужны новые функции и исправления: разработка перенесена в проект, который есть в каталоге как Scientific Illustrator
- На компьютере нет настольной версии draw.io: плагин управляет только ею
Пример запроса к агенту
Используй Draw.io Scientific Illustrator: запусти живой draw.io и шаг за шагом перерисуй эту схему из статьи с паузой 100 мс, подписи и стрелки оставь редактируемыми, в конце сохрани .drawio и экспортируй PNG шириной 2000 пикселейОграничения
- Репозиторий больше не обновляется: автор перенес разработку и выпуски в проект scientific-illustrator и советует ставить его. Старый остается открытым, без архива. Версия 1.0.0 вышла 12.07.2026, лицензия MIT.
- Проверена Windows. Для macOS и Linux автор обещает поддержку по мере возможности, пока сообщество не протестирует ее.
- Вставки изображений в живом режиме нет. Если рисунок состоит из снимков, тепловых карт или сложных графиков, скилл велит сказать об этом, а не молча собирать XML заранее.
- Для сложных перерисовок автор советует модель GPT-5.6 Sol и максимальный уровень рассуждения. Такой режим дольше отвечает и тратит больше токенов.
- Если образец плохо читается, скилл требует перечислить неуверенные подписи и элементы, а не придумывать их. Итоговую сверку с образцом по смыслу делает человек.
Как отключить. Команды удаления в документации нет. Уберите плагин через управление плагинами в Codex или удалите каталог, в который установщик склонировал репозиторий (для `install.sh` по умолчанию `~/.codex/marketplaces/drawio-scientific-illustrator`), и перезапустите Codex. Сохраненные `.drawio` и экспорты остаются там, куда вы их записали.
Частые вопросы
Управляет ли плагин мышью и клавиатурой?
Нет. Он вызывает внутренний API модели графа в draw.io через канал отладки, который слушает только 127.0.0.1. Скилл запрещает автоматизацию мыши, клавиатуры и окон операционной системы.
Чем отличаются серверы drawio-live и drawio-file-utils?
`drawio-live` запускает или находит видимый draw.io и меняет его граф в реальном времени. `drawio-file-utils` работает с уже сохраненным файлом: проверяет структуру и экспортирует PNG, SVG, PDF или JPG.
Какой порт использует плагин и где хранит профиль?
Предпочтительный порт отладки 9333, при занятости выбирается ближайший свободный, его можно задать через `DRAWIO_LIVE_PORT`. Отдельный профиль draw.io лежит в `~/.drawio-live-mcp/<порт>`, путь меняет `DRAWIO_LIVE_PROFILE`.
Что делать, если draw.io не находится?
Плагин ищет типичные места установки в Windows, macOS и Linux. Для нестандартного пути задайте `DRAWIO_PATH` до запуска Codex, например `$env:DRAWIO_PATH = "D:\Apps\draw.io\draw.io.exe"` в PowerShell.
Почему скилл не собирает XML сразу?
По правилам скилла рисунок должен появиться на видимом холсте шаг за шагом, и только потом сериализуется файл `.drawio`. Так вы видите ход работы и можете остановить агента на неудачном разделе.
Нужно ли перезапускать Codex после установки?
Да. Перезапустите Codex и начните новую задачу, иначе новые скилл и MCP-инструменты не загрузятся.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныNext AI Draw.io: MCP-сервер и плагин, в которых агент рисует диаграммы draw.io на живом холсте в браузере, а вы правите их вручную
Официальный MCP-сервер draw.io: агент строит диаграммы из XML или Mermaid и открывает их в редакторе draw.io
Scientific Illustrator
scientific-illustrator
Плагин для Codex: по картинке-образцу перерисовывает научный рисунок редактируемыми объектами в PowerPoint, WPS или draw.io. README на китайском
Скилл для редактируемых диаграмм draw.io из текста, кода, Terraform, Kubernetes, SQL и OpenAPI с экспортом и самопроверкой
Draw.io Skill
Draw.io Skill for Claude & Codex
Скиллы для диаграмм draw.io: архитектура, сети, блок-схемы, импорт из Terraform и кода, офлайн-генерация из YAML и экспорт в PNG и SVG
Скилл рисует редакторские диаграммы как самостоятельные файлы HTML и SVG: архитектура, блок-схемы, ER, воронки и еще около сорока типов
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Draw.io Scientific Illustrator (эта запись) | нет | 1 460 | |
| Scientific Illustrator | нет | 958 | новая версия того же автора, куда перенесена разработка; рисует еще и в PowerPoint и WPS |
| drawio-skill | нет | 10 307 | скилл собирает диаграммы draw.io из текста, кода, Terraform и SQL, а не перерисовывает научный рисунок по образцу |
Коротко о README
В репозитории лежит плагин в папке `plugins/drawio-scientific-illustrator`: манифест, два MCP-сервера на Node.js и скилл, рядом корневой каталог установки для Codex, скрипты `install.sh` и `install.ps1`, проверки `validate-repo.mjs` и `smoke-test.mjs`, политика конфиденциальности и журнал изменений. Описание на английском и китайском начинается с предупреждения о переносе проекта, затем идут требования, три способа установки, пример запроса, порядок инструментов, переменные окружения, разбор неполадок и известные ограничения.
Бейдж для README
Исходный SKILL.md
--- name: recreate-scientific-figure-in-drawio description: Recreate, trace, revise, inspect, or export static scientific figures and schematic illustrations live inside the visible draw.io desktop canvas through draw.io's own graph API. Use when the user wants to watch an MCP draw a reference figure step by step in draw.io, explicitly rejects XML-first generation or operating-system mouse/screen control, provides a PNG/JPEG/SVG/PDF reference to rebuild as editable draw.io geometry, requests targeted live changes, or needs final .drawio/PNG/SVG/PDF/JPG deliverables. --- # Recreate Scientific Figures in draw.io Use the plugin's live MCP tools whose names end in `drawio_live_launch`, `drawio_live_status`, `drawio_live_screenshot`, `drawio_live_add_shape`, `drawio_live_add_edge`, `drawio_live_update_cell`, `drawio_live_draw_sequence`, `drawio_live_fit`, `drawio_live_inspect`, and `drawio_live_save_snapshot`. Use file tools ending in `drawio_validate` and `drawio_export` only after the visible drawing has been saved. ## Hard boundary - Control only draw.io's internal graph/model API through the live MCP server. - Never use operating-system mouse, keyboard, window, or full-screen automation for this workflow. - Never pre-build XML and then open it as the drawing method. Serialize `.drawio` only after live shapes and edges already exist on the visible canvas. - Renderer screenshots are allowed only to inspect the draw.io canvas itself; they are not general computer-screen control. ## Workflow 1. Inspect every provided reference image with vision before creating XML. For a PDF, render the relevant page first. Do not merely embed the raster image and call it recreated. 2. Decompose the figure into editable primitives: canvas/aspect ratio, panels, containers, nodes, text, arrows, legends, repeated motifs, colors, stroke widths, fonts, and z-order. Identify any portions that must remain raster because draw.io primitives cannot reproduce them faithfully. 3. Call `drawio_live_launch` with a visible per-step delay, normally 400–1000 ms. Call `drawio_live_status` and require `graph_ready=true` before drawing. 4. Add geometry directly to the live canvas: - Use `drawio_live_add_shape` and `drawio_live_add_edge` for one deliberate visible step at a time. - Use `drawio_live_draw_sequence` only with a nonzero `step_delay_ms`; each operation must remain a separate draw.io model update so the user can watch it appear. - Use stable semantic cell ids from the beginning so later edges and edits can target exact elements. 5. Call `drawio_live_screenshot` after each logical section, not after every trivial cell. Inspect only the draw.io renderer and compare it with the reference. 6. Iterate directly in the live graph. Use `drawio_live_inspect` followed by `drawio_live_update_cell` for labels, styles, position, and size. Use `drawio_live_fit` to keep progress visible. 7. After the visible figure is complete, call `drawio_live_save_snapshot`. This is the first point at which `.drawio` XML should be serialized. 8. Call `drawio_validate`. Fix structural errors through the live graph when possible, then save again. 9. Export a review PNG with `embed=false` and `width=2000`. Check element count, wording, topology, alignment, overlap, clipping, arrow direction, color, whitespace, and correspondence to the reference. 10. After approval, export the requested deliverables. Default to an editable `.drawio` plus PNG. Use `embed=true` for final PNG/SVG/PDF so draw.io XML remains embedded where supported. ## Fidelity rules - Match scientific meaning before decoration: labels, relationships, directionality, grouping, and panel structure must be correct. - Recreate text as text and arrows as connectors; do not flatten them into a screenshot. - Keep coordinates on a 10 px grid unless matching the reference requires finer placement. - Use consistent fonts, stroke widths, arrowheads, corner radii, and semantic colors. - Route connectors around unrelated shapes. Pin entry/exit points where multiple edges share a node. - For microscopy, photographs, heatmaps, molecular renderings, or dense plotted data, explain that the live API currently focuses on editable draw.io primitives. Add a dedicated live image-insertion operation before attempting hybrid figures; do not silently fall back to XML-first construction. - If a reference is ambiguous or too low-resolution to read, state the uncertain labels/elements instead of inventing them. ## Delivery Return clickable paths for the `.drawio` source and each export. State validation status and briefly identify any intentionally rasterized portions.