# @dharma-ai-labs/agent-fabric-relay-client 中文文档

规范地址：https://npmcn.com/package/%40dharma-ai-labs/agent-fabric-relay-client/

版本：0\.2\.37
npm 元数据更新时间：2026-11-05T02:11:47.155Z
中文译文更新时间：2026-11-16T00:34:11.353Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40dharma-ai-labs/agent-fabric-relay-client
原文对照：https://npmcn.com/package/%40dharma-ai-labs/agent-fabric-relay-client/?lang=original
项目主页：https://github.com/dharma-ai-labs/dharma-agent-fabric/tree/main/packages/relay-client#readme
源码仓库：https://github.com/dharma-ai-labs/dharma-agent-fabric

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

- 包体积（解压后）：1.2 MB，106 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-08-08T21:28:20.009Z
- 最新版本发布：2026-11-05T02:11:46.743Z
- 近 30 天下载量：1970（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：43（近 12 个月 43 个）

## 中文简介

Dharma Agent Fabric 的境外签名设备注册和中继客户端

## 安装

```sh
npm install @dharma-ai-labs/agent-fabric-relay-client
```

也可以使用：`pnpm add @dharma-ai-labs/agent-fabric-relay-client`、`yarn add @dharma-ai-labs/agent-fabric-relay-client`、`bun add @dharma-ai-labs/agent-fabric-relay-client`

## README

# `@dharma-ai-labs/agent-fabric-relay-client`

Fabric探员的外出设备注册和中继客户端. 它使用设备 签名、 非ce 和序列重放保护、 持久光标、 偶位 收据,以及组织范围浏览器的批准. 它不会暴露 输入外壳或任意本地文件 API.

## 只读签名后恢复规划

`planDeviceSigningRecovery()` 根据强制性规定准备当地公共环境 拥有主机范围. 东道方用品已核实来源同意和原产地 选择会话,永远不要模式/挑战声明。 函数读取 选定的设备配置及其匹配的受保护的公众注册 锚有新鲜读物和 `readOnly: true`它不迁移一个老锚, 读取私人密钥, 生成身份, 联系服务器, 发布证明或 改变信任。 第二个配置读作在规划期间拒绝替换; 范围撤消和会议间隔(15分钟)限制拒绝产出.

计划是明确的 `local_context_only_not_recovery_authorization`它确实 不验证当前服务器成员、 角色的选中内容 , 撤销、源策略或本地实时会话。 记录的预算只是 输入一个具有约束力的摘要,而不是新的支出授权。 老锚是的 本身不证明安装、成员或源选择 受信任的本地来电者在批准/使用前必须独立核实. 此API 尚未连接到靴子或可执行的恢复命令 .

带宽绑定使用现有的 `canonicalize()` UTF-8 JSON代表作:

-   `sourceSelectionDigest`页:1 `dharma.agent-fabric.signing-recovery-source-selection/v1` + NUL + 犬科 准确来源选择字段的JSON和现有公众 `setupClaimReference`. 原始文献的同意参考地图 生成/接收/修订/政策记录,而不是原始存储器内容.
-   `nativeSessionBindingDigest`页:1 `dharma.agent-fabric.signing-recovery-native-session/v1` + NUL + 犬科 贾森 `{session, hostBinding, installationId}`。会话选择绑定 确切成员/设备/仓库/工作空间/终点/装订/提供者,名称 会话/所有者/时间/预算;主机选择绑定连接/内容/线程/ 转 私人本地路径,饼干,笔录和证书不在此列.
-   `previousAnchorHash`, (中文(简体) ), `protectedConfigDigest` 财务报告和审定财务报表 `previousKeysetHash`数字 : 准确对应的公众快照中的SHA-256 Canonical JSON. 配置散列包括合并的磁盘连接偏好, 但是 不变。 它不是保护仓库的证明;只有锚快照 来自受保护的商店.
-   `previousRootFingerprint`: SHA-256 该犬被解码为32字节 Ed25519 大众根. 文摘采用 `sha256:` 小写- hex 前缀.

