内容
# observed_effect v0
此导出包含三个已完成的observed-effect实验：
- `below-harness-observer-carrier-2026-06/` 展示了观察者/覆盖率标准化以及Tetragon适配器。
- `observed-effect-drift-consumer-2026-06/` 展示了v0生产者/消费者合约、示例记录以及独立消费者。
- `observed-effect-neutral-carriers-2026-06/` 展示了相同的冻结v0记录嵌入在四个中立载体（独立JCS、in-toto DSSE声明、MCP引用槽以及SCITT-shaped COSE声明）中，在每个载体中重新计算出一个相同的內容地址。
这些示例是有界证据合约制品。它们不声称运行时真实性、意图推断、恶意检测、安全合规性或运行时强制执行。外部判决词汇是`匹配 | 不匹配 | 不完整 | 无效`。
## 源类和声明上限
observed-effect记录是独立发布的：发出它的观察者并不是它所描述的行为组件。这使它与自我报告或由记录决策的当事人签名的记录处于不同的源类。该类是合约的一部分，因为它限定了验证者可以得出的结论。
重新计算摘要确认字节在声明的规范化下是完整的。它并不提高记录的视角。重新计算自我发布的记录确认了发布者记录的内容，而不是实际发生的内容；对独立观察记录的相同重新计算支持更强的结论，因为视角更强，而不是因为哈希更强。签名、哈希链和时间锚定提高了防篡改证据，但从不提高视角。
这些记录相应地不是其他格式的配置文件，也不符合任何供应商的配置文件。相同的冻结记录在以下四个载体中传输，并在每个载体中重新计算为一个内容地址；任何声明其规范化与其摘要的载体都可以持有它。记录贡献的是观察及其明确的限制（`非声明`位于摘要内部），除此之外没有更多的内容。
## 与MCP组合
中立载体示例在MCP引用槽中携带记录。自2026年6月下旬以来，该格式在工具注释扩展草案中指定（[experimental-ext-tool-annotations](https://github.com/modelcontextprotocol/experimental-ext-tool-annotations)，`specification/draft/trust-annotations.mdx`，于2026-06-26合并）：一个`证据引用`，其`类型`/`摘要`/`规范化`三元组是客户端本地重新推导引用记录所需的最小信息，`cbor/rfc8949`和`jcs/rfc8785`均有效且都不是默认值。
使用合并的字段集，此导出中冻结记录的指针示例：
```jsonc
{
"_meta": {
"io.modelcontextprotocol/trust-annotations": {
"evidenceRef": {
"type": "observed-effect",
"digest": "sha256:c2a9723ea19504aad6f8336ccbac9d9e434d6246064d404ed8e741e1930c789c",
"canonicalization": "jcs/rfc8785",
"schema": "https://assay.dev/schemas/observed-effect.v0.json",
"ref": "audit://observed-effect/match_agreement"
}
}
}
}
```
可以解析此指针后面的记录的客户端可以使用`observed-effect-drift-consumer-2026-06/`中的stdlib消费者仅凭字节重新计算地址，并且应该在得出任何结论之前读取记录的自己的`非声明`。`observed-effect-neutral-carriers-2026-06/`中的载体示例早于合并的草案，但使用等效的早期规范化标签；重新计算是标签独立的，该示例的别名记录演示了这一点。记录不是扩展的一部分，也不受扩展的认可。它与引用形状组合，在in-toto和SCITT下解析的方式相同。
要验证确定性goldens：
```sh
cd below-harness-observer-carrier-2026-06 && ./verify-golden.sh
cd ../observed-effect-drift-consumer-2026-06 && ./verify-golden.sh
cd ../observed-effect-neutral-carriers-2026-06 && ./verify-golden.sh
```
要运行测试：
```sh
python -m pytest below-harness-observer-carrier-2026-06 observed-effect-drift-consumer-2026-06 observed-effect-neutral-carriers-2026-06
```
## 相关
- [Assay](https://github.com/Rul1an/assay) 在MCP工具调用边界处生成和验证证据包；这些记录与该层组合。
- [gateway-evidence-replay](https://github.com/Rul1an/gateway-evidence-replay) 将网关路径证据离线重放至有界判决。
- [RGE-Bench](https://github.com/rge-bench/rge-bench) 是一个中立的一致性测试套件，其轴可以针对此记录格式（和其他格式）读取。
