# Agent Completion Research Site

中文研究文档，用网页呈现“Agent 如何证明完成、验证器怎样误判、失败后如何恢复”的
全文审计结论。

首页是当前研究结论，旧的 K1412 Agent Evaluation v1 说明页保留在：

```text
/evaluation-v1.html
```

网页是阅读层，事实源仍是：

- `research/completion-verification/findings.md`
- `research/completion-verification/evidence-ledger.md`

## Build Evidence Data

证据浏览器由 Markdown 账本确定性生成：

```bash
python3 evaluation-site/build_research_data.py
python3 evaluation-site/build_research_data.py --check
```

`tools/check_project.py` 会检查生成数据的 SHA-256、40 篇全文池、37 篇审计记录和
26 篇核心证据，防止网页与研究源漂移。

## Local Preview

```bash
python3 -m http.server 4173 --directory evaluation-site
```

打开：

```text
research document: http://127.0.0.1:4173/
archived v1 report: http://127.0.0.1:4173/evaluation-v1.html
```

## Production

- app slug: `agent-eval`
- container port: `8080`
- health path: `/health`
- public URL: `https://agent-eval.k1412.top/`
- deployment: k1412 Unraid Compose Manager
- NAS host port: `12005`

生产部署必须使用不可变镜像，并在这里和项目状态文档中记录最终 tag。