background-agents的8大核心功能清单:从多人会话到定时自动化全覆盖
【免费下载链接】background-agentsAn open-source background agents coding system项目地址: https://gitcode.com/GitHub_Trending/ba/background-agents
background-agents(项目内部代号 Open-Inspect)是一个开源的背景 Agent 编码系统,它让 AI 在云端隔离沙箱里后台自主写代码,你可以从 Web、Slack、GitHub、Linear 或 Webhook 任意入口下发任务,随后关掉笔记本,回来再看结果。本文以清单形式拆解它覆盖「多人会话 → 定时自动化」全链路的 8 大核心功能,帮助你在动手部署前快速建立全局认知 🚀
一功能总览:8 大核心能力速查表
| # | 核心功能 | 一句话价值 | 关键文档 |
|---|---|---|---|
| 1 | 多人协作会话 | 多人同屏实时协作写代码 | docs/HOW_IT_WORKS.md |
| 2 | 后台秒级启动 | 快照 + 预热,会话几乎零等待 | docs/HOW_IT_WORKS.md |
| 3 | 多仓库与环境 | 一个会话跨 10 个仓库协同 | docs/HOW_IT_WORKS.md |
| 4 | 多模型支持 | Claude / GPT / Grok 随心切换 | docs/AVAILABLE_MODELS.md |
| 5 | 多客户端集成 | Slack、GitHub、Linear 直接派单 | docs/integrations/SLACK.md |
| 6 | 定时自动化 | cron、Sentry、Webhook 全托管 | docs/AUTOMATIONS.md |
| 7 | 并行子会话 | 拆分子任务到独立沙箱并行跑 | docs/HOW_IT_WORKS.md |
| 8 | 托管技能 | 沉淀可复用指令,告别重复提示词 | docs/MANAGED_SKILLS.md |
下面逐个展开。每个功能都尽量配「你会看到什么」,方便你对照实际界面。
功能 1:多人协作会话,多人同屏实时写代码
普通 AI 编码助手是「一人一屏」,而 background-agents 的会话(Session)天生支持多人加入:
- 在线状态(Presence):实时显示谁正在这个会话里
- 共享事件流:所有人的客户端看到的是同一条工具调用 / 令牌流
- 署名提示词:每条提示词都会标记发送者,并落到对应的 git 提交作者上
这让一个会话非常适合结对编程、现场排障、带新人——一个人发起任务,另一个人接着补充修改。所有状态存在控制平面而非某个客户端里,因此「在 Slack 里发提示、在 Web 上回看结果」天然成立。
功能 2:后台运行,会话秒级启动零等待
传统助手的冷启动要经历「起容器 → 克隆仓库 → 装依赖 → 起 Agent」,动辄几分钟。background-agents 用三层预热把等待压到近乎为零:
- 文件系统快照——每次提示词完成后保存沙箱状态,续聊时直接恢复而不是重新克隆
- 预构建镜像——按仓库或环境开启,每 30 分钟用最新提交和依赖重建
- 主动预热——你开始打字时沙箱就已经在拉起了,等你按下回车它往往已就绪
结果:同一会话里的追问,比第一次快得多。性能细节见docs/HOW_IT_WORKS.md的快照与预热章节。
功能 3:多仓库会话与「环境」,一次处理最多 10 个仓库
一个会话不再被限制在单个仓库:
- 临时多选:新建会话时最多勾选10 个仓库,它们被并排克隆,Agent 可做跨仓库的协同改动,并为每个仓库分别开 PR
- 环境(Environment):把一组仓库存成可复用的命名环境,拥有独立的作用域密钥和可选的预构建镜像,之后像选仓库一样一键拉起
- 会话在创建时对环境做快照:之后修改或删除环境,都不会影响已存在的会话
前端 + 后端 API、服务 + 共享库这类「固定组合」,存成环境后就能反复秒开。
功能 4:多模型支持,Claude / GPT / Grok 随心切换
按任务挑模型,并支持每个会话单独调节推理力度(reasoning effort):
| 提供方 | 代表模型 |
|---|---|
| Anthropic | Claude Haiku / Sonnet / Opus / Fable 系列 |
| OpenAI | GPT 5.x、Codex 系列(可走 ChatGPT 订阅 OAuth,无需单独 API Key) |
| xAI / SuperGrok | Grok 系列(可选开启) |
| OpenCode Zen | Kimi、MiniMax、Qwen、GLM 等(可选开启) |
OpenAI 模型可复用你现有的 ChatGPT 订阅;Grok 走 SuperGrok 订阅。完整模型清单见docs/AVAILABLE_MODELS.md,订阅配置见docs/OPENAI_MODELS.md与docs/GROK_MODELS.md。
功能 5:多客户端集成,从 Slack / GitHub / Linear 直接派单
background-agents 的架构是客户端无关的——只要能发 HTTP 请求并维持 WebSocket 的入口都能接入:
- Web UI:完整会话管理、模型/推理选择器、终端面板、多人在线状态
- Slack Bot:@提及或私信即开会话,支持图片附件,结果按线程回复
- GitHub Bot:PR 打开时自动评审,或响应 PR 评论里的 @提及(按仓库可配置)
- Linear Bot:在 issue 上 @ 或指派 Agent 即启动编码会话,回传进度并关联 PR
- Webhooks:任意外部系统通过鉴权 HTTP POST 触发会话
各集成的详细配置见docs/integrations/SLACK.md、docs/integrations/GITHUB.md、docs/integrations/LINEAR.md。
功能 6:定时自动化,cron / Sentry / Webhook 全托管
「自动化(Automations)」让你一次定义仓库配置、模型和指令,触发器一响就自动开会话,全程无需人工:
- Cron 计划:每小时 / 每日 / 每周 / 每月,或自定义 5 段 cron(支持时区,最小间隔 15 分钟)
- Sentry 告警:新错误、回归、关键指标告警时自动分诊
- 入站 Webhook:用 JSONPath 条件过滤,决定哪些 payload 才真正开会话
- 多仓库扇出:一条计划任务可跨最多 10 个仓库,每个仓库各开一个会话和 PR
- 自愈保护:连续 3 次失败自动暂停、一键手动触发、完整运行历史
典型用法:夜间依赖更新、部署/故障事件响应、定期生成报告。完整配置见docs/AUTOMATIONS.md。
功能 7:并行子会话,把大任务拆成多路并行
Agent 可以把工作拆成并行的子会话,在各自的沙箱里同时推进:
spawn-child:创建一个独立沙箱的子会话并立即返回,父会话继续干活send-child-prompt:向已存在的直接子会话追加后续指令(进入其持久队列,不中断当前工作)get-child-status/cancel-child:协调子会话的状态与取消- 内置深度限制与按仓库的护栏,防止无限递归
这让你「一次指令,多路并行」,大幅缩短跨模块、跨方案探索的总耗时。
功能 8:托管技能,沉淀可复用指令告别重复提示词
托管技能(Managed Skills)把可复用的指令和支持文件标准化,部署、代码评审、事故响应、项目专属约定都只需写一次:
- 共享技能:给所有人复用,可按「全局 / 指定仓库 / 指定环境」分配
- 个人配置(Profile):保存你常用的一组技能,建会话时一键套用
- 修订固定:每次会话在创建时钉死确切的技能版本,保证行为可复现
- 从仓库导入:可直接把仓库里的
SKILL.md+ 支持文件导入为托管技能
会话右侧边栏的「Managed skills」会告诉你本次到底带上了哪些技能、哪个版本、为什么匹配。使用指南见docs/MANAGED_SKILLS.md。
每个沙箱里有什么?完整开发环境开箱即用
每个会话都跑在一个隔离沙箱里,预装完整开发环境:
- Node.js 22、Python 3.12、Bun、git、GitHub CLI、build-essential
- 浏览器自动化:agent-browser CLI + 无头 Chromium,可做截图、视觉 diff、UI 校验
- code-server:浏览器里的 VS Code,直连会话工作区
- Web 终端:ttyd 驱动的终端,可从会话 UI 访问
- 端口隧道:最多暴露 10 个开发服务器端口,URL 写入
/workspace/.tunnels.env - 密钥管理:AES-256-GCM 加密,支持全局 / 按仓库 / 按环境三级作用域,启动时注入为环境变量
架构速览:三层分离,状态集中
- 控制平面(Cloudflare Workers + Durable Objects):只管状态与路由,每个会话一个独立 SQLite 库
- 数据平面(沙箱后端):代码真正运行的地方,支持 Modal / Daytona / Vercel Sandboxes / OpenComputer / E2B 五种后端
- 客户端(Web / Slack / GitHub / Linear):只做交互,状态都在控制平面,因此跨端一致
⚠️ 安全提示:该系统面向单租户部署设计,所有用户共享同一 GitHub App 凭证,适合组织内部可信成员。部署建议见
docs/HOW_IT_WORKS.md与docs/GETTING_STARTED.md。
快速开始:三步跑起你自己的实例
- 克隆仓库并安装依赖
git clone https://gitcode.com/GitHub_Trending/ba/background-agents cd background-agents npm install - 按
docs/GETTING_STARTED.md用 Terraform 部署,只需创建云账号、填一个terraform.tfvars - 进入 Web 界面,选仓库或环境,发第一条提示词——后台会话即刻启动
小结:为什么 background-agents 值得放进你的工具箱
它把「AI 编码」从实时盯着的聊天框升级为可后台、可并行、可多人、可定时的工程系统:
- 用多人会话把 AI 变成团队公共算力
- 用快照 + 预热把等待时间压到零
- 用自动化让 Agent 在 cron、Sentry、Webhook 下无人值守值守
- 用托管技能把团队最佳实践固化为可复用资产
先读docs/HOW_IT_WORKS.md理解核心概念,再按docs/GETTING_STARTED.md部署,即可在自己的组织里跑起来。
【免费下载链接】background-agentsAn open-source background agents coding system项目地址: https://gitcode.com/GitHub_Trending/ba/background-agents
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考