# @agentyx/cli 中文文档

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

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

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

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

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

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

## 中文简介

Agentyx 的命令行接口.

## 安装

```sh
npm install @agentyx/cli
```

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

## README

# @ agentyx/ cli (英语)

用于选择Agentyx能力包并安装其技能/MCP的提供者不可知的CLI 配置为本地编码代理目标.

```sh
pnpm dlx @agentyx/cli init --pack technical --pack typescript --target codex --yes
pnpm dlx @agentyx/cli doctor
pnpm dlx @agentyx/cli install --dry-run
pnpm dlx @agentyx/cli install
```

配置为 第一组 :

```json
{
  "packs": ["technical", "typescript", "angular", "efficiency"],
  "enable": ["rtk"],
  "targets": ["codex", "kimi"]
}
```

`packs` 总是安装他们的轻量级技能。 可选较重能力,例如: `rtk` 或者说 `codebase-memory` 只在列表中活动 `enable` 或通过 `--enable` 运行.

使用 `agentyx configure --exclude skill:api-design --yes` 将已宣布的能力从 有效利用,或 `agentyx configure --include skill:api-design --yes` 取消这种排除. `--include` 不激活可选能力;它将它们返回到普通的包语义.

有用的检查命令 :

```sh
agentyx pack show efficiency
agentyx skill list
agentyx mcp list
agentyx target list
agentyx source show superpowers
agentyx source inspect superpowers
agentyx graph
agentyx report
agentyx graph --format mermaid
agentyx graph owner authentication
```

项目图中记录的直接建筑关系 `.agentyx.json` 并揭示文本, JSON,美人鱼和SVG预测. 这不是一个包依赖图。 仓库/docs/MCP 参考文献是描述性的: Agentyx 不获取或索引相关的寄存器. 配置 项目事实和可选内部上下文作为中立供应商安装 `agentyx-project-context` 技能通过正常适配器生命周期. 交互式 `init` 现有提议 `check`, (中文(简体) ), `test`, (中文(简体) ), `build`,以及 `lint` 仅当脚本 软件包管理器是明确的。 建议开始未选定,作为指令数据存储,以及 从来不由Agentyx管理。 非交互式 `init` 没有上下文.

`doctor --check` 保持正常的人类或 JSON 输出,但退出时有代码 1 的警告以及 错误使得 CI 在安装漂移转换为破碎的运行前会失败 .

项目自有包可参考标准 `SKILL.md` 已声明目录 `skillDirectories` 财务报告和审定财务报表 `localPacks` 内 `.agentyx.json`。路径与项目和 Agentyx 相关 拒绝在工程外解决的符号链接 .

准确的CLI指针、已安装的锁文件、重新核对和锁取回,见 [可复制性指南](https://npmcn.com/package/docs/reproducibility.md)。 。 。 .

可通过下列方式宣布信任的外部来源: `trustedSources` 并在当地视察。 初始数据 超能力整合验证本地 `.codex-plugin/plugin.json` 和技能库存,但 将安装禁用,直到Agentyx能够保存有资源的技能目录.

## 常见问题

### @agentyx/cli 是什么？

Agentyx 的命令行接口\.

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

在项目目录运行 npm install @agentyx/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agentyx，可以用 npx agentyx 直接运行。

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

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

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

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

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

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

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

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

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

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

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

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