Builds 预构建与恢复

Build 提前准备基础镜像、各仓库和 install 结果，再保存可启动的磁盘快照。新 Agent、自动化和代码评审默认使用环境最新成功的 active Build。

触发与状态

触发	行为
Recurring	定期检查仓库默认分支、配置和密钥变化
Configuration change	保存配置或修改密钥后构建
Manual	Builds 页 Trigger build
Agent-requested	Agent 申请测试环境配置

Recurring 没有变化时记录 Skipped，不执行 install，不替换 active Build。其他三种触发不会这样跳过。失败的新 Build 保留现有成功版本，不会让所有后续任务改用失败环境。

Git 与新鲜度

Build 记录每个仓库的确切 commit。默认分支任务从该记录启动；开启 Update stale builds 后，超过 Staleness threshold 才在启动时 pull 最新代码。阈值默认 24 小时，设为 0 表示总是拉取。

关闭该开关时使用 Build 记录的提交，不保证是启动时最新 HEAD。Feature branch 则在准备好的磁盘上检出请求分支，并按需要刷新依赖。

保存了什么

只保存磁盘状态，不保留进程、shell exports 或内存缓存。团队和环境 secrets 可用于 Build，用户 secrets 只在 Agent 启动时加入，不进入共享快照。Build 包含在 Cloud Agents 中，官方说明无额外 Build 收费。

验证与恢复

在环境 Builds 页查看类型、状态、日志和提交，手动触发、取消、选择 active Build，或从指定 Build 启动 Agent。每次运行记录使用的 Build，便于对照故障发生时的环境。

失败时可以从失败 Build 启动诊断 Agent，在失败状态中检查日志、修改设置并运行测试 Build。首个成功 Build 尚未完成时继续使用标准环境启动流程；自托管机器从现有机器状态运行，不使用这些 Builds。