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

# agentcompass view

`agentcompass view` 在本地启动结果查看器，你可以在浏览器中查看一次运行的指标、摘要、任务结果和逐步轨迹，也可以在多个运行之间切换。它只读取结果文件，不会修改运行目录。

```bash theme={"system"}
agentcompass view [OPTIONS] [RUN-DIR]
```

## 快速开始

传入一个 AgentCompass [运行目录](/zh/user_guide/other_features/results#目录布局)：

```bash theme={"system"}
agentcompass view \
  results/my-model_swebench_verified_mini_swe_agent/20260703_120000
```

查看器会在终端输出访问地址（默认 `http://127.0.0.1:8765`），并用系统浏览器打开该运行。在终端按 `Ctrl+C` 即可停止查看器。

<Frame caption="结果查看器">
  <img src="https://github.com/user-attachments/assets/4712aeaa-4693-41c7-8336-4388eac08dce" alt="结果查看器的整体界面：左侧为结果目录树，右侧为运行概览和任务列表" />
</Frame>

页面上方是运行概览，包括核心指标、结果分布条、指标详情和汇总；下方是任务卡片列表，卡片颜色表示任务结果。点击分布条的任一段可以筛选任务，也可以在列表工具栏中按 task ID 搜索或按类别筛选。

省略 `RUN-DIR` 时，查看器打开首页，你可以在顶栏输入路径，或从最近打开的目录中选择。路径在运行查看器的机器上解析。顶栏右侧可以切换中英文界面。

## 查看任务详情与轨迹

点击任务卡片即可打开详情页：

* **左侧**：主指标、状态、尝试次数、重试次数、耗时等概要信息，以及分析器发现和重试诊断。
* **右侧**：任务有多次尝试时，可在顶部切换 attempt；存在问题时，先显示问题列表和异常堆栈，然后依次是最终输出和轨迹。
* **轨迹**：每一步默认折叠，只显示一行预览、工具调用次数和耗时；展开后可查看思考、回复、工具调用参数和观测。

<Frame caption="任务详情">
  <img src="https://github.com/user-attachments/assets/aad3abbb-8a9a-4c38-8ed1-36d571b177d1" alt="任务详情：左侧为任务概要，右侧为最终输出和展开的轨迹步骤" />
</Frame>

需要在终端中进一步查看原始文件时，点击详情页页头的复制按钮，即可复制任务文件的完整路径。

## 在运行之间切换

加载运行目录后，左侧边栏以目录树展示它所在的结果根目录。点击目录可以展开或折叠，点击运行目录即可切换到该运行；点击侧边栏的刷新按钮，可以显示新产生的运行。点击顶栏左侧的按钮，可以隐藏或显示侧边栏。

你也可以直接打开结果根目录，再在侧边栏中选择运行：

```bash theme={"system"}
agentcompass view results
```

## 查看进行中的评测

评测运行期间也可以打开查看器。未完成的任务显示为执行中的卡片，并标出当前阶段，不计入任务总数。查看器会为进行中的评测自动开启定时刷新，你也可以在任务列表工具栏中关闭自动刷新，或随时手动刷新。如果评测已经异常退出，残留的未完成任务会显示为已中断。

## 在远程机器上查看

结果位于远程机器时，在远程机器上使用 `--no-open` 启动查看器，再从本地转发端口：

```bash theme={"system"}
agentcompass view results/my-run/20260703_120000 --no-open
```

```bash theme={"system"}
ssh -L 8765:127.0.0.1:8765 user@remote-host
```

然后在本地浏览器中打开终端输出的地址。

<Warning>
  查看器默认只监听 `127.0.0.1`。使用 `--host 0.0.0.0` 等非回环地址时，能访问该端口的任何人都可以读取这台机器上当前用户可读的结果文件。
</Warning>

## 从源码安装时构建前端

发布包已包含查看器前端。如果你通过克隆仓库并以可编辑模式（`pip install -e .`）安装 AgentCompass，首次运行 `agentcompass view` 时会自动在 `tools/result-browser` 下执行 `npm ci` 和 `npm run build`，构建产物写入 `src/agentcompass/viewer/static/`。首次构建需要联网下载 npm 依赖。

自动构建需要 Node.js 20.19+ 或 22.12+。未安装 Node.js 或版本过低时，命令会报错并提示安装。

构建产物已存在时不会再次构建。更新代码后，使用 `--rebuild` 重新构建前端：

```bash theme={"system"}
agentcompass view --rebuild
```

## 参数

| 参数 | 是否必需 | 默认值 | 作用 |
| - | - | - | - |
| `RUN-DIR` / `--run-dir` | 可选 | 无 | 启动后直接打开的运行目录或结果根目录。 |
| `--host <address>` | 可选 | `127.0.0.1` | 监听地址。 |
| `--port <port>` | 可选 | `8765` | 首选端口；被占用时依次尝试后续端口。 |
| `--open` / `--no-open` | 可选 | `--open` | 是否用系统浏览器打开查看器。 |
| `--rebuild` | 可选 | 关闭 | 启动前从源码重新构建前端，仅适用于源码安装。 |

## 相关页面

* [结果与输出](/zh/user_guide/other_features/results)
* [`agentcompass summary`](/zh/user_guide/using_agentcompass/cli/summary)
* [`agentcompass analysis`](/zh/user_guide/using_agentcompass/cli/analysis)
* [CLI 概览](/zh/user_guide/using_agentcompass/cli/overview)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.