SuperAPI AI 工具集

soia-dev-drawio-visio-diagrams

通用与其它

查看项目

更新于 10-16 09:27

技能介绍

用途:把外部 .vsdx 当作只读原件,先做安全结构盘点,再用本机 draw.io Desktop 转成可编辑 .drawio,然后在新文件上理解、修改、渲染和复核图表。

主要能力:只读解析 VSDX OOXML 中的页面、形状、文字、连接和媒体并输出盘点;调用 draw.io Desktop CLI 将 VSDX 导入并导出为 .drawio XML;在副本上按 JSON 计划修改页面名、文字、样式和几何;从 .drawio 或 .vsdx 导出 PNG、SVG、PDF、JPG;递归检查目录生成清单。

必要用法: python3 scripts/inspect_vsdx.py <diagram.vsdx> --format markdown python3 scripts/drawio_cli.py doctor python3 scripts/drawio_cli.py convert <diagram.vsdx> --output <diagram.drawio> python3 scripts/inspect_drawio.py <diagram.drawio> --format markdown python3 scripts/edit_drawio.py <diagram.drawio> --plan <upgrade-plan.json> --output <diagram-upgraded.drawio> python3 scripts/drawio_cli.py export <diagram-upgraded.drawio> --format png --output <preview.png>

依赖:Python 3.10+ 必需;draw.io Desktop 为转换/渲染必需,macOS 可用 brew install --cask drawio;drawio-mcp-server 可选。脚本会依次查找 DRAWIO_BIN、drawio、draw.io 及各平台常见安装路径。

限制:draw.io 30.x CLI 支持 VSDX 输入与 XML/PNG/SVG/PDF/JPG 输出,不支持 VSDX 输出,默认交付真源是 .drawio,不承诺无损回写 VSDX。VSDX→draw.io 可能损失字体、主题、复杂母版、图片裁切、超链接或特殊连接语义,需渲染预览做视觉复核。edit_drawio.py 只操作未压缩 .drawio XML,仅支持计划中明确列出的字段。没有明确授权时只读,不覆盖原件。