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

`agentcompass summary` 根据已有运行目录中的任务结果重新计算 Benchmark 聚合指标，并更新汇总文件。它不会重新运行 agent、验证器或分析器。

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

## 重新生成摘要

`RUN-DIR` 应指向完整的 AgentCompass [结果目录](/zh/user_guide/other_features/results#目录布局)，而不是其中的 `details/` 子目录：

```bash theme={"system"}
agentcompass summary \
  results/swebench_verified/my-model/20260703_120000
```

AgentCompass 会读取已保存的任务结果，并使用对应 Benchmark 的聚合逻辑重新计算指标。默认在原目录创建或覆盖 `summary.md` 和内部计数文件 `.summary_counts.json`，不会修改任务结果。

## 预览摘要

在写入文件前，可以使用 `--dry-run` 在终端中预览新的 `summary.md`：

```bash theme={"system"}
agentcompass summary \
  results/swebench_verified/my-model/20260703_120000 \
  --dry-run
```

此模式不会更新运行目录中的任何文件。

## 参数

| 参数                          | 是否必需 | 默认值 | 作用                                                         |
| --------------------------- | ---- | --- | ---------------------------------------------------------- |
| `RUN-DIR` / `--run-dir`     | 必需   | 无   | 指定已有的 AgentCompass 运行目录。                                   |
| `--config <path>`           | 可选   | 无   | 加载用于补充 Benchmark 配置的 YAML 或 JSON 文件；可重复指定。运行目录中已保存的同名参数优先。 |
| `--benchmark-params <json>` | 可选   | 无   | 使用 JSON 对象覆盖从运行目录恢复的 Benchmark 参数。                         |
| `--dry-run`                 | 可选   | 关闭  | 将重新生成的 Markdown 输出到终端，不写入文件。                               |

通常无需提供 `--config` 或 `--benchmark-params`。只有旧运行缺少聚合所需字段，或明确需要调整聚合参数时才使用；这些参数只影响本次汇总，不会重新评测任务。

## 相关页面

* [汇总与分析结果](/zh/user_guide/other_features/results/summary_analysis)
* [`agentcompass analysis`](/zh/user_guide/using_agentcompass/cli/analysis)
* [`agentcompass config`](/zh/user_guide/using_agentcompass/cli/config)
* [CLI 概览](/zh/user_guide/using_agentcompass/cli/overview)