@cloudbase/cli 2.10.0-beta.0 → 2.10.1-alpha.0

package/specs/template-pull-command/design.md

@@ -1,135 +0,0 @@
-# 技术方案设计
-
-## 架构概述
-
-为 CloudBase CLI 添加模板拉取功能，支持多种模板来源的统一管理。
-
-## 技术栈
-
-- **语言**: TypeScript
-- **框架**: 基于现有的 CloudBase CLI 架构
-- **依赖**: 
-  - `simple-git`: Git 操作
-  - `fs-extra`: 文件系统操作
-  - `path`: 路径处理
-  - `inquirer`: 交互式提示
-
-## 技术选型
-
-### Git 子目录下载方案
-
-Git 本身不支持直接下载子目录，但可以通过以下方式实现：
-
-1. **方案一**: 使用 `git clone --filter=blob:none --sparse` 进行稀疏克隆
-2. **方案二**: 克隆整个仓库后删除不需要的文件
-3. **方案三**: 使用 GitHub/Gitee API 获取子目录内容
-
-**推荐方案**: 方案一 + 方案二结合，优先使用稀疏克隆，失败时回退到完整克隆。
-
-### 模板来源识别
-
-```typescript
-interface TemplateSource {
-  type: 'builtin' | 'github' | 'gitee' | 'git';
-  identifier: string;
-  subpath?: string;
-}
-```
-
-## 数据库/接口设计
-
-### 内置模板映射
-
-```typescript
-const BUILTIN_TEMPLATES = {
-  miniprogram: {
-    url: 'https://static.cloudbase.net/cloudbase-examples/miniprogram-cloudbase-miniprogram-template.zip',
-    name: '微信小程序 + CloudBase'
-  },
-  react: {
-    url: 'https://static.cloudbase.net/cloudbase-examples/web-cloudbase-react-template.zip',
-    name: 'Web 应用 - React + CloudBase'
-  },
-  vue: {
-    url: 'https://static.cloudbase.net/cloudbase-examples/web-cloudbase-vue-template.zip',
-    name: 'Web 应用 - Vue + CloudBase'
-  },
-  uniapp: {
-    url: 'https://static.cloudbase.net/cloudbase-examples/universal-cloudbase-uniapp-template.zip',
-    name: '跨端应用 - UniApp + CloudBase'
-  },
-  rules: {
-    url: 'https://static.cloudbase.net/cloudbase-examples/web-cloudbase-project.zip',
-    name: 'AI 规则和配置'
-  }
-}
-```
-
-### Git URL 解析
-
-```typescript
-interface GitUrlInfo {
-  platform: 'github' | 'gitee' | 'git';
-  owner: string;
-  repo: string;
-  branch: string;
-  subpath?: string;
-}
-```
-
-## 核心模块设计
-
-### 1. TemplateManager 类
-
-负责模板下载的核心逻辑：
-
-```typescript
-class TemplateManager {
-  async pullTemplate(source: string, options: PullOptions): Promise<void>
-  async downloadBuiltinTemplate(templateId: string, targetPath: string): Promise<void>
-  async downloadGitTemplate(gitUrl: string, targetPath: string, subpath?: string): Promise<void>
-  private parseGitUrl(url: string): GitUrlInfo
-  private cloneWithSparse(gitUrl: string, targetPath: string, subpath: string): Promise<void>
-  private cloneFull(gitUrl: string, targetPath: string): Promise<void>
-}
-```
-
-### 2. AI 命令增强
-
-修改现有的 AI 命令，添加 `--template` 参数支持。
-
-### 3. Pull 命令实现
-
-新增 `PullCommand` 类，支持多种模板来源。
-
-## 测试策略
-
-### 单元测试
-
-1. Git URL 解析测试
-2. 模板下载功能测试
-3. 错误处理测试
-
-### 集成测试
-
-1. 完整命令执行测试
-2. 网络异常处理测试
-3. 文件系统操作测试
-
-## 安全性
-
-1. **路径验证**: 确保下载路径在安全范围内
-2. **Git 操作**: 使用安全的 Git 操作，避免命令注入
-3. **文件权限**: 确保下载的文件具有适当的权限
-
-## 错误处理
-
-1. **网络错误**: 重试机制和友好的错误提示
-2. **文件系统错误**: 权限检查和清理机制
-3. **Git 错误**: 详细的错误信息和回退方案
-
-## 性能考虑
-
-1. **稀疏克隆**: 减少网络传输和存储空间
-2. **流式处理**: 大文件下载时使用流式处理
-3. **缓存机制**: 避免重复下载相同模板

