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

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

版本：0\.1\.18
npm 元数据更新时间：2026-10-18T08:57:07.622Z
中文译文更新时间：2026-11-12T06:05:45.177Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：489 kB，90 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-08-08T21:27:57.072Z
- 最新版本发布：2026-10-18T08:57:06.677Z
- 近 30 天下载量：11574（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

Dharma Agent Fabric 的版本计划、签名和类型脚本合同

## 安装

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

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

## README

# `@dharma-ai-labs/agent-fabric-contracts`

Dharma Agent Fabric 协议的版本类型脚本合同和验证器 信封、提供者能力、证据请求、签名任务和收据. Schema的有效性确定了结构和完整性;它没有证明事实 确定理由或推理的有效性.

## 签名过期回收拥有协议

`parseDeviceSigningRecoveryChallenge()`, (中文(简体) ), `deviceSigningRecoverySigningPayload()` 财务报告和审定财务报表 `verifyDeviceSigningRecoveryProof()` 验证目的分离 `dharma.device-signing-recovery-challenge/v1` 公共占有协议。 这个 挑战约束现有装置和安装、预定接收者、, 组织、工作空间、源选择和政策、受保护的配置、, 本地会话绑定文摘、浏览器批准意图、准确的发行人/观众, 以前的被保护锚和信任, 提议的单体信托文物, 加密传送公用钥匙和最多15分钟的窗口. 会话约束 是文摘,从不浏览器 cookie, 会话符号或本地的语录内容.

有效证据只确定设备钥匙的拥有。 它不是接受者或 所有者核准、候选出处、服务器认证员核查,a 单用途消费记录或修改受保护信任的许可。 呼叫者 必须从权威记录中获得预期的背景,而不是从 请求 计划检查结构; 解析器还检查峡谷 编码、时间戳、上下文平等、增加生成和改变 艺术品 普通签名更新核查和历史关键窗口 不变。 服务器、浏览器和被保护的存储恢复流程尚未实现 连接;仅靠这些功能无法恢复生产.

## 行动决定收款

`dharma.action-decision-receipt/v1` 是一个由名字签名的短期收据 KMS 密钥版本. 它携带一个 `release`, (中文(简体) ), `block`, (中文(简体) ), `escalate`,或 `withhold` 将决定与组织、任务、行动、, 终点、工作空间、评价合同、国家信封、证据参考书, 和犬学SHA-256任务动作文摘. 收据最多可活30个 几分钟.

使用 `actionDecisionDigest()` 结束 `dharma.task-action/v1` 并验证嵌入式 `{ id, actionDigest, receipt, signature, keyVersion }` 与 `verifyActionDecisionReceipt()`。 。 。 . `buildActionDecisionAcknowledgement()` 发射 总部执行有效载荷 `executed`, (中文(简体) ), `contained`,或 `unknown` 处置。 身份确认在已签名的设备内返回 协议频道.

## 代码任务观察

`dharma.codex-task-observation/v1` 将一个逻辑命名会话工作项目绑定为 其精确保存的捕捉、源头和结果快照、签名存储器 包件,证据同意,以及独立签名的结果. 记录 包含散列和身份;原始来源,对话内容,证书, 私人分级者按其适用政策分别保留.

使用 `codexTaskLogicalRequestId()` 以在供应商复述时保存身份. `verifyCodexTaskObservation()` 检查设备签名, 当前注册 同意、权威证据、包干、分级合同、, 和独立的分级签名。 分级键必须与设备不同 键。 失败和中断的工作可以保留失败的结果;它们不能声称 过分 提供商要求的型号与其 未报告的已执行模式,而且重放是明确的任务级别.

原地观测核查现在需要 `retained.captureBytes` 从 授权的证据库。 匹配设备提供的散列描述符不是 足够了. `verifyCodexTaskCaptureBytes()` 检查准确的 UTF-8 字节 严格 v2 捕获计划, 请求/ 事件摘要, 所有范围化的身份, 事件 命令、时限、完整覆盖和观察终端通知. 其投入和产出没有授权披露或证明执行. 在本地保留原始捕获加密,除非有单独的适用许可 保留。 编辑或可移植导出是不同的证据 文摘;不能作为原始抓取而被传递. 缺少原始字节 未关闭且没有资格进入本地观察机构.

`verifyCodexTaskOutcome()` 适用具有约束性、时间性和独立性的相同结果 签名检查不需要设备签名的观察信封. A 类 成功结果返回收件ID、犬类收件散列和实际 任务详细证据参考的级别。 提供权威的逻辑工作, 抓取、快照、评估合同和公开证据散失 终端状态和完成时间、已注册设备密钥和可信任的分级器 解决者。 仅凭核实的结果并不能证明目前的同意或入学情况 并且不能被算作一种公认的学习观察.

打电话者必须从入学者那里获得核查资料和经批准的证据 存储和信任的分级记录,而不是对观察的 声明。 校验不存储或计数观察, 复制 或进行评价、金丝雀、出版或回滚。 这些运行时间 在学习之前仍然需要融入和真正的Codex资格 报告为可操作.

-   [API与活动合同](https://github.com/dharma-ai-labs/dharma-agent-fabric/blob/main/docs/12-api-and-event-contracts.md)
-   [API与活动合同](https://github.com/dharma-ai-labs/dharma-agent-fabric/blob/main/docs/12-api-and-event-contracts.md)
-   [来源](https://github.com/dharma-ai-labs/dharma-agent-fabric/tree/main/packages/contracts)
-   [达摩大赦国际](https://www.dharma-ai.io/)

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

## 常见问题

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

Dharma Agent Fabric 的版本计划、签名和类型脚本合同

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

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

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

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

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

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

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

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

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

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

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

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