# @agentium/cli 中文文档

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

版本：4\.11\.0
npm 元数据更新时间：2026-10-23T22:37:43.568Z
中文译文更新时间：2026-11-08T08:24:38.741Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40agentium/cli
原文对照：https://npmcn.com/package/%40agentium/cli/?lang=original
项目主页：https://agentium.in/
源码仓库：https://github.com/agentiumOS/agentium

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

- 包体积（解压后）：30 kB，26 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：^22\.18\.0 \|\| ^24\.11\.0
- 运行依赖：1 个
- peer 依赖：@agentium/core ^4\.11\.0
- 首次发布：2026-05-22T19:58:10.822Z
- 最新版本发布：2026-10-23T22:37:43.420Z
- 近 30 天下载量：1855（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：39（近 12 个月 39 个）

## 中文简介

用于脚手架和管理Agtium项目的命令行工具

## 安装

```sh
npm install @agentium/cli
```

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

## README

# @ agentium/ cli (英语)

用于脚手架和管理Agentium项目的命令行工具.

## 安装

```bash
npm install -g @agentium/cli
```

或按需运行而不安装:

```bash
npx @agentium/cli init my-app
```

## 图标

### `agentium init <name>`

脚手架 一个新的Agtium项目。 别名 : `new`, (中文(简体) ), `create`。 。 。 .

```bash
agentium init my-app --template basic
agentium init voice-app --template voice
agentium init rag-app --template rag
agentium init browser-app --template browser
```

需要节点22.18+(22.x)或24.11+(24.x). 名称必须是没有范围或路径的小写 npm 名称 。 现有目的地在写作前被拒绝. 生成的项目使用 CLI 发布范围, 限定可选 SDK 范围, 并包含 `typecheck` 并设置指示。 设定 `OPENAI_API_KEY` 在你的外壳和 `OPENAI_MODEL` 用于文本/浏览器示例。 浏览器项目也需要 `npx playwright install chromium`。 。 。 .

模板 :

| 模板 | 你得到的东西 |
| --- | --- |
| `basic` | 一个 `Agent` 请求与资源清理 |
| `rag` | 内向量检索作为证据传递给代理人 |
| `voice` | 配置 `VoiceAgent` 配备 OpenAI 实时提供者; 提供您自己的媒体运输工具 |
| `browser` | `BrowserAgent` 与剧作家 |

### `agentium dev`

在 Dev 模式下运行 Agentium app,并进行热重载.

```bash
agentium dev --entry ./src/index.ts
```

### `agentium skills install <source>`

使用 npm 安装 npm/ Git 软件包, 安装已禁用脚本, 或者验证本地目录中包含 `SKILL.md` (或档案本身). 在应用程序或控制配置中明确注册软件包工具或技能目录。 此命令不会自动创建运行时间表或附加技能 .

```bash
agentium skills install github:agentiumOS/skill-gmail
agentium skills install @some-org/skill-pagerduty
agentium skills install ./local-skill
```

### `agentium publish`

方便包装 `npm publish --access public` – 在一个 Agentium monorepo 内有用,您想要从任何软件包目录中运行一个命令.

## 文档

完整文件时间 [参考文献. agentium.in](https://docs.agentium.in/)

## 社区

加入对话 [解析器](https://discord.gg/T86SJshP)。 。 。 .

## 许可证

麻省理工学院

## 常见问题

### @agentium/cli 是什么？

用于脚手架和管理Agtium项目的命令行工具

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

在项目目录运行 npm install @agentium/cli，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@agentium/core（^4\.11\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 agentium，可以用 npx agentium 直接运行。

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

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

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

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

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

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

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

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

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

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

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

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