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) 或自定十六进制颜色，以分类节点或强调视觉工作空间中的优先级。