# @cnbcool/cnb-cli 中文文档

规范地址：https://npmcn.com/package/%40cnbcool/cnb-cli/

版本：1\.19\.20
npm 元数据更新时间：2026-11-10T05:06:02.727Z
中文译文更新时间：2026-11-10T04:29:04.340Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40cnbcool/cnb-cli
原文对照：https://npmcn.com/package/%40cnbcool/cnb-cli/?lang=original
源码仓库：https://cnb.cool/cnb/skills/cnb-skill

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

- 包体积（解压后）：1.5 MB，6 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：0 个
- 首次发布：2026-03-25T11:54:58.464Z
- 最新版本发布：2026-11-10T05:06:02.516Z
- 近 30 天下载量：124217（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：287（近 12 个月 287 个）

## 中文简介

CNB OpenAPI 命令行工具，基于 CNB 平台 Swagger 自动生成，支持 Issues、PR、Git、组织管理等全部 API 操作

## 安装

```sh
npm install @cnbcool/cnb-cli
```

也可以使用：`pnpm add @cnbcool/cnb-cli`、`yarn add @cnbcool/cnb-cli`、`bun add @cnbcool/cnb-cli`

## README

# CNB Skills

CNB 平台技能集合，支持多种主流 Agent，通过 `npx skills` 一键安装。

## 快速开始

```bash
# 推荐：全局安装所有 Skills，对所有 Agent 生效
npx skills add https://cnb.cool/cnb/skills/cnb-skill.git -g -y
```

安装后所有 CNB Skills 即可在任意 Agent 中使用。

## 更多安装方式

```bash
# 安装到指定 Agent（如 CodeBuddy；不指定 --agent 时自动检测并提示选择）
npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --agent codebuddy -y

# 同时安装到多个 Agent
npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --agent codebuddy --agent claude-code -y

# 安装到所有支持的 Agent
npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --agent '*' -y

# 只安装指定 Skill（先用 --list 查看可安装项）
npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --list
npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --skill cnb-api --agent codebuddy -y
```

* * *

## 前置依赖

使用 `npx skills` 需要安装 cnb-cli：

```bash
# macOS / Linux
curl -fsSL https://cnb.cool/cnb/skills/cnb-skill/-/git/raw/main/install.sh | sh

# Windows PowerShell
irm https://cnb.cool/cnb/skills/cnb-skill/-/git/raw/main/install.ps1 | iex

# npm
npm install @cnbcool/cnb-cli -g
```

> 也可前往 [Releases](https://cnb.cool/cnb/skills/cnb-skill/-/releases) 手动下载。

## AI 安装提示词

将以下内容发送给 Agent 即可自动安装；按需替换 `--agent` 参数：

```
npm install @cnbcool/cnb-cli -g
npm install skills -g
npx skills add https://cnb.cool/cnb/skills/cnb-skill.git --agent codebuddy -y --copy
```

## 环境变量

**必填**

-   `CNB_TOKEN`：访问凭证
-   `CNB_API_ENDPOINT`：API 端点，如 `https://api.cnb.cool`

**可选**

-   `CNB_BRANCH`：默认分支
-   `CNB_SSL_NO_VERIFY`：设为 `true` 跳过 HTTPS 证书校验，适用于自签证书或私有化部署。仅作用于 cnb 自身请求，`git` 的 clone/push 需另配 `http.sslVerify=false`

## cnb git-credential

`cnb git-credential` 可作为 Git Credential Helper，为 HTTPS 操作自动提供 CNB 访问凭据。

### 1\. 登录

```bash
cnb login
```

### 2\. 配置 Git

```bash
git config --global credential.https://cnb.cool.helper ""
git config --global credential.https://cnb.cool.helper "!cnb git-credential"
git config --global credential.https://cnb.cool.useHttpPath true
```

### 3\. 使用 HTTPS 操作

```bash
git clone https://cnb.cool/<org>/<repo>.git
cd <repo>
git pull
git push
```

> 凭据来源优先级：CodeBuddy 环境 token → `CNB_TOKEN` 环境变量 → `~/.cnb/token` 登录凭据。

## 常见问题

### @cnbcool/cnb-cli 是什么？

CNB OpenAPI 命令行工具，基于 CNB 平台 Swagger 自动生成，支持 Issues、PR、Git、组织管理等全部 API 操作

### 如何安装 @cnbcool/cnb-cli？

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

### @cnbcool/cnb-cli 支持 TypeScript 吗？

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

### @cnbcool/cnb-cli 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

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

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

### @cnbcool/cnb-cli 可以商用吗？

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

### @cnbcool/cnb-cli 的下载量有多少？

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

### @cnbcool/cnb-cli 还在维护吗？

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