# @composal/cli 中文文档

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

版本：1\.17\.108
npm 元数据更新时间：2026-11-05T19:21:32.750Z
中文译文更新时间：2026-11-10T13:59:43.019Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：124 MB，6 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-10-05T17:22:15.484Z
- 最新版本发布：2026-11-05T19:21:32.522Z
- 近 30 天下载量：4270（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：29（近 12 个月 29 个）

## 中文简介

用于校验、主机应用、部署、秘密和代理设置的组合 CLI

## 安装

```sh
npm install @composal/cli
```

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

## README

[![Composal silver foil sticker](https://raw.githubusercontent.com/ComposalAI/cli/main/assets/composal-silver-sticker.svg)](https://composal.com/)

# 组合式 CLI

**验证更改。 船舶应用. 装备你的特工.**

[无](https://www.npmjs.com/package/@composal/cli) • 妇女 [GitHub 图像](https://github.com/ComposalAI/cli) • 妇女 [文档](https://composal.com/docs) • 妇女 [组合](https://composal.com/)

* * *

`com` 把混凝土带到终端和编码代理上 验证真实的用户行程, 部署应用程序,管理机密,将您的代理连接到相同的工具 用来运送.

## 安装

与 **节点.js 18或更新**数字 :

```sh
npm install -g @composal/cli
```

更喜欢独立的安装器? 节点.js需要:

```sh
curl -fsSL https://dl.composal.com/install.sh | sh
```

两个选项都安装轻量级 `com` 产品CLI。 Git 源检出和 lex 执行属于单独的 `vex` CLI(英语:CLI).

支持的平台为 **macOS 苹果系统 硅** 财务报告和审定财务报表 **Linux x64 有克立布克**。在 Windows 上,使用 x64 WSL 分布.

您也可以在没有全局安装的情况下运行 :

```sh
npx @composal/cli --help
```

为项目安装 `npm install --save-dev @composal/cli` 运行 `npx com`。 。 。 . 用 `npm install -g @composal/cli@<version>`。 。 。 .

## 开始吧

```sh
com login
com whoami
com --help
```

对于代理和无头自动化,从嵌入在您 CLI 中的向导开始:

```sh
com agent-guide
com auth check --json
com schema verify sweeps run
com --agent app list --org <org>
```

`--agent` 返回未提示而版本的 JSON 收据. `--json` 保留 现有成功有效载荷和返回结构化故障。 读取嵌入式 用于认证、操作ID、一元重试和全工作流程的指南.

跟着 [快速启动](https://composal.com/docs/quickstart) 连接您的账户 并运行您的第一个命令.

## 尽你所能

|  | 从你的终端 |
| --- | --- |
| **[校验](https://composal.com/docs/verify)** | 测试真实的浏览器行程并检查截图,录音,和痕迹. |
| **[船舶应用](https://composal.com/docs/hosting)** | 应用,管理服务和预览环境,并检查日志. |
| **[管理机密](https://composal.com/docs/cli)** | 存储和取回秘密,或者运行命令 注入他们环境的秘密. |
| **[装备你的特工](https://composal.com/docs/agents)** | 为您的编码代理设置编译技能和MCP工具. |

以 `com verify --help`, (中文(简体) ), `com deploy --help`,以及 `com secrets --help`编辑 [CLI 参考](https://composal.com/docs/cli) 涵盖 全部命令设定 .

### 连接您的编码代理

对于 Codex ,请在您的项目中安装紧凑的组合技能 :

```sh
com skills install --targets codex --dry-run --json
com skills install --targets codex --json
```

运行 `com skills setup` 用于同一装置和 `com skills list` 工作流程参考和 `com skills install --help` 页:1 其他探员。 同样的紧凑指南在 [com/agent.md (中文(简体) )](https://composal.com/agent.md)。 。 。 . 使用 `com skills setup --targets codex --mcp` 安装相同的单一技能并配置 MCP. 添加 `--with deploy` 同时安装可选部署技能.

## 随时更新

全球 npm 安装 :

```sh
npm install -g @composal/cli@latest
```

项目安装,运行 `npm install --save-dev @composal/cli@latest`。 。 。 .

对于独立安装器:

```sh
com update
```

## 探索组合

-   [快速启动](https://composal.com/docs/quickstart) - 安装,注册,并开始.
-   [CLI 参考](https://composal.com/docs/cli) 命令和例子.
-   [校验](https://composal.com/docs/verify) ——浏览器测试您的应用程序.
-   [托管](https://composal.com/docs/hosting) 部署和操作您的应用程序.
-   [代理设置](https://composal.com/docs/agents) 把混音带到你的编码工作流程里.

找到问题还是有主意? [告诉我们](https://github.com/ComposalAI/cli/issues)。 。 。 .

## 常见问题

### @composal/cli 是什么？

用于校验、主机应用、部署、秘密和代理设置的组合 CLI

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

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

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

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/composal\_\_cli 是否存在。

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

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

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

@composal/cli 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

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

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

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

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