# @agenticprimitives/witness 中文文档

规范地址：https://npmcn.com/package/%40agenticprimitives/witness/

版本：0\.0\.0-alpha\.31
npm 元数据更新时间：2026-10-26T11:49:26.410Z
中文译文更新时间：2026-11-06T17:18:49.034Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agenticprimitives/witness
原文对照：https://npmcn.com/package/%40agenticprimitives/witness/?lang=original
项目主页：https://agenticprimitives.dev/
源码仓库：https://github.com/agentictrustlabs/agenticprimitives

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：22.3 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：@agenticprimitives/types ^1\.0\.0-alpha\.46
- 首次发布：2026-07-14T15:52:07.484Z
- 最新版本发布：2026-10-26T11:49:23.191Z
- 近 30 天下载量：2607（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：30（近 12 个月 30 个）

## 中文简介

证据纠纷证明(Spec 307/G-11):确定走关系记录+核实收据并证明为 scope/出 scope/已撤销 执行前/stale status 已使用/不充分 证据. 事实,永远不要补救.

## 安装

```sh
npm install @agenticprimitives/witness
```

也可以使用：`pnpm add @agenticprimitives/witness`、`yarn add @agenticprimitives/witness`、`bun add @agenticprimitives/witness`

## README

# @ 代理人/证人

> 部分 **[代理先导](https://agenticprimitives.dev/)** ——代理应用程序的开源信任底板:可以签名的身份,行为时间检查权限,所有者携带的证据. [开发者工具包](https://github.com/agentictrustlabs/agentic-primitives) • 妇女 [所有软件包](https://agenticprimitives.dev/developers)

**证据纠纷证明** ——中性功能,仅取自文物: _这一行动是在事件发生时授权的关系范围内进行的,如果不是,则由谁负责 检查失败 ?_

谱: [`specs/307-witness.md`](https://npmcn.com/package/specs/307-witness.md) 消费: [核查收据(第303项)](https://npmcn.com/package/specs/303-verification-receipts.md) + 键 [关系记录(第306项)](https://npmcn.com/package/specs/306-relationship-record.md)。 。 。 .

## 走路时

```ts
import { evaluateDispute, mintWitnessAttestation } from '@agenticprimitives/witness';

const evaluation = await evaluateDispute({
  record,            // the spec-306 hash-linked evidence chain
  receipt,           // the disputed spec-303 public receipt
  detail,            // optional — released to the witness via releaseMode 'witness_escrow'
  verifyReceiptSignature,
});
// → { outcome: 'in_scope' | 'out_of_scope' | 'revoked_before_execution'
//              | 'stale_status_used' | 'insufficient_evidence', ... }

const attestation = await mintWitnessAttestation(
  { witness: witnessSa, relationshipId, evaluation, receipt, checkedDetail: !!detail, attestedAt },
  { sign: witnessSigner },
);
```

徒步走着 **总计和订购** (证据完整性 ) 记录会员资格 ——撤销时间表 —— 因此,两个证人 给予同样的文物 产生相同的结果和结果 证相散相. 任何无法核实的东西——断开的链条,无效的收据,不是收据 记录的一个条目,一个不开放的细节——是 `insufficient_evidence`从来没有猜测.

`stale_status_used` 是负载结果: 撤销项在收件之前 关系记录,然而允许的验证器 `revocation: 'active'` - 核查员依赖 停顿状态,这正是引发该条采购清单所指定的责任.

## 状态

`w1-evaluate-attest` - 步行+证明薄荷/验证,8个测试套房(每个结果一个, 决断主义,篡改主义,无身份外出. W2: 证明锚+证人-证人 解密Grant发布路径. W3:G-12对这些结果的责任计划.

## 常见问题

### @agenticprimitives/witness 是什么？

证据纠纷证明\(Spec 307/G-11\):确定走关系记录\+核实收据并证明为 scope/出 scope/已撤销 执行前/stale status 已使用/不充分 证据\. 事实,永远不要补救\.

### 如何安装 @agenticprimitives/witness？

在项目目录运行 npm install @agenticprimitives/witness，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@agenticprimitives/types（^1\.0\.0-alpha\.46）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @agenticprimitives/witness 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @agenticprimitives/witness 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @agenticprimitives/witness 可以商用吗？

@agenticprimitives/witness 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @agenticprimitives/witness 的下载量有多少？

根据 npm 官方下载统计，@agenticprimitives/witness 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,607 次，日均约 87 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @agenticprimitives/witness 还在维护吗？

最新版本 0\.0\.0-alpha\.31 发布于 2026/10/26（12 天前）；至今共发布 30 个版本，其中过去 12 个月发布了 30 个；首次发布于 2026/07/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。