前言¶
複習提綱、學科考點、讀書筆記，往往先落成大綱或 JSON，再交給畫圖工具排版。手工在 XMind、ProcessOn 裏拖節點，改一層結構就要整圖重調；用通用腳本畫圖，中文清晰度、分支防重疊、節點旁掛公式說明又需要額外工程。若你已經在 Agent 裏維護層級化知識數據，更希望「結構化輸入 → 一張可直接打印或插入文檔的導圖」，而不是重複排版勞動。
下面介紹 SkillHub 上的 知識類思維導圖製作（座標 @user_2c769e18/sa-knowledge-mindmap，版本 1.0.0，分類 knowledge-management，社區來源）。它將 JSON 或縮進文本形式的層級結構渲染爲專業思維導圖 PNG，並針對知識類場景提供佈局、視覺風格、配色與節點說明等能力。
這是什麼¶
一句話定位：面向知識類內容的思維導圖渲染 Skill——輸入層級知識結構，輸出高分辨率 PNG。
- 發佈與託管：SkillHub 社區 Skill，發佈者
user_2c769e18；頁面標註requires_api_key=false，安裝使用不依賴額外 API Key。 - 解決的問題：把已有層級數據（大綱、考點樹、概念體系）穩定轉成版式統一、中文可讀、適合複習與分享的思維導圖，減少手工製圖與反覆調版。
核心功能¶
以下能力均來自 SkillHub 官方簡介，可按需組合。
輸入與輸出¶
- 輸入格式：層級知識結構，支持 JSON 或 縮進文本。
- 輸出：PNG 思維導圖；官方說明爲 300DPI 高分辨率，字體使用 Noto Sans SC，便於中文展示。
佈局（三種）¶
| 標識 | 說明 |
|---|---|
htree |
橫向樹 |
vtree |
豎向樹 |
radial |
徑向 |
佈局側還提供 自動防重疊樹佈局，減輕節點擠在一起的問題。
視覺風格（兩種）¶
| 風格 | 說明 |
|---|---|
classic |
深度循環配色 + 直角連線 |
buzan |
博贊風格：有機曲線、主分支同色漸變、層次梯度 |
配色方案¶
支持 vivid、jewel、sunset、ocean、classic；默認 vivid（鮮豔、高區分）。
節點說明與資料填充¶
- 節點支持
desc，用於展開說明（公式、定義、要點等）。 - 支持 一鍵自動檢索 SA-LIB、小小圖書館（非專業書籍）等知識庫，並結合 聯網資料 填充說明，減輕手寫每條
desc的負擔。
安裝與啓用¶
SkillHub 頁面給出的安裝方式，是讓你的 AI 助手按統一安裝文檔拉取該 Skill：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_2c769e18/sa-knowledge-mindmap`。
說明：
- 具體命令、目錄位置以 skillhub.md 安裝說明 爲準；不同客戶端（Cursor、Codex CLI、Claude Code 等）若文檔中有分支步驟，按對應小節執行即可。
- 官方 API 入口：
https://api.skillhub.cn/user_2c769e18/sa-knowledge-mindmap；瀏覽與介紹頁：https://www.skillhub.cn/skills/user_2c769e18/sa-knowledge-mindmap。
典型用法¶
官方資料未在頁面展開完整 SKILL 示例；結合簡介，可復現的工作流如下。
1. 準備層級數據¶
用 JSON 或縮進文本表達「根 → 子節點 → 更深子節點」。需要在節點旁展示要點時，爲節點增加 desc（含義以 Skill 內 SKILL.md 爲準）。
縮進文本示例（結構示意）：
力學
牛頓定律
第一定律
第二定律
動量
若使用 JSON，保持層級與節點字段與 Skill 約定一致；安裝後讓 Agent 讀取本 Skill 的 SKILL.md 再生成，可避免字段名猜錯。
2. 選定佈局與風格¶
向 Agent 說明需求，例如：
- 佈局：
htree/vtree/radial之一； - 視覺：
classic或buzan； - 配色：
vivid（默認）或jewel、sunset、ocean、classic。
3. 生成 PNG¶
調用本 Skill，將上一步的數據與選項交給渲染流程，得到 PNG 文件。若節點 desc 不完整，可使用簡介中的 一鍵檢索 SA-LIB、小小圖書館及聯網資料 能力補全說明後再出圖。
4. 在對話中的觸發方式¶
當任務是把 任意層級化知識結構 畫成思維導圖時，在提示中明確引用 @user_2c769e18/sa-knowledge-mindmap 或說明「使用知識類思維導圖製作 Skill」，並附上結構與佈局、風格偏好。
適用場景與注意¶
適合誰¶
官方列出的場景包括：
- 中學學科 知識點梳理、概念體系構建；
- 複習提綱、考點網絡；
- 讀書筆記結構化 等知識類可視化。
需要 可分享、可打印 的導圖 PNG，且結構已在文本或 JSON 中維護時，與本 Skill 的定位一致。
使用注意¶
- 輸入質量：導圖層次與措辭取決於你的層級數據；自動檢索填充的說明仍建議人工覈對，尤其是考試與教學場景。
- 知識庫範圍：小小圖書館側重非專業書籍；專業深度內容是否覆蓋，取決於 SA-LIB 與聯網檢索結果，不宜默認「全庫無誤」。
- 安裝細節：頁面僅給出 Skill 座標與安裝文檔鏈接；字段級參數、CLI 子命令以安裝後倉庫內的
SKILL.md爲準。 - 社區 Skill：版本當前爲 1.0.0；升級或行爲變更以 SkillHub 頁面爲準。
結尾¶
知識類思維導圖製作 把「層級知識結構 → 專業 PNG 思維導圖」收斂到一條 Agent 工作流裏：多種樹佈局、classic / buzan 兩種視覺、多套配色、中文與高 DPI 輸出，並支持 desc 與知識庫檢索補說明。若你已在用 SkillHub 管理 Agent 能力，可按官方說明安裝 @user_2c769e18/sa-knowledge-mindmap。
- SkillHub 介紹頁：https://www.skillhub.cn/skills/user_2c769e18/sa-knowledge-mindmap
- API 入口：https://api.skillhub.cn/user_2c769e18/sa-knowledge-mindmap
