企业官网建设流程全解析

background-agents的4种会话目标详解：单仓库、多仓库、环境、无仓库怎么选

【免费下载链接】background-agentsAn open-source background agents coding system项目地址: https://gitcode.com/GitHub_Trending/ba/background-agents

background-agents（Open-Inspect）是一个开源的后台智能体编程系统（background agents coding system）：你发送一条提示词，AI 编码会话就在云端沙箱中独立运行，你可以合上电脑、稍后回来收结果。创建会话时要做的第一个决定，就是选择会话目标（Session Target）——也就是沙箱要工作在什么代码上。background-agents 提供 4 种会话目标：单仓库、多仓库、环境（Environment）和无仓库。选对目标，直接决定会话的工作空间形态、速度和安全密钥注入方式。本文用大白话讲清 4 种目标的差异，帮你 1 分钟做出正确选择。

先搞懂：会话目标是什么？

会话（Session）是 background-agents 的基本工作单元。每个会话绑定一个"工作空间"，智能体就在这个克隆好的工作空间里读代码、改文件、跑测试、提 PR。

根据官方文档 HOW_IT_WORKS.md 的说明，你在网页选择器里看到的是 4 个选项：

目标一：单仓库会话——最经典的起步方式

单仓库是默认选项，也是新手最熟悉的形态：选一个仓库、选一个分支，沙箱克隆下来，智能体开工。

它的特点很简单：

• 🎯一个克隆、一个分支选择器，没有心智负担
• 推送和 PR 流程都是单仓库维度，结果清晰
• 首次会话会经历克隆、装依赖等初始化；之后可通过快照或预构建镜像秒级启动（详见 IMAGE_PREBUILD.md）

什么时候选它？90% 的日常任务都选它：修一个 bug、加一个功能、重构一个模块。

目标二：多仓库会话——一次搞定跨仓库联动

当你需要"前端改完还要同步改 API"时，单仓库就不够用了。多仓库会话让你临时勾选最多 10 个仓库，它们会并列克隆进沙箱。

关键机制有 3 点：

1. 并列克隆：每个仓库克隆到/workspace下以自己名字命名的独立目录，智能体可以一眼看到所有仓库、跨仓库做联动修改
2. 第一个仓库是主仓库（primary）：它决定默认配置（比如哪些设置项生效）
3. 推送与 PR 按仓库分别进行：一个会话可以同时给多个仓库各提一个 PR，会话侧栏会列出每个仓库的分支和 PR 状态

多仓库会话是"临时方案"——同样的工作区形态，但没有环境级密钥和预构建。选好后，选择器会主动建议你把这组仓库保存为环境（见下一节）。

什么时候选它？一次性、临时的跨仓库任务；或者你还不确定这组仓库以后是否会反复用到。

目标三：环境（Environment）——把常用仓库组合"存档"

环境是背景智能体场景下最值得理解的一个概念：它是一个有名字、可复用的仓库集合，在Settings > Environments中管理，并固定显示在新建会话选择器顶部。

一个环境定义了：

• ✅有序的仓库列表（最多 10 个），每个仓库可指定基础分支，第一个是主仓库
• ✅环境级密钥：从环境发起的会话会获得全局密钥 + 环境密钥（注意：仓库级密钥不会流入环境会话，规则见 SECRETS.md）
• ✅可选的预构建镜像：整套工作区（所有克隆 + 全部安装脚本）提前构建好，会话几秒内启动

还有一个重要细节：会话在创建时对环境做一次快照。之后你编辑或删除这个环境，都不影响已存在的会话——这让环境可以放心地持续演进。

什么时候选它？当"前端 + 它的 API"、"服务 + 共享库"这样的组合反复出现时，就把多仓库会话升级成环境：启动更快（预构建）、密钥更集中、团队里任何人一键就能打开完全相同的工作区。

目标四：无仓库——空沙箱自由发挥

第 4 个选项是无仓库：给你一个不克隆任何代码的空沙箱。别小看它——沙箱里依然是完整开发环境（Node.js、Python、git、浏览器自动化工具等）。

什么时候选它？

• 🔍 技术调研、读文档、查报错
• ✍️ 从零写一个小工具、脚本或文档
• 🧪 不碰任何现有代码的实验性尝试

它的存在让"空白的开始"成为一等公民，而不是"必须选个仓库凑合用"。

快速选择指南：4 种会话目标怎么选？

按这张决策清单走，基本不会选错：

1. 只涉及一个仓库？→ 单仓库，结束
2. 涉及多个仓库，但只做这一次？→ 多仓库（临时组合）
3. 多仓库组合会反复使用，或需要环境密钥/预构建提速？→ 环境（把组合存档）
4. 完全不碰代码？→ 无仓库

💡 一个顺滑的升级路径：先用多仓库会话试跑 → 发现常用 → 保存为环境 → 以后享受秒级启动。

机器人会话如何自动确定目标？

除了网页手动选择，background-agents 还支持从 Slack、GitHub、Linear 发起会话，目标由系统自动解析：

• GitHub：PR 审查或 @mention 默认打开 webhook 对应的仓库；但如果该仓库的元数据指定了默认环境，则会直接打开整个环境工作区
• Slack：可通过路由规则关键词、频道关联，或由 LLM 分类器（把仓库和环境的名称、描述作为判断信号）决定目标
• Linear：通过团队/项目映射中的environmentId条目指向环境

这些解析逻辑分别实现在控制平面的仓库解析与会话目标模块中，例如 session-target.ts 和 Web 端的选择逻辑 session-target.ts，多仓库自动化的设计细节可看 MULTI_REPO_AUTOMATIONS.md。

小结：一张表回顾 background-agents 会话目标

想进一步了解系统整体工作方式，建议从 HOW_IT_WORKS.md 开始，再按需阅读 SECRETS.md（密钥规则）与 IMAGE_PREBUILD.md（预构建加速）。选对会话目标，你的后台智能体就能以最快的速度、最正确的姿势开工 🚀

【免费下载链接】background-agentsAn open-source background agents coding system项目地址: https://gitcode.com/GitHub_Trending/ba/background-agents