# @agenticprimitives/agent-relationships 中文文档

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

版本：1\.0\.0-alpha\.46
npm 元数据更新时间：2026-10-26T11:48:26.567Z
中文译文更新时间：2026-11-06T07:44:51.930Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：141 kB，44 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：viem ^2\.52\.2，@agenticprimitives/types ^1\.0\.0-alpha\.46，@agenticprimitives/connect-auth ^1\.0\.0-alpha\.46，@agenticprimitives/agent-account ^1\.0\.0-alpha\.46
- 首次发布：2026-05-31T17:13:08.257Z
- 最新版本发布：2026-10-26T11:48:23.349Z
- 近 30 天下载量：4111（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：45（近 12 个月 45 个）

## 中文简介

代理关系 SDK:与角色分类学相关的信任-造型边缘商店(主体,对象,关系Type). 第1相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相

## 安装

```sh
npm install @agenticprimitives/agent-relationships
```

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

## README

# @ agenticprimities/ 代理关系

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

> **警告——不要用于保密边缘.**
> 
> 此软件包写出信任- 配置边框图 **公开上市**。 。 。 . 每一个边缘——它的终点、类型、角色设置和地位——都可以看到 任何人看链子,永远。 没有连锁保密 联 合 国 **存在边缘的事实**。 。 。 .
> 
> 这意味着这个包裹 **结构不兼容** 带有使用大小写 带来保密要求:财务对手图表, 医疗转诊网络、国家残疾管理局下的B2B伙伴关系, 家庭/家庭成员,或任何“谁与谁有关” 其中连接本身是秘密。 这个 `metadata-hash` 字段 锚离链JSON但不能隐藏边缘的存在或 其终点的特性.
> 
> 每个边缘的具体公众接触量: `subject` 地址:, `object` 地址:, `relationshipType` (例如:. `HAS_MEMBER`, (中文(简体) ), `HAS_GOVERNANCE_OVER`),角色设置 在每一边, `EdgeStatus` 寿命周期(拟议/确认/活动/取消), 和每个州过渡的演员地址.
> 
> 私人链接——包括每个人的\\\\ org链接,属于 [`related-agents`](https://npmcn.com/package/%40agenticprimitives/related-agents) (持有者-居民金库证书, [AR-0025 (英语)](https://npmcn.com/package/docs/architecture/decisions/0025-related-agent-links-are-private.md)) (中文(简体) ). 未来 v2 私有尖端变体(基于承诺,带有 有选择性的披露证据)将与这个包裹并存. 直到它结束 船舶, **要求保密的收养人不应使用此方法 软件包** 并且应该保持他们的关系图 在脱链 存储带有明确的访问控制.
> 
> 追踪为 **隐私叉** (审计) `PKG-agent-relationships-001` 编号 : `EXT-019`) (中文(简体) ). `capability.manifest.json` 套装 `"stability": "experimental"`。 。 。 .

