SuperAPI AI 工具集

json-canvas

通用与其它

查看项目

更新于 10-25 16:16

技能介绍

JSON Canvas 是一项面向兼容 skills 的智能体技能,用途是让智能体创建和编辑有效的 JSON Canvas 文件(扩展名 .canvas)。该格式为无限画布数据的开放文件格式,遵循 JSON Canvas Spec 1.0,被 Obsidian 等应用使用。

主要能力:文件由两个顶层数组 nodes 和 edges 组成,均为可选。节点有四种类型:text 携带 Markdown 文本内容;file 引用系统内文件或附件(图片、视频、PDF、笔记等),可选 subpath 指向标题或块;link 展示外部 URL;group 作为其他节点的可视容器,可设 label、背景图片路径和 backgroundStyle(cover、ratio、repeat)。所有节点共享 id、type、x、y、width、height 必填属性及可选 color。节点在数组中的顺序即 z-index 顺序,首个在最底层、最后在最顶层。边连接节点,必填 id、fromNode、toNode,可选 fromSide、toSide(top、right、bottom、left)、fromEnd、toEnd(none、arrow)、color 和 label。颜色可用十六进制值或预设 "1" 至 "6"(红、橙、黄、绿、青、紫,具体色值未定义,由应用自行决定)。

使用方式:智能体按规范生成 JSON 结构,为节点和边分配唯一 ID(Obsidian 采用 16 位小写十六进制字符串),设置坐标与尺寸,并用边表达连接关系。资料提供了布局建议:坐标可为负、x 向右增大、y 向下增大、位置指节点左上角;给出了不同类型节点的建议尺寸、分组内留 20-50px 内边距、节点间距 50-100px、按 10 或 20 的倍数对齐网格。校验规则包括:所有 id 在节点与边之间唯一;fromNode 与 toNode 必须引用存在的节点;各节点类型必填字段齐全;type 限 text、file、link、group;backgroundStyle 限 cover、ratio、repeat;fromSide/toSide 限四个方向;fromEnd/toEnd 限 none、arrow;颜色预设限 "1" 至 "6" 或有效十六进制。

适用场景:资料示例涵盖思维导图式文本节点与连线、带分组栏目的项目看板、整合文件与链接的研究画布、以及流程图。限制:资料未提供安装命令、收费、价格、平台支持范围或效果数据,这些事实暂未提供;预设颜色的具体色值也刻意未定义。