历史验证 验证被绑根签名和签名窗口 在记录的旧期满前不久;它并不使这种信任有效 现在 这个策划者支持被钉死的历史案件 不是任意的 后转相行相. 不支持的历史失败 。 新的签注来源, 所有者/预期接受者批准、一次性重复播放和专用 受保护的安装/启动日记账仍然是单独的未执行闸门.

`claimSetupReference` 是本地的、非互动的公众参考入学人数 运输工具是特工运行的靴子 参照书不授予无记名权. 客户端证明了其受保护的 Ed25519 设备身份, 绑定了麻黄 精确挑战的加密密钥,并等待预定收件人的 浏览器批准. 兼容服务器必须执行它的活性验证器, 不可改变的范围、期限和经原子核准的钥匙入学/回收.

解密的入学证书仍保留在这个方法内,只保存 通过现有的受保护的证书商店。 返回值包含 公共设备配置和范围名称。 它从不归还任何象征, 密码文本,私人密钥或私人终端输入. HTTPS 重定向, 更改 核准上下文、过期回复和无法保护的存储失败 关闭。 源头测试不能确定现场入学或启动准备.

地方选择 `onFailureDiagnostic` 观察员只收到被冻结的 `dharma.setup-claim-failure/v1` 记录与固定 `setup_claim_failed` 代码 和允许的阶段。 它可能添加一个键入 `reason`,服务器错误代码 作为 `serverCode` 当它是已知代码和服务器时 `correlationId`· ; `approval_expired` 表示浏览器 在等待结束之前没有给予批准。 CLI 将此记录发布为 标准,然后是固定的 `setupClaimFailureMessage` 当一个理由是 已知; studout 和现有的已消毒例外保持不变。 观察员 失败被忽略了。 没有捕获到的例外,服务器消息,证书,批准 包含URL或设备数据. 一个阶段描述的是最后一次尝试的当地边界,而不是 远端根源,证明前一阶段在解剖学上取得了成功,或 重试的权限。 特别是,a `credential_commit` 失败可能保留 为已有的同键恢复路径被保护部分写入 .

这种诊断不能提供可信任的预录主机回调,放松 ,或者使一个无法使用的OS后置存储器可用。 资格 那些运行时间的界限在实际登入前是独立的.

`AgentFabricClient.open({ ...paths, readOnly: true })` 使用已经接受的 设备密钥和登录锚,而不对其进行修复或迁移。 一个 `openSession()` 创建一个单独的认证服务器协议会话;其 序列和待读内容仍为内存。 它既不读也不改写 持久中继发件箱,无法重放其待完成的工作 。 随后适用 POST,会话替换和在模糊读取后隐含的重试被拒绝. 签名获取保留正常设备/会话/非会话/序列验证 。 这不是 匿名或服务器侧权限绕行:打开会话创建 普通认证/审计记录。 报告这种影响与资料来源分开, 计划与证明的突变。 无法获取或被保护的身份不一致 未关闭, 而不是注册或生成替换密钥 .

-   [双向协议](https://github.com/dharma-ai-labs/dharma-agent-fabric/blob/main/docs/05-bidirectional-protocol.md)
-   [安全边界](https://github.com/dharma-ai-labs/dharma-agent-fabric/blob/main/docs/10-security-privacy-and-threat-model.md)
-   [来源](https://github.com/dharma-ai-labs/dharma-agent-fabric/tree/main/packages/relay-client)
-   [达摩大赦国际](https://www.dharma-ai.io/)

根据麻省理工学院的许可.

## 常见问题

### @dharma-ai-labs/agent-fabric-relay-client 是什么？

Dharma Agent Fabric 的境外签名设备注册和中继客户端

### 如何安装 @dharma-ai-labs/agent-fabric-relay-client？

在项目目录运行 npm install @dharma-ai-labs/agent-fabric-relay-client，或使用 pnpm add / yarn add / bun add。

### @dharma-ai-labs/agent-fabric-relay-client 支持 TypeScript 吗？

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

### @dharma-ai-labs/agent-fabric-relay-client 支持 ESM 还是 CommonJS？

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

### @dharma-ai-labs/agent-fabric-relay-client 可以商用吗？

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

### @dharma-ai-labs/agent-fabric-relay-client 的下载量有多少？

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

### @dharma-ai-labs/agent-fabric-relay-client 还在维护吗？

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

