SuperAPI AI 工具集

tldraw-offline

智能体与模型

查看项目

更新于 10-16 02:32

技能介绍

用途:让编码智能体操作 tldraw offline 桌面应用(offline.tldraw.com)中打开的文档,读取画布、生成或修改图形,并编写嵌入 .tldraw 文件的文档脚本,使文件在加载时自动运行、具备持久行为。智能体不使用 GUI 点击,也不直接手改 .tldraw 文件。

主要能力:一次性画布编辑(布局、生成图形、清理)通过 /exec 接口执行;持久行为通过编辑磁盘上的 script/main.js 实现,应用的文件监视器会自动应用。脚本可创建图形、监听 store 变化、响应指针事件、做动画,并支持自定义形状/工具。

使用方式:应用启动后会在配置目录写入 server.json,含端口(默认 7236)与 bearer token;除 GET / 外所有请求需 Authorization: Bearer <token>。每次 shell 调用都要重新读取端口与 token。查找文档用 api.getFocusedDoc(),执行代码用 /api/doc/:id/exec,脚本路径用 /script-workspace,状态用 /script-status。脚本入口为 export default function ({ editor, helpers, signal }),需从 'tldraw' 导入 createShapeId、toRichText 等,并在 signal abort 时清理监听器。

适用场景:用户已打开 tldraw offline 并要求构建或修改画布、为绘图添加持久交互逻辑。

限制:需先安装并运行应用、安装 Agent Skills;本地编辑无需账号或网络。脚本每次加载都会重跑,必须幂等;store.listen 在提交后的 tick 才触发;tick 在窗口隐藏时暂停;Linux 上 inotify 实例耗尽会导致脚本不被监视。自运行脚本需在 metadata.json 中提供 sha256 清单并预信任摘要,否则会弹出运行脚本确认对话框。部分平台与验证细节资料未提供。