SuperAPI AI 工具集

paperclip-plugin-dev

写作与研究

查看项目

更新于 10-15 17:23

技能介绍

用途:在用户要求“搭建 Paperclip 插件”“编写 Paperclip 插件 manifest”“为插件添加 UI 插槽”等场景下,指导完成 Paperclip 插件开发与发布。

主要能力与要点:

  • 搭建:使用 create-paperclip-plugin 脚手架命令生成项目,支持 connector、workspace、automation、ui 四类,需指定 SDK 路径等参数。
  • 版本:SDK 为 @paperclipai/plugin-sdk,采用 calver(YYYY.MDD.patch)并有 canary 标签;开始前运行 npm view @paperclipai/plugin-sdk version dist-tags exports --json 并固定所选版本。
  • 常见错误:package.json 必须声明 files(如 ["dist", "package.json"]);capabilities 必须与功能精确匹配,否则 manifest 被拒;首次发布版本用 0.0.1;发布前构建并检查;服务端 npm 缓存需清理;新增 capability 会触发升级审批。
  • 其他注意:SDK 不支持任意 agents.create,只提供 ctx.agents.managed 与 ctx.agents.sessions;ConvexError 的消息在 error.data 而非 error.message;应依赖 npm 上的 SDK,而非 tgz;使用类型化客户端(如 ctx.issues、ctx.agents、ctx.routines、ctx.skills 等),不要用原始 HTTP 调内部 API。
  • 用法:提供脚手架命令,搭建后立即添加 files 字段、改版本为 0.0.1、初始化 git;随后可注册事件、任务、数据、动作和工具。
  • 限制:UI 插槽与能力映射、完整 API 等细节需查阅附带的 reference 文件;worker 以子进程方式运行,通过 JSON-RPC 与宿主通信;未提供更多收费、价格或效果信息。