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

中文文档
0.2.37发布于 2026/11/05MITTypeScriptES Module构建来源已验证近 30 天下载 1970

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

中文使用文档

@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,会话替换和在模糊读取后隐含的重试被拒绝. 签名获取保留正常设备/会话/非会话/序列验证 。 这不是 匿名或服务器侧权限绕行:打开会话创建 普通认证/审计记录。 报告这种影响与资料来源分开, 计划与证明的突变。 无法获取或被保护的身份不一致 未关闭, 而不是注册或生成替换密钥 .

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

版本与发布记录

@dharma-ai-labs/agent-fabric-relay-client 共发布 43 个版本,首次发布于 2026/08/09;过去 12 个月发布了 43 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.37latest2026/11/0510 天前
0.2.362026/11/0511 天前
0.2.352026/11/0411 天前
0.2.342026/10/1828 天前
0.2.332026/10/151 个月前
0.2.322026/10/101 个月前

关于 @dharma-ai-labs/agent-fabric-relay-client 的常见问题

@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 和提交记录判断。