# @agenticprimitives/content-primitives 中文文档

规范地址：https://npmcn.com/package/%40agenticprimitives/content-primitives/

版本：1\.0\.0-alpha\.41
npm 元数据更新时间：2026-10-26T11:09:57.702Z
中文译文更新时间：2026-11-06T07:20:57.388Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：80.9 kB，41 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：viem ^2\.52\.2，@agenticprimitives/types ^1\.0\.0-alpha\.45，@agenticprimitives/verifiable-credentials ^0\.0\.0-alpha\.42
- 首次发布：2026-06-07T23:27:29.848Z
- 最新版本发布：2026-10-26T11:09:53.357Z
- 近 30 天下载量：4214（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：36（近 12 个月 36 个）

## 中文简介

可验证内容 Substrate SDK:名称,解决,承诺,权利门,并引用由第三方权利持有者控制的平台外内容. 拥有Canonical Locus / CorpusManifest / 内容说明 / 引文Asservertion / 应享权利(FRBR-aconition), d

## 安装

```sh
npm install @agenticprimitives/content-primitives
```

也可以使用：`pnpm add @agenticprimitives/content-primitives`、`yarn add @agenticprimitives/content-primitives`、`bun add @agenticprimitives/content-primitives`

## README

# @ agenticprimitives/ 内容 - primitives

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

可核查的内容底盘——名称,决心,承诺,权利门,并引用那些生活在平台外并被第三方权利持有者所控制的内容.

代理人越来越多地根据他们不拥有的内容采取行动:引用有许可证的文本,引用一条教条,对权利持有的委托书进行查阅。 天真的方法都失败了——复制文本而你违反许可证;信任平台和引文是无法验证的;把每个段落都抹去一个身份,身份层被淹没. 此软件包走第三条路径: 内容 **从来不是经纪人,也从未储存**. 内容单位得到一个决定性的、计划性的地址;一个发行人(他是一个聪明的代理人)签署对它的承诺;读者核实签名,评价权利,并引用结果——所有这一切都没有文字输入底片([ADR-0033 (英语)](https://npmcn.com/package/docs/architecture/decisions/0033-content-agnostic-verifiable-content-firewall.md)) (中文(简体) ).

软件包严格是内容不可知的:我们存储的任何描述或承诺(R3)中没有渲染文本,Repo(R1)中没有许可的材料,参考语法是被应用的,从不硬化(R4). 信任来源于发行人的签名和访问政策,从来不是平台索赔(R5).

部分 [代理原始产品](https://npmcn.com/package/README.md) ——代理经济的信托基底:一个有监护,授权,命名,证书,审计证据的犬类智能代理身份,设计成一个系统.

## 型号(FRBR)

| 法国 | 类型 | 页:1 |
| --- | --- | --- |
| 工作 | `CanonicalLocus` | 计划障碍 `locusId`; 从未注册 |
| 示意图 | `CorpusManifest` | 默克勒发行公司 `corpusRoot`已签名 |
| 项目 | `ContentDescriptor` | 承诺+ `retrievalPointer` + 发行人签名 - **从不发短信** |
| —— 说 | `Entitlement` 编号 : `CitationAssertion` | W3C VC 2.0主题 |

FRBR Works/Project的分拆是为什么这是一个新的底片,而不是另一个命名记录类型:一个内容中心是一个根据参考方案计算的地址,而只有发行人,公司所有人和当事人是Smart Agents(ADR-0010仍然管理) _他们_) (中文(简体) ).

## 快开始

```ts
import {
  buildCanonicalLocus, corpusRef, contentCommitment,
  buildContentDescriptor, verifyContentDescriptor,
  evaluateEntitlement, buildCitationAssertion,
} from '@agenticprimitives/content-primitives';

// 1. App supplies the reference grammar (kept out of the package — R4).
const clauseScheme = { id: 'standard-clause', normalize: (p: string) => /* canonical form */ p };
const locus = buildCanonicalLocus(clauseScheme, 'Part 4, Section 2'); // -> { locusId, path: 'Part4.Section2' }

// 2. Issuer commits to off-platform text + signs a descriptor (no text on-chain — R3).
const commitment = contentCommitment(renderingText); // keccak256, off-platform
const descriptor = await buildContentDescriptor(
  { locusId: locus.locusId, corpusRef: ref, contentType: 'standard-clause',
    commitment, proofPolicy: 'signature', accessPolicy: 'public',
    retrievalPointer: 'content://standard-clause/v3/Part4.Section2', issuer },
  issuerSign, // signs descriptorHash via the issuer SA (ERC-1271)
);

// 3. Reader verifies (signature injected — ADR-0006) + gates + cites.
const ok = await verifyContentDescriptor(descriptor, { verifySignature });
const gate = evaluateEntitlement(descriptor.accessPolicy, descriptor.corpusRef);
```

应享权利评价失败 `/merkle` 子路径; ERC-1271 签名验证为依赖性注入,所以包会停留在图表的底部.

## 状态

阶段1至阶段3(命名、承诺、描述性核查、权利定位、引用)得到实施和测试. **ZK证明和付费访问被保留(第4/5阶段),并扔到执行为止** 整个SDK地表和相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 [第266区](https://npmcn.com/package/specs/266-verifiable-content-substrate.md) (见 [`spec.md`](https://npmcn.com/package/%40agenticprimitives/content-primitives/spec.md)) (中文(简体) ).

测试网/飞行员准备 生产启动在基础README的公开核对表上进行——包括第三方合同审计和治理关键轮换。 追踪所有安全发现 [`docs/audits/findings.yaml`](https://npmcn.com/package/docs/audits/findings.yaml)。 。 。 .

## 构建

```bash
pnpm --filter @agenticprimitives/content-primitives typecheck
pnpm --filter @agenticprimitives/content-primitives test
pnpm --filter @agenticprimitives/content-primitives build
```

## 常见问题

### @agenticprimitives/content-primitives 是什么？

可验证内容 Substrate SDK:名称,解决,承诺,权利门,并引用由第三方权利持有者控制的平台外内容\. 拥有Canonical Locus / CorpusManifest / 内容说明 / 引文Asservertion / 应享权利\(FRBR-aconition\), d

### 如何安装 @agenticprimitives/content-primitives？

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

### @agenticprimitives/content-primitives 支持 TypeScript 吗？

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

### @agenticprimitives/content-primitives 支持 ESM 还是 CommonJS？

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

### @agenticprimitives/content-primitives 可以商用吗？

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

### @agenticprimitives/content-primitives 的下载量有多少？

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

### @agenticprimitives/content-primitives 还在维护吗？

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