> ## Documentation Index
> Fetch the complete documentation index at: https://agent-compass.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 文档更新

说明 provider 的准备方式、参数、资源、网络行为、运行示例和故障排查方法。

创建或更新以下英文页面，并同步更新本地化页面：

```text theme={"system"}
docs/en/user_guide/modules/environments/providers/<environment-id>.mdx
```

页面归属、本地化、导航、链接和验证要求遵循共享的[文档贡献指南](/zh/developer_guide/contributing/documentation)。

## 必要内容

文档必须包含：

* provider 是本地还是远程，以及可以在哪些操作系统上使用。
* 官方准备链接、身份验证、账号范围、配额和外部前置条件。
* 镜像、快照、命名镜像、模板、工作区和持久化行为。
* 每个公共参数的类型、默认值、单位、有效值和选择建议。
* CPU、内存、磁盘、GPU、放置策略和不支持的资源控制项。
* 准备、操作、空闲、生命周期、命令执行和删除操作各自的超时语义。
* 支持的网络模式、允许列表条目类型、阶段切换和限制。
* provider 启动限流和实际并发建议。
* 最小可运行命令与 provider 专属示例。
* 常见身份验证、镜像、权限、配额、超时、网络和清理错误。

## 解释推断值与显式值

明确区分用户直接传入的字段和 Recipe 推断出的值。如果 provider 支持自定义镜像或原生选择器，应展示覆盖方法并说明优先级。

运行配置中的网络设置应链接到[网络策略](/zh/user_guide/modules/environments/configuration/network)，跨 provider 的单位与容量规划应链接到[sandbox 资源限制](/zh/user_guide/modules/environments/configuration/resource_limits)，并发和重试行为应链接到[运行控制](/zh/user_guide/using_agentcompass/run_controls)。Benchmark 专属镜像名称和评测器规则留在 Benchmark 页面。

## 预览与验证

将新页面加入 `docs/docs.json`，同时预览正常与窄屏布局，再验证：

```bash theme={"system"}
cd docs
mint dev
mint broken-links
mint validate
```