package/specs/template-pull-command/implementation-summary.md

@@ -1,160 +0,0 @@
-# 实现总结
-
-## 已完成功能
-
-### 1. AI 命令模板标识支持 ✅
-
-- **功能**: 为 `tcb ai` 命令添加了 `--template` 参数支持
-- **用法**: `tcb ai --template <template_type>`
-- **支持的模板**: `miniprogram`, `react`, `vue`, `uniapp`, `rules`
-- **测试结果**: ✅ 正常工作
-
-### 2. 新增 Pull 命令 ✅
-
-- **功能**: 创建了 `tcb pull` 命令，支持多种模板来源
-- **用法**: `tcb pull <source> [options]`
-- **选项**: 
-  - `-o, --output <output>`: 指定输出目录
-  - `-f, --force`: 强制覆盖已存在的目录
-- **测试结果**: ✅ 正常工作
-
-### 3. 内置模板支持 ✅
-
-- **支持的模板**:
-  - `miniprogram`: 微信小程序 + CloudBase
-  - `react`: Web 应用 - React + CloudBase
-  - `vue`: Web 应用 - Vue + CloudBase
-  - `uniapp`: 跨端应用 - UniApp + CloudBase
-  - `rules`: AI 规则和配置
-- **测试结果**: ✅ 正常工作
-
-### 4. Git 仓库支持 ✅
-
-- **支持的格式**:
-  - GitHub: `https://github.com/user/repo`
-  - Gitee: `https://gitee.com/user/repo`
-  - SSH: `git@github.com:user/repo.git`
-- **测试结果**: ✅ 正常工作
-
-### 5. Git 子目录支持 ✅
-
-- **功能**: 支持从 Git 仓库的特定子目录下载内容
-- **用法**: `tcb pull https://github.com/user/repo/tree/branch/path`
-- **实现方式**: 先克隆整个仓库到临时目录，然后复制指定子目录
-- **测试结果**: ✅ 正常工作
-
-### 6. 错误处理和用户体验 ✅
-
-- **目标目录检查**: 自动检查目标目录是否为空，询问是否覆盖
-- **错误处理**: 完善的错误信息提示
-- **进度显示**: 下载进度和状态提示
-- **测试结果**: ✅ 正常工作
-
-## 测试用例
-
-### 1. AI 命令测试
-
-```bash
-# 测试 rules 模板
-tcb ai --template rules
-
-# 测试 miniprogram 模板
-tcb ai --template miniprogram
-```
-
-### 2. Pull 命令测试
-
-```bash
-# 显示可用模板列表
-tcb pull list
-
-# 下载内置模板
-tcb pull rules
-tcb pull miniprogram
-
-# 下载 Git 仓库
-tcb pull https://github.com/TencentCloudBase/awesome-cloudbase-examples
-
-# 下载 Git 子目录
-tcb pull https://github.com/TencentCloudBase/awesome-cloudbase-examples/tree/master/web/overcooked-game
-
-# 指定输出目录
-tcb pull miniprogram --output ./my-project
-```
-
-## 技术实现
-
-### 1. 核心组件
-
-- **TemplateManager**: 模板下载的核心逻辑
-- **PullCommand**: 新的 pull 命令实现
-- **AI 命令增强**: 添加 `--template` 参数支持
-
-### 2. 依赖
-
-- `simple-git`: Git 操作
-- `fs-extra`: 文件系统操作
-- `inquirer`: 用户交互
-
-### 3. 文件结构
-
-```
-src/
-├── commands/
-│   ├── ai/index.ts          # AI 命令增强
-│   └── pull/
-│       ├── index.ts         # 导出文件
-│       └── pull.ts          # PullCommand 实现
-├── utils/
-│   └── template-manager.ts  # 模板管理器
-└── commands/index.ts        # 命令注册
-```
-
-## 验收标准达成情况
-
-### 需求 1 - AI 命令模板标识支持 ✅
-- [x] When 用户执行 `tcb ai --template miniprogram` 时，系统应当直接下载微信小程序模板
-- [x] When 用户执行 `tcb ai --template react` 时，系统应当直接下载 React 模板
-- [x] When 用户执行 `tcb ai --template vue` 时，系统应当直接下载 Vue 模板
-- [x] When 用户执行 `tcb ai --template uniapp` 时，系统应当直接下载 UniApp 模板
-- [x] When 用户执行 `tcb ai --template rules` 时，系统应当只下载 AI 规则和配置
-- [x] When 用户未指定 `--template` 参数时，系统应当保持原有的交互式选择行为
-
-### 需求 2 - 新增 Pull 命令 ✅
-- [x] When 用户执行 `tcb pull miniprogram` 时，系统应当下载微信小程序模板
-- [x] When 用户执行 `tcb pull react` 时，系统应当下载 React 模板
-- [x] When 用户执行 `tcb pull vue` 时，系统应当下载 Vue 模板
-- [x] When 用户执行 `tcb pull uniapp` 时，系统应当下载 UniApp 模板
-- [x] When 用户执行 `tcb pull rules` 时，系统应当只下载 AI 规则和配置
-
-### 需求 3 - Git 仓库支持 ✅
-- [x] When 用户执行 `tcb pull https://github.com/user/repo` 时，系统应当克隆整个仓库
-- [x] When 用户执行 `tcb pull https://gitee.com/user/repo` 时，系统应当克隆整个仓库
-- [x] When 用户执行 `tcb pull git@github.com:user/repo.git` 时，系统应当克隆整个仓库
-
-### 需求 4 - Git 子目录支持 ✅
-- [x] When 用户执行 `tcb pull https://github.com/TencentCloudBase/awesome-cloudbase-examples/tree/master/web/overcooked-game` 时，系统应当只下载该子目录的内容
-- [x] When 用户执行 `tcb pull https://github.com/user/repo/tree/main/src/templates` 时，系统应当只下载该子目录的内容
-- [x] When 用户执行 `tcb pull https://gitee.com/user/repo/tree/master/examples` 时，系统应当只下载该子目录的内容
-
-### 需求 5 - 目标目录指定 ✅
-- [x] When 用户执行 `tcb pull miniprogram --output ./my-project` 时，系统应当将模板下载到 `./my-project` 目录
-- [x] When 用户执行 `tcb pull https://github.com/user/repo --output ./custom-template` 时，系统应当将仓库内容下载到 `./custom-template` 目录
-- [x] When 用户未指定 `--output` 参数时，系统应当下载到当前目录
-
-### 需求 6 - 错误处理 ✅
-- [x] When Git 仓库不存在时，系统应当显示清晰的错误信息
-- [x] When 网络连接失败时，系统应当显示网络错误信息
-- [x] When 目标目录已存在且不为空时，系统应当询问用户是否覆盖
-- [x] When Git 子目录路径无效时，系统应当显示路径错误信息
-
-## 总结
-
-所有需求都已成功实现并通过测试。新功能提供了：
-
-1. **便捷的模板下载**: 通过 `tcb pull` 命令快速获取各种模板
-2. **灵活的模板来源**: 支持内置模板、Git 仓库和子目录
-3. **良好的用户体验**: 完善的错误处理和交互提示
-4. **向后兼容**: 不影响现有功能的使用
-
-这些功能大大提升了 CloudBase CLI 的易用性和开发效率。

