> ## 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.

# Host Process

`host_process` 直接在运行 AgentCompass 的 host 上执行任务。它是默认 provider，启动最快，但不提供进程、文件系统、资源或网络隔离，只适合可信且明确支持本地执行的任务。

Linux 和 WSL 2 完整支持该 provider。macOS 仅适合 Benchmark 文档明确支持的轻量任务；原生 Windows 不受支持。

<Warning>
  agent 运行的命令拥有当前用户的权限，可以读取、修改或删除该用户可访问的文件。不要用 `host_process` 执行不可信命令。
</Warning>

## 使用前准备

使用前请确认：

* Benchmark 和 Harness 明确支持 `host_process`；
* 任务需要的命令、Python 包和本地服务已经安装；
* `workspace` 指向专用的可丢弃目录，而不是重要代码仓库或数据目录。

`host_process` 不需要额外凭证，会直接继承启动 AgentCompass 的用户环境。

<a id="运行一个任务" />

## 使用 `run` 验证配置

省略 `--env` 时也会选择 `host_process`。下面显式写出 provider，并通过 [`sample_ids`](/zh/user_guide/modules/benchmarks/overview#共享-benchmark-字段) 只运行一个任务，便于先确认任务实际运行在哪里：

```bash theme={"system"}
agentcompass run <benchmark> <harness> "$MODEL_NAME" \
  --env host_process \
  --benchmark-params '{"sample_ids":["<sample-id>"]}'
```

请将占位符替换为所选 Benchmark、Harness 和样本 ID。上面是 `agentcompass run` 的最小验证示例；模型端点等通用参数见 [`agentcompass run`](/zh/user_guide/using_agentcompass/cli/run)。

`host_process` 同样支持 `agentcompass launch`。在编排文件的 `defaults.environment` 中设置所有请求共享的配置，或在 `requests[].environment` 中设置单个请求；`id: host_process` 与 provider 参数写在同一层。详见 [`launch` 的映射规则](/zh/user_guide/using_agentcompass/cli/launch#映射规则)。

<a id="provider-参数" />

## 参数参考

参数可以通过 `--env-params` 传入，也可以写在配置文件的 `environments.host_process` 中。

例如，先创建一个专用工作区，再将以下选项添加到上面的 `agentcompass run` 命令。请把路径替换为已经存在的绝对路径：

```bash theme={"system"}
--env-params '{"workspace":"/path/to/disposable-workspace"}'
```

### 连接与凭证

`host_process` 不提供连接或凭证参数。任务直接继承启动 AgentCompass 的当前用户身份和 host 环境。

### 镜像与启动

`host_process` 不创建镜像或 sandbox，因此不提供镜像和启动参数。任务命令直接使用 host 上已经安装的程序和依赖。

### 标识与元数据

`host_process` 不创建独立的远程资源或容器，因此不提供运行实例名称、标签或其他 provider 元数据参数。

### 工作区与环境变量

| 字段                       | 默认值          | 说明                                                                                                          |
| ------------------------ | ------------ | ----------------------------------------------------------------------------------------------------------- |
| `workspace`              | `.`          | host 上执行命令和解析 provider 相对路径的目录。相对路径按启动 AgentCompass 时的当前工作目录解析；该目录必须在运行前存在，建议使用专用的绝对路径。                     |
| `default_workspace_root` | `workspace/` | Benchmark 未指定任务工作目录时，提供给 Harness 的默认 workspace。可以使用绝对路径；相对路径按 `workspace` 解析，但不会改变 `workspace` 本身设置的命令执行目录。 |

`host_process` 不提供单独的环境变量参数；任务进程继承启动 AgentCompass 时的 host 环境变量。

### 资源

`host_process` 不提供 CPU、内存或磁盘限制参数。任务与其他 host 进程共享资源，实际调度和限制由 host 操作系统处理。

### 网络

`host_process` 不提供 provider 专属网络参数，并且只支持通用网络策略中的 `public`。出站访问由 host 的网络配置和权限控制。

### 生命周期与超时

`host_process` 不创建需要管理生命周期的 sandbox，因此不提供 provider 专属生命周期或超时参数。评测总超时由[运行控制](/zh/user_guide/using_agentcompass/run_controls)设置。

## 参数参考来源

* 运行 `agentcompass config docs env host_process`，可以查看当前安装版本实际支持的字段、类型和默认值。
* `host_process` 直接使用 AgentCompass host，不对应独立的上游 provider；命令、路径和权限的实际行为由 host 操作系统与当前用户环境决定。

## 特有行为

* **没有隔离。** 任务共享 host 的文件系统、进程权限、已安装工具和环境变量。
* **只支持公共网络。** 无法限制出站访问，也无法在准备、agent 运行和验证阶段切换网络策略，详见[网络策略](/zh/user_guide/modules/environments/configuration/network)。
* **没有 provider 级资源限制。** CPU、内存和磁盘用量由操作系统管理，详见[资源限制](/zh/user_guide/modules/environments/configuration/resource_limits)。
* **不创建需要清理的 sandbox。** `--keep-environment` 对该 provider 没有实际作用。

## 故障排查

| 现象               | 检查内容                                                        |
| ---------------- | ----------------------------------------------------------- |
| 找不到命令或 Python 包  | 确认依赖安装在启动 AgentCompass 的同一环境中，并检查 `PATH`。                   |
| 相对路径指向意外位置       | 为 `workspace` 设置绝对路径，并确认目录存在。                               |
| 文件权限不足           | 检查当前用户、文件归属和父目录权限。                                          |
| 提示网络策略不受支持       | `host_process` 只支持 `public`；需要隔离时改用 Docker、Daytona 或 Modal。 |
| Benchmark 需要任务镜像 | 改用该 Benchmark 文档列出的容器或远程 provider。                          |

## 相关页面

* [Environment 概览](/zh/user_guide/modules/environments/overview)
* [配置 Environment](/zh/user_guide/modules/environments/configuration/overview)
* [运行控制](/zh/user_guide/using_agentcompass/run_controls)
* [安装与系统支持](/zh/get_started/installation)