**地址之间的信任图,而不是某人数据库中的账户.** 随着特工们承担了真正的工作,问题从"这名特工是谁?"转移到"谁站在它的后面——它是谁的成员,谁管理它,谁担保它?". 大多数系统都用供应商数据库中的行进行回答,当供应商这样做时,这些行就会消失。 此软件包在Cononic Smart Agent地址之间以链上边缘回答: a `Edge` 是一个 `(subject, object, relationshipType)` 每边各设置一个角色,一个状态生命周期(`PROPOSED → CONFIRMED → ACTIVE → REVOKED`以决定性内容散列为主的可选链外元数据。 因为终点是犬类特征本身([ADR-0010 (英语)](https://npmcn.com/package/docs/architecture/decisions/0010-smart-agent-canonical-identifier.md)),边缘能活过证书旋转,名称变化,以及所有其他面相交换.

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

何处 [`agent-naming`](https://npmcn.com/package/%40agenticprimitives/agent-naming) 决定 _名称-地址_ 财务报告和审定财务报表 [`agent-profile`](https://npmcn.com/package/%40agenticprimitives/agent-profile) 拥有 _配置图层_此软件包拥有 **关系层**:org会员的公开图表,治理主张,伙伴关系,以及验证信任其他层组成反对.

> **图层 :** 发现——信任 **图表** (不是犬科特征——即: `agent-account`) (中文(简体) ). **条形键 :** 聪明的特工地址 边缘连接锚;边缘是 **没有** 代表团.

## 安装

工作空间- 内置代理主机单列; 尚未发布 .

## 使用量

### 边缘ID 衍生(纯)

```ts
import {
  computeEdgeId,
  RELATIONSHIP_TYPE,
} from '@agenticprimitives/agent-relationships';

const id = computeEdgeId(
  '0x1111…1111',                              // subject
  '0x2222…2222',                              // object
  RELATIONSHIP_TYPE.HAS_MEMBER,               // type (bytes32 hash)
);
//   0x… — keccak256 of packed (subject || object || typeId)
```

同样的三相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 非对称类型的方向事项( :`HAS_MEMBER(A→B)` ≠ `HAS_MEMBER(B→A)`)),并拒绝自来水.

### 关系类型+角色分类

```ts
import {
  RELATIONSHIP_TYPE,
  ROLE,
  TYPE_SEMANTICS,
} from '@agenticprimitives/agent-relationships/taxonomy';

RELATIONSHIP_TYPE.HAS_MEMBER;        // bytes32 — keccak256("HAS_MEMBER")
RELATIONSHIP_TYPE.PARTNERSHIP;       // bytes32 — symmetric
RELATIONSHIP_TYPE.HAS_GOVERNANCE_OVER; // bytes32 — hierarchical

ROLE.BOARD_MEMBER;                   // bytes32 — keccak256("BOARD_MEMBER")
ROLE.TREASURER;                      // bytes32

TYPE_SEMANTICS[RELATIONSHIP_TYPE.PARTNERSHIP].symmetric;     // true
TYPE_SEMANTICS[RELATIONSHIP_TYPE.HAS_GOVERNANCE_OVER].hierarchical; // true
```

`NAMESPACE_CONTAINS` 实值 **故意缺席** ——命名等级存在于 [`agent-naming`](https://npmcn.com/package/%40agenticprimitives/agent-naming) 通过父指针 [ADR-0006 (韩语)](https://npmcn.com/package/docs/architecture/decisions/0006-agent-naming-as-resolution-layer.md),所以没有平行的权威可以漂移.

### 关系客户端(第二阶段+)

```ts
import {
  AgentRelationshipsClient,
  RELATIONSHIP_TYPE,
  ROLE,
} from '@agenticprimitives/agent-relationships';

const rel = new AgentRelationshipsClient({
  rpcUrl: 'https://base-sepolia.g.alchemy.com/v2/…',
  chainId: 84532,
});

// Read (Phase 2+)
const edges = await rel.listEdgesFor('0x…', { relationshipType: RELATIONSHIP_TYPE.HAS_MEMBER });

// Write (Phase 4+)
await rel.proposeEdge({
  subject: '0xAlice…',
  object:  '0xAcme…',
  relationshipType: RELATIONSHIP_TYPE.HAS_MEMBER,
  subjectRoles: [ROLE.BOARD_MEMBER],
});
await rel.confirmEdge({ edgeId: '0x…', selfRoles: [] });
```

每种写作都通过演员的"智能特工"(Smart Agent ERC-1271 → 它的"保管政策"模块)授权. 关系包本身保持监护-不可知(否) `@agenticprimitives/account-custody` 导入).

## 怎么不一样

竞争类别是 **社会/信任图产品和登记“认可”特征** —— 应用数据库中保存的跟随者边缘, 证明列表, org 图表 :

-   **双边建筑.** 非对称的边缘需要双方确认才能影响任何东西(第3阶段+合同执行);a `PROPOSED` 边缘是权利要求,而不是事实。 任何一方均可单方面、不经许可地撤销.
-   **边缘连接身份,而不是手柄.** 两个端点都是Canonic Smart Agent地址,因此图不能被更名的手柄或旋转的密钥所孤.
-   **边缘不是权威.** `HAS_GOVERNANCE_OVER` 声称有关系,但没有任何好处。 权力总是一种授权或一种监护政策行动——单独的原始人,单独的包裹. 图形产品通常会模糊这条线;这里的包边让模糊变得不可能.

## 子路径导出

-   `@agenticprimitives/agent-relationships/taxonomy` ——关系类型+角色常数+语义图.

## 安全变化因素

-   边缘标识是 **决定性** —— 说 `keccak256(subject || object || relationshipType)`;脱链和链上衍生物总是相匹配.
-   `computeEdgeId` 拒绝自攻(subject qq对象).
-   关系类型+角色ID是 `keccak256(name)` (比例) `keccak256(bytes(name))`)——字节32 hashes,不是生弦,可以防止跨名空间相撞.
-   非对称类型(第3阶段+合同执行)的双侧确认.
-   任何一方的许可撤销(第3阶段+).
-   保管-不可知——权威总是通过演员的"智能特工"ERC-1271来通路.
-   `NAMESPACE_CONTAINS` 故意缺席(ADR-0006).

见 [`AUDIT.md`](https://npmcn.com/package/%40agenticprimitives/agent-relationships/AUDIT.md) 组合审计+开放式审计结果.

## 状态

**实验和第一阶段** ——纯SDK + spec + API骨架. 纯层`computeEdgeId`,分类学,语义图)是真实的并经过测试的;客户端读取方法抛出 `R Phase 2` 并投掷写法 `R Phase 4` - 设计上的根 合同(`AgentRelationship.sol` + 键 `RelationshipTypeRegistry.sol`第三阶段的土地. `AgentAssertion` (签名-索赔层)和 `AgentRelationshipResolver` (政策层)推迟至v2 [ADR-0007 (英语)](https://npmcn.com/package/docs/architecture/decisions/0007-agent-identity-stack-three-packages.md). 全面设计+阶段计划: [`specs/216-agent-relationships.md`](https://npmcn.com/package/specs/216-agent-relationships.md)。 。 。 .

包件阶段以外:仅测试网/飞行员准备状态;生产发射在根部的公开核对表上加门 [`README.md`](https://npmcn.com/package/README.md#status--honest-version)追踪所有安全发现 [`docs/audits/findings.yaml`](https://npmcn.com/package/docs/audits/findings.yaml) ——在通过前重读上层的保密警告.

## 许可证

UNLICENSED(内部单列,未出版).

## 常见问题

### @agenticprimitives/agent-relationships 是什么？

代理关系 SDK:与角色分类学相关的信任-造型边缘商店\(主体,对象,关系Type\)\. 第1相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相

### 如何安装 @agenticprimitives/agent-relationships？

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

### @agenticprimitives/agent-relationships 支持 TypeScript 吗？

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

### @agenticprimitives/agent-relationships 支持 ESM 还是 CommonJS？

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

### @agenticprimitives/agent-relationships 可以商用吗？

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

### @agenticprimitives/agent-relationships 的下载量有多少？

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

### @agenticprimitives/agent-relationships 还在维护吗？

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