package/specs/template-pull-command/requirements.md

@@ -1,73 +0,0 @@
-# 需求文档
-
-## 介绍
-
-为 CloudBase CLI 添加模板拉取功能，支持从多种来源获取项目模板，包括内置模板、Git 仓库和子目录。
-
-## 需求
-
-### 需求 1 - AI 命令模板标识支持
-
-**用户故事：** 用户在使用 `tcb ai` 命令时，希望能够直接指定模板类型，避免交互式选择。
-
-#### 验收标准
-
-1. When 用户执行 `tcb ai --template miniprogram` 时，系统应当直接下载微信小程序模板而不进行交互式选择。
-2. When 用户执行 `tcb ai --template react` 时，系统应当直接下载 React 模板。
-3. When 用户执行 `tcb ai --template vue` 时，系统应当直接下载 Vue 模板。
-4. When 用户执行 `tcb ai --template uniapp` 时，系统应当直接下载 UniApp 模板。
-5. When 用户执行 `tcb ai --template rules` 时，系统应当只下载 AI 规则和配置。
-6. When 用户未指定 `--template` 参数时，系统应当保持原有的交互式选择行为。
-
-### 需求 2 - 新增 Pull 命令
-
-**用户故事：** 用户希望能够通过 `tcb pull` 命令从多种来源拉取项目模板。
-
-#### 验收标准
-
-1. When 用户执行 `tcb pull miniprogram` 时，系统应当下载微信小程序模板。
-2. When 用户执行 `tcb pull react` 时，系统应当下载 React 模板。
-3. When 用户执行 `tcb pull vue` 时，系统应当下载 Vue 模板。
-4. When 用户执行 `tcb pull uniapp` 时，系统应当下载 UniApp 模板。
-5. When 用户执行 `tcb pull rules` 时，系统应当只下载 AI 规则和配置。
-
-### 需求 3 - Git 仓库支持
-
-**用户故事：** 用户希望能够从 Git 仓库拉取模板。
-
-#### 验收标准
-
-1. When 用户执行 `tcb pull https://github.com/user/repo` 时，系统应当克隆整个仓库到当前目录。
-2. When 用户执行 `tcb pull https://gitee.com/user/repo` 时，系统应当克隆整个仓库到当前目录。
-3. When 用户执行 `tcb pull git@github.com:user/repo.git` 时，系统应当克隆整个仓库到当前目录。
-
-### 需求 4 - Git 子目录支持
-
-**用户故事：** 用户希望能够从 Git 仓库的特定子目录拉取内容。
-
-#### 验收标准
-
-1. When 用户执行 `tcb pull https://github.com/TencentCloudBase/awesome-cloudbase-examples/tree/master/web/overcooked-game` 时，系统应当只下载该子目录的内容。
-2. When 用户执行 `tcb pull https://github.com/user/repo/tree/main/src/templates` 时，系统应当只下载该子目录的内容。
-3. When 用户执行 `tcb pull https://gitee.com/user/repo/tree/master/examples` 时，系统应当只下载该子目录的内容。
-
-### 需求 5 - 目标目录指定
-
-**用户故事：** 用户希望能够指定模板下载的目标目录。
-
-#### 验收标准
-
-1. When 用户执行 `tcb pull miniprogram --output ./my-project` 时，系统应当将模板下载到 `./my-project` 目录。
-2. When 用户执行 `tcb pull https://github.com/user/repo --output ./custom-template` 时，系统应当将仓库内容下载到 `./custom-template` 目录。
-3. When 用户未指定 `--output` 参数时，系统应当下载到当前目录。
-
-### 需求 6 - 错误处理
-
-**用户故事：** 系统应当优雅地处理各种错误情况。
-
-#### 验收标准
-
-1. When Git 仓库不存在时，系统应当显示清晰的错误信息。
-2. When 网络连接失败时，系统应当显示网络错误信息。
-3. When 目标目录已存在且不为空时，系统应当询问用户是否覆盖。
-4. When Git 子目录路径无效时，系统应当显示路径错误信息。

