SuperAPI AI 工具集

soia-dev-drawio-visio-diagrams

通用与其它

查看项目

更新于 10-16 08:46

技能介绍

用途:把外部 .vsdx 当作只读原件,先做安全结构盘点,再用本机 draw.io Desktop 转为可编辑 .drawio,并在新文件上理解、修改、渲染与复核。draw.io 可导入 VSDX,但 26.1.0 起移除 VSDX 导出,默认交付真源是 .drawio,不承诺无损回写 VSDX。

主要能力:只读解析 VSDX OOXML 包中的页面、形状、文字、连接与媒体;调用 draw.io Desktop CLI 将 VSDX 导入并导出为未压缩 .drawio XML;按 JSON 计划修改副本中的页面名、文字、样式与几何,或交由可选 draw.io MCP 做元素级编辑;从 .drawio 或 .vsdx 导出 PNG、SVG、PDF、JPG;递归检查目录并生成清单。盘点输出 SHA-256、页数/形状数/连接数。

使用方式:提供输入文件或目录、目标动作和交付路径;无明确授权时只读,不覆盖原件。常用命令: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 为可选。

适用场景:读懂 VSDX 的页面、组件与关键链路;转为可编辑 draw.io 且原件不动;批量替换旧系统名、统一主色并导出预览;审查升级前后页数与关键文字是否丢失。

限制:VSDX 是输入格式而非编辑真源;转换可能损失字体、主题、复杂母版、图片裁切、超链接或特殊连接语义,结构计数通过后仍需渲染做视觉复核。edit_drawio.py 只操作未压缩 .drawio XML 且仅支持计划中列出的字段,复杂重画交给 draw.io Desktop 或可选 MCP。远端上传、公开分享、覆盖、删除等外部状态变更须客户明确授权。