# @agentxm/registry-protocol 中文文档

规范地址：https://npmcn.com/package/%40agentxm/registry-protocol/

版本：0\.51\.0
npm 元数据更新时间：2026-10-30T03:39:05.983Z
中文译文更新时间：2026-11-06T08:26:06.509Z
软件包许可：FSL-1\.1-MIT

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

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

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

- 包体积（解压后）：209 kB，23 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.21\.0
- 运行依赖：1 个
- peer 依赖：effect ^4\.1\.0
- 首次发布：2026-09-02T10:30:44.973Z
- 最新版本发布：2026-10-30T03:39:05.589Z
- 近 30 天下载量：3847（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：60（近 12 个月 60 个）

## 中文简介

探员XM 登记电线合同:索引、发现、出版物集、能见度、授权和建议行动计划。 不稳定且不支持——使用轴心.sh CLI.

## 安装

```sh
npm install @agentxm/registry-protocol
```

也可以使用：`pnpm add @agentxm/registry-protocol`、`yarn add @agentxm/registry-protocol`、`bun add @agentxm/registry-protocol`

## README

# @ agentxm/ registry- protocol

AXM客户端对公共代理XM Register HTTP的打字代表 合同: 扩展索引和版本条目计划 (单位:千美元)`./unstable/registry/schema`),发现请求 (单位:千美元)`./unstable/registry/discover-schema`预览和 审定(`./unstable/registry/publication-set`),公布能见度 (单位:千美元)`./unstable/publish`,以及共同建议的行动和 人手错误词汇表( a)`./unstable/suggested-action`, (中文(简体) ), `./unstable/human-handoff`) (中文(简体) ).

## 批量分辨率元数据

`./unstable/registry/resolution-metadata` 定义已版本的 a 合同 重复安全 `POST /v1/resolutions/metadata` 查询。 书记官处拥有HTTP 路由和授权; AXM 保存版本选择、发布年龄政策,以及 依附图决定. 一个请求将最多100件物品分组到一个信任的项目中 书记官处和证书背景。 每个项目都有唯一的调用键, 扩展名 身份,以及一个 `select` 或者说 `restore-exact` 目标。 确切的修复用品 被接受的版本和完整性。 打电话者也可提供预期的 出版物的约束力、已知的代表权修订或 前次修订.

答复按请求顺序对每个提交的关键有一个结果:

| 结果 | 含义 |
| --- | --- |
| `metadata` | 授权的一页版本描述器,依赖性和包兼容性数据,生命周期信息,以及不透明的修订. A 类 `null` 继续意味着候选人名单已经完成. |
| `unchanged` | 目前的授权和生命周期仍然承认客户已经持有相应的完整代表。 没有代理的客户重复此项目 `knownRevision`。 。 。 . |
| `unavailable` | 身份不存在或无法获取;答复故意没有区分这些案件. |
| `binding-conflict` | 授权身份不再具有预期出版商的约束性. |
| `exact-conflict` | 经授权的准确版本或完整性不再符合公认的身份. |
| `restart-required` | 继续的一页横跨了演示文稿的修订;丢弃了以前的一页并重新启动. |

一个元数据页最多包含100个版本. 客户端必须跟随每一个 在选择版本之前继续并检查修订和结果密钥; 截取的页面永远不会完成选择输入 。 继续符号为 透明度高,书记官处必须将其与请求的身份、证书相挂钩 和修订。 更改装订、持有、能见度、横幅、档案或 折旧事实必须使 `unchanged` 结果。 后端失败是 信封出错, 从未发明过每个项目缺失 。 查询是私人和 无法跨命令;其 POST 方法不会使发布突变 可重试.

计划导出项目、版本页、请求体和响应体 限制。 服务器在解码和返回前检查已编码的车体大小 已声明 `request-too-large` 超过时出错 。 请求密钥关联结果 只有,他们没有身份或进入.

导出 `./unstable/registry/resolution-metadata.vectors.json` 记录 普通和精确的扬克、释放年龄、直接和包的选定示例 限制、软件包兼容性,以及出版社约束的修改。 生产商和 消费者测试可以在不移动选择到服务器的情况下使用相同的案例.

活字节 `./unstable/registry/publication-set.vectors.json` 导出指针摘要 独立执行公开议定书的合规范例. 它的元数据描述了条框化和可选域规则 文摘算法需要新的合同标识符和矢量格式 而不是编辑现有向量的含义.

内容分析、知识检查、索引目录和档案 显示的验证存在于 `@agentxm/extension-content`; 释放选择 住在这里 `@agentxm/extension-model`,并且释放年龄政策生活在 `@agentxm/workspace-kernel/resolution`。 。 。 .

此软件包与每个软件包一同发布 `axm.sh` 释放,与 绑起来的CLI 每个出口都生活在一个明确的 `./unstable/*` 子路径:表面不支持,可能会改变任何释放. 普通类 用户应当使用 [`axm` 国 际](https://axm.sh/) 换句话说.

FSL-1.1-MIT 2025-2026 AgentXM, Inc.

## 常见问题

### @agentxm/registry-protocol 是什么？

探员XM 登记电线合同:索引、发现、出版物集、能见度、授权和建议行动计划。 不稳定且不支持——使用轴心\.sh CLI\.

### 如何安装 @agentxm/registry-protocol？

在项目目录运行 npm install @agentxm/registry-protocol，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：effect（^4\.1\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @agentxm/registry-protocol 支持 TypeScript 吗？

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

### @agentxm/registry-protocol 支持 ESM 还是 CommonJS？

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

### @agentxm/registry-protocol 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.21\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @agentxm/registry-protocol 可以商用吗？

@agentxm/registry-protocol 使用 FSL-1\.1-MIT 许可。声明的许可为 FSL-1\.1-MIT，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @agentxm/registry-protocol 的下载量有多少？

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

### @agentxm/registry-protocol 还在维护吗？

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