package/specs/template-pull-command/tasks.md

@@ -1,101 +0,0 @@
-# 实施计划
-
-## 阶段一：核心功能实现
-
-- [x] 1. 创建 TemplateManager 工具类
-  - 实现模板下载的核心逻辑
-  - 支持内置模板和 Git 仓库下载
-  - 实现 Git 子目录下载功能
-  - _需求: 需求 2, 需求 3, 需求 4
-
-- [x] 2. 实现 Git URL 解析功能
-  - 解析 GitHub/Gitee/Git 仓库地址
-  - 提取仓库信息（owner, repo, branch, subpath）
-  - 支持多种 URL 格式
-  - _需求: 需求 3, 需求 4
-
-- [x] 3. 实现 Git 子目录下载功能
-  - 使用稀疏克隆技术
-  - 实现回退到完整克隆的机制
-  - 处理子目录路径验证
-  - _需求: 需求 4
-
-## 阶段二：命令实现
-
-- [x] 4. 创建 PullCommand 命令类
-  - 实现 `tcb pull` 命令
-  - 支持多种模板来源参数
-  - 添加 `--output` 参数支持
-  - _需求: 需求 2, 需求 5
-
-- [x] 5. 增强 AI 命令
-  - 添加 `--template` 参数支持
-  - 修改交互式选择逻辑
-  - 保持向后兼容性
-  - _需求: 需求 1
-
-- [x] 6. 注册新命令到 CLI
-  - 在命令索引中添加 PullCommand
-  - 更新命令帮助信息
-  - 确保命令正确注册
-  - _需求: 需求 2
-
-## 阶段三：错误处理和用户体验
-
-- [x] 7. 实现错误处理机制
-  - Git 操作错误处理
-  - 网络连接错误处理
-  - 文件系统错误处理
-  - _需求: 需求 6
-
-- [x] 8. 添加用户交互功能
-  - 目标目录覆盖确认
-  - 下载进度显示
-  - 友好的错误提示
-  - _需求: 需求 5, 需求 6
-
-- [x] 9. 实现安全检查
-  - 路径验证
-  - Git 操作安全
-  - 文件权限检查
-  - _需求: 需求 6
-
-## 阶段四：测试和文档
-
-- [ ] 10. 编写单元测试
-  - TemplateManager 测试
-  - Git URL 解析测试
-  - 命令执行测试
-  - _需求: 所有需求
-
-- [ ] 11. 编写集成测试
-  - 完整命令流程测试
-  - 网络异常测试
-  - 文件系统操作测试
-  - _需求: 所有需求
-
-- [ ] 12. 更新文档
-  - 更新 README.md
-  - 添加命令使用示例
-  - 编写 API 文档
-  - _需求: 所有需求
-
-## 阶段五：优化和发布
-
-- [ ] 13. 性能优化
-  - 实现下载缓存
-  - 优化大文件处理
-  - 减少不必要的网络请求
-  - _需求: 所有需求
-
-- [ ] 14. 代码审查和重构
-  - 代码质量检查
-  - 性能优化
-  - 安全性检查
-  - _需求: 所有需求
-
-- [ ] 15. 发布准备
-  - 版本号更新
-  - 更新日志编写
-  - 发布测试
-  - _需求: 所有需求

