json-canvas

json-canvas 技能賦予代理程式以程式化方式操作 Obsidian Canvas 檔案的能力，這對於視覺化筆記與知識管理至關重要。透過遵循官方 JSON Canvas Spec 1.0 規範，此技能支援建立與結構化修改 .canvas 檔案，讓您可以直接在 Obsidian 庫中自動化生成複雜的圖表、專案看板與腦力激盪工作階段。

此工具專為需要連結非結構化文字筆記與結構化視覺介面的使用者而設計。無論您是從一系列 Markdown 檔案中產生流程圖、將任務整理為看板風格的群組，還是繪製節點間的概念關係，該技能都能處理底層的 JSON 序列化、ID 產生與座標計算，以確保維持一個有效且可呈現的畫布。

• 自動化節點建立：使用 X/Y 座標精確放置各種類型的節點（文字、檔案、連結、群組），確保佈局清晰且不重疊。

• 動態邊緣連結：輕鬆連結具備方向性或非方向性的節點，包含側邊錨點（上、右、下、左）與描述性標籤，以明確定義各項關係。

• 群組管理：建立並整理群組以包含子節點，構建適合專案管理或系統架構圖的階層式視覺結構。

• 結構驗證：自動為所有實體產生唯一的 16 字元十六進位 ID，並驗證結構完整性，確保邊緣總是參照存在的節點，防止視覺呈現錯誤。

• 此技能要求使用者對 JSON Canvas 結構有基本了解：節點（id, type, x, y, width, height）與邊緣（fromNode, toNode）。

• 在 Obsidian 工作空間中，確保座標對齊並使用 10 或 20 的倍數，以獲得更整潔的網格基礎美感。

• 插入文字節點時，請確保文字內容使用正確的 \n 換行字元以符合 JSON 相容性，防止 Obsidian 內部的呈現問題。

• 在儲存對 .canvas 檔案的變更前，務必驗證節點 ID 與邊緣參照，確保圖形輸出保持一致且可互動。

• 利用顏色預設值 (1-6) 或自訂十六進位顏色，以分類節點或強調視覺工作空間中的優先順序。