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

# 结果

> 理解 results 目录中的 details、summary、analysis、logs 和 progress 文件。

AgentCompass 默认把每次 run 写到 `results_dir`，通常是 `results`。

```text theme={null}
results/
└── <benchmark>/
    └── <model>/
        └── <timestamp>/
            ├── details/
            ├── logs/
            ├── params.json
            ├── progress.json
            ├── progress.jsonl
            ├── summary.md
            ├── analysis_summary.json
            └── analysis_summary.md
```

## Details

`details/` 包含 per-task JSON。成功样本通常以 task id 命名；可重试失败可能写成 `_error_<task_id>.json`。

如果启用了 analysis，每个 attempt 可能包含：

```text theme={null}
analysis_result.<AnalyzerId>
```

## Summary

`summary.md` 是 benchmark metrics 和 run metadata 的聚合视图。只重建 summary：

```bash theme={null}
agentcompass summary \
  results/<benchmark>/<model>/<run>
```

## Analysis Summary

`analysis_summary.json` 和 `analysis_summary.md` 聚合 analyzer 输出。重新分析：

```bash theme={null}
agentcompass analysis \
  --input results/<benchmark>/<model>/<run> \
  --analysis-params '{"analyzers":["ExceptionAnalyzer"]}'
```

## Progress

`progress.json` 保存最新结构化状态；`progress.jsonl` 保存事件流，外部监控应优先读取它，而不是解析日志文本。

## 本地结果查看器

如需用本地 Web 界面查看 `summary.md`、progress 和单任务 details，可从仓库 checkout 启动结果查看器：

```bash theme={null}
cd tools/result-browser
npm install
npm run dev
```

打开 dev server 输出的 Vite 地址，并输入 run directory 绝对路径，例如 `/path/to/AgentCompass/results/<benchmark>/<model>/<run>`。该路径会在运行 `npm run dev` 的机器上解析，通过端口转发访问 UI 时也是如此。
