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

package/specs/codebuddy-integration/tasks.md

@@ -1,159 +0,0 @@
-# 实施计划
-
-## 任务概览
-
-本计划将分阶段实现 Codebuddy Code CLI 在 CloudBase CLI 中的集成，包括基础集成、配置管理、MCP 服务器管理等功能。
-
-## 详细任务
-
-### 阶段 1: 基础架构扩展
-
-- [ ] 1. 添加 Codebuddy 常量定义
-  - 在 `src/utils/ai/const.ts` 中添加 CODEBUDDY 常量
-  - 定义配置验证 Schema
-  - 添加默认配置选项
-  - _需求: 需求1, 需求4
-
-- [ ] 2. 扩展 AI 命令选项
-  - 在 `src/commands/ai/index.ts` 中添加 codebuddy 选项
-  - 更新命令描述和示例
-  - 确保参数透传功能正常工作
-  - _需求: 需求1, 需求3
-
-- [ ] 3. 添加 Codebuddy 路由逻辑
-  - 在 `src/utils/ai/router.ts` 中添加 executeCodebuddyAgent 方法
-  - 实现命令执行和参数透传
-  - 添加错误处理和日志记录
-  - _需求: 需求1, 需求3
-
-### 阶段 2: 配置管理实现
-
-- [ ] 4. 扩展现有配置管理器
-  - 在 AIConfigManager 中添加 Codebuddy 配置支持
-  - 实现配置验证逻辑
-  - 复用现有的配置管理机制
-  - _需求: 需求4
-
-- [ ] 5. 实现配置向导
-  - 创建交互式配置向导
-  - 支持 API 密钥和模型配置
-  - 提供配置验证和错误提示
-  - _需求: 需求1, 需求4
-
-- [ ] 6. 实现配置显示和重置功能
-  - 添加配置信息显示功能
-  - 实现配置重置功能
-  - 提供配置备份和恢复
-  - _需求: 需求1
-
-### 阶段 3: 安装和依赖管理
-
-- [ ] 7. 实现 Codebuddy CLI 安装检查
-  - 检查 codebuddy 命令是否可用
-  - 提供安装指导和自动安装选项
-  - 支持不同平台的安装方式
-  - _需求: 需求1
-
-- [ ] 8. 实现版本兼容性检查
-  - 检查 Codebuddy CLI 版本
-  - 验证功能兼容性
-  - 提供升级建议
-  - _需求: 需求1
-
-### 阶段 4: MCP 服务器管理
-
-- [ ] 9. 实现 MCP 命令透传
-  - 支持 mcp add 命令透传
-  - 支持 mcp list 命令透传
-  - 支持 mcp get 命令透传
-  - 支持 mcp remove 命令透传
-  - _需求: 需求2
-
-- [ ] 10. 实现 MCP 配置作用域支持
-  - 支持 Local 作用域配置
-  - 支持 Project 作用域配置
-  - 支持 User 作用域配置
-  - 实现配置文件自动合并
-  - _需求: 需求2
-
-### 阶段 5: 测试和文档
-
-- [ ] 11. 编写单元测试
-  - 测试配置验证逻辑
-  - 测试命令执行流程
-  - 测试参数透传功能
-  - 测试错误处理机制
-  - _需求: 需求1, 需求2, 需求3, 需求4
-
-- [ ] 12. 编写集成测试
-  - 测试完整命令执行流程
-  - 测试配置管理流程
-  - 测试 MCP 服务器管理
-  - 测试跨平台兼容性
-  - _需求: 需求1, 需求2, 需求3, 需求4
-
-- [ ] 13. 更新文档
-  - 更新 README.md 文档
-  - 添加 Codebuddy 使用示例
-  - 更新命令行帮助信息
-  - 添加故障排除指南
-  - _需求: 需求1, 需求2, 需求3, 需求4
-
-### 阶段 6: 优化和发布
-
-- [ ] 14. 性能优化
-  - 优化命令执行性能
-  - 优化配置加载速度
-  - 减少内存占用
-  - _需求: 需求1, 需求3
-
-- [ ] 15. 用户体验优化
-  - 改进错误提示信息
-  - 优化安装向导流程
-  - 添加进度指示器
-  - _需求: 需求1, 需求4
-
-- [ ] 16. 发布准备
-  - 版本号更新
-  - 更新 CHANGELOG
-  - 发布到 npm
-  - _需求: 需求1, 需求2, 需求3, 需求4
-
-## 风险评估
-
-### 技术风险
-- **Codebuddy CLI 版本兼容性**: 需要确保与不同版本的 Codebuddy CLI 兼容
-- **跨平台支持**: 需要测试在不同操作系统上的兼容性
-- **配置冲突**: 需要处理与现有 AI 工具配置的冲突
-
-### 缓解措施
-- 建立版本兼容性测试矩阵
-- 在多个平台上进行充分测试
-- 实现配置隔离和冲突检测机制
-
-## 时间估算
-
-- 阶段 1: 2-3 天
-- 阶段 2: 2-3 天  
-- 阶段 3: 1-2 天
-- 阶段 4: 2-3 天
-- 阶段 5: 2-3 天
-- 阶段 6: 1-2 天
-
-**总计**: 10-16 天
-
-## 验收标准
-
-### 功能验收
-- [ ] 所有需求中的验收标准都已实现
-- [ ] 命令执行正常，参数透传正确
-- [ ] 配置管理功能完整
-- [ ] MCP 服务器管理功能正常
-- [ ] 错误处理机制完善
-
-### 质量验收
-- [ ] 单元测试覆盖率 > 80%
-- [ ] 集成测试通过率 100%
-- [ ] 代码审查通过
-- [ ] 文档完整且准确
-- [ ] 性能指标达标

