用途:该技能面向 bb 插件的构建、安装与调试,适用于需要 bb 插件、侧边栏面板、bb CLI 子命令、智能体工具、主题、提供方等场景。bb 插件是运行在 bb 内的 TypeScript 包,bb 的许多一方功能本身即为插件,如 GitHub、Docs、Memory、Tasks、Connect、Automations、Secrets、Keep Awake 及编码智能体提供方。
主要能力:插件可注册设置、kv 与 SQLite 存储、HTTP、RPC、实时通信、后台服务与 cron、一个顶层 bb <name> 命令、智能体工具、skills 文件夹、额外指令、提及提供方,以及可选的主机 worker 和实验性智能体提供方。app.tsx 默认导出 definePluginApp,可添加页面、线程面板操作、编辑器控件、文件打开器和替换侧边栏。
使用方式:脚手架命令为 bb plugin new hello(加 --app 生成 React UI),随后 cd bb-plugin-hello、bb plugin install . --yes、bb plugin dev。清单是 package.json 中的 bb 对象,必填 bb.name、bb.description、bb.branding.icon、bb.server,可选 bb.app、bb.host、bb.skills、bb.themes。插件 id 为包名最后一段去掉 bb-plugin- 前缀。运行时导入放 dependencies,类型与工具放 devDependencies。安装支持本地路径、github、npm:、git: 等形式,可用 bb plugin list、bb plugin reload <id>、bb plugin logs <id> -f。
限制:插件为完全信任,服务端代码在进程内运行,应用 UI 为同源页面代码而非沙箱,主机 worker 在已注册机器上以 Node 运行。安装第三方插件前应审查源码,凭据应放在 secret: true 设置中。安装会因代码完全信任而提示确认,可用 --yes 跳过。托管更新失败会回滚,目录刷新不会安装代码。社区列表位于 https://getbb.app/marketplace/v1/marketplace.json,提交需向 https://github.com/get-bb/marketplace 发 PR。实现具体 API 时应阅读 bb-plugin-authoring 技能并运行 bb guide plugins,在插件目录运行 bb plugin types,不要从压缩的 dist/ 文件猜测。