package/templates/html/loginFail.html

@@ -1,90 +0,0 @@
-<!DOCTYPE html>
-<html>
-    <head>
-        <meta charset="utf-8" />
-        <meta name="viewport" content="width=device-width, initial-scale=1" />
-        <title>CloudBase CLI</title>
-
-        <style media="screen">
-            body {
-                background: #eceff1;
-                color: rgba(0, 0, 0, 0.87);
-                font-family: Roboto, Helvetica, Arial, sans-serif;
-                margin: 0;
-                padding: 0;
-            }
-            #message {
-                background: white;
-                max-width: 360px;
-                margin: 100px auto 16px;
-                padding: 32px 24px 8px;
-                border-radius: 3px;
-            }
-            #message h2 {
-                color: #f44336;
-                font-weight: bold;
-                font-size: 16px;
-                margin: 0 0 8px;
-            }
-            #message h1 {
-                font-size: 22px;
-                font-weight: 300;
-                color: rgba(0, 0, 0, 0.6);
-                margin: 0 0 16px;
-            }
-            #message p {
-                line-height: 140%;
-                margin: 16px 0 24px;
-                font-size: 14px;
-            }
-            #message a {
-                display: block;
-                text-align: center;
-                background: #039be5;
-                text-transform: uppercase;
-                text-decoration: none;
-                color: white;
-                padding: 16px;
-                border-radius: 4px;
-            }
-            #message,
-            #message a {
-                box-shadow: 0 1px 3px rgba(0, 0, 0, 0.12), 0 1px 2px rgba(0, 0, 0, 0.24);
-            }
-            #load {
-                color: rgba(0, 0, 0, 0.4);
-                text-align: center;
-                font-size: 13px;
-            }
-            @media (max-width: 600px) {
-                body,
-                #message {
-                    margin-top: 0;
-                    background: white;
-                    box-shadow: none;
-                }
-                body {
-                    border-top: 16px solid #f44336;
-                }
-            }
-            code {
-                background: #37474f;
-                color: white;
-                border-radius: 2px;
-                padding: 2px 4px;
-                font-size: 12px;
-                margin: 0 4px;
-            }
-        </style>
-    </head>
-    <body>
-        <div id="message">
-            <h2>失败！</h2>
-            <h1>CloudBase CLI 登录失败</h1>
-            <p>
-                CloudBase CLI 登录失败，请检验终端网络是否联通，然后使用
-                <code>cloudbase login</code> 再次登录 。
-            </p>
-        </div>
-    </body>
-</html>