package/specs/mcp-global-bin/design.md

@@ -1,57 +0,0 @@
-# 技术方案设计
-
-## 架构概述
-
-本方案通过在 CLI 中暴露一个全局的 `cloudbase-mcp` bin 命令，直接调用内置的 `@cloudbase/cloudbase-mcp` 包，并修改模板下载逻辑，使所有 MCP 配置都指向这个全局命令，从而避免用户需要额外安装 MCP 包。
-
-## 技术栈
-
-- Node.js CLI 工具
-- `@cloudbase/cloudbase-mcp` 内置依赖
-- 文件系统操作 (fs-extra)
-- 模板下载和解压
-
-## 技术选型
-
-### 1. Bin 文件创建
-- 在 `bin/` 目录下创建 `cloudbase-mcp.js` 文件
-- 在 `package.json` 的 `bin` 字段中注册 `cloudbase-mcp` 命令
-- 直接调用内置的 `@cloudbase/cloudbase-mcp` 包
-
-### 2. 模板配置生成
-- 修改 `router.ts` 中的模板下载逻辑
-- 根据 IDE 类型生成对应的 MCP 配置文件
-- 所有配置都指向 `cloudbase-mcp` 命令
-
-### 3. IDE 配置映射和格式支持
-- 参考 CloudBase-AI-ToolKit 的 IDE 到文件映射关系
-- 支持 Cursor、VSCode、Claude Code、OpenAI Codex、OpenCode、Aider 等多种 IDE
-- 支持 JSON 和 TOML 两种配置文件格式
-- 实现 TOML 解析和修改功能
-
-## 数据库/接口设计
-
-无需数据库设计，主要涉及文件系统操作和命令行接口。
-
-## 测试策略
-
-1. **单元测试**：测试 bin 文件是否正确调用内置包
-2. **集成测试**：测试模板下载和配置生成功能
-3. **端到端测试**：测试完整的 MCP 配置流程
-
-## 安全性
-
-- 确保 bin 文件有正确的执行权限
-- 验证模板下载源的安全性
-- 防止路径遍历攻击
-
-## 实施计划
-
-```mermaid
-graph TD
-    A[创建 cloudbase-mcp.js bin 文件] --> B[在 package.json 中注册命令]
-    B --> C[修改 router.ts 模板下载逻辑]
-    C --> D[实现 IDE 配置映射]
-    D --> E[测试验证]
-    E --> F[文档更新]
-``` 

package/specs/mcp-global-bin/requirements.md

