esa-cli 0.0.2-beta.2 → 0.0.2-beta.21

package/dist/docs/Commands_zh_CN.md

@@ -1,224 +1,236 @@
-# Commands
+## 命令一览
 
-### init
+### esa init [name]
 
-选择模版初始化项目。
+初始化一个边缘函数项目（支持框架或模板）。
 
 ```bash
-$ esa init [OPTIONS]
+esa init [name]
 ```
 
-- -c, --config `boolean` `optional`
-- 在您的项目中生成一个esa.toml配置文件。
+- 位置参数：
+  - name：项目名
 
-### routine [script]
+- 选项：
+  - -f, --framework string：选择前端框架（react/vue/nextjs...）
+  - -l, --language string：选择语言（typescript/javascript）。可选：typescript | javascript
+  - -t, --template string：指定模板名称
+  - -y, --yes boolean：对所有交互询问选择“是”（默认 false），模版采用helloworld
+  - --git boolean：在项目中初始化 git
+  - --deploy boolean：初始化完成后自动部署
 
-管理边缘函数。
+---
 
-#### delete <routineName>
+### esa dev [entry]
 
-删除一个边缘函数。
+启动本地开发服务器。
 
 ```bash
-$ esa routine delete <routineName>
+esa dev [entry]
 ```
 
-- routineName `string` `required`
-- 要删除的边缘函数名称。
-
-#### list
-
-查看所有边缘函数。
+- 位置参数：
+  - entry：边缘函数入口文件
 
-```bash
-$ esa routine list
-```
+- 选项：
+  - -p, --port number：监听端口
+  - -m, --minify boolean：开发模式下压缩代码（默认 false）
+  - --refresh-command string：保存自动刷新前执行的命令
+  - --local-upstream string：在本地开发中作为源站的主机
+  - --debug boolean：输出调试日志（默认 false）
 
-### route [script]
+---
 
-管理绑定到边缘函数的路由。
+### esa commit [entry]
 
-#### add [route] [site]
-
-将路由绑定到边缘函数。
+提交代码并保存为新版本。
 
 ```bash
-$ esa route add [route] [site]
+esa commit [entry]
 ```
 
-#### delete <route>
-
-删除一个绑定路由。
+- 选项：
+  - -m, --minify boolean：提交前压缩代码（默认 false）
+  - -a, --assets string：静态资源目录
+  - -d, --description string：版本/例程描述（跳过交互输入）
+  - -n, --name string：边缘函数名称
 
-```bash
-$ esa route delete <route>
-```
+---
 
-- route `string` `required`
-- 要删除的路由名称。
+### esa deploy [entry]
 
-#### list
-
-查看所有绑定路由。
+部署项目。
 
 ```bash
-$ esa route list
+esa deploy [entry]
 ```
 
-### login
-
-登录。
+- 选项：
+  - entry 可选参数，默认以`esa.jsonc`中entry配置为准
+  - -v, --version string：指定要部署的版本（跳过交互选择）
+  - -e, --environment string：部署环境。可选：staging | production
+  - -n, --name string：边缘函数名称
+  - -a, --assets string：静态资源目录（例如：./dist）
+  - -d, --description string：版本描述
+  - -m, --minify boolean：是否压缩代码
 
-```bash
-$ esa login
-```
+---
 
-### dev [entry]
+### esa deployments [list | delete]
 
-启动本地调试。
+管理部署版本。
 
 ```bash
-$ esa dev [entry] [OPTIONS]
+esa deployments list
+esa deployments delete [deploymentId...]
 ```
 
-- entry `string` `optional`
-- 入口文件路径。
-
-- -port, --p `number` `optional`
-- 监听端口。
-
-- --inspect-port `number` `optional`
-- 用于 Chrome inspect 调试工具的端口。
-
-- -minify, --m `boolean` `optional`
-- 开发打包时压缩代码。
+- 子命令：
+  - list：列出所有部署
+  - delete [deploymentId...]：删除一个或多个部署版本
 
-- --local-upstream `string` `optional`
-- 在开发时作为源站的域名。
+---
 
-- --refresh-command `string` `optional`
-- 提供一个在保存自动刷新前执行的命令。
+### esa routine [list | delete]
 
-### deploy [entry]
-
-部署您的项目。
+管理边缘函数。
 
 ```bash
-$ esa deploy [entry]
+esa routine list
+esa routine delete <routineName>
 ```
 
-- entry `string` `optional`
-- 入口文件路径。
-
-### domain [script]
+- 子命令：
+  - list：列出所有边缘函数
+  - delete `<routineName>`：删除指定边缘函数
 
-管理绑定到边缘函数的域名。
+---
 
-#### add <domain>
+### esa site [list]
 
-绑定域名到边缘函数。
+管理站点。
 
 ```bash
-$ esa domain add <domain>
+esa site list
 ```
 
