用途:在本地浏览和操作以 HTML 呈现的设计看板(artboard)。画布应用随插件安装,位置在项目之外;看板保留在项目中,升级插件只替换应用,不会改动你写的看板。
主要能力:每个看板文件夹对应一个 tldraw 页面,每个 .html 文件对应一个形状,通过左上角页面菜单切换。支持用 ?canvas=<slug> 深链接到某个页面,加 #<file> 定位单块看板并聚焦相机。可通过 sheet.html?canvas=<slug> 或 /board/<slug>/<file>.html 把看板当作普通网页读取,便于链接、重载和被浏览器扩展(如 Figma 导入器)读取。内置 window.snapCanvas 受限桥接,支持 describe、get、create、select、zoom、undo 等操作。当来自 sp start 时,左侧提供聊天面板,可向 Claude Code 或 Codex 发消息。
使用方式:在项目内运行 sp start;在无应用打开的终端可用 sp start <dir> 指定项目。默认看板目录为 mockups/canvases,可用 --canvases DIR 或 PROTOTYPING_CANVASES_DIR 改变。端口用 --port N 或 SP_CANVAS_PORT。若未在 PATH 中或版本过低,可用 uv tool install "git+https://github.com/ReScienceLab/super-prototyping#subdirectory=tools" 安装,重装时加 --force。
限制:仅监听回环地址,是本地设计工具,不应对外暴露。已被占用的端口不会被复用,会直接拒绝启动。桥接命令不得注入任意 JavaScript,不得把不可信 HTML 载入看板,也不得给 artboard iframe 添加 allow-same-origin。文档保存在浏览器 IndexedDB,重命名文件夹或文件会孤立形状,需右键 Force refresh 重建。每块看板受 478 × 980 与 sandbox 约束。服务器手动启动时需设置 PROTOTYPING_PROJECT_DIR,否则聊天面板无法运行。首次运行会拉取画布应用缓存到 ~/.cache/super-prototyping/<version>/。