esa-cli 0.0.2-beta.12 → 0.0.2-beta.13

package/dist/docs/Commands_en.md

@@ -1,29 +1,25 @@
 # Commands
 
-- init - Initialize a new project from a template
-- dev - Start a local development server for testing
-- commit - Commit code and create a version
-- deploy - Build and deploy project to the edge routine
-- deployments - Manage deployments
-- routine - Manage edge routine functions
-- site - Manage site settings
-- domain - Configure edge function trigger domain
-- route - Configure edge function trigger routes
-- login - Authenticate via AK/SK to your account
-- logout - Log out current user
-- config - Modify local/global settings
-- lang - Switch CLI interface language
-
 ### init
 
-Initialize a routine with a template.
+Initialize a project using a framework or a template.
 
 ```bash
 $ esa init [OPTIONS]
 ```
 
+- -f, --framework `string` `optional`
+- Choose a frontend framework: `react` | `vue` | `next`.
+
+- -t, --template `string` `optional`
+- Use an ESA template by name.
+
 - -c, --config `boolean` `optional`
-- Generate a config file for your project.
+- Generate an `esa.toml` config file in your project.
+
+Notes:
+- If neither `--framework` nor `--template` is provided and `--yes` is not used, you will be prompted to choose between “Framework” or “Template”.
+- When a framework is chosen, the official scaffolding tool will be used to create the project, and `esa.toml` will be auto-generated in the project root. The entry file is auto-detected among: `src/index.js`, `src/index.jsx`, `src/index.tsx`, `src/main.js`, `src/main.ts`, `src/main.tsx`, `pages/index.js`, `pages/index.tsx`, `app/page.js`, `app/page.tsx`. The static assets directory is set to the framework’s common build output if available: CRA `build/`, Vite usually `dist/`, Next static export `out/`.
 
 ### routine [script]
 

package/dist/docs/Commands_zh_CN.md

@@ -1,29 +1,25 @@
 # Commands
 
-- init - 使用模板初始化新项目
-- dev - 启动本地开发服务器进行调试
-- commit - 提交代码并创建一个新版本
-- deploy - 部署项目到边缘网络
-- deployments - 管理历史部署版本
-- routine - 管理边缘函数
-- site - 管理站点
-- domain - 管理绑定到边缘函数的域名
-- route - 管理绑定到边缘函数的路由
-- login - 通过AK/SK登录到您的账户
-- logout - 注销当前用户
-- config - 修改本地/全局配置
-- lang - 切换CLI界面语言
-
 ### init
 
-选择模版初始化项目。
+选择框架或模版初始化项目。
 
 ```bash
 $ esa init [OPTIONS]
 ```
 
+- -f, --framework `string` `optional`
+- 选择前端框架初始化项目，支持：`react` | `vue` | `next`。
+
+- -t, --template `string` `optional`
+- 指定 ESA 模版名称初始化项目。
+
 - -c, --config `boolean` `optional`
-- 在您的项目中生成一个esa.toml配置文件。
+- 在您的项目中生成一个 `esa.toml` 配置文件。
+
+说明：
+- 未指定 `--framework` 与 `--template` 且未使用 `--yes` 时，会先询问选择“框架初始化”或“模版初始化”。
+- 选择框架后将调用对应官方脚手架创建项目，并在新项目根目录自动生成 `esa.toml`。入口文件会自动探测，候选包括：`src/index.js`、`src/index.jsx`、`src/index.tsx`、`src/main.js`、`src/main.ts`、`src/main.tsx`、`pages/index.js`、`pages/index.tsx`、`app/page.js`、`app/page.tsx`。静态资源目录会根据框架常规构建输出自动设置，例如 CRA 为 `build/`、Vite 通常为 `dist/`（若存在），Next 静态导出使用 `out/`（若存在）。
 
 ### routine [script]
 

package/dist/docs/eslint-config-en.md

@@ -0,0 +1 @@
+ 

package/dist/docs/eslint-config.md

