SuperAPI AI 工具集

obsidian-canvas

设计与创作

查看项目

更新于 10-16 05:07

技能介绍

用途:该技能用于创建和编辑 Obsidian Canvas 文件(.canvas)。Canvas 是 Obsidian 原生功能(1.1.0 起可用),提供无限自由的可视化工作区,与 Mermaid 结构化图表、Excalidraw 手绘白板不同,它把库中笔记变成可拖拽的卡片,并保留完整内容与链接行为。当用户提到“创建 canvas”“打开 canvas”“笔记的可视化地图”“空间思考”“概念聚类”,或需要项目看板、研究梳理、头脑风暴画布时调用。

主要能力:Canvas 文件为 JSON,含 nodes 与 edges 两部分。节点类型包括 text(浮动富文本,需 text、x、y、width、height)、file(库内笔记或文件,需 file、x、y、width、height)、link(网页 iframe,需 url 等)、group(彩色分组框,坐标尺寸加可选 label、color)。边通过 fromNode、toNode、fromSide、toSide、label、color、fromEnd、toEnd 配置,side 取 top/bottom/left/right,end 取 none/arrow。颜色用编号 1 红、2 橙、3 黄、4 绿、5 青、6 紫,也可用十六进制。

常用布局:中心辐射(中心概念加四周卡片)、分栏(如看板状态列)、线性流程、嵌套聚类。典型卡片尺寸:小文本卡 200×100,中文本卡 300×150,文件笔记卡 350×250,宽横幅 500×80,分组框留 30–40px 边距。

用法:先确认库路径并核对引用的笔记是否存在,可运行 find <vault-root> -name ".md" | grep -i "<search-term>",用 find <vault-root> -name ".canvas" 避免重名;再明确目标、选择布局、规划节点与边坐标,最后输出完整合法 JSON,建议用户保存为 <Name>.canvas 并在 Obsidian 中打开。

限制与规则:文件名需库内相对路径(不带开头 /),所有节点与边 id 必须唯一且边引用的节点存在,不要引用不存在的文件,除非标注为占位。若用户明确说 canvas,不应改用 Excalidraw 或 Mermaid;手绘白板用 excalidraw-diagram,结构化流程图用 mermaid-diagram,笔记内 wikilink 用 obsidian-links。Obsidian 版本低于 1.1.0 不可用。收费、价格、平台等资料未提供。