Present completion research as web document

evaluation-site/README.md

@@ -1,6 +1,30 @@
-# Agent Evaluation Site
+# Agent Completion Research Site
 
-中文交互式报告，用于展示 K1412 Agent Evaluation v1 的结论、任务契约、发布门禁和相关产物。
+中文研究文档，用网页呈现“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
 
@@ -8,7 +32,12 @@
 python3 -m http.server 4173 --directory evaluation-site
 ```
 
-打开 `http://127.0.0.1:4173/`。
+打开：
+
+```text
+research document: http://127.0.0.1:4173/
+archived v1 report: http://127.0.0.1:4173/evaluation-v1.html
+```
 
 ## Production
 
@@ -18,10 +47,5 @@ python3 -m http.server 4173 --directory evaluation-site
 - public URL: `https://agent-eval.k1412.top/`
 - deployment: k1412 Unraid Compose Manager
 - NAS host port: `12005`
-- immutable image: `docker.k1412.top/wuyang/agent-eval:20260727T084425Z-cd1eacb`
 
-网页是阅读入口，事实源仍是：
-
-- `research/evaluation/k1412-agent-evaluation-v1.md`
-- `data/evaluation/k1412-agent-eval-task-contracts-v1.json`
-- `tools/evaluation/score_agent_runs.py`
+生产部署必须使用不可变镜像，并在这里和项目状态文档中记录最终 tag。