@@ -1,43 +0,0 @@
-# 需求文档
-
-## 介绍
-
-当前下载的模板中的 MCP 配置使用 `npx npm-global-exec@latest @cloudbase/cloudbase-mcp@latest` 命令，这会导致用户需要安装 MCP，降低了成功率。CLI 已经内置了 `@cloudbase/cloudbase-mcp@latest` 依赖，需要在 CLI 中直接暴露一个额外的 bin 文件指向到这个依赖，然后修改下载模板的 MCP 配置都指向这个全局命令。
-
-## 需求
-
-### 需求 1 - 创建全局 MCP bin 命令
-
-**用户故事：** 作为开发者，我希望 CLI 提供一个全局的 MCP 命令，这样我就不需要额外安装 MCP 包，提高配置成功率。
-
-#### 验收标准
-
-1. When CLI 安装后，the 系统 shall 提供一个全局的 `cloudbase-mcp` 命令
-2. When 执行 `cloudbase-mcp` 命令时，the 系统 shall 直接调用内置的 `@cloudbase/cloudbase-mcp` 包
-3. When 验证 MCP 配置时，the 配置文件中的命令 shall 指向 `cloudbase-mcp` 而不是 `npx npm-global-exec@latest @cloudbase/cloudbase-mcp@latest`
-
-### 需求 2 - 自动修改模板 MCP 配置
-
-**用户故事：** 作为开发者，我希望下载模板后系统自动修改 MCP 配置，将 npx 命令替换为 CLI 提供的全局命令，避免额外的依赖安装。
-
-#### 验收标准
-
-1. When 下载模板完成后，the 系统 shall 自动检测并修改所有 MCP 配置文件
-2. When 发现 `.cursor/mcp.json` 等配置文件时，the 系统 shall 将 `npx npm-global-exec@latest @cloudbase/cloudbase-mcp@latest` 替换为 `cloudbase-mcp`
-3. When 修改完成后，the 系统 shall 验证配置文件的正确性
-4. When 用户使用模板时，the MCP 功能 shall 无需额外安装即可正常工作
-
-### 需求 3 - 支持多种 IDE 配置和格式
-
-**用户故事：** 作为开发者，我希望模板支持多种 IDE 的 MCP 配置，包括不同格式（JSON、TOML）和各种工具。
-
-#### 验收标准
-
-1. When 下载模板时，the 系统 shall 根据 IDE 类型生成对应的配置文件
-2. When 配置 Cursor 时，the 系统 shall 生成 `.cursor/mcp.json` 和 `.cursor/rules/cloudbase-rules.mdc`
-3. When 配置 VSCode 时，the 系统 shall 生成 `.vscode/mcp.json` 和 `.vscode/settings.json`
-4. When 配置 Claude Code 时，the 系统 shall 生成 `CLAUDE.md` 和 `.mcp.json`
-5. When 配置 OpenAI Codex 时，the 系统 shall 处理 `.codex/config.toml` 文件
-6. When 配置 OpenCode 时，the 系统 shall 处理 `.opencode.json` 文件
-7. When 配置 Aider 时，the 系统 shall 处理 `mcp.json` 文件
-8. When 处理 TOML 格式时，the 系统 shall 正确解析和修改配置 

package/specs/mcp-global-bin/tasks.md

