json-canvas

技能简介

json-canvas 是一个用于创建和编辑 JSON Canvas 文件（.canvas）的技能。它帮助 Agent 生成符合规范的可视化画布，包括节点、边、分组和连接关系，适用于 Obsidian Canvas、思维导图与流程图场景。

使用场景

• 在 Obsidian 中新建或修改 .canvas 画布文件
• 将结构化信息绘制成思维导图或节点图
• 创建流程图并添加连线与方向箭头
• 为已有画布新增节点、调整位置、修改内容
• 需要批量维护多个 Canvas 文件时

使用方法

本技能无需额外安装命令，作为 Skill 文件由 Agent 加载使用。启用后，Agent 会按 JSON Canvas Spec 1.0 操作 .canvas 文件。

基本流程：

1. 创建 .canvas 文件，基础结构为 {"nodes": [], "edges": []}
2. 为每个节点生成唯一 16 位十六进制 ID
3. 按节点类型填写属性：text、file、link、group
4. 使用 fromNode、toNode 添加边，必要时设置 fromSide、toSide
5. 操作后进行校验：JSON 合法、ID 唯一、边引用的节点存在

注意事项

• 节点数组顺序决定 z-index：第一个在最底层，最后一个在最顶层。
• 文本换行必须使用 \n，不要写成 \\n，否则 Obsidian 会显示为反斜杠和 n。
• 颜色可用预设 "1" ~ "6"（红橙黄绿青紫）或十六进制色值。
• 连线端头 fromEnd 默认为 none，toEnd 默认为 arrow。