agentcompass summary

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

agentcompass summary [OPTIONS] RUN-DIR

重新生成摘要

RUN-DIR 应指向完整的 AgentCompass 结果目录，而不是其中的 details/ 子目录：

agentcompass summary \
  results/swebench_verified/my-model/20260703_120000

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

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

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。只有旧运行缺少聚合所需字段，或明确需要调整聚合参数时才使用；这些参数只影响本次汇总，不会重新评测任务。