# 日志、回执与时间戳

每项决策，无论已执行还是被拒绝，都封存在按工作区划分、哈希链式、只追加的日志中，客户端还会为每项决策保留自己的签名回执。任何人都可以在不依赖 Azoth 的情况下核查两者。

## 封存日志

- 每条记录都包含前一条记录的哈希：`entry_hash = sha256(prev_hash || core_canonical)`。修改或删除一条记录会使链从该处起断裂。
- 拒绝同样会被封存：Azoth 证明它阻止了什么。封存记录只包含非个人事实（ID、代码、哈希、规则集、法律、价格、决策时间、执行者类型和追踪），从不包含提示词或回答。
- 个人数据存放在单独的信封中，可依据 GDPR 删除而不破坏链。
- 链在增长过程中每小时验证一次（新条目，以及最后一条已验证条目仍在且未被改动）；每周一次以及点击**立即验证**时会完整复核，从保留的第一条起重新计算每一条条目；断裂会显示在**证据**中并触发告警。
- 在**证据 › 决策**中查看——每个结果都附有详情：规则、安全判定、依据核查、路由、法律——或使用 `GET /api/v1/journal`。

## 回执

网关的每个非流式回答都附带 `X-Azoth-Receipt`：一个以工作区 Ed25519 密钥签名的紧凑 JWS。即使 Azoth 已不复存在，它也能证明这是 Azoth 做出的决定，并让审计人员在链中找到该决策。流式回答不附带回执：其响应头在决策封存之前发出，决策在流结束时封存（以错误结束的流记为失败调用，从不封存）。

```
header { "alg": "EdDSA", "typ": "azoth-receipt+jws", "kid": "<RFC 7638 thumbprint>" }
claims { "v": 1, "ws": "…", "trace": "…", "core": "<sha256>", "out": "allowed", "iat": 1793750400 }
```

### 回执包含的内容

- `ws` — 工作区
- `trace` — 该调用的追踪 ID，与“证据 › 决策”中显示的一致
- `core` — 该决策已封存核心的 sha256
- `out` — `allowed`、`blocked`、`rerouted`、`held` 或 `failed`
- `ref` — 业务决策引用的哈希（当调用发送了引用时）
- `iat` — 签名时间

- 绝不包含任何内容。流式回答暂不附带回执，而是附带 `X-Azoth-Trace-Id`。
- 决策日志开启时，已执行的回答附有回执；拒绝始终附有回执。回执绝不会导致调用失败。
- 公钥以 JWKS 形式发布在 `GET /api/proof/keys/<workspaceId>`，包括已停用的密钥。密钥每 90 天轮换一次。

```
import { receiptOf, verifyReceipt } from '@azothos/sdk';

const jwks = await fetch(`https://www.azothos.ai/api/proof/keys/${workspaceId}`).then(r => r.json());
const claims = await verifyReceipt(receiptOf(response), jwks);   // null when it does not verify
```

## 一项业务决策，多次调用

在服务于同一项决策的每次调用中发送 `X-Azoth-Decision-Ref`——您的系统已有的标识，例如信贷档案编号，切勿使用个人数据。Azoth 只保留按工作区加盐的哈希，并将这些调用汇集到一份[决策档案](https://www.azothos.ai/zh/docs/dossiers#decision)中。

```
await openai.chat.completions.create(body, {
  headers: azothGatewayHeaders({ decisionRef: 'CREDIT-2026-000123' }),   // an opaque id
});
```

## 可信时间戳

- RFC 3161 时间戳机构为每份导出档案的根哈希签名，并每 5 到 60 分钟为每个工作区的链头签名。离开 Azoth 的只有 SHA-256 摘要。
- 每个工作区有三个级别：标准（部署的机构）、合格（由工作区指定的机构，保存前会经过测试）和本地（运营方自己的机构，适用于 SaaS 之外）。

## 客户端保险库

对于处于保险库模式的系统，网关不保留其调用的任何内容（无日志信封、无语义缓存），并以 `X-Azoth-Vault: on` 作答。SDK 使用您的密钥将内容加密存入您自己的存储，并发送回执；Azoth 只封存其哈希。

## 依据核查

发送回答必须依据的段落，Azoth 会估算这些段落所支持的陈述比例，核查方式取决于系统的风险高低：回答后抽样核查、随回答一起返回，或在回答发出前核查。分数始终是估算值，并附上其评判者与人工判断的实测一致程度。段落从不被存储。
