云端环境与启动流程

Cursor 托管 Cloud Agents 使用隔离的 Ubuntu 机器。环境应具备仓库、依赖、测试工具、密钥和网络访问，让 Agent 可以验证修改。

创建与解析

从 Cloud Agents dashboard 的 Environments 创建环境，选择一个或多个仓库。推荐使用引导设置，让 Agent 安装依赖、验证代码并完成首个 Build；也可使用 Dockerfile 手工定义。

配置按以下顺序取第一个匹配：仓库 .cursor/environment.json、个人保存环境、团队保存环境。多仓环境按仓库组复用，可支持跨仓修改和测试。

这些设置针对 Cursor 托管运行时。Self-Hosted Machines 只使用环境中的仓库信息，不读取 environment.json，也不从 Build 启动。

安装与启动分工

字段	执行时机	放什么
install	创建 Build 时	依赖安装、代码生成、编译、磁盘缓存
start	每次 Agent 启动时	Docker、数据库、隧道等服务
terminals	start 后	在共享 tmux 终端中的应用进程

install 必须可重复执行并正常结束，可能在已经准备过的磁盘上运行。不要在其中放一直不退出的服务；Build 只保留磁盘，不保留运行进程、shell export 或内存缓存。

团队使用

把可版本管理的设置提交到 .cursor/environment.json，并在 AGENTS.md 中增加云端专用测试说明。详细步骤较长时引用其他文件，避免每次重新解释环境。

托管多仓环境可以协调多个仓库，但 Cloud Agents 不等同于编辑器的 multi-root workspace。Long running 功能当前也不支持多仓环境，应按具体功能分别核对。

变更与恢复

环境页可以查看历史、用 Update with Agent 调整、用 New Setup Run 重新配置，或从历史 Restore。失败 Build 不替换现有成功环境；诊断流程见Builds。