mcpField
B
bb-plugins

bb-plugins

github.com/davidondrej开发4.2k43 次安装今天更新
代码仓库

关于 bb-plugins

用于创建、安装和维护 bb TypeScript 插件的技能，涵盖插件扩展面、脚手架、发布和验证，并强调插件以完全信任权限运行。

主要功能

  1. 01生成脚手架并安装插件
  2. 02注册服务端和应用界面扩展
  3. 03添加命令、Agent 工具和技能
  4. 04通过保存自动重载进行开发
  5. 05检查状态、日志和更新
  6. 06了解完全信任模式的安全影响

适用场景

  1. 01从脚手架创建 bb 插件
  2. 02为 bb 添加界面页面或 Agent 工具
  3. 03调试无法加载的插件
  4. 04安装并验证插件包

MCP 相关

该技能说明 bb 插件可添加 Agent 工具及相关能力，但未说明 MCP 服务的连接或管理方式。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/davidondrej/skills --skill bb-plugins

安装后在 Claude Code 中输入/bb-plugins确认已加载。

详细介绍

bb plugins

bb plugins 是运行在 bb 内部的 TypeScript 包，可用于扩展 bb。

许多第一方功能都是插件：GitHub、Docs、Memory、Tasks、Connect、Automations、Secrets、Keep Awake，以及编码 Agent 提供商。

信任

插件拥有完全信任权限。服务端代码在进程内运行。应用 UI 是同源页面代码，并非沙箱。主机工作进程以 Node 身份在已注册的机器上运行。

安装第三方插件前，请审查其源代码。将凭据保存在 secret: true 设置中。

此技能与其他技能的区别

  • 使用此技能创建、安装或更改插件。
  • 使用 bb-cli 操作 bb（线程、项目、环境）。
  • 如需查看准确的 API 签名，请先阅读 bb-plugin-authoring 技能（如果可用），然后运行 bb guide plugins。在插件目录中，先运行 bb plugin types，再信任本地 SDK 类型。不要根据经过压缩的 dist/ 文件猜测。

脚手架

bb plugin new hello            # add --app for a React UI
cd bb-plugin-hello
bb plugin install . --yes
bb plugin dev                  # rebuild + reload on save

清单是 package.json 中的 bb 对象。必需字段：bb.name、bb.description、bb.branding.icon、bb.server。可选字段：bb.app、bb.host、bb.skills、bb.themes。

插件 ID 是包名的最后一段去掉 bb-plugin- 前缀后的值。bb-plugin-hello 和 @acme/bb-plugin-hello 都会变成 hello。

将运行时导入项放在 dependencies 中。将类型和工具放在 devDependencies 中。Git 安装会运行 npm install --omit=dev。

插件可以添加的内容

server.ts 中的默认导出工厂会接收 BbPluginApi 并注册以下界面：

  • 设置、kv + SQLite 存储、HTTP、RPC、实时功能
  • 后台服务和 cron
  • 一个顶层 bb <name> … 命令
  • Agent 工具、skills/ 文件夹、额外指令
  • 提及提供商
  • 可选的主机工作进程和实验性 Agent 提供商

app.tsx 默认导出 definePluginApp，可以添加页面、线程面板操作、撰写框控件、文件打开器，以及替代侧边栏。

不要将完整 API 复制到此技能中。实现某个界面时，请阅读 bb-plugin-authoring。

安装和发布

bb plugin install .                                 # local path
bb plugin install github                            # bundled official plugin
bb plugin install npm:bb-plugin-notes@^1.0.0
bb plugin install git:https://github.com/acme/bb-plugin-notes.git@^1.2.0
bb plugin list
bb plugin reload <id>
bb plugin logs <id> -f

由于代码拥有完全信任权限，安装时会提示确认。传入 --yes 可跳过。

托管更新失败时会回滚。刷新目录不会安装代码。

社区插件列表位于 https://getbb.app/marketplace/v1/marketplace.json。请向 https://github.com/get-bb/marketplace 提交 PR。有关此工作流，请使用 submit-a-plugin 技能。

检查工作成果

  1. bb plugin list 显示插件状态为 running。
  2. 如果添加了 CLI，bb <command> --help 可以正常运行。
  3. 如果添加了 UI，请在 bb 中打开相应页面或面板，并确认其正常加载。
  4. 如果工厂抛出异常，插件状态会变为 error。请查看 bb plugin logs <id> 并修复，然后运行 bb plugin reload <id>。

评论

支持 Markdown