# @absolutejs/agent-exchange 中文文档

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

版本：0\.5\.1
npm 元数据更新时间：2026-09-24T22:29:58.475Z
中文译文更新时间：2026-11-08T03:09:59.591Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：195 kB，28 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：5 个
- 首次发布：2026-08-26T09:21:48.805Z
- 最新版本发布：2026-09-24T22:29:58.283Z
- 近 30 天下载量：1925（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

使用Agency,A2A,和E2EE进行人和剂的验证,型号盲敏感值交换.

## 安装

```sh
npm install @absolutejs/agent-exchange
```

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

## README

# `@absolutejs/agent-exchange`

经核实的、有目的限制的、模型盲敏感价值的人类和 探员 它由现有的绝对JS原始组成,而不是创建另一个 许可或运输系统:

```text
Auth identity and delegation
        ↓
Agency approval and single-use execution lease
        ↓
deterministic source tool → E2EE envelope → deterministic recipient sink
        ↓
A2A carries an opaque exchange reference and redacted receipt
```

默认处理模式是 `tool-confined`。保护字节提供给 信任的工具,擦去每一个完成路径, 并排除从请求, 机构分类账、A2A任务历史、出错、遥测和收款.

> 这是实验 `0.x` 未经独立审计. 只有在宣布的每一项保证要求都存在时,才有吸入阻力 实际满足; 电子邮件和短信编码仍然是无记名证书.

## 明确保证

每次请求都宣布三项独立保证。 防钓的形状 故意无法以无记名证书或一般执行方式表示:

```ts
assurance: {
  approval: "webauthn-verifier-bound",
  credential: "sender-constrained",
  execution: "purpose-bound",
}
```

对于这个模式, `beginApproval()` 产生一个域分隔的 SHA-256 挑战 来自 完全不可改变的交换. `approve()` 只接受配置的核准 提供者核实的WebAuthn结果 请求者的确切对象和权限 源代码。 由此产生的机构核准储存了证书识别码的散列, 从来没有断言或原始标识。 租赁的签发和执行的重新检查 与当前要求相反的证据.

这符合WebAuthn关于验证挑战、来源、RP ID散列的要求, 用户存在标记,以及——应要求——用户验证标记。 提供者 必须请求用户验证并进行加密断言验证.

当上游提供者签发无记名访问标志但绝对 PaaS 限制 他们给一个决定性的经纪人, 请求使用一个单独的,故意弱化 形状 :

```ts
assurance: {
  approval: "webauthn-verifier-bound",
  credential: "token-confined-broker",
  execution: "purpose-bound",
}
```

这意味着代理商都无法进入 并且只限一个经批准的 工具操作,但上游资源本身没有加密绑定 经纪人的出入证 它绝不能被描述为相当于 发送器- 约束 DPoP 或 mTLS 令牌 .

### 常设任务

长期运行的代理对代理自动化使用单独的保证值:

```ts
assurance: {
  approval: "standing-mandate",
  credential: "token-confined-broker",
  execution: "purpose-bound",
}
```

`createAgentExchangeStandingMandateAuthority()` 问题和核查紧凑的JWS 其有效载荷对所有人、请求代理人、执行代理人、 OAuth代理授权、账户、提供者、来源、操作、目的、风险等级、秘密类型、激活 窗口、过期和总使用限额。 签发需要新鲜的、用户验证的WebAuthn 证据。 授权还需要请求 `delegationId` 将会是 作为其独立认证的代理代表团,要求 请求的单独 `mandateId` 与签署的授权身份证相等,并在解剖学上 在撤销时消耗交换 ID 存储。 JWS没有被放入A2A任务历史.

核心接受可互换的 JWS 签名器、 验证器和耐用存储器 执行。 生产核查员必须认证可信赖的签发人和 密钥 ID, 执行明确的 JWS 类型和允许的算法, 并拒绝未知或 撤销登记。 记忆库仅用于测试和局部开发.

此设计使用签名的负载格式 [RFC 7515 (法语)](https://www.rfc-editor.org/rfc/rfc7515)JSON规则 [RFC 8785 (英语)](https://www.rfc-editor.org/rfc/rfc8785),狭义的行动和 来自 [RFC 9396 (法语)](https://www.rfc-editor.org/rfc/rfc9396),则 描述的单独主题/演员语义 [RFC 8693 (法语)](https://www.rfc-editor.org/rfc/rfc8693)它不制造电线 合同取决于未完成的交易委托书或链式委托书.

## 安全变化因素

-   每个请求都约束请求者、接受者、目的、服务来源、账户 参考、操作、保证、过期、非ce、处理模式,以及 `maximumUses: 1`。 。 。 .
-   机构只授权元数据行动并消耗执行租赁 在读取来源之前.
-   接受者同意的,须与同一请求核对.
-   接收器认证信封,然后在解剖上消耗非ce 在水槽执行前。 无效的密码文本不能燃烧合法的交换 .
-   源、信封、运输和汇故障成为允许列出的错误代码; 依赖性错误信息永远不会跨越边界 .
-   接收和汇的参考文献被扫描为直接、UTF-8、十六进制、基数64、, 和受保护值的基数64url表示.
-   高风险恢复、行政、安全设定、货币流动和出口 除非主机明确选择它们,否则流量会被拒绝.
-   常设授权是精确匹配的许可列表,绝不是通配范围. 退缩, 重放预防,过期,总使用限由一原子商店执行.

## A2A 边界

`@absolutejs/agent-exchange/a2a` 添加代理交换扩展到代理 卡片和创建请求信件,只包含不透明的交换引用和 安全元数据。 信封通过配置的交换运输交付, 在普通 A2A 任务历史中并不存在.

见 [警卫](https://npmcn.com/package/%40absolutejs/agent-exchange/SECURITY.md) 在使用真实的保护数据之前.

## 可互换来源

来源融合在公众中 [`absolutejs/agent-exchange-sources`](https://github.com/absolutejs/agent-exchange-sources) 所以这个核心从不依赖邮箱、短信、金库或设备提供者 SDKs (英语).

第一个适配器是 `@absolutejs/agent-exchange-email`它约束了决定性因素 Gmail, 微软图形, 或 IMAP 检索 `@absolutejs/email` 改为: `SensitiveValueSource` API : (英语)

```bash
bun add @absolutejs/agent-exchange @absolutejs/agent-exchange-email @absolutejs/email
```

模版清单中仍然没有核查码检索。 这个 适配器手可变字节直接到此软件包进行加密, 而这个 包裹在交货后擦去.

## 许可证

阿帕奇 - 2.0

## 释放兼容性

这个 `0.5.x` 线条使用版本绑定 `@absolutejs/e2ee@0.5.x` 认证合同和单独认证的供应商运行时间。 供应商 接纳仍然是东道方的责任;兼容类型不替换 释放的特定安全证据.

## 常见问题

### @absolutejs/agent-exchange 是什么？

使用Agency,A2A,和E2EE进行人和剂的验证,型号盲敏感值交换\.

### 如何安装 @absolutejs/agent-exchange？

在项目目录运行 npm install @absolutejs/agent-exchange，或使用 pnpm add / yarn add / bun add。

### @absolutejs/agent-exchange 支持 TypeScript 吗？

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

### @absolutejs/agent-exchange 支持 ESM 还是 CommonJS？

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

### @absolutejs/agent-exchange 可以商用吗？

@absolutejs/agent-exchange 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @absolutejs/agent-exchange 的下载量有多少？

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

### @absolutejs/agent-exchange 还在维护吗？

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