@@ -0,0 +1,73 @@
+# ESLint 配置说明
+
+本项目已配置ESLint来检查代码质量，包括以下功能：
+
+## 已配置的检查规则
+
+### 1. Import 排序检查
+
+- **规则**: `import/order`
+- **功能**: 自动排序import语句，按照以下顺序：
+  1. Node.js 内置模块 (如 `fs`, `path`)
+  2. 第三方模块 (如 `react`, `lodash`)
+  3. 内部模块 (项目内部文件)
+  4. 父级模块 (`../`)
+  5. 同级模块 (`./`)
+  6. 当前目录的 index 文件
+- **格式**: 每组之间用空行分隔，按字母顺序排列
+
+### 2. 引号检查
+
+- **规则**: `quotes`, `@typescript-eslint/quotes`
+- **功能**: 强制使用单引号
+- **例外**: 允许在需要转义的情况下使用双引号，支持模板字符串
+
+### 3. 多余变量检查
+
+- **规则**: `@typescript-eslint/no-unused-vars`
+- **功能**: 检查未使用的变量、参数和导入
+- **例外**: 以 `_` 开头的变量会被忽略（如 `_unusedVariable`）
+
+### 4. 其他检查
+
+- **重复导入检查**: `import/no-duplicates`
+- **未使用表达式检查**: `no-unused-expressions`
+- **TypeScript类型检查**: 警告使用 `any` 类型
+
+## 使用方法
+
+### 检查代码
+
+```bash
+npm run eslint
+```
+
+### 自动修复
+
+```bash
+npm run eslint -- --fix
+```
+
+### 检查特定文件
+
+```bash
+npx eslint src/commands/example.ts
+```
+
+## 配置说明
+
+配置文件位于 `.eslintrc.cjs`，主要包含：
+
+- **解析器**: `@typescript-eslint/parser` 用于解析TypeScript代码
+- **插件**:
+  - `react` 和 `react-hooks` 用于React相关检查
+  - `import` 用于import相关检查
+  - `@typescript-eslint` 用于TypeScript特定检查
+- **规则**: 详细的代码质量规则配置
+- **设置**: TypeScript import解析器配置
+
+## 注意事项
+
+1. 如果遇到TypeScript版本警告，这是正常的，不影响功能
+2. 未使用的变量请以 `_` 开头命名，这样ESLint会忽略它们
+3. 自动修复功能可以解决大部分格式问题，但逻辑问题需要手动修复

package/dist/docs/init-command-quick-test.md