-- domain `string` `required`
-- 需要添加的域名。
-
-#### delete <domain>
-
-删除一个绑定域名。
-
-```bash
-$ esa domain delete <domain>
-```
+- 子命令：
+  - list：列出所有已激活站点
 
-- domains `string` `required`
-- 要删除的绑定域名。
+---
 
-#### list
+### esa domain <add | list | delete>
 
-查看所有绑定域名。
+管理与边缘函数绑定的域名。
 
 ```bash
-$ esa domain list
+esa domain add <domain>
+esa domain list
+esa domain delete <domain>
 ```
 
-### deployments [script]
+- 子命令：
+  - add `<domain>`：绑定域名
+  - list：查看所有已绑定域名
+  - delete `<domain>`：删除已绑定域名
 
-管理您的部署。
+---
 
-#### delete <deploymentId>
+### esa route <add | list | delete>
 
-删除一个部署版本。
+管理与边缘函数绑定的路由。
 
 ```bash
-$ esa deployments delete <deploymentId>
+esa route add
+esa route list
+esa route delete <routeName>
 ```
 
-- deploymentId `string` `required`
-- 要删除的部署版本ID。
+- 子命令：
+  - add：绑定路由
+  - list：查看所有已绑定路由
+  - delete `<routeName>`：删除已绑定路由
 
-#### list
+#### esa route add
 
-查看所有部署。
+为当前边缘函数绑定一个路由。
 
 ```bash
-$ esa deployments list
+esa route add [route] [site] [--alias <routeName>] [--route <route>] [--site <site>]
 ```
 
-### commit [entry]
+- 位置参数（可选）：
+  - route：路由值，例如：example.com/_ 或 _.example.com/\*
+  - site：站点名称，例如：example.com
 
-提交代码，保存为一个版本。
+- 选项：
+  - -r, --route string：路由值，例如：example.com/\*
+    - 主机名支持以 `*` 开头表示后缀匹配（如：`*.example.com`）
+    - 路径支持以 `*` 结尾表示前缀匹配（如：`/api/*`）
+  - -s, --site string：站点名称（需为已激活站点）
+  - -a, --alias string：路由名称（别名）
 
-```bash
-$ esa commit [entry] [OPTIONS]
-```
+- 交互提示：
+  - 未提供 `--alias` 时，会提示输入路由名称
+  - 未提供 `--site` 时，会列出账号下已激活站点供选择
+  - 未提供 `--route` 时，会提示输入路由值
 
-- entry `string` `optional`
-- 入口文件路径。
+- 路由匹配说明：
+  - host 支持前缀 `*`：`*.example.com` 表示匹配所有以 `.example.com` 结尾的域名
+  - path 支持后缀 `*`：`/api/*` 表示匹配以 `/api/` 开头的路径
+  - 示例：`example.com/*`、`*.example.com/`、`*.example.com/api/*`
 
-- -m, --minify `boolean` `optional`
-- 上传前压缩代码。
+- 示例：
+  - `esa route add -a home -s example.com -r example.com/*`
+  - `esa route add example.com/* example.com -a home`
 
-### logout
+---
 
-注销登录。
+### esa login
+
+登录。
 
 ```bash
-$ esa logout
+esa login
 ```
 
-### config
+- 选项：
+  - --access-key-id, --ak string：AccessKey ID (AK)
+  - --access-key-secret, --sk string：AccessKey Secret (SK)
+- 从环境变量中读取process.env
+  - ESA_ACCESS_KEY_ID
+  - ESA_ACCESS_KEY_SECRET
 
-使用 -l 或 -g 修改本地或全局配置。
+---
+
+### esa logout
+
+退出登录。
 
 ```bash
-$ esa config [OPTIONS]
+esa logout
 ```
 
-- -g, --global `boolean` `optional`
-- 编辑全局配置文件。
+---
 
-- -l, --local `boolean` `optional`
-- 编辑本地配置文件。
+### esa config [-l | -g]
 
-### lang
-
-选择语言。
+修改本地或全局配置。
 
 ```bash
-$ esa lang
+esa config [--local] [--global]
 ```
 
-### site [script]
+- 选项：
+  - -l, --local boolean：编辑本地配置文件（默认 false）
+  - -g, --global boolean：编辑全局配置文件（默认 false）
 
-管理站点。
+---
 
-#### list
+### esa lang
 
-列出站点。
+设置 CLI 语言。
 
 ```bash
-$ esa site list
+esa lang
 ```

package/dist/i18n/index.js

@@ -1,8 +1,8 @@
 import { resolve } from 'path';
-import { getCliConfig } from '../utils/fileUtils/index.js';
 import logger from '../libs/logger.js';
-import { readJson } from '../utils/readJson.js';
 import { getDirName } from '../utils/fileUtils/base.js';
+import { getCliConfig } from '../utils/fileUtils/index.js';
+import { readJson } from '../utils/readJson.js';
 const localesJson = readJson(resolve(getDirName(import.meta.url), './locales.json'));
 const t = (key, variables) => {
     var _a;