@@ -1,54 +0,0 @@
-# 实施计划
-
-- [x] 1. 创建 cloudbase-mcp bin 文件
-  - 在 `bin/` 目录下创建 `cloudbase-mcp.js` 文件
-  - 实现直接调用内置 `@cloudbase/cloudbase-mcp` 包的逻辑
-  - 确保文件有正确的执行权限
-  - _需求: 需求 1
-
-- [x] 2. 在 package.json 中注册新命令
-  - 在 `bin` 字段中添加 `cloudbase-mcp` 命令映射
-  - 确保命令指向正确的 bin 文件
-  - _需求: 需求 1
-
-- [x] 3. 实现 IDE 配置映射常量
-  - 在 `router.ts` 中添加 IDE 到文件的映射关系常量
-  - 参考 CloudBase-AI-ToolKit 的映射配置
-  - 支持 Cursor、VSCode、Claude Code 等多种 IDE
-  - _需求: 需求 3
-
-- [x] 3.1. 扩展支持更多 IDE 和格式
-  - 添加 OpenAI Codex (.codex/config.toml) 支持
-  - 添加 OpenCode (.opencode.json) 支持
-  - 添加 Aider (mcp.json) 支持
-  - 实现 TOML 格式解析和修改功能
-  - _需求: 需求 3
-
-- [x] 4. 修改模板下载后的处理逻辑
-  - 在 `downloadAndExtractTemplate` 方法中添加 MCP 配置修改逻辑
-  - 实现自动检测 MCP 配置文件的功能
-  - 实现将 npx 命令替换为 cloudbase-mcp 命令的功能
-  - _需求: 需求 2
-
-- [x] 5. 实现 MCP 配置文件修改函数
-  - 创建 `modifyMCPConfigs` 函数
-  - 遍历所有 IDE 配置文件并修改命令
-  - 验证修改后的配置文件正确性
-  - _需求: 需求 2
-
-- [x] 6. 添加配置验证功能
-  - 实现验证 MCP 配置文件格式的功能
-  - 确保修改后的配置仍然有效
-  - 添加错误处理和回滚机制
-  - _需求: 需求 2
-
-- [x] 7. 测试验证
-  - 测试 cloudbase-mcp 命令是否正常工作
-  - 测试模板下载和配置修改功能
-  - 测试不同 IDE 配置文件的生成
-  - _需求: 需求 1, 需求 2, 需求 3
-
-- [x] 8. 文档更新
-  - 更新 README.md 说明新的 cloudbase-mcp 命令
-  - 更新模板下载相关的文档
-  - _需求: 需求 1, 需求 2 

package/specs/ssl-fix/design.md

@@ -1,93 +0,0 @@
-# SSL错误修复技术方案设计
-
-## 架构概述
-
-采用多层解决方案架构，从检测到自动修复，提供完整的SSL错误处理流程。
-
-## 技术栈
-
-- **错误检测层**：Node.js错误捕获 + SSL协议检测
-- **配置管理层**：环境变量管理 + Node.js配置
-- **网络适配层**：代理配置 + SSL降级处理
-- **用户交互层**：CLI交互 + 自动修复
-
-## 技术选型
-
-### 1. SSL错误检测
-- 使用 `process.on('uncaughtException')` 捕获SSL错误
-- 通过错误信息模式匹配识别SSL协议问题
-- 集成环境信息收集功能
-
-### 2. SSL配置优化
-- 使用 `process.env.NODE_OPTIONS` 设置SSL配置
-- 支持 `--tls-min-v1.2` 和 `--tls-max-v1.3` 参数
-- 提供环境变量配置选项
-
-### 3. 网络适配
-- 集成现有的代理配置系统
-- 支持企业网络环境检测
-- 提供SSL证书验证选项
-
-## 数据库/接口设计
-
-### 配置存储
-```typescript
-interface SSLConfig {
-  tlsMinVersion: string;
-  tlsMaxVersion: string;
-  secureProtocol: string;
-  rejectUnauthorized: boolean;
-  proxyEnabled: boolean;
-  proxyUrl?: string;
-}
-```
-
-### 错误诊断接口
-```typescript
-interface SSLDiagnostic {
-  errorType: 'EPROTO' | 'CERTIFICATE' | 'PROXY' | 'UNKNOWN';
-  errorMessage: string;
-  environment: {
-    nodeVersion: string;
-    platform: string;
-    arch: string;
-    sslVersion: string;
-  };
-  solutions: SSLSolution[];
-}
-```
-
-## 测试策略
-
-1. **单元测试**：SSL配置函数测试
-2. **集成测试**：错误检测和修复流程测试
-3. **环境测试**：Windows 11 PowerShell环境测试
-4. **兼容性测试**：不同Node.js版本兼容性测试
-
-## 安全性
-
-- 保持SSL证书验证的完整性
-- 提供安全的代理配置选项
-- 避免降低安全性的降级方案
-
-## 实施计划
-
-### 阶段1：错误检测与诊断
-- 实现SSL错误自动检测
-- 添加环境信息收集
-- 提供诊断报告功能
-
-### 阶段2：配置优化
-- 实现SSL配置自动优化
-- 添加环境变量配置
-- 提供代理配置选项
-
-### 阶段3：降级处理
-- 实现TLS版本降级
-- 添加兼容性模式
-- 提供自动修复功能
-
-### 阶段4：用户交互
-- 实现CLI交互界面
-- 添加自动修复选项
-- 提供配置管理功能