@@ -0,0 +1,208 @@
+# ESA CLI Init 命令快速测试指南
+
+## 快速开始
+
+### 1. 环境准备
+
+```bash
+# 确保 ESA CLI 已安装
+esa --version
+
+# 创建测试目录
+mkdir init-test && cd init-test
+```
+
+### 2. 基础功能测试（5分钟）
+
+#### 测试 1: 帮助信息
+
+```bash
+esa init --help
+```
+
+**预期结果**: 显示 init 命令的帮助信息
+
+#### 测试 2: 项目名称验证
+
+```bash
+esa init A
+```
+
+**预期结果**: 显示错误信息"项目名称必须至少2个字符"
+
+#### 测试 3: 指定项目名称
+
+```bash
+esa init test-project --skip
+```
+
+**预期结果**: 创建 test-project 目录
+
+#### 测试 4: 自动确认模式
+
+```bash
+esa init --yes --skip
+```
+
+**预期结果**: 自动创建项目（名称格式：edge-routine-<timestamp>）
+
+### 3. 交互式测试（10分钟）
+
+#### 完整流程测试
+
+```bash
+esa init
+```
+
+**交互步骤**:
+
+1. 输入项目名称（如：my-test-app）
+2. 选择模板
+3. 选择是否初始化 Git（Yes/No）
+4. 选择是否部署（Yes/No）
+
+**验证点**:
+
+- [ ] 项目目录创建成功
+- [ ] 模板文件复制完成
+- [ ] 依赖安装成功（如果有 package.json）
+- [ ] Git 初始化（如果选择）
+- [ ] 部署成功（如果选择且已登录）
+
+### 4. 错误处理测试（5分钟）
+
+#### 测试目录冲突
+
+```bash
+mkdir conflict-test
+esa init conflict-test
+```
+
+**预期结果**: 显示"项目已存在"错误
+
+#### 测试无效模板
+
+```bash
+esa init test --template invalid-template
+```
+
+**预期结果**: 显示"模板未找到"错误
+
+### 5. 多语言测试（3分钟）
+
+#### 中文界面
+
+```bash
+esa lang zh_CN
+esa init --help
+```
+
+**预期结果**: 显示中文帮助信息
+
+#### 英文界面
+
+```bash
+esa lang en
+esa init --help
+```
+
+**预期结果**: 显示英文帮助信息
+
+## 自动化测试
+
+### 运行完整测试脚本
+
+```bash
+# 给脚本执行权限
+chmod +x scripts/test-init-command.sh
+
+# 运行测试
+./scripts/test-init-command.sh
+```
+
+### 测试结果示例
+
+```
+==========================================
+    ESA CLI Init 命令测试开始
+==========================================
+[INFO] 检查 ESA CLI 是否可用...
+[PASS] ESA CLI 可用
+[INFO] 测试帮助信息...
+[PASS] 帮助信息显示正确
+[INFO] 测试项目名称验证...
+[PASS] 项目名称验证 - 大写字母检测
+[PASS] 项目名称验证 - 单个字符检测
+[PASS] 项目名称验证 - 下划线检测
+[INFO] 测试指定项目名称...
+[PASS] 指定项目名称创建成功
+[INFO] 测试 --yes 选项...
+[PASS] --yes 选项自动生成项目名称
+[INFO] 测试 --skip 选项...
+[PASS] --skip 选项跳过交互
+[INFO] 测试项目目录冲突...
+[PASS] 项目目录冲突检测
+[INFO] 测试模板不存在...
+[PASS] 模板不存在检测
+[INFO] 测试 --config 选项...
+[PASS] --config 选项生成配置文件
+[INFO] 测试多语言支持...
+[PASS] 中文界面支持
+[PASS] 英文界面支持
+==========================================
+    测试完成
+==========================================
+通过: 12
+失败: 0
+总计: 12
+所有测试通过！
+```
+
+## 常见问题
+
+### Q: 测试时提示"ESA CLI 未安装"
+
+**A**: 确保已正确安装 ESA CLI 并在 PATH 中
+
+### Q: 测试失败，提示权限错误
+
+**A**: 确保有足够的权限创建目录和文件
+
+### Q: 网络相关测试失败
+
+**A**: 检查网络连接，某些测试需要下载依赖
+
+### Q: 模板相关测试失败
+
+**A**: 确保模板包已正确安装
+
+## 测试报告模板
+
+### 快速测试检查清单
+
+| 测试项目     | 状态          | 备注 |
+| ------------ | ------------- | ---- |
+| 帮助信息显示 | ☐ 通过 ☐ 失败 |      |
+| 项目名称验证 | ☐ 通过 ☐ 失败 |      |
+| 指定项目名称 | ☐ 通过 ☐ 失败 |      |
+| 自动确认模式 | ☐ 通过 ☐ 失败 |      |
+| 交互式流程   | ☐ 通过 ☐ 失败 |      |
+| 错误处理     | ☐ 通过 ☐ 失败 |      |
+| 多语言支持   | ☐ 通过 ☐ 失败 |      |
+
+### 问题记录
+
+**问题描述**:
+**复现步骤**:
+**预期结果**:
+**实际结果**:
+**环境信息**:
+**解决方案**:
+
+## 联系支持
+
+如果遇到问题，请：
+
+1. 查看完整测试文档：`docs/init-command-test-guide.md`
+2. 检查项目 Issues
+3. 联系开发团队