@cloudbase/cli 2.11.6 → 2.11.7

package/specs/codebuddy-integration/tasks.md

@@ -0,0 +1,159 @@
+# 实施计划
+
+## 任务概览
+
+本计划将分阶段实现 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

@@ -0,0 +1,57 @@
+# 技术方案设计
+
+## 架构概述
+
+本方案通过在 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

@@ -0,0 +1,43 @@
+# 需求文档
+
+## 介绍
+
+当前下载的模板中的 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

@@ -0,0 +1,54 @@
+# 实施计划
+
+- [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

@@ -0,0 +1,93 @@
+# 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

@@ -0,0 +1,47 @@
+# 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

@@ -0,0 +1,65 @@
+# 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

@@ -0,0 +1,137 @@
+# 技术方案设计
+
+## 概述
+
+为 `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 仓库的拉取时间
+- 监控网络请求的成功率
+
+
+
+
+
+
+