用途:根据用户请求生成 .drawio XML 图表,并用本地 draw.io 桌面应用 CLI 导出为 PNG、SVG、PDF、JPG。适合需要精确、专业外观的图表,如架构图、网络图、严格 UML、ERD、泳道图、自定义几何图形,以及需要大量官方形状的场景。不适合手绘白板风格(建议 excalidraw/tldraw)、需在 git 中维护的 diagrams-as-code(建议 mermaid/plantuml)或自由画布涂鸦。
主要能力:PNG/SVG/PDF 导出支持 --embed-diagram(-e),导出文件内含完整图表 XML,可在 draw.io 中恢复为可编辑图表,建议用双扩展名(如 name.drawio.png)。附带 31 个脚本,覆盖按用例分组:编写/导入代码、导入 IaC、导入 API 规范、实时基础设施、比较、注释、反向导出、工具等。支持从 Python/JS/Go/Rust 导入图、Python 类层次、Terraform/K8s/docker-compose 基础设施、实时部署状态、OpenAPI 规范、CI 流水线、SQL DDL 生成 ER 图;支持 C4 模型、序列图、地铁图、热力图、时间线动画、构建动画、PPTX 导出、交互式 HTML 查看器、Mermaid 转换、图表差异比较、标签批量替换、主题重设、边端口分配、结构校验、图像转可编辑图表、执行摘要压缩、运行手册等。
使用方式:需先安装 draw.io 桌面应用并确保 CLI 可用。macOS 可用 brew install --cask drawio,然后 drawio --version;Windows 使用 "C:\Program Files\draw.io\draw.io.exe" --version;Linux 使用 drawio --version,建议从 GitHub releases 下载 .deb/.rpm,不要用 snap。部分 macOS 沙箱环境调用 CLI 可能崩溃或无输出,此时应视为 CLI 不可用,改用非沙箱环境或浏览器回退/仅 XML 输出。工作流先确认图表类型、输出格式、输出位置、范围与保真度等细节,再解析样式预设(用户目录 ~/.drawio-skill/styles/ 或内置预设),随后生成或导入图表并导出。
限制:部分脚本依赖额外组件,如 drawio2pptx.py 需 python-pptx 和 draw.io CLI,ciimports.py 需 PyYAML,buildup.py 的 --gif 需 Pillow,compress.py 需 Graphviz dot。edgeports.py 仅分配端口,不负责路由,无法阻止边穿过无关形状。drawio2mermaid.py 仅保留结构,样式和图标不保留。具体收费、价格、平台支持等资料暂未提供。