用途:向已存在的 Obsidian Canvas 文件追加内容,支持多种节点类型与区域、连线操作。
主要能力:添加图片(自动检测宽高比并按规格表定尺寸)、文本卡片、PDF、wiki 笔记、网页链接、Mermaid 图、SVG、GIF,以及通过 banana 技能生成 AI 图片;可创建分组区域(zone)和节点连线(connect)。
使用方式:每次添加前先读取目标 canvas JSON,解析 nodes 与 edges,收集已有 ID 防冲突,生成新 ID([type]-[slug]-[unix-timestamp]),用自动定位算法计算位置并保证与所有已有内容节点至少 80px 水平、60px 垂直间距,追加节点后运行 python3 scripts/canvas_validate.py <path> 校验重叠与节点数,再写回并报告。图片宽高比可用 python3 -c "from PIL import Image; img=Image.open('[path]'); print(img.width, img.height)" 或 identify -format '%w %h' [path] 检测。URL 图片用 curl -sL [url] -o [media_dir]/[filename] 下载。
适用场景:在 Obsidian 中整理图文画布、知识地图、项目看板等。
限制:GIF 每画布最多 3 个、宽度不超过 480px;SVG 以 img 渲染无交互且需 viewBox;笔记节点须用 type file 而非 link;banana 技能不可用时无法生成 AI 图片。媒体目录在 vault 模式为 _attachments/images/canvas/,独立模式为 .canvases/assets/。