# @ezship/cli 中文文档

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

版本：0\.1\.18
npm 元数据更新时间：2026-11-12T21:40:21.060Z
中文译文更新时间：2026-11-14T07:05:38.154Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40ezship/cli
原文对照：https://npmcn.com/package/%40ezship/cli/?lang=original

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

- 包体积（解压后）：1.8 MB，34 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2026-09-05T18:15:32.613Z
- 最新版本发布：2026-11-12T21:40:20.900Z
- 近 30 天下载量：2325（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 20 个）

## 中文简介

ez:"ezship Sites"的指挥线合同. 还有工作室的代理面板运行的模块.

## 安装

```sh
npm install @ezship/cli
```

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

## README

# `@ezship/cli`

这个 `ez` 命令和 **合同**: 每一次操作, 均由 CLI和工作室。 Apache-2.0;需要节点20或更后. `ez help` 是建立网站的指南.

## 签名于

`ez login acme` 发现 `https://acme.ezship.dev` 并用电子邮件(\`----------------------------------------------

\`,否则它会问起')。 它用\`-密码\[-用户名:NAME\]'来要求密码(或读取它) (b) “-浏览器”批准平台页面上的登录.

每个登录都是保存的连接 `~/.ez/connections.json`。 。 。 . `ez login bravo` 在Acme时保存另一个 保持初级状态; `ez logins` 列出他们, `ez switch bravo` 更改初级,以及 `--instance acme` 目标 一个命令。 绑定文件夹总是意味着它自己的实例 。 用于当地发展 `ez login http://dev.localhost:5199`;不需要更改系统 DNS .

`ez account [--password]` 打开平台的账户页面. `ez tokens` 财务报告和审定财务报表 `ez token revoke <id>` 清单和 撤销符 (`--json` 页:1. `ez logout [--all]` 忘记了保存的证书;它不会撤销一个标志.

## 实例文件夹

`ez clone [<instance>]` 调出每个 您可以打开的站点 `sites/<folder>/`,以网站命名,并 全球工作空间进入 `global/`· ; `ez pull --all` 刷新它们, 遵循每个文件夹的绑定, 绝不是它的 名称,并在其网站更名时移动文件夹。 任何网站都不得命名 `global` 或者说 `sites`。 。 。 .

`ez global <command>` 工作在全球工作副本 从网站的文件夹。 管理员和建设者增加表格, 无效的列和索引到 `global/db/schema.sql`; 每个计划编辑再生 `global/db/types.d.ts`, (中文(简体) ), 和站点代码导入行类型 `global/db/types`运行 `ez global check`,则 `ez global push`,在 预览或部署可以创建您添加的内容: 推动使已公布的定义永久化, 不运行 DDL,以及 a 已部署的网址保持其密码和声明,直到再次部署为止。 有限建设者阅读、检查和 预览他们自己的副本.

`ez preview` 财务报告和审定财务报表 `ez dev` 与 `global/` 现场(或 `--global-dir <dir>`,这必须是 为同一实例和构建器所拉出),其他则带有被驱动的全局文件;保留版本的预览 用被推开的. `ez dev` 每次更改后都监视副本和上传; 预览会重新加载 在每次成功建造之后. `ez check` 运行主机管道的全部检查.

## 编辑器设置

克隆弹,拉起并 `ez dev` 写入 VS 代码和其他类型脚本编辑器的编辑器设置: 一个根 `tsconfig.json` 扩展 `.ez/editor/tsconfig.json`共享 `global/` 和每个网站文件夹, 与反应,JSX, `@ezship/react` 以及全球声明和数据库行类型。 工作不需要 npm 安装 收到了,长官 一个独立的工作副本,一个有自己的网站 `tsconfig.json`,或使用不同的 `--global-dir` 保留自己的设置; 自定义配置可以扩展 `./.ez/editor/tsconfig.json`编辑元数据 输入状态, Push 或 Preview, 声明会遵循已安装的 CLI 发布 .

## 包裹里有什么

-   `ez.mjs`:终端装订:登录,主机,站点选择,磁盘上的工作副本.
-   `connections.mjs`:发现、保存身份、主要、目标和要求具有约束力、合同 编号.
-   `commands.mjs` (单位:千美元)`@ezship/cli/contract`:针对 `Workspace` 接口,以及 `ROUTES`,怎样 每个远程方法都达到了 API(`httpWorkspace` 对于客户, `matchRoute` 页:1.
-   `schema.mjs` (单位:千美元)`@ezship/cli/schema`: App数据库规则表 `db/schema.sql` 解析器和计划 计划员.
-   `types.d.mts` (单位:千美元)`@ezship/cli/types`: HTTP API的外形.
-   `account.mjs`数字 : `ez tokens` 财务报告和审定财务报表 `ez token revoke`· ; `editor.mjs`: 编辑器设置; `bindings.mjs`: 在 文件夹绑定的生命 .
-   `local-fetch.mjs`: HTTP 用于 `*.localhost`,在连接回转时保留实例源.
-   `update-check.mjs`: 每天最多一次,npm是否有新的发布; `ez` 然后在标准错误上这么说 在命令之后. `EZ_NO_UPDATE_CHECK=1` 或者说 `CI` 关掉.

Plain JavaScript, 零运行时间依赖性, 没有构建 。 测试 : `bun run test`。 。 。 .

## 常见问题

### @ezship/cli 是什么？

ez:"ezship Sites"的指挥线合同\. 还有工作室的代理面板运行的模块\.

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

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

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

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

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

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

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

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

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

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

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

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

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

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