前言¶
團隊裏常見一種斷層：導圖在 XMind 裏維護，下游工具或同事用的是 eMindMap（.emmx）。手工重畫層級成本高，也容易漏節點。若你只需要把文本和父子結構遷過去，而不是完整還原樣式，一個只做格式轉換、依賴極少的腳本往往更合適。下面介紹 SkillHub 上的社區 Skill xmind-to-emmx.skill：用 Python 標準庫把 .xmind 轉成 .emmx，可在本機命令行直接跑，也可作爲 Agent Skill 供助手按說明調用。
這是什麼¶
xmind-to-emmx.skill 是 XMind → EMMX 的格式轉換工具：讀取 XMind 思維導圖（.xmind），輸出 eMindMap 格式（.emmx）。
- 座標：
@user_dda00956/xmind-to-emmx - 版本：1.0.0（2026-05-05）
- 來源：community（SkillHub 發佈者
user_dda00956） - 分類：dev-programming
- 標籤：
requires_api_key=false（無需 API Key）
包體很小（約 3 KB 級 ZIP），內含 SKILL.md 與 scripts/convert.py，邏輯本地執行，無網絡請求。
核心功能¶
已覈實能力如下：
- 解析 XMind Zen 格式：
.xmind實爲 ZIP，腳本解壓後讀取content.json；兼容頂層爲數組或字典兩種 JSON 結構，取第一個 Sheet 的rootTopic。 - 生成 EMMX 結構：遞歸遍歷節點，根節點映射爲
MainIdea，子節點爲SubTopic；爲每個節點分配 UUID，在 XML 中記錄SubLevel以保留層級。 - 打包輸出：在臨時目錄寫入
page/page.xml，再 ZIP 爲.emmx；臨時目錄在finally中清理。 - 運行時依賴：僅 Python 3.6+ 標準庫（
zipfile、json、xml.etree.ElementTree、os、sys、shutil、tempfile、uuid），無需pip安裝第三方包。
第三方深度檢查報告（2026-05-06）在真實 Zen 格式樣例上做過完整鏈路測試（含 615 節點導圖），轉換結果與節點計數一致；該報告與官方說明中的「已知限制」一致，可作爲能力邊界的補充參考。
安裝與啓用¶
從 SkillHub 獲取包¶
- API 頁：https://api.skillhub.cn/user_dda00956/xmind-to-emmx
- 展示頁：https://www.skillhub.cn/skills/user_dda00956/xmind-to-emmx
頁面統計（以抓取資料爲準）：評分 100000，下載 1263。安裝到具體 Agent 產品時，請按你使用的 SkillHub / IDE 集成方式拉取 @user_dda00956/xmind-to-emmx；資料中未單獨列出 Cursor、Codex CLI、Claude Code 的差異命令，此處不展開未覈實步驟。
本地解壓與環境¶
.skill 本質爲重命名的 ZIP。可先改擴展名爲 .zip 再解壓，或用任意 ZIP 工具打開，得到：
xmind-to-emmx.skill/
├── SKILL.md
└── scripts/
└── convert.py
確認本機 Python 版本：
python --version
需要 Python 3.6 及以上。無需安裝額外庫。
典型用法¶
在解壓後的 Skill 目錄（或已將 scripts/convert.py 放到工作路徑的環境）中執行：
python scripts/convert.py <輸入文件.xmind> [輸出文件.emmx]
指定輸出文件名：
python scripts/convert.py mymap.xmind mymap.emmx
省略第二個參數時，默認在與輸入文件同目錄生成同名 .emmx：
python scripts/convert.py mymap.xmind
參數不足、文件不存在或其他異常時，腳本會打印提示並以非零退出碼結束，便於在腳本或 CI 裏判斷失敗。
適用場景與注意¶
適合：
- 從 XMind 2019 及以上（Zen 格式，內含
content.json）遷出導圖骨架到 eMindMap。 - 需要在無外網、無額外 Python 依賴的機器上做一次性或批量轉換（可自行寫 shell 循環調用同一命令）。
- 希望 Agent 讀取
SKILL.md後，按固定命令幫用戶完成轉換說明或代跑腳本。
格式與內容限制（官方與設計說明一致）：
| 項 | 說明 |
|---|---|
| 輸入 | 僅 XMind Zen（.xmind + content.json），不支持舊版 content.xml |
| 輸出 | EMMX 基礎結構，不含佈局座標，佈局依賴 eMindMap 自動排版 |
| 多 Sheet | 只處理第一個 Sheet |
| 富內容 | 僅文本與層級；不保留樣式、顏色、圖標、圖片、備註、鏈接、優先級標籤等 |
使用前請確認源文件爲 Zen 導出，且你對「只保留結構」的預期與下游 eMindMap 使用方式一致。若需要多畫布或完整視覺信息，應在 XMind 側先合併 Sheet 或接受手工補全。
結尾¶
xmind-to-emmx.skill 把 XMind Zen 到 eMindMap 的遷移收成一條可復現的命令：零第三方依賴、跨平臺標準庫實現，邊界在官方文檔裏寫得很清楚。若你的痛點是結構遷移而非像素級還原，可以優先試用。
- 官方地址：https://api.skillhub.cn/user_dda00956/xmind-to-emmx
- SkillHub 頁面：https://www.skillhub.cn/skills/user_dda00956/xmind-to-emmx
