@cloudbase/cli 2.8.28 → 2.9.0

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/types/commands/pull/pull.d.ts

@@ -3,6 +3,7 @@ import { Logger } from '../../utils/log';
 export declare class PullCommand extends Command {
     get options(): {
         cmd: string;
+        childCmd: string;
         options: {
             flags: string;
             desc: string;
@@ -11,6 +12,6 @@ export declare class PullCommand extends Command {
         requiredEnvId: boolean;
         withoutAuth: boolean;
     };
-    execute(options: any, log: Logger): Promise<void>;
+    execute(options: any, params: string[], log: Logger): Promise<void>;
     private showTemplateList;
 }

package/types/utils/ai/config.d.ts

@@ -1,5 +1,5 @@
 import { ConfigParser } from '@cloudbase/toolbox';
-import { CLAUDE, QWEN, CODEX, AIDER, CURSOR } from './const';
+import { CLAUDE, QWEN, CODEX, AIDER, CURSOR, CODEBUDDY } from './const';
 import z from 'zod/v3';
 export declare const CONFIG_NOT_FOUND = "CONFIG_NOT_FOUND";
 export declare function isValidAgent(agent: unknown): agent is keyof AIConfig['agents'];
@@ -11,6 +11,7 @@ export interface AIConfig {
         codex?: z.infer<(typeof CODEX)['configSchema']>;
         aider?: z.infer<(typeof AIDER)['configSchema']>;
         cursor?: z.infer<(typeof CURSOR)['configSchema']>;
+        codebuddy?: z.infer<(typeof CODEBUDDY)['configSchema']>;
     };
 }
 export interface AgentConfig {
@@ -28,12 +29,12 @@ export declare const TOOLKIT_CONFIGS: {
         config?: undefined;
     } | {
         config: string;
-        rules: string;
         mcp?: undefined;
+        rules?: undefined;
     } | {
         config: string;
+        rules: string;
         mcp?: undefined;
-        rules?: undefined;
     };
 };
 export declare function createConfigParser(): ConfigParser;
@@ -77,5 +78,8 @@ export declare class AIConfigManager {
         provider?: string;
     }): Promise<void>;
     updateCursorConfig(type: 'none'): Promise<void>;
+    updateCodebuddyConfig(type: 'custom' | 'none', config: {
+        apiKey?: string;
+    }): Promise<void>;
     private updateConfig;
 }

package/types/utils/ai/const.d.ts

@@ -166,6 +166,26 @@ export declare const CURSOR: {
         type?: "none";
     }>;
 };
+export declare const CODEBUDDY: {
+    name: string;
+    value: string;
+    configSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"none">;
+    }, "strip", z.ZodTypeAny, {
+        type?: "none";
+    }, {
+        type?: "none";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"custom">;
+        apiKey: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type?: "custom";
+        apiKey?: string;
+    }, {
+        type?: "custom";
+        apiKey?: string;
+    }>]>;
+};
 export declare const NONE: {
     name: string;
     value: string;
@@ -325,6 +345,25 @@ export declare const AGENTS: readonly [{
     }, {
         type?: "none";
     }>;
+}, {
+    name: string;
+    value: string;
+    configSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"none">;
+    }, "strip", z.ZodTypeAny, {
+        type?: "none";
+    }, {
+        type?: "none";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"custom">;
+        apiKey: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type?: "custom";
+        apiKey?: string;
+    }, {
+        type?: "custom";
+        apiKey?: string;
+    }>]>;
 }, {
     name: string;
     value: string;

package/types/utils/ai/router.d.ts

@@ -47,5 +47,8 @@ export declare class AICommandRouter {
     private modifyMCPTomlFile;
     private mergeMcpConfig;
     private objectToToml;
+    private executeCodebuddyAgent;
+    private executeNoneCodebuddyAgent;
+    private ensureCodebuddy;
 }
 export {};

package/types/utils/ai/setup.d.ts

@@ -22,4 +22,5 @@ export declare class AISetupWizard {
     private configureCursorAgent;
     private ensureGitignore;
     private selectCloudBaseProvider;
+    private configureCodebuddyAgent;
 }