SuperAPI AI 工具集

sp-canvas

设计与创作

查看项目

更新于 10-20 03:27

技能介绍

sp-canvas 是 Super Prototyping 的本地原型画布工具,基于 tldraw,用来展示和操作 HTML 画板。

用途:它会自动发现项目 canvases/<slug>/ 目录下的每个 .html 文件,并渲染为画布上的一个形状。添加画板不需要编辑 shape map,也不需要改代码。项目是 ~/Documents/Super Prototyping 下的文件夹(可用 PROTOTYPING_PROJECTS_DIR 改变位置),画板位于该文件夹的 canvases 中。应用安装在项目之外,升级不会影响已写入的画板。

启动与运行方式:运行 sp open 会打开 Super Prototyping 应用首页,打印画布地址和项目文件夹;项目的画板位于 <address>p/<project>/。若找不到 sp,运行本技能目录下的 scripts/install.sh,Windows 使用 powershell -ExecutionPolicy Bypass -File <this skill's dir>/scripts/install.ps1,然后按 references/install.md 配置 PATH。sp start 用于 CI、Linux、远程主机等无法运行应用的环境,首次运行会将画布取到 ~/.cache/super-prototyping/<version>/,在 127.0.0.1:5173 提供服务,可用 --port N 或 SP_CANVAS_PORT 指定端口;已响应的端口不会被复用。sp root 打印找到的代码树,sp status 查看运行状态与端口,sp paths 打印路径和相关变量,sp clean 清理缓存和 start 产生的文件。

画布组织:boards 目录下一个文件夹 = 一个 tldraw 页面;一个 .html 文件 = 一个形状,通过左上角页面菜单切换。layout.json 控制布局,编辑后可右键画布选择 Force refresh 重建形状。项目根目录只保留文档(*.md)和 project.json,作品放在画布文件夹,运行产生的临时内容放在该文件夹的 scratch/。sp pack 只打包根目录的 canvases/ 与文档。

sp canvas 命令行:可读取当前画布(get)并放置形状、图片、视频和画板。支持 create、update、delete、align、distribute、stack、pack、frame、select、zoom、shot 等操作。命令需要项目在应用中打开,否则等待十秒后失败;不要自行写入 canvas.json。创建图片或视频时需给出本机文件路径,文件会先复制到画布文件夹的 files/;可放置未列入 layout.json 的画板;文本、便签、几何形状通过 props 传参;箭头可绑定两端。坐标应通过 get 获取,不能猜测。属于他人的形状或被人移动过的形状,更新会被拒绝(如 not_agents、moved_by_person、locked 等),除非使用 force。

导出与链接:可用 ?canvas=<slug> 深链到某个页面,用 #<file> 深链到某个画板。顶部栏的 Export to Figma 会以 sheet.html?canvas=<slug> 打开所有画板组成的滚动文档,单个画板地址为 /board/<slug>/<file>.html,便于浏览器扩展读取并导入 Figma。

聊天面板:画布左侧面板可向 Claude Code 或 Codex 发送消息,面板会告知代理当前项目与画布,并指向本技能。对话按会话保存,代理运行在项目文件夹下的 .workspaces/<id> 中,画板写入对应项目的 canvases。

使用限制:画布应保持在本地回环地址,不应对外暴露。不要用 sp canvas 注入任意 JavaScript,不要将不受信任的 HTML 加载为画板,也不要给画板 iframe 添加 allow-same-origin。关于收费、价格和具体平台支持,资料暂未提供。