bb SDK 编程指南：用 BBSdk 以代码驱动你的 AI 编码工作流

bb SDK 编程指南用 BBSdk 以代码驱动你的 AI 编码工作流【免费下载链接】bbThe agent IDE that builds itself项目地址: https://gitcode.com/gh_mirrors/bb14/bbbb 是一款「自我构建的智能体 IDEagentic IDE」而BBSdk是它官方提供的 Node.js 编程接口你可以用几行 TypeScript 代码在 bb 服务上创建 AI 线程thread、派发编码任务、等待结果并拉取输出把原本要在界面里点按的操作变成可脚本化、可自动化的工作流。本指南面向新手带你从安装到订阅实时事件完整掌握 bb SDK 编程。为什么需要 bb SDK三种驱动方式任选bb 的每一个交互面都是一等公民Web 应用、CLIbb命令行和HTTP API SDK。如果你已经熟悉用界面操作SDK 就是「界面的可编程版本」驱动方式适合场景Web 应用日常开发、可视化跟踪线程CLInpx bb-app bb终端脚本、一次性命令BBSdk本文主角CI/CD、批处理、二次开发、自建机器人 bb 会复用你本机已配置的编码代理凭据如 Claude Code、Codex、Cursor、Pi 等 ACP 兼容代理无需额外申请密钥即可跑通大部分示例。快速上手先让 bb 跑起来BBSdk 需要连接一个正在运行的 bb 服务因此第一步是启动服务npx bb-applatest启动后访问http://localhost:38886。状态默认存放在~/.bb/日志位于~/.bb/logs/。若你使用的是源码仓库可以 clone 后在本地开发git clone https://gitcode.com/gh_mirrors/bb14/bb环境要求Node.js 22.19 / 24 / 26、Git以及至少一个受支持的代理提供方详见 packages/bb-app/README.md 的 Prerequisites 章节。创建 BBSdk 实例连接 bb 服务的最快方式SDK 从bb-app包导出BBSdk类封装见 packages/bb-app/src/public-sdk.ts底层由bb/sdk包实现核心组装逻辑在 packages/sdk/src/core.tsimport { BBSdk } from bb-app; // 默认连接本机 127.0.0.1:38886与 CLI 相同的配置解析 const bb new BBSdk(); // 连接远程或测试环境时显式指定地址 const remote new BBSdk({ baseUrl: http://192.168.1.50:38886 });三个实用细节环境变量优先BB_SERVER_URL可覆盖默认地址与 CLI 行为完全一致bb 拉起的脚本免配置由 bb 自身启动的脚本会自动注入BB_SERVER_URL与BB_THREAD_ID内置超时与错误类型BbHttpError、BbRequestTimeoutError、ThreadWaitTimeoutError等异常可直接catch方便在自动化里做健壮的错误处理。认识 SDK 的 13 个功能区域AreaBBSdk把 bb 的全部能力组织成命名空间按主题分区域areas这也是阅读 packages/sdk/src/areas/ 源码时最直观的导航区域能力典型方法bb.threads线程生命周期spawn/send/wait/output/fork/stopbb.projects项目管理list/create/updatebb.environments工作环境含 Git worktreelist/diff/pullRequest/commitbb.providers代理提供方与模型list/modelsbb.plugins插件市场与安装install/enable/checkUpdatesbb.skills技能Skills注册表search/get/installbb.hosts多设备 / 远程主机list/createJoinCodebb.terminals终端会话列表 / 读写输出bb.files文件读写read/write/listbb.statusbb.systembb.theme状态 / 系统 / 主题getbb.subscribe实时事件订阅见下文subscribe 命名规律每个区域都暴露list / get / create或等价方法方法签名全部带完整 TypeScript 类型编辑器自动补全即可上手。实战示例用 5 行代码跑完一个 AI 编码任务这是 packages/bb-app/README.md 官方给出的「最小闭环」派发 → 等待 → 取结果。线程相关的完整 API 定义见 packages/sdk/src/areas/threads.ts。import { BBSdk } from bb-app; const bb new BBSdk(); // 1. 在指定项目、指定工作环境中生成一个 AI 线程并下发提示词 const thread await bb.threads.spawn({ projectId: proj_personal, environment: { type: host, workspace: { type: personal } }, prompt: Summarize my active bb work., }); // 2. 阻塞等待线程进入 idle默认超时 20 分钟 await bb.threads.wait({ threadId: String(thread.id), status: idle }); // 3. 打印线程输出 console.log(await bb.threads.output({ threadId: String(thread.id) }));进阶玩法都对应bb.threads下现成方法中途追加指令bb.threads.send(...)在运行中的线程里补一句话分叉实验bb.threads.fork(...)从某条消息复制出平行分支互不污染紧急叫停bb.threads.stop(...)检索历史bb.threads.search(...)按关键词翻历史线程。免轮询监控订阅 bb 实时事件SDK 内置 WebSocket 实时通道类型定义见 packages/sdk/src/realtime-types.ts。订阅thread:changed事件后线程状态一变开始运行、等待确认、跑完转 idle你的回调立刻触发无需轮询const stopSub bb.subscribe({ event: thread:changed, callback: (evt) console.log(线程变化:, evt), }); // 需要时取消订阅 stopSub();支持的事件共 7 类thread:changed、project:changed、environment:changed、host:changed、system:changed、system:config-changed、realtime:connection连接状态心跳。三个高频自动化场景清单CI 里做「AI 代码审查」构建通过后spawn一个线程审查 PR diffwaitoutput后把结论写回构建日志批量重构脚本projects.list()拉取全部项目对每个项目循环threads.spawn下发统一的重构指令值班机器人常驻进程subscribe(thread:changed)线程一旦卡在等待确认pending interaction就推送通知send代用户回复。深入阅读与源码路径想继续深入按此顺序阅读收益最高packages/bb-app/README.md — 安装、CLI、SDK 速览Scripting with the SDK 小节packages/sdk/src/node.ts — Node 端入口createNodeBbSdk如何解析配置与BB_SERVER_URLpackages/sdk/src/core.ts — 13 个区域的组装方式BbSdk接口的完整定义packages/sdk/src/transport-http.ts 与 packages/sdk/src/realtime.ts — HTTP 传输层与实时通道实现docs/repository-overview.md — 仓库整体架构概览理解 SDK 在 bb 中的位置docs/system-overview.md — 系统级运作机制小结bb SDKBBSdk把 bb 智能体 IDE 的全部核心能力开放成了类型安全的代码接口new BBSdk()连接服务threads.spawn → wait → output完成最小任务闭环subscribe实现事件驱动的实时监控。掌握这三步你就拥有了一个可编程的 AI 编码工作流底座——剩下的只是把创意写进脚本里。【免费下载链接】bbThe agent IDE that builds itself项目地址: https://gitcode.com/gh_mirrors/bb14/bb创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考