前言¶
客戶給了一套 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