json-canvas

json-canvas 技能為與 Obsidian Canvas 文件進行程式化互動提供了全面的功能。此工具專為需要自動化創建視覺化圖表、複雜心智圖、專案看板或流程圖的用戶而設計，這些作業可直接在 Obsidian 倉庫中完成。透過嚴格遵守 JSON Canvas Spec 1.0 規範，該技能確保所有生成或修改的文件均與 Obsidian 原生 Canvas 引擎完全相容。

此技能非常適合研究人員、專案經理與技術作家，他們希望將來自多個 Markdown 檔案的資訊整合到單一的視覺化空間中。它支援文字節點、檔案嵌入、外部連結與群組容器的整合，實現了結構化的佈局管理。開發人員可以使用它來編寫腳本，自動生成專案概覽、任務相依性圖表或知識庫視覺化，而無需手動操作 Canvas 介面。

• 完整支援 JSON Canvas Spec 1.0，包含節點、連線、群組與連接配置。

• 自動生成節點與連線所需的 16 字元十六進位唯一識別碼 (ID)，確保數據完整性並防止衝突。

• 支援多種節點類型：文字（含 Markdown 語法）、檔案嵌入（包含區塊/標題的子路徑）、外部網址與群組容器。

• 精確控制佈局屬性，包括 X、Y 座標、寬度、高度，以及透過 Z-index 管理的節點層級。

• 支援自定義錨點（頂部、右側、底部、左側）、標籤與方向箭頭的連線配置。

• 支援使用 canvasColor 標準（十六進位顏色或 1-6 預設值）進行顏色設定。

• 修改後請務必驗證 JSON 結構，確保所有 fromNode 與 toNode 參考均正確對應至現有 ID。

• 在創建佈局時，請使用標準網格增量（10 或 20 的倍數），並在節點之間保持 50-100px 的間距，以在 Obsidian 介面中獲得最佳可讀性。

• 在 JSON 字串內請使用標準的 '\n' 字元進行換行，以避免 Obsidian 渲染問題。

• 該工具針對 .canvas 副檔名文件設計，需符合有效的 JSON 格式；它是連接結構化數據流程與視覺化畫布工作區的橋樑。