用途:该技能让兼容 skills 的智能体创建和编辑有效的 JSON Canvas 文件(.canvas),该格式是用于无限画布数据的开放文件格式,遵循 JSON Canvas Spec 1.0,可用于 Obsidian 等应用。
文件结构:canvas 文件包含两个顶层数组 nodes 和 edges。nodes 为节点对象数组(可选),edges 为连接节点的边对象数组(可选)。
节点:节点有四种类型——text(含 Markdown 的文本)、file(引用文件或附件,可带 subpath 指向标题或块)、link(外部 URL)、group(用于组织其他节点的可视化容器,可有 label、background 与 backgroundStyle)。通用属性包括 id、type、x、y、width、height 以及可选 color。节点按 z-index 排序:数组中第一个节点在最底层,最后一个在最顶层。
边:边连接节点,必填 id、fromNode、toNode;可选 fromSide、fromEnd、toSide、toEnd、color、label。fromSide/toSide 取值 top、right、bottom、left;fromEnd/toEnd 取值 none、arrow。
颜色:canvasColor 可用十六进制如 "#FF0000",或用预设 "1" 至 "6"(红、橙、黄、绿、青、紫),预设具体色值未定义,允许应用使用自身品牌色。
ID 生成:节点与边 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 只能为 top、right、bottom、left;fromEnd/toEnd 只能为 none、arrow;颜色预设须为 "1" 至 "6" 或有效十六进制。
适用场景:思维导图、项目看板、研究画板、流程图等可视化画布。限制:未提供的收费、价格、平台支持等细节暂未说明。