# @action-state-group/agent-action-capsule 中文文档 规范地址：https://npmcn.com/package/%40action-state-group/agent-action-capsule/ 版本：0\.14\.0 npm 元数据更新时间：2026-11-04T23:03:03.948Z 中文译文更新时间：2026-11-06T06:41:36.356Z 软件包许可：BSD-3-Clause 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40action-state-group/agent-action-capsule 原文对照：https://npmcn.com/package/%40action-state-group/agent-action-capsule/?lang=original 项目主页：https://github.com/action-state-group/agent-action-capsule#readme 源码仓库：https://github.com/action-state-group/agent-action-capsule ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.2 MB，133 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=20 - 运行依赖：0 个 - peer 依赖：@action-state-group/cll 0\.3\.0 - 首次发布：2026-10-06T08:30:34.088Z - 最新版本发布：2026-11-04T23:03:03.598Z - 近 30 天下载量：4410（2026-10-05 至 2026-11-03，npm 官方下载统计） - 已发布版本数：18（近 12 个月 18 个） ## 中文简介 Agent Action Capsule 格式 4 的文本引用 ## 安装 ```sh npm install @action-state-group/agent-action-capsule ``` 也可以使用：`pnpm add @action-state-group/agent-action-capsule`、`yarn add @action-state-group/agent-action-capsule`、`bun add @action-state-group/agent-action-capsule` ## README # 代理动作封面类型Script 引用 此软件包是符合 Python 权威的记录格式引用 在此仓库中。 它执行严格的JSON/JCS,格式4 Capsule IDs 类型1和 `references[]` 核查、登记册、, 制片人封口,并通过DE-3披露封口. 这是故意的 不包含 Capsule 生产者动词、 CLL 存储、 策略、 适配器或 permalink运输. 对只记录的消费者,使用所支持的 `@action-state-group/agent-action-capsule/core` 输入。 它输出现有的JSON/身份,打出Capsule型号,Class-1/store, 注册、 披露信封和生产者信封 API 不装入 Bundle, CLL或演示文稿模块. 内容 `browser` 条件不包括节点签名/密钥 创建,同时保留 WebCrypto 信封校验. ```ts import { verifyClass1 } from "@action-state-group/agent-action-capsule/core"; const result = await verifyClass1(capsule); ``` CLL 是一个可选的对等点, 因此干净的生产安装不会安装 CLL或它的存储驱动程序. 用于 `@action-state-group/agent-action-capsule/bundle` 或现有宽根条目,明确安装被绑定的相容 CLL: ```bash npm install @action-state-group/agent-action-capsule @action-state-group/cll@0.3.0 ``` `verifyBundle(bundle, { strict: true })` 增加严格检查 [`vectors/bundle/strict/README.md`](https://npmcn.com/package/%40action-state-group/vectors/bundle/strict/README.md) (单位:千美元) 判决(`result.strict.verdict`数字 : `VALID`, (中文(简体) ), `INCOMPLETE` 或者说 `INVALID`) (中文(简体) ). 过 `requireSignature` 未签名的记录和 `witnessDirectory` (a) 分析 `witnesses.json`检查证人的收据 `checkpoint.witnesses`; 无 被信任没有它。 CLL的COSE检查站核查员 验证签名 在节点和浏览器的检查点. `verificationBanner(context, stamps)` 宣布判决为 页面中,有一个州 [`spec/verification-display-v0.md`](https://npmcn.com/package/%40action-state-group/spec/verification-display-v0.md) 节 6.2; 2; `bundleVerified` 是它的门(第1节) `buildVerificationPageModel` 财务报告和审定财务报表 `verificationCheckLists` 给出其他验证页。 此软件包不绘制页面: 胶囊查看器 (单位:千美元)[`action-state-group/capsule-viewer`](https://github.com/action-state-group/capsule-viewer), (中文(简体) ), `ts/src/evidence-graph-view.ts` 从这个模型中抽取。 旗帜的 `state` 实值 `verified` 仅为 `valid` 判决,否则 `incomplete` 或者说 `failed`; 页面显示 `checking` 直到检查结束 `unable` 当它 根本没有SHA-256`UNABLE_TO_VERIFY_LINES`) (中文(简体) ). 每个州都有一条固定的线 (单位:千美元)`VERIFICATION_BANNER_LINES`被钉住的每个观众 [`vectors/viewer-core-text/`](https://npmcn.com/package/%40action-state-group/vectors/viewer-core-text/README.md)),没有 模块、措辞包或捆绑提供. `verdict` 实值 `valid`, (中文(简体) ), `incomplete` 或者说 `invalid`,以及 `checkpoint` 实值 `verified`, (中文(简体) ), `unverified`, (中文(简体) ), `invalid` 或者说 `absent`编辑 `detail` 页面未检查的行名或失败的行名, 和标签间隔覆盖 每个有记录的成员 `checkpoint_unverified` 当他们在检查站休息时 页面未认证。 没有ED25519的运行时间不严格 判决; 失踪 Ed25519 本身从来不是失败, 所以捆绑通过 页面本身的检查,每个记录绑入日志位置,读取 `incomplete`。浏览器用 CLL 建立检查点认证 浏览器条目, 有无WebCrypto; 使用 Ed25519 是它的旗子 节点给。 匹配这些字段的一页状态,而不是其词. `buildEvidenceBundle(source, { root, intervalFrom })` 从一个 `ProofSource`:该日志的签名 COSE检查站,它的叶子,记录由 Capsule 身份证, 包含和范围证明 在Bundle自己的线形。 没有 键,它用 `verifyBundle(bundle, { strict: true })` 在归还之前,拒绝 `BundleBuildError` 任何核查者 打电话来. `proofSourceFromCll(backend, records)` 制作一个 `ProofSource` 从 CLL 后端 (`scanEntries`, (中文(简体) ), `loadCll`还有一家唱片店 `get(capsuleId)` 决定: `capsule` 财务报告和审定财务报表 `producerEnvelope` 字节和拒绝 与 `code: "not_found"` 它没有记录. - `intervalFrom: N` 将每张记录从N后移到检查站小费 n以下没有,有范围证明: Bundle 可以读取 VALID . `N = 1` 这是 整个日志. - `intervalFrom: null` 只携带所选记录,每个记录都有自己的记录 包含证明和状态 `completeness.selection: "producer-selected"`数字 : 他们之间没有记录,所以它读作INCOMPLETE. `intervalFrom` 没有默认,所以一个呼叫者 从来没有交出整个日志 遗漏。 树叶上没有记录, N以下有记录 并拒绝通过检查站的记录 姓名。 缺少引文或 未署名的记录被声明,没有拒绝,并读取INCOMPLETE. `buildUnprovenBundle(records, { root })` 是没有日志证明的表单,用于 无日志的盖子 . `buildEvidenceBundle` 需要CLL的检查站 核查器,在节点测试; `buildUnprovenBundle` 没有检查站,所以 它在严格的地方运行 `verifyBundle` 包含浏览器. `@action-state-group/agent-action-capsule/settlement` 出口 `verifySettlements`,产生状态 `draft-mih-agent-settlement-records-01` 从双方的腿部记录。 这个 不需要 CLL . `@action-state-group/agent-action-capsule/witness` 出口证人收据 请检查严格模式的使用, 对于一个包外的呼叫者: `verifyCoseReceipt` (一个DER公用钥匙下的叶字节的COSE收据), `verifyReceipt`, (中文(简体) ), `verifyRekorReceipt`, (中文(简体) ), `verifyScrapiReceipt`帮助目录 `witnessRowFor` 财务报告和审定财务报表 `witnessRowKeys`它不需要CLL. 现有根出口仍然可用,安装了CLL。 分开 Bundle 条目重复使用 AAC 现有的验证器和 CLL 验证操作;它确实 未引入其他执行。 开发安装包括CLL,因此 完整套装和浏览器兼容套装继续运行. 节点条目需要node.js 20或更新. 使用 `browser` 条件解析 WebCrypto 唯一的校验条目;它排除 保留时只使用节点的制作人信封签名和密钥创建 API `verifyProducerEnvelope`。 。 。 . 依赖文摘的API为Aync:等待 `sha256Hex`, (中文(简体) ), `jsonDigest`, (中文(简体) ), `computeCapsuleId`, (中文(简体) ), `verifyClass1`, (中文(简体) ), `verifyStore`, (中文(简体) ), `verifyDisclosureEnvelope`, (中文(简体) ), `sealCapsule`,以及 `parseCapsule`。 。 。 . `verifyProducerEnvelope` 还在两个切入点同步. ```bash npm ci npm run check ``` 测试消耗了同样的承诺 蝎子下 `../vectors/`。 。 。 . ## 释放 发布跟随寄存器 [相关内容](https://npmcn.com/package/%40action-state-group/RELEASING.md): 运行 **· 准备** 页:1 `ts`,并合并其拉动请求 `ts/v` 标记和发送 [发布 \\ 发布类型脚本](https://github.com/action-state-group/agent-action-capsule/actions/workflows/publish-ts.yml) 就在这 工作流程检查标签对应 `ts/package.json`,锁文件和 承诺是在 `main`运行 `npm ci` 和完整的软件包 检查/建设,并履行 `npm publish --dry-run` 从上传前 `npm` 环境。 重运行跳过 npm 版本, 注册错误 除E404之外,其他出版物停止出版。 预发版 `next` ditt-tag, 以及一个比 npm 时长的稳定版本 `latest` 下级 `backport`这样 `latest` 永远不要往后移动. 在真正发布之前, npm 软件包所有者必须配置一个 [信任的出版社](https://docs.npmjs.com/trusted-publishers/) 页:1 `@action-state-group/agent-action-capsule`: GitHub 拥有者 `action-state-group`, (中文(简体) ), 仓库 `agent-action-capsule`,工作流程文件名 `publish-ts.yml`,以及 直接许可 `npm publish`,带有环境名称 `npm` (任务运行) 在这种环境下。 包/镜 必须由它的所有者提供; 该工作流程不拖住所有权. 工作流程使用节点22 (QQ22.14)并安装 npm 11.19.1; 信任 出版需要npm \\\\ 11.5.1. 没有使用长寿npm的代号,和 可信出版用品自动出处. 包裹公开. TS工作流程只为 `ts/v*` 标记: 当发布... 标记发送时 在标签上,或当一个 GitHub 释放一个 `ts/v*` 标签已发布, 因此 通过手上传到 npm 发布这样的发布. 被派到一个分行 什么也没做. `ts/v` 标签从不启动 Python/ PyPI 发布任务, 矢量 释放要分开. 对于本地的免上传预览,运行于 `ts/`数字 : ```bash npm ci npm run check npm publish --dry-run --access public ``` 如果 npm 已经包含该版本, 但是 GitHub 拒绝使用标签回收 工作流程令牌,拥有所需工作流程许可的维护者必须创建 `ts/v` 在npm记录 `gitHead`,然后重新运行工作流程。 别 重置另一个承诺或发布一个替换的 npm 版本. ## 常见问题 ### @action-state-group/agent-action-capsule 是什么？ Agent Action Capsule 格式 4 的文本引用 ### 如何安装 @action-state-group/agent-action-capsule？ 在项目目录运行 npm install @action-state-group/agent-action-capsule，或使用 pnpm add / yarn add / bun add。 ### @action-state-group/agent-action-capsule 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @action-state-group/agent-action-capsule 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @action-state-group/agent-action-capsule 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @action-state-group/agent-action-capsule 可以商用吗？ @action-state-group/agent-action-capsule 使用 BSD-3-Clause 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。另外不得用原作者名义为衍生产品背书。以上为概括，不构成法律意见，请以许可原文为准。 ### @action-state-group/agent-action-capsule 的下载量有多少？ 根据 npm 官方下载统计，@action-state-group/agent-action-capsule 在 2026/10/05 – 2026/11/03 这 30 天内被下载 4,410 次，日均约 147 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @action-state-group/agent-action-capsule 还在维护吗？ 最新版本 0\.14\.0 发布于 2026/11/05（1 天前）；至今共发布 18 个版本，其中过去 12 个月发布了 18 个；首次发布于 2026/10/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。