# @agentyx/adapters 中文文档

规范地址：https://npmcn.com/package/%40agentyx/adapters/

版本：0\.24\.0
npm 元数据更新时间：2026-10-26T11:00:49.611Z
中文译文更新时间：2026-11-06T11:55:10.477Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40agentyx/adapters
原文对照：https://npmcn.com/package/%40agentyx/adapters/?lang=original
项目主页：https://github.com/Andersseen/agentyx/tree/main/packages/adapters#readme
源码仓库：https://github.com/Andersseen/agentyx

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

- 包体积（解压后）：313 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：2 个
- 首次发布：2026-08-09T12:20:38.499Z
- 最新版本发布：2026-10-26T11:00:48.704Z
- 近 30 天下载量：3347（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 28 个）

## 中文简介

提供方适配器,MCP渲染和安全安装规划 Agentyx.

## 安装

```sh
npm install @agentyx/adapters
```

也可以使用：`pnpm add @agentyx/adapters`、`yarn add @agentyx/adapters`、`bun add @agentyx/adapters`

## README

# @ agentyx/ 适应器

用于 [剂型](https://github.com/Andersseen/agentyx): 转动的图层 已解析的 Ageyx 环境进入特定编码代理预期的文件.

Agentyx包,技能,MCP定义,和工具检查描述开发环境,从未 提供商,所以所有 提供商知道在这里生活,而不是在 [`@agentyx/core`](https://github.com/Andersseen/agentyx/tree/main/packages/core)此软件包取决于 核心; 核心从来不取决于它.

## 目标

| 编号 | 探员 | 项目技能目的地 |
| --- | --- | --- |
| `codex` | 代码 | `.agents/skills` |
| `claude` | 克劳德代码 | `.claude/skills` |
| `kimi` | 基米码 | `.agents/skills` |
| `qwen` | Quen 代码 | `.qwen/skills` |

每个目的地都是提供商记录的项目-地方会议: [代码](https://developers.openai.com/codex/skills) 阅读中立供应商的储存技能 `.agents/skills`, (中文(简体) ), [克劳德代码](https://code.claude.com/docs/en/skills) 从 `.claude/skills`, (中文(简体) ), [基米码](https://www.kimi.com/code/docs/en/kimi-code-cli/customization/skills.html) 也扫描 项目 `.agents/skills`,以及 [Quen 代码](https://qwenlm.github.io/qwen-code-docs/en/users/features/skills/) 从 `.qwen/skills`。 。 。 . 安装是本地项目,无文字记录 `$HOME`。 。 。 .

## 先计划,再写

```ts
import { applyInstallPlans, planInstall } from "@agentyx/adapters";
import { builtInSkillRegistry } from "@agentyx/core";

const skills = ["planning", "angular-modern"].map((name) => builtInSkillRegistry.get(name));

// Reads the destinations to classify each file, and writes nothing.
const plans = await planInstall({
  targets: ["codex", "claude", "kimi", "qwen"],
  projectDir,
  skills,
});

// The only code in Agentyx that mutates a project. Skipping it is a dry run.
await applyInstallPlans(plans);
```

一个计划是一份清单 `write-file` 操作,每个操作有一个 `create` 编号 : `update` 编号 : `unchanged` 状态, a 绝对路径和用于输出的工程相对路径。 父目录由 执行器,所以没有目录操作;没有运行命令的操作.

每个目标都是一样的 `SkillDefinition` 对象和犬类 `SKILL.md` 那个 `@agentyx/core` 因此供应商只能收到相同的指令。 提供商 共享相同的目的地和内容, 如 Codex 和 Kimi 代码, 崩溃为一个物理写入 与共享 `usedBy` 元数据.

## 写入适配器

适配器是一个满足的普通对象 `AgentAdapter`页:1 `id`页:1 `name`它拥有的目录, `detect`,则a **纯** `planFiles` 将解析的技能映射到想要的文件。 把它们比作 安装和写的东西是共享的机器.

```ts
import { createAdapterRegistry, createSkillDirectoryAdapter } from "@agentyx/adapters";

const acme = createSkillDirectoryAdapter({
  id: "acme",
  name: "Acme Agent",
  skillsDir: [".acme", "skills"],
  reference: "https://example.invalid/skills",
});

const registry = createAdapterRegistry([acme]);
```

`createSkillDirectoryAdapter` 涵盖任何读取 `<directory>/<skill>/SKILL.md`; 一个真正的 不同的布局执行 `AgentAdapter` 直接说 没有动态包装和没有 远程注册——适配器是您传递的值 .

## 安全问题

Agentyx 只管理 `<destination>/<skill>/SKILL.md` 为它所决定的技能, `<agents dir>/<agent>.md` (或 `.toml`对于它解决的代理,以及它添加到一个提供者项目中的MCP服务器和钩子键 相会. 在目录或项目文件外写入的计划 a 拒绝目标自有 `InstallPathError`,包括项目本地路径 共鸣. 未更改的文件不重写, 写作为 UTF-8, 并且没有执行、 获取或 全球安装.

项目MCP配置,项目钩和项目代理都是通过同一方式规划并写入的 计划第一机器。 适配器只接收活性定义;包和可选能力 解析保留在核心中。 权限和用户-全球配置不是合同的一部分 : Agentyx 从不写在下面 `$HOME`,这就是为什么一个只有用户级的提供者——Kimi 代码——完全没有钩子安装.

当一个提供者文件具有几种能力时,它仍然是一种写作。 Quen代码读作两种 `mcpServers` 财务报告和审定财务报表 `hooks` 从 `.qwen/settings.json`,所以计划者 将两者合并为 单个操作和锁定记录 `settings` 条目同时命名服务器和 钩子;将计划两个独立的合并一个文件,每个文件从一个被读取的被读取的被读取,第二个文件 写会掉第一个.

Prune 和 uninstall 只在路径、 MCP 服务器密钥和被录入的钩子名称上行事 `.agentyx.lock.json`文件 其当前内容不再与所显示的散列相匹配,被报告为冲突而独自一人 除非呼叫者明确选择 `--force`。 。 。 .

麻省理工学院

## 常见问题

### @agentyx/adapters 是什么？

提供方适配器,MCP渲染和安全安装规划 Agentyx\.

### 如何安装 @agentyx/adapters？

在项目目录运行 npm install @agentyx/adapters，或使用 pnpm add / yarn add / bun add。

### @agentyx/adapters 支持 TypeScript 吗？

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

### @agentyx/adapters 支持 ESM 还是 CommonJS？

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

### @agentyx/adapters 需要什么版本的 Node\.js？

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

### @agentyx/adapters 可以商用吗？

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

### @agentyx/adapters 的下载量有多少？

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

### @agentyx/adapters 还在维护吗？

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