# @concavejs/cli 中文文档

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

版本：0\.0\.1-alpha\.20
npm 元数据更新时间：2026-11-10T23:04:05.392Z
中文译文更新时间：2026-11-10T23:04:54.850Z
软件包许可：SEE LICENSE IN LICENSE

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

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

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

- 包体积（解压后）：8.4 MB，14 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.5\.0
- 运行依赖：16 个
- peer 依赖：wrangler \>=3\.0\.0
- 首次发布：2026-02-04T16:13:53.640Z
- 最新版本发布：2026-11-10T23:04:05.206Z
- 近 30 天下载量：14299（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

用于开发、检查、进口、出口和部署Concave应用软件的CLI

## 安装

```sh
npm install @concavejs/cli
```

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

## README

# @concavejs/cli (英语)

命令行接口 [隐蔽](https://concave.dev/)页:1 用于 Cloudflare 工人、 Bun 和 Convex 兼容的后端 节点.js.

孔口为相. 使用 [兼容矩阵](https://docs.concave.dev/reference/compatibility/) 在迁移或部署之前确认您的应用需要.

## 开始吧

现有的 Convex 应用程序保留其 `convex/` 目录和 `convex` 进口:

```sh
npx @concavejs/cli init
npx @concavejs/cli dev
```

`dev` 自动检测 Bun 或节点。 选择运行时间 `--bun`, (中文(简体) ), `--node` 或者说 `--cf` (克卢德弗莱尔通过Wrangler). 部署到云层 `npx @concavejs/cli deploy`。 。 。 .

见 [快速启动](https://docs.concave.dev/quickstart/) 财务报告和审定财务报表 [CLI 参考](https://docs.concave.dev/reference/cli/) 用于配置, 迁移、部署和操作员命令.

## 图标

运行 `concave --help` 完整名单。 主要群体:

| 组 | 图标 |
| --- | --- |
| 设置 | `init`, (中文(简体) ), `rules`, (中文(简体) ), `codegen`, (中文(简体) ), `components`, (中文(简体) ), `function-spec` |
| 开发 | `dev`, (中文(简体) ), `seed`, (中文(简体) ), `run`, (中文(简体) ), `data`, (中文(简体) ), `logs`, (中文(简体) ), `doctor` |
| 核查和代理 | `check --json`, (中文(简体) ), `verify`, (中文(简体) ), `inspect`, (中文(简体) ), `mcp` |
| 部署 | `deploy`, (中文(简体) ), `build`, (中文(简体) ), `rollback`, (中文(简体) ), `destroy`, (中文(简体) ), `status`, (中文(简体) ), `deployments`, (中文(简体) ), `migrations` |
| 访问 | `admin-key` (单位:千美元)`print`, (中文(简体) ), `rotate`, (中文(简体) ), `login`, (中文(简体) ), `env`, (中文(简体) ), `auth` (包括 `auth init` 用于 Convex Auth ) |
| 数据 | `export`, (中文(简体) ), `import` |
| 预览 | `cloud` (多租户托管) |

一个持久 `concave deploy` 薄荷 管理键。 使用 `concave admin-key print` 读它。 见 [CLI 参考](https://docs.concave.dev/reference/cli/)。 。 。 .

## 所需资源

-   节点js 22.5或更新,或 Bun
-   这个 `convex` convex 兼容类型和 API 应用程序中的软件包

当Bun手 `dev --node` 至 Node.js 的 CLI 探测器 发射 设定 `NODE_BIN` 选择一个特定的可执行节点;仅选择 CLI 添加 `--experimental-sqlite` 当选中的发布需要时.

见大众 [支助政策](https://docs.concave.dev/reference/support/) 用于α支持 边界。 船坞根据 [自定义函数源术语](https://docs.concave.dev/reference/license/)。 。 。 . 使用 [孔口发条](https://discord.gg/K2k3BaaXN4) 阿尔法反馈.

## 常见问题

### @concavejs/cli 是什么？

用于开发、检查、进口、出口和部署Concave应用软件的CLI

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

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

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

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

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

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

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

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

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

@concavejs/cli 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

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

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

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

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