> ## 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 准备、参数、资源、网络行为、示例和故障排查。

创建或更新 `docs/en/user_guide/modules/environments/providers/<environment-id>.mdx` 及其本地化对应页面。

## 必要内容

文档必须包含：

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

## 解释推断值与显式值

清晰区分用户直接传入的字段和 Recipe 推断值。provider 支持时，展示自定义镜像或 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
```