# 自行验证

`azoth-verify` 无需 Azoth 即可检查档案或回执：没有依赖、没有网络调用、与生成方不共享任何代码——因此其结论不依赖于对我们的信任。

## 在命令行中

从**证据 › 验证**下载验证工具（一个 ZIP，旁边附有其 SHA-256），解压后使用 Node.js 18 或更高版本运行：

```
shasum -a 256 -c azoth-verify.zip.sha256
unzip azoth-verify.zip -d azoth-verify && cd azoth-verify

node bin/azoth-verify.mjs dossier.zip --keys keys.jwks.json                          # PASS / FAIL per check, exit 0 / 1
node bin/azoth-verify.mjs dossier.zip --keys keys.jwks.json --json                   # machine-readable
node bin/azoth-verify.mjs dossier.zip --keys keys.jwks.json --tsa-root tsa-root.pem  # pin the time-stamping root too
node bin/azoth-verify.mjs receipt receipt.txt --dossier dossier.zip --keys keys.jwks.json
```

## 在浏览器中离线验证

`/azoth-verify.html` 是一个独立的页面，在浏览器中运行相同的检查，完全不访问网络。“证据 › 档案”和“证据 › 验证”中的**自行验证**按钮会打开它；在主页上，它会打开最近一次已验证的决策，该决策的**导出并验证此决策**会下载其档案并在旁边打开此页面。请保存一份副本：它无需 Azoth 即可使用。

[/azoth-verify.html](https://www.azothos.ai/azoth-verify.html)

## 用示例试一试

一份包含五项合成决策的演示档案、演示工作区的公钥，以及其中一次调用的回执——均由 Azoth 自身的导出代码生成，并使用一个私钥部分从未被写入的演示密钥签名。下载这三个文件，然后运行：

[demo-dossier.zip](https://www.azothos.ai/verify-examples/demo-dossier.zip) · [demo-keys.jwks.json](https://www.azothos.ai/verify-examples/demo-keys.jwks.json) · [receipt.txt](https://www.azothos.ai/verify-examples/receipt.txt)

```
node bin/azoth-verify.mjs demo-dossier.zip --keys demo-keys.jwks.json
node bin/azoth-verify.mjs receipt receipt.txt --dossier demo-dossier.zip --keys demo-keys.jwks.json
```

在浏览器页面中选择 `demo-dossier.zip`，并选择 `demo-keys.jwks.json` 以固定其密钥。修改档案中的任意一个字节后再次验证：验证会失败。

## 开源

验证工具采用 Apache-2.0 许可证发布：任何人都可以阅读、运行和修改它。其代码与 ZIP 包和浏览器页面中的代码相同。

[github.com/azothos/azoth-verifier](https://github.com/azothos/azoth-verifier)

每个版本还会发布到其独立的公共代码库和 npm——使用 Node.js，无需事先下载任何内容：

```
npx -y @azothos/verifier demo-dossier.zip --keys demo-keys.jwks.json
npx -y @azothos/verifier receipt receipt.txt --dossier demo-dossier.zip --keys demo-keys.jwks.json
```

## 检查内容

- 每个文件与清单是否一致，以及根哈希；
- 已封存决策的哈希链；
- RFC 3161 时间戳，对照您用 `--tsa-root` 固定的根证书；
- 每种档案：决策、事件、合规、诉讼、成本耗尽、AI 足迹；
- 回执：其格式、密钥、签名以及它所指向的决策；
- 每项决策的适用法律，根据其封存记录重新裁决；
- 档案的签名（自 2.0.0 版起必需），对照您用 `--keys` 固定的密钥，以及签名所涵盖的内容：导出时的日志头、所列条目和筛选条件；
- 自 2.1.0 版起，每个条目的时间、执行者类型和追踪，对照其封存内容；
- 每笔已封存的成本，根据其封存的价格和签名的模型目录重新计算。

> 信任来自您所固定的内容：发布在 `/api/proof/keys/<workspaceId>` 的密钥，以及时间戳机构的根证书。没有这些密钥，档案无法通过验证：档案自带的密钥只能为自己担保，而未签名的档案不会将其内容绑定到任何东西。没有时间戳机构的根证书，时间戳会以警告形式报告。

每项检查都在 `packages/verifier/SPEC.md` 中有规范说明，足以从零开始编写另一个验证工具。

检查通过可证明这些文件正是 Azoth 封存并签名的文件，顺序与时间均如所示。它不能证明某项决策是正确的：这是技术证据，而非评判。