package/templates/html/loginSuccess.html

@@ -1,86 +0,0 @@
-<!DOCTYPE html>
-<html>
-    <head>
-        <meta charset="utf-8" />
-        <meta name="viewport" content="width=device-width, initial-scale=1" />
-        <title>CloudBase CLI</title>
-
-        <style media="screen">
-            body {
-                background: #eceff1;
-                color: rgba(0, 0, 0, 0.87);
-                font-family: Roboto, Helvetica, Arial, sans-serif;
-                margin: 0;
-                padding: 0;
-            }
-            #message {
-                background: white;
-                max-width: 360px;
-                margin: 100px auto 16px;
-                padding: 32px 24px 8px;
-                border-radius: 3px;
-            }
-            #message h2 {
-                color: #026EFF;
-                font-weight: bold;
-                font-size: 16px;
-                margin: 0 0 8px;
-            }
-            #message h1 {
-                font-size: 22px;
-                font-weight: 300;
-                color: rgba(0, 0, 0, 0.6);
-                margin: 0 0 16px;
-            }
-            #message p {
-                line-height: 140%;
-                margin: 16px 0 24px;
-                font-size: 14px;
-            }
-            #message a {
-                display: block;
-                text-align: center;
-                background: #026EFF;
-                text-transform: uppercase;
-                text-decoration: none;
-                color: white;
-                padding: 16px;
-                border-radius: 4px;
-            }
-            #message,
-            #message a {
-                box-shadow: 0 1px 3px rgba(0, 0, 0, 0.12), 0 1px 2px rgba(0, 0, 0, 0.24);
-            }
-            #load {
-                color: rgba(0, 0, 0, 0.4);
-                text-align: center;
-                font-size: 13px;
-            }
-            @media (max-width: 600px) {
-                body,
-                #message {
-                    margin-top: 0;
-                    background: white;
-                    box-shadow: none;
-                }
-                body {
-                    border-top: 16px solid #026EFF;
-                }
-            }
-
-            code {
-                font-size: 18px;
-                color: #999;
-            }
-        </style>
-    </head>
-    <body>
-        <div id="message">
-            <h2>恭喜 🎉🎉</h2>
-            <h1>CloudBase CLI 授权成功！</h1>
-            <p>
-                您已经登录成功，您可以直接关闭这个窗口，开始使用 CloudBase CLI！
-            </p>
-        </div>
-    </body>
-</html>

package/templates/server/node/_gitignore

@@ -1,54 +0,0 @@
-# Logs
-logs
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# Runtime data
-pids
-*.pid
-*.seed
-*.pid.lock
-
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
-
-# Coverage directory used by tools like istanbul
-coverage
-
-# nyc test coverage
-.nyc_output
-
-# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# Bower dependency directory (https://bower.io/)
-bower_components
-
-# node-waf configuration
-.lock-wscript
-
-# Compiled binary addons (http://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directories
-node_modules/
-
-# Optional npm cache directory
-.npm
-
-# Optional eslint cache
-.eslintcache
-
-# Optional REPL history
-.node_repl_history
-
-# Output of 'npm pack'
-*.zip
-
-# Yarn Integrity file
-.yarn-integrity
-
-# dotenv environment variables file
-.env