package/specs/ssl-fix/requirements.md

@@ -1,47 +0,0 @@
-# SSL错误修复需求文档
-
-## 介绍
-
-Windows 11 PowerShell环境下运行 `tcb ai` 时出现SSL协议版本不匹配错误，需要提供多种解决方案。
-
-## 需求
-
-### 需求 1 - SSL错误检测与诊断
-
-**用户故事：** 当用户遇到SSL错误时，系统应当能够自动检测并提供诊断信息
-
-#### 验收标准
-
-1. When 检测到SSL错误时，the 系统 shall 提供详细的错误诊断信息
-2. When 检测到SSL错误时，the 系统 shall 提供多种解决方案选项
-3. When 检测到SSL错误时，the 系统 shall 提供环境信息收集功能
-
-### 需求 2 - SSL配置优化
-
-**用户故事：** 系统应当提供SSL配置优化选项来解决协议版本不匹配问题
-
-#### 验收标准
-
-1. When 用户选择SSL配置优化时，the 系统 shall 提供Node.js SSL配置选项
-2. When 用户选择SSL配置优化时，the 系统 shall 提供环境变量配置选项
-3. When 用户选择SSL配置优化时，the 系统 shall 提供代理配置选项
-
-### 需求 3 - 降级兼容性处理
-
-**用户故事：** 系统应当提供降级到兼容SSL版本的选项
-
-#### 验收标准
-
-1. When 用户选择降级处理时，the 系统 shall 自动设置兼容的SSL协议版本
-2. When 用户选择降级处理时，the 系统 shall 提供TLS 1.2兼容模式
-3. When 用户选择降级处理时，the 系统 shall 保持功能完整性
-
-### 需求 4 - 网络环境适配
-
-**用户故事：** 系统应当能够适配不同的网络环境配置
-
-#### 验收标准
-
-1. When 检测到企业网络环境时，the 系统 shall 提供代理配置指导
-2. When 检测到防火墙限制时，the 系统 shall 提供绕过方案
-3. When 检测到SSL证书问题时，the 系统 shall 提供证书验证选项

package/specs/ssl-fix/tasks.md

@@ -1,65 +0,0 @@
-# SSL错误修复实施计划
-
-## 任务拆分
-
-- [x] 1. SSL错误检测模块开发
-  - 实现SSL错误自动捕获机制
-  - 添加错误模式识别功能
-  - 集成环境信息收集
-  - _需求: 需求1
-
-- [x] 2. SSL配置优化模块开发
-  - 实现Node.js SSL配置自动设置
-  - 添加环境变量配置功能
-  - 集成代理配置选项
-  - _需求: 需求2
-
-- [x] 3. 降级兼容性处理模块开发
-  - 实现TLS版本降级功能
-  - 添加TLS 1.2兼容模式
-  - 确保功能完整性
-  - _需求: 需求3
-
-- [x] 4. 网络环境适配模块开发
-  - 实现企业网络环境检测
-  - 添加防火墙绕过方案
-  - 提供证书验证选项
-  - _需求: 需求4
-
-- [x] 5. 用户交互界面开发
-  - 实现CLI交互界面
-  - 添加自动修复选项
-  - 提供配置管理功能
-  - _需求: 需求1, 需求2, 需求3, 需求4
-
-- [x] 6. 测试与验证
-  - 单元测试编写
-  - 集成测试执行
-  - Windows 11环境测试
-  - 兼容性测试验证
-  - _需求: 需求1, 需求2, 需求3, 需求4
-
-- [x] 7. 文档与部署
-  - 用户使用文档编写
-  - 故障排除指南更新
-  - 部署脚本更新
-  - _需求: 需求1, 需求2, 需求3, 需求4
-
-## 优先级排序
-
-1. **高优先级**：任务1、任务2（核心功能）
-2. **中优先级**：任务3、任务4（兼容性）
-3. **低优先级**：任务5、任务6、任务7（完善）
-
-## 风险评估
-
-- **技术风险**：SSL配置可能影响其他功能
-- **兼容性风险**：不同Node.js版本兼容性
-- **安全风险**：降级方案可能降低安全性
-
-## 成功标准
-
-- SSL错误自动检测准确率 > 95%
-- 自动修复成功率 > 90%
-- 用户满意度 > 85%
-- 无安全漏洞引入

package/specs/tcb-pull-cnb-support/design.md

@@ -1,137 +0,0 @@
-# 技术方案设计
-
-## 概述
-
-为 `tcb pull` 命令增加 cnb.cool 仓库的支持，使开发者能够直接从 cnb.cool 平台拉取项目模板。
-
-## 技术架构
-
-### 当前架构分析
-
-`tcb pull` 命令基于 `TemplateManager` 类实现，支持：
-- 内置模板下载（ZIP 文件）
-- Git 仓库克隆（GitHub, Gitee, SSH）
-
-### 新增功能架构
-
-```
-TemplateManager
-├── isGitUrl()           # 新增 cnb.cool URL 识别
-├── parseGitUrl()        # 新增 cnb.cool URL 解析
-├── buildGitUrl()        # 新增 cnb.cool Git URL 构建
-└── downloadGitTemplateToTemp()  # 复用现有 Git 下载逻辑
-```
-
-## 技术选型
-
-### URL 格式识别
-- 使用正则表达式匹配 cnb.cool URL 格式
-- 支持 HTTP 和 HTTPS 协议
-- 支持带分支和子目录的 URL
-
-### URL 解析逻辑
-- 解析格式：`https://cnb.cool/{owner}/{repo}[/tree/{branch}[/{subpath}]]`
-- 默认分支：main（与 GitHub 保持一致）
-- 支持子目录拉取
-
-### Git URL 构建
-- 构建格式：`https://cnb.cool/{owner}/{repo}.git`
-- 复用现有的 Git 克隆逻辑
-
-## 实现细节
-
-### 1. 接口扩展
-
-```typescript
-interface GitUrlInfo {
-    platform: 'github' | 'gitee' | 'git' | 'cnb'  // 新增 'cnb'
-    owner: string
-    repo: string
-    branch: string
-    subpath?: string
-}
-```
-
-### 2. URL 解析实现
-
-```typescript
-// 新增 cnb.cool URL 解析
-const cnbMatch = url.match(/https?:\/\/cnb\.cool\/([^\/]+)\/([^\/]+)(?:\/tree\/([^\/]+)\/(.+))?/)
-if (cnbMatch) {
-    return {
-        platform: 'cnb',
-        owner: cnbMatch[1],
-        repo: cnbMatch[2],
-        branch: cnbMatch[3] || 'main',
-        subpath: cnbMatch[4]
-    }
-}
-```
-
-### 3. Git URL 构建
-
-```typescript
-if (gitInfo.platform === 'cnb') {
-    return `https://cnb.cool/${gitInfo.owner}/${gitInfo.repo}.git`
-}
-```
-
-## 安全考虑
-
-### URL 验证
-- 严格的正则表达式匹配，确保只识别合法的 cnb.cool URL
-- 防止恶意 URL 注入
-
-### 网络安全
-- 复用现有的 Git 克隆安全机制
-- 支持 HTTPS 协议，确保传输安全
-
-## 兼容性
-
-### 向后兼容
-- 不影响现有的 GitHub/Gitee/SSH 支持
-- 保持现有的 API 接口不变
-
-### 前向兼容
-- 支持 cnb.cool 的未来 URL 格式变更
-- 预留扩展空间
-
-## 测试策略
-
-### 单元测试
-- URL 解析测试（基础 URL、带分支、带子目录）
-- URL 验证测试
-- Git URL 构建测试
-
-### 集成测试
-- 实际 cnb.cool 仓库拉取测试
-- 错误处理测试
-
-## 部署策略
-
-### 渐进式部署
-1. 代码合并到主分支
-2. 在测试环境验证功能
-3. 生产环境灰度发布
-4. 全量发布
-
-### 回滚策略
-- 代码层面：可通过条件编译回滚
-- 配置层面：可通过配置开关控制
-
-## 监控和运维
-
-### 错误监控
-- 记录 cnb.cool 拉取失败的错误信息
-- 监控 URL 解析失败的情况
-
-### 性能监控
-- 监控 cnb.cool 仓库的拉取时间
-- 监控网络请求的成功率
-
-
-
-
-
-
-