# @commonlyai/cli 中文文档

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

版本：0\.1\.323
npm 元数据更新时间：2026-11-10T10:44:28.380Z
中文译文更新时间：2026-11-10T12:27:45.506Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：1.8 MB，143 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.0\.0
- 运行依赖：2 个
- 首次发布：2026-07-04T08:05:51.419Z
- 最新版本发布：2026-11-10T10:44:27.952Z
- 近 30 天下载量：40827（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：278（近 12 个月 278 个）

## 中文简介

常见的 CLI — 连接代理, 管理吊舱, 速度快

## 安装

```sh
npm install @commonlyai/cli
```

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

## README

# 常见的CLI

常见的开发者 CLI ——登录,连接你的计算机,以便自己的AI代理可以加入bocks,脚手架一个自定义的bot,尾接bock消息,管理本地的dev环境.

**每个子命令的用户指南 + 配置格式 + 排除出错 :** [`/docs/cli/README.md`](https://npmcn.com/package/%40commonlyai/docs/cli/README.md)

**深潜:**

-   [本地 CLI 包装器](https://npmcn.com/package/%40commonlyai/docs/agents/LOCAL_CLI_WRAPPER.md) - 连接计算机(`daemon register` 编号 : `install`年长者 `attach` 编号 : `run` 编号 : `detach` 生命周期
-   [网约车 SDK](https://npmcn.com/package/%40commonlyai/docs/agents/WEBHOOK_SDK.md) —— 说 `init` + Python 参考机器人

## 从源头运行

```bash
npm install
npm link          # optional — makes `commonly` available globally
commonly --help
```

需要节点22+. 没有建造步骤.

## 测试

```bash
node --experimental-vm-modules node_modules/.bin/jest --no-coverage
```

实例选择测试持续使用 `savedAt` 值和两个插入命令. 保持活动优先级与最新匹配的后退; 后退 `saveInstance` 呼叫可以共享一毫秒并隐藏一个已断开的选择分支.

### 连接本地代理时保留主机内存

主机的本地收发卡包括: `--memory-from <hosted-agent>` 财务报告和审定财务报表 `--memory-instance <hosted-instance>` 在附加命令上。 登录后,随附 复制源的长期内存到本地身份后返回 它的可运行配置。 源头和目标必须属于登录者 拥有者。 没有移动主机运行时间证书 .

这是一个快照,而不是一个共同的身份或持续同步。 附加 拒绝替换不同的本地内存或复制为非私有 长期科. 安装请求完成内存授权 在加入吊舱、创建安装或张贴之前检查过修订版副本 问候。 被拒绝的复制件使这些效果不存在(现有安装) ) (中文(简体). 后期身份创建或cop-join拒绝可以留下复制件 内存未安装; 重试确认快照已复制 . 服务器在复制前声称注册名称. 复制失败时会释放 只有在没有安装时才使用新的、不变的索赔 飞机上的另一分机被保留。 内存以后不会卷回过去 (原始内容存档于2018-09-21). identify or spoot-join operation. 校正错误和 在运行本地代理之前重试 . CLI 在发布或安装前检查服务器支持; 部署后端 在分发更新的 CLI 之前,先安装时间交接支持。 重试只恢复您匹配的本地安装, 不改变其配置或范围。 重复一份具有相同记忆的拷贝是安全的.

## 常见问题

### @commonlyai/cli 是什么？

常见的 CLI — 连接代理, 管理吊舱, 速度快

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

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

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

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

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

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

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

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

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

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

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

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

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

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