前言¶

客户给了一套 Draw.io / diagrams.net 的 .drawio/.xml 图纸，要交付成 Visio 可编辑文件。常见做法是打开在线转换站、上传 XML、等结果——但客户图纸往往带涉密或未公开内容，不能出本机。也有做法是手动复制到 Visio，几百个元素几小时就过去了。

下面介绍的 drawio-to-visio 是走本地浏览器自动化完成转换，并在转换过程中做结构校验，输出的是可编辑 VSDX。

这是什么¶

一句话：把已有的 Draw.io / diagrams.net XML 图纸（.drawio/.xml）转换成可编辑的 Microsoft Visio VSDX 文件，全程在本机浏览器里完成，并附带结构校验。

发布者是 SkillHub 社区账号 user_400639b0，Skill 坐标 @user_400639b0/drawio-to-visio，当前版本 1.0.1，来源 community，分类 dev-programming。官方页面标注的标签里有 requires_api_key=false，即不需要额外申请 API key。

解决的问题有两个：一是转换路径不出本地，二是转换结果不能只是”看起来像 Visio”，必须是结构可编辑的 VSDX，而不是截图或 PDF。

核心功能¶

只列已核实的能力：

1、输入是已有的 Draw.io / diagrams.net XML 图纸，格式为 .drawio 或 .xml。
2、输出是可编辑的 Microsoft Visio VSDX 文件。
3、转换由本地浏览器自动化完成，过程中对文件做结构与页面内容校验。
4、触发场景包括：用户要求转换、导出、批量转换，或要求交付 Visio/VSDX；尤其是客户图纸必须留在本地的场景。

官方说明里的原文定位是：

Convert existing Draw.io or diagrams.net XML diagrams (.drawio/.xml) into
editable Microsoft Visio VSDX files with local browser automation and
structural validation.

安装与启用¶

这个 Skill 基于通用 SKILL.md 格式发布在 SkillHub 上，官方入口是 https://api.skillhub.cn/user_400639b0/drawio-to-visio，页面地址是 https://www.skillhub.cn/skills/user_400639b0/drawio-to-visio。

需要说明：已抓取资料里没有给出具体的安装命令、目录结构或配置字段，因此这里不写未经核实的安装步骤。启用方式建议以官方页面和 SKILL.md 为准。

配置方面，页面标签标注了 requires_api_key=false，意味着不需要为它单独准备 API key。

典型用法¶

按官方简介给出的可复现场景整理：

1、用户提供一个或多个 .drawio / .xml 图纸文件。
2、用户明确要求”转成 Visio”“导出 VSDX”“批量转换”“交付 Visio 文件”。
3、执行 Skill 后，在本地浏览器自动化流程中完成解析与转换。
4、对结果做结构校验，输出可编辑的 VSDX，而不是图片或不可编辑文档。

适合批量处理时的使用形态：把一批客户图纸放在同一目录，按 Skill 流程逐个转换并校验。具体命令参数以 SKILL.md 为准。

适用场景与注意¶

适合谁：

• 需要把 Draw.io / diagrams.net 图纸交付成 Visio 可编辑文件的开发者或交付团队。
• 图纸内容受保密约束、不能上传到在线转换服务的场景。
• 需要批量转换而不是手工重画的场景。

限制与注意：

• 它转换的是已有 XML 图纸，不能凭空生成 Visio 文件；输入文件本身要先是 Draw.io/diagrams.net 格式。
• 官方页面标注的版本是 1.0.1，属于早期版本，复杂图元在转换后是否需要人工微调，建议在正式交付前先拿一个文件试跑并核对。
• 页面标签里有 requires_api_key=false，不代表运行环境不需要任何依赖，浏览器自动化通常要求本机有可用浏览器环境；具体前置条件以 SKILL.md 说明为准。
• 校验是结构与页面内容校验，不等于视觉逐像素一致；交付前仍建议按页面内容做一次人工确认。

结尾¶

drawio-to-visio 的价值在于把”Draw.io 转 Visio”这条链路放到本地，并且要求输出的是结构校验过的可编辑 VSDX，而不是图。它适合交付场景和保密场景，安装与参数以官方页面为准。

官方地址：https://api.skillhub.cn/user_400639b0/drawio-to-visio