前言¶
讀完一本電子書或一份長文檔，腦子裏有結構，卻很難快速落成可分享的樹狀視圖。手工在導圖軟件裏敲節點，要先自己拆章節、定層級，長材料尤其費時。若希望 Agent 先讀材料、抽出提綱，再產出可在瀏覽器裏展開摺疊的 HTML 思維導圖（並可導出圖片），可以把「思維導圖生成」裝進當前環境的 Skills 目錄，用自然語言觸發整條流水線。
這是什麼¶
「思維導圖生成」是 SkillHub 上的社區 Skill，座標爲 @user_966d65df/mindmapgenerator，當前版本 1.0.2，分類爲 knowledge-management，發佈者爲 user_966d65df。頁面標註 requires_api_key=false，即不依賴額外 API Key 配置。
它面向「已有文件、需要結構化呈現」的場景：根據用戶提供的目錄路徑，或對話中上傳的文檔，自動提取文本、生成結構化大綱，並據此生成可交互的 HTML 思維導圖，且支持導出圖片格式。
核心功能¶
以下能力均來自 SkillHub 官方簡介與頁面說明，安裝後由 Agent 按 Skill 內 SKILL.md 約定執行。
- 多格式輸入：支持從目錄路徑或上傳文檔讀取內容，格式包括 epub、pdf、docx、md、txt 等。
- 提綱生成：在提取文本後，生成結構化大綱（提綱），作爲導圖節點層級的基礎。
- HTML 思維導圖：基於大綱生成可交互的 HTML 思維導圖，便於在瀏覽器中查看與操作。
- 圖片導出：在 HTML 導圖基礎上，支持導出爲圖片格式，便於插入筆記或分享。
- 觸發語匹配：當用戶表達「生成思維導圖」「畫思維導圖」「根據這本書/文檔做大綱和導圖」「把這份材料整理成樹狀導圖」等意圖時，Agent 應選用本 Skill。
安裝與啓用¶
SkillHub 頁面要求：先按 SkillHub 安裝說明 準備 skillhub CLI，再將本 Skill 安裝到當前 Agent 實際使用的 skills 目錄；若未指定 --dir，默認會裝到 ./skills/，當前 Agent 可能無法加載。
1、檢查或安裝 skillhub CLI¶
command -v skillhub && skillhub --version
若未安裝，可使用官方腳本（完整安裝含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝本 Skill¶
將 @user_966d65df/mindmapgenerator 安裝到對應目錄。以 Cursor 爲例，skills 目錄一般爲 ~/.cursor/skills/：
skillhub install @user_966d65df/mindmapgenerator --dir ~/.cursor/skills/
其他常見客戶端路徑（摘自 SkillHub 安裝文檔，按你實際使用的環境擇一）：
- Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/ - Gemini CLI：
~/.gemini/skills/
安裝完成後，按你所用 Agent 的說明刷新或重啓，使新 Skill 被識別。
典型用法¶
本 Skill 通過對話驅動，無單獨 CLI 子命令。下面示例與官方簡介中的觸發場景一致，便於復現。
示例 1：指定本地路徑
在 Agent 對話中說明材料位置，並明確要求導圖，例如：
請根據
/path/to/my-book目錄裏的材料生成思維導圖，先出大綱再做成可交互 HTML。
示例 2：上傳文檔
在支持附件的對話裏上傳 pdf、docx、md 等文件，然後說明：
把這份材料整理成樹狀導圖，需要 HTML 版本，方便導出圖片。
示例 3：口語化觸發
直接使用官方列出的說法之一即可，Agent 會按 Skill 流程提取文本、生成提綱並輸出 HTML 導圖：
- 「根據這份文檔做大綱和導圖」
- 「畫思維導圖」
- 「生成思維導圖」
具體輸出路徑、文件名與導出圖片的格式，以 Skill 包內說明與 Agent 執行結果爲準；若需固定落盤位置，可在對話中一併寫明。
適用場景與注意¶
適合誰
- 需要把電子書、技術文檔、課程講義等長文快速變成層級視圖的人。
- 已在 Cursor、Claude Code 等支持 Skills 的環境裏工作，希望少用手動導圖排版的人。
使用上需注意
- 輸入質量取決於源文件是否可被正常解析；掃描版 PDF、版式複雜的 docx 等，提取效果可能不穩定，官方簡介未承諾 OCR 或版式還原。
- 大綱與節點劃分由模型與 Skill 邏輯共同決定，重要材料建議人工覈對後再對外分享。
- SkillHub 頁面顯示的評分爲 100000，下載 6631（統計以 SkillHub 爲準，會隨時間變化）。
結尾¶
「思維導圖生成」把「讀文件 → 提綱 → HTML 可交互導圖 → 圖片導出」串成一條 Agent 可觸發的流程，適合知識整理與長文速覽。安裝與詳情見 SkillHub：
- 頁面：https://www.skillhub.cn/skills/user_966d65df/mindmapgenerator
- API 入口：https://api.skillhub.cn/user_966d65df/mindmapgenerator
