json-canvas skill 是什麼、怎麼安裝使用：讓 AI 生成 Obsidian Canvas 白板（.canvas 思維導圖、流程圖）

本文根據 kepano/obsidian-skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 7.2 萬次；所在倉庫 kepano/obsidian-skills 在 GitHub 約 4.9 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

Obsidian 的 Canvas 是一塊無限白板，可以擺放文字卡片、筆記、網頁連結並用箭頭連接。它的文件格式 JSON Canvas 是公開規範，文件就是一段 JSON——這意味着智能體可以直接「寫」出一張白板。難點在細節：節點 ID 怎麼生成、座標和尺寸怎麼排才不重疊、連線從哪一側出來。json-canvas 技能把這些講清楚了。description：創建和編輯帶節點、連線、分組和連接的 JSON Canvas 文件（.canvas）；處理 .canvas 文件、創建可視化白板、思維導圖、流程圖，或用戶提到 Obsidian 的 Canvas 文件時使用。

內容包括：文件結構（頂層是 nodes 和 edges 兩個數組，遵循 JSON Canvas 1.0 規範）；四個常見流程——新建白板、往已有白板加節點、連接兩個節點、編輯已有白板；四種節點類型（文本、文件、連結、分組）及其通用屬性；連線、顏色、ID 的生成方式（16 位十六進制）；佈局建議；以及一份提交前的校驗清單。完整示例放在單獨的參考文件裏。

怎麼安裝

json-canvas 隨 kepano/obsidian-skills 的 obsidian 插件一起安裝。Claude Code 裏輸入（命令來自倉庫 README）：

text
/plugin marketplace add kepano/obsidian-skills
/plugin install obsidian@obsidian-skills

其他智能體用 npx skills add https://github.com/kepano/obsidian-skills，在選擇介面裏勾選 json-canvas；也可以把倉庫裏的 skills/json-canvas 文件夾直接複製到所用工具的技能目錄。

倉庫整體介紹和其他安裝方式，詳見本站《obsidian-skills 是什麼、怎麼安裝：Obsidian CEO kepano 寫的 Agent Skills，讓 Claude Code 讀寫 Obsidian 筆記庫》。

怎麼用

• 「把這個項目的模組關係畫成一張 Canvas，按前端、後端、數據三組分區」。
• 「根據這篇筆記的大綱生成一張思維導圖」。
• 「在現有的白板裏加一個『風險』節點，連到『上線計劃』」。

適合誰 / 侷限

適合用 Obsidian 做可視化梳理的人，也適合任何支持 JSON Canvas 格式的其他應用的用戶。智能體是在「盲排」——它看不到渲染結果，節點很多時佈局難免需要你手動拖一拖；它生成的是結構圖，不是帶樣式設計的圖表，要更精緻的成品應選擇專門的畫圖技能。

注意事項

• 許可：MIT。
• 不執行腳本、不聯網：只讀寫 .canvas 文件。
• 編輯已有白板前先備份，JSON 寫壞會導致整張白板打不開。