@cloudbase/cli 2.8.27 → 2.9.0

package/lib/commands/account/login.js

@@ -37,13 +37,9 @@ const utils_1 = require("../../utils");
 function printSuggestion() {
     const tips = `可使用下面命令继续操作：
 
-${chalk_1.default.gray('–')} 初始化云开发项目
+${chalk_1.default.gray('–')} 一键开启 AI 开发体验
 
-  ${chalk_1.default.cyan('$ tcb new')}
-
-${chalk_1.default.gray('–')} 部署云函数
-
-  ${chalk_1.default.cyan('$ tcb fn deploy')}
+  ${chalk_1.default.cyan('$ tcb ai')}
 
 ${chalk_1.default.gray('–')} 查看命令使用介绍
 

package/lib/commands/ai/index.js

@@ -39,7 +39,7 @@ let AICommand = class AICommand extends common_1.Command {
             options: [
                 {
                     flags: '-a, --agent <agent>',
-                    desc: 'AI CLI 工具 (claude, qwen, codex, aider)'
+                    desc: 'AI CLI 工具 (claude, qwen, codex, aider, codebuddy)'
                 },
                 {
                     flags: '-e, --envId <envId>',
@@ -66,7 +66,7 @@ let AICommand = class AICommand extends common_1.Command {
                     desc: '指定模板类型 (miniprogram, react, vue, uniapp, rules)'
                 }
             ],
-            desc: 'CloudBase AI ToolKit CLI - 快速启动和配置主流 AI 编程工具\n\n示例：\n  tcb ai -a claude -- --continue\n\n说明：-- 后的参数会直接传递给目标 AI CLI。',
+            desc: 'CloudBase AI ToolKit CLI - 快速启动和配置主流 AI 编程工具\n\n示例：\n  tcb ai -a claude -- --continue\n  tcb ai -a codebuddy -- mcp list\n\n说明：-- 后的参数会直接传递给目标 AI CLI。',
             requiredEnvId: false,
             withoutAuth: true,
             allowUnknownOption: true

package/lib/commands/pull/pull.js

@@ -31,6 +31,7 @@ let PullCommand = class PullCommand extends common_1.Command {
     get options() {
         return {
             cmd: 'pull',
+            childCmd: '<source>',
             options: [
                 {
                     flags: '-o, --output <output>',
@@ -46,10 +47,10 @@ let PullCommand = class PullCommand extends common_1.Command {
             withoutAuth: true
         };
     }
-    execute(options, log) {
+    execute(options, params, log) {
         return __awaiter(this, void 0, void 0, function* () {
             const { output, force } = options;
-            const source = process.argv[3];
+            const [source] = params || [];
             if (!source || typeof source !== 'string') {
                 throw new error_1.CloudBaseError('请指定要拉取的模板来源');
             }
@@ -89,9 +90,10 @@ let PullCommand = class PullCommand extends common_1.Command {
 __decorate([
     (0, decorators_1.InjectParams)(),
     __param(0, (0, decorators_1.ArgsOptions)()),
-    __param(1, (0, decorators_1.Log)()),
+    __param(1, (0, decorators_1.ArgsParams)()),
+    __param(2, (0, decorators_1.Log)()),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object, log_1.Logger]),
+    __metadata("design:paramtypes", [Object, Array, log_1.Logger]),
     __metadata("design:returntype", Promise)
 ], PullCommand.prototype, "execute", null);
 PullCommand = __decorate([

package/lib/help.js

@@ -8,20 +8,15 @@ const chalk_1 = __importDefault(require("chalk"));
 const outputHelpInfo = () => {
     const commands = `
   命令
-
+    ai             -- [cmd]                      开启 AI 全栈开发体验
     login             [options]                  登录腾讯云账号
     logout                                       登出腾讯云账号
     env               [cmd]                      环境管理操作
     fn                [cmd]                      操作函数
-    framework         [cmd]                      云开发 Serverless 应用框架操作
     hosting           [cmd]                      静态托管资源管理操作
-    new               [appName] [template]       创建新的云开发应用
-    open              [link]                     在浏览器中打开云开发相关连接
     storage           [cmd]                      云存储资源管理操作
     service           [cmd]                      HTTP 访问服务管理操作
-    run:deprecated    [cmd]                      云托管环境管理操作 (BAAS 或 RUN 类型环境)
-    run               [cmd]                      云托管环境管理操作 (TCBR 类型环境)
-    cloudrun          [cmd]                      云托管服务管理操作（新版云开发平台）`;
+    cloudrun          [cmd]                      云托管服务管理操作`;
     const options = `
   选项
 
@@ -38,17 +33,10 @@ const outputHelpInfo = () => {
 
       ${chalk_1.default.cyan('$ tcb login')}
 
-    ${chalk_1.default.gray('–')} 创建新的云开发应用
-
-      ${chalk_1.default.cyan('$ tcb new appName')}
-
-    ${chalk_1.default.gray('–')} 部署云函数
-
-      ${chalk_1.default.cyan('$ tcb fn deploy')}
-
-    ${chalk_1.default.gray('–')} 查看命令使用介绍
+    ${chalk_1.default.gray('–')} 使用 AI 全栈开发部署
 
-      ${chalk_1.default.cyan('$ tcb fn -h')}`;
+      ${chalk_1.default.cyan('$ tcb ai')}
+`;
     console.log(commands, '\n', options, '\n', tips);
 };
 exports.outputHelpInfo = outputHelpInfo;

package/lib/utils/ai/banner.js

@@ -75,12 +75,12 @@ AI ToolKit`, {
                 log.log('    🎯 无需运维，极速上线你的创意 💫');
             }
             log.log('');
+            log.log('Github:');
+            log.log((0, output_1.genClickableLink)('https://github.com/TencentCloudBase/CloudBase-AI-ToolKit'));
+            log.log('');
             log.log('使用指引');
             log.log((0, output_1.genClickableLink)('https://docs.cloudbase.net/cli-v1/ai/introduce'));
             log.log('');
-            log.log('Beta 能力，如遇问题可创建 issue：');
-            log.log((0, output_1.genClickableLink)('https://cnb.cool/tencent/cloud/cloudbase/community/-/issues'));
-            log.log('');
         }
         catch (e) {
             log.log(chalk_1.default.bold.cyanBright('⛰︎'), chalk_1.default.bold.hex('#FFFFFF')(' CloudBase AI ToolKit CLI'));
@@ -89,6 +89,9 @@ AI ToolKit`, {
             log.log(chalk_1.default.hex('#34495E')('    ⚡ 生成、部署和托管全栈 Web 应用与小程序、数据库和后端服务'));
             log.log(chalk_1.default.hex('#34495E')('    🎯 无需运维，极速上线你的创意 💫'));
             log.log('');
+            log.log('Github:');
+            log.log((0, output_1.genClickableLink)('https://github.com/TencentCloudBase/CloudBase-AI-ToolKit'));
+            log.log('');
             log.log('使用指引');
             log.log((0, output_1.genClickableLink)('https://docs.cloudbase.net/cli-v1/ai/introduce'));
             log.log('');

package/lib/utils/ai/config.js

@@ -25,7 +25,7 @@ const notFoundError = () => {
     });
 };
 function isValidAgent(agent) {
-    return [const_1.CLAUDE, const_1.QWEN, const_1.CODEX, const_1.AIDER, const_1.CURSOR].some((x) => x.value === agent);
+    return [const_1.CLAUDE, const_1.QWEN, const_1.CODEX, const_1.AIDER, const_1.CURSOR, const_1.CODEBUDDY].some((x) => x.value === agent);
 }
 exports.isValidAgent = isValidAgent;
 exports.TOOLKIT_CONFIGS = {
@@ -33,6 +33,9 @@ exports.TOOLKIT_CONFIGS = {
         mcp: '.mcp.json',
         rules: 'CLAUDE.md'
     },
+    [const_1.CODEBUDDY.value]: {
+        config: '.env.local'
+    },
     [const_1.QWEN.value]: {
         config: '.env.local',
         rules: '.qwen/QWEN.md'
@@ -45,7 +48,7 @@ exports.TOOLKIT_CONFIGS = {
     },
     [const_1.CURSOR.value]: {
         config: '.cursor/mcp.json'
-    }
+    },
 };
 function createConfigParser() {
     return new toolbox_1.ConfigParser({ configPath: const_1.CONFIG_PATH });
@@ -253,6 +256,17 @@ class AIConfigManager {
             yield this.updateConfig('ai.agents.cursor.type', type);
         });
     }
+    updateCodebuddyConfig(type, config) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.updateConfig('ai.agents.codebuddy', {});
+            yield this.updateConfig('ai.agents.codebuddy.type', type);
+            if (type === 'custom') {
+                if (config.apiKey) {
+                    yield this.updateConfig('ai.agents.codebuddy.apiKey', config.apiKey, 'CODEBUDDY_API_KEY');
+                }
+            }
+        });
+    }
     updateConfig(key, value, env) {
         return __awaiter(this, void 0, void 0, function* () {
             const configParser = createConfigParser();

package/lib/utils/ai/const.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LIST_HINT = exports.getBooleanHint = exports.getDefaultModelByBaseUrl = exports.BASE_URL_MODEL_MAPPING = exports.getAgentConfigValidator = exports.getDefaultConfig = exports.CLOUDBASE_PROVIDERS = exports.AGENTS = exports.NONE = exports.CURSOR = exports.AIDER = exports.CODEX = exports.QWEN = exports.CLAUDE = exports.DEFAULT_CONFIG = exports.CLOUDBASE_MCP_CONFIG_PATH = exports.CLAUDE_CODE_ROUTER_LOGS_DIR_PATH = exports.CLAUDE_CODE_ROUTER_LOG_PATH = exports.CLAUDE_CODE_ROUTER_CONFIG_PATH = exports.ENV_LOCAL_PATH = exports.CONFIG_PATH = void 0;
+exports.LIST_HINT = exports.getBooleanHint = exports.getDefaultModelByBaseUrl = exports.BASE_URL_MODEL_MAPPING = exports.getAgentConfigValidator = exports.getDefaultConfig = exports.CLOUDBASE_PROVIDERS = exports.AGENTS = exports.NONE = exports.CODEBUDDY = exports.CURSOR = exports.AIDER = exports.CODEX = exports.QWEN = exports.CLAUDE = exports.DEFAULT_CONFIG = exports.CLOUDBASE_MCP_CONFIG_PATH = exports.CLAUDE_CODE_ROUTER_LOGS_DIR_PATH = exports.CLAUDE_CODE_ROUTER_LOG_PATH = exports.CLAUDE_CODE_ROUTER_CONFIG_PATH = exports.ENV_LOCAL_PATH = exports.CONFIG_PATH = void 0;
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const v3_1 = __importDefault(require("zod/v3"));
@@ -101,11 +101,24 @@ exports.CURSOR = {
         type: v3_1.default.literal('none')
     })
 };
+exports.CODEBUDDY = {
+    name: 'Codebuddy Code CLI',
+    value: 'codebuddy',
+    configSchema: v3_1.default.discriminatedUnion('type', [
+        v3_1.default.object({
+            type: v3_1.default.literal('none')
+        }),
+        v3_1.default.object({
+            type: v3_1.default.literal('custom'),
+            apiKey: v3_1.default.string().optional()
+        })
+    ])
+};
 exports.NONE = {
     name: '暂不配置',
     value: 'none'
 };
-exports.AGENTS = [exports.CLAUDE, exports.QWEN, exports.CODEX, exports.AIDER, exports.CURSOR, exports.NONE];
+exports.AGENTS = [exports.CLAUDE, exports.QWEN, exports.CODEX, exports.AIDER, exports.CURSOR, exports.CODEBUDDY, exports.NONE];
 exports.CLOUDBASE_PROVIDERS = [
     {
         name: 'Kimi',

package/lib/utils/ai/router.js

@@ -140,7 +140,7 @@ class AICommandRouter {
             if (missingFiles.length > 0) {
                 const skipTemplate = yield this.checkSkipTemplateConfig();
                 if (skipTemplate) {
-                    log.info('🚫 已配置跳过模板下载');
+                    log.info('🚫 已跳过模板下载，无法使用云开发 MCP 及 AI 规则。如需使用，请参考 tcb pull --help');
                     return;
                 }
                 log.log('');
@@ -389,6 +389,13 @@ class AICommandRouter {
                     args: ['install', '-g', '@google/gemini-cli'],
                     message: 'npm install -g @google/gemini-cli'
                 };
+            case 'codebuddy':
+                return {
+                    success: true,
+                    command: 'npm',
+                    args: ['install', '-g', '@tencent-ai/codebuddy-code@beta'],
+                    message: 'npm install -g @tencent-ai/codebuddy-code@beta'
+                };
             default:
                 return { success: false, message: `# 请查阅 ${agent} 的官方安装文档` };
         }
@@ -396,8 +403,7 @@ class AICommandRouter {
     executeCommand(command, args, env, log) {
         return __awaiter(this, void 0, void 0, function* () {
             return new Promise((resolve, reject) => {
-                const useShell = process.platform !== 'win32' ||
-                    (process.env.WSL_DISTRO_NAME || process.env.MSYS2 || process.env.GIT_BASH);
+                const useShell = process.platform === 'win32';
                 const child = (0, child_process_1.spawn)(command, args, {
                     stdio: 'inherit',
                     env,
@@ -442,11 +448,9 @@ class AICommandRouter {
     isToolAvailable(command) {
         return __awaiter(this, void 0, void 0, function* () {
             return new Promise((resolve) => {
-                const useShell = process.platform !== 'win32' ||
-                    (process.env.WSL_DISTRO_NAME || process.env.MSYS2 || process.env.GIT_BASH);
                 const child = (0, child_process_1.spawn)(command, ['--version'], {
                     stdio: 'pipe',
-                    shell: useShell
+                    shell: true
                 });
                 child.on('close', (code) => {
                     resolve(code === 0);
@@ -522,6 +526,13 @@ class AICommandRouter {
                     }
                 case const_1.CURSOR.value:
                     return yield this.executeNoneCursorAgent(additionalArgs, log);
+                case const_1.CODEBUDDY.value:
+                    if (agentConfig.type === 'custom') {
+                        return yield this.executeCodebuddyAgent(agentConfig, additionalArgs, log);
+                    }
+                    else {
+                        return yield this.executeNoneCodebuddyAgent(additionalArgs, log);
+                    }
                 default:
                     throw new Error(`不支持的 AI 工具: ${agent}`);
             }
@@ -1201,6 +1212,43 @@ class AICommandRouter {
         }
         return lines.join('\n');
     }
+    executeCodebuddyAgent({ apiKey }, additionalArgs, log) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.ensureCodebuddy(log);
+            yield this.executeCommand('codebuddy', additionalArgs, Object.assign(Object.assign({}, process.env), (apiKey && { CODEBUDDY_API_KEY: apiKey })), log);
+        });
+    }
+    executeNoneCodebuddyAgent(additionalArgs, log) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.ensureCodebuddy(log);
+            yield this.executeCommand('codebuddy', additionalArgs, Object.assign({}, process.env), log);
+        });
+    }
+    ensureCodebuddy(log) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (yield this.isToolAvailable('codebuddy')) {
+                log.debug('codebuddy 已安装!');
+            }
+            else {
+                const { shouldInstall } = yield inquirer_1.default.prompt([
+                    {
+                        type: 'confirm',
+                        name: 'shouldInstall',
+                        message: `AI 开发缺少 codebuddy 依赖，是否安装? ${(0, const_1.getBooleanHint)(true)}`
+                    }
+                ]);
+                if (shouldInstall) {
+                    yield this.executeCommand('npm', ['install', '-g', '@tencent-ai/codebuddy-code@beta'], process.env, log);
+                    log.info('✅ codebuddy 安装完成');
+                }
+                else {
+                    log.info('❌ codebuddy 未安装，请手动安装');
+                    log.info('📦 安装命令: npm install -g @tencent-ai/codebuddy-code@beta');
+                    process.exit(1);
+                }
+            }
+        });
+    }
 }
 exports.AICommandRouter = AICommandRouter;
 function safeParseJson(json) {

package/lib/utils/ai/setup.js

@@ -194,7 +194,7 @@ class AISetupWizard {
                     type: 'list',
                     name: 'agent',
                     message: `${message} ${const_1.LIST_HINT}`,
-                    choices: [const_1.CLAUDE, const_1.QWEN, const_1.CODEX, const_1.CURSOR, const_1.AIDER, ...(includeNone ? [const_1.NONE] : [])],
+                    choices: [const_1.CLAUDE, const_1.QWEN, const_1.CODEX, const_1.CURSOR, const_1.AIDER, const_1.CODEBUDDY, ...(includeNone ? [const_1.NONE] : [])],
                     default: const_1.CLAUDE.value
                 }
             ]);
@@ -203,7 +203,7 @@ class AISetupWizard {
     }
     configureAgent(agent, log) {
         return __awaiter(this, void 0, void 0, function* () {
-            const agentInfo = [const_1.CLAUDE, const_1.QWEN, const_1.CODEX, const_1.AIDER, const_1.CURSOR].find((a) => a.value === agent);
+            const agentInfo = [const_1.CLAUDE, const_1.QWEN, const_1.CODEX, const_1.AIDER, const_1.CURSOR, const_1.CODEBUDDY].find((a) => a.value === agent);
             log.info(`\n📝 配置 ${(agentInfo === null || agentInfo === void 0 ? void 0 : agentInfo.name) || agent.toUpperCase()}:`);
             switch (agent) {
                 case const_1.CLAUDE.value:
@@ -216,6 +216,8 @@ class AISetupWizard {
                     return yield this.configureAiderAgent(log);
                 case const_1.CURSOR.value:
                     return yield this.configureCursorAgent(log);
+                case const_1.CODEBUDDY.value:
+                    return yield this.configureCodebuddyAgent(log);
                 default:
                     throw new Error(`不支持的 AI 工具: ${agent}`);
             }
@@ -641,5 +643,46 @@ class AISetupWizard {
             }
         });
     }
+    configureCodebuddyAgent(log) {
+        return __awaiter(this, void 0, void 0, function* () {
+            log.info(`配置说明可参考 ${(0, output_1.genClickableLink)('https://cnb.woa.com/genie/genie/-/tree/main/docs')}`);
+            const { configMethod } = yield inquirer_1.default.prompt([
+                {
+                    type: 'list',
+                    name: 'configMethod',
+                    message: `选择配置方式: ${const_1.LIST_HINT}`,
+                    choices: [
+                        {
+                            name: '使用 Codebuddy Code CLI 内置鉴权方式（如 OAuth）',
+                            value: 'none'
+                        },
+                        {
+                            name: '配置 API KEY（用于无交互环境）',
+                            value: 'custom'
+                        }
+                    ],
+                    default: 'none'
+                }
+            ]);
+            if (configMethod === 'custom') {
+                const { apiKey } = yield inquirer_1.default.prompt([
+                    {
+                        type: 'password',
+                        name: 'apiKey',
+                        message: '请输入 Codebuddy API Key:',
+                        validate: (input) => input.trim().length > 0 || 'API Key 不能为空'
+                    }
+                ]);
+                yield this.aiConfigManager.updateCodebuddyConfig('custom', {
+                    apiKey
+                });
+            }
+            else {
+                yield this.aiConfigManager.updateCodebuddyConfig('none', {});
+            }
+            log.info('✅ Codebuddy Code CLI 配置完成');
+            log.info('💡 提示：首次使用时会自动打开浏览器进行 OAuth 身份验证');
+        });
+    }
 }
 exports.AISetupWizard = AISetupWizard;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cloudbase/cli",
-    "version": "2.8.27",
+    "version": "2.9.0",
     "description": "cli tool for cloudbase",
     "main": "lib/index.js",
     "scripts": {
@@ -48,7 +48,7 @@
     "license": "ISC",
     "dependencies": {
         "@cloudbase/cloud-api": "^0.5.5",
-        "@cloudbase/cloudbase-mcp": "^1.8.39",
+        "@cloudbase/cloudbase-mcp": "^1.8.40",
         "@cloudbase/framework-core": "^1.9.7",
         "@cloudbase/functions-framework": "1.16.0",
         "@cloudbase/iac-core": "0.0.3-alpha.11",

package/specs/codebuddy-integration/design.md

@@ -0,0 +1,152 @@
+# 技术方案设计
+
+## 架构概述
+
+在 CloudBase CLI 的 ai 命令中集成 Codebuddy Code CLI，采用与现有 AI 工具（如 Claude、Qwen、Codex）相同的架构模式，通过命令路由器和配置管理器来实现统一的 AI 工具管理。
+
+## 技术架构
+
+```mermaid
+graph TD
+    A[tcb ai -a codebuddy] --> B[AICommandRouter]
+    B --> C[executeCodebuddyAgent]
+    C --> D[AIConfigManager]
+    C --> E[CodebuddyExecutor]
+    
+    D --> F[配置文件管理]
+    E --> G[命令执行]
+    E --> H[安装检查]
+    
+    F --> I[~/.codebuddy/settings.json]
+    F --> J[项目级配置]
+    
+    G --> K[codebuddy CLI]
+    H --> L[安装向导]
+```
+
+## 技术选型
+
+### 核心组件
+- **AICommandRouter**: 现有的命令路由器，负责路由到不同的 AI 工具
+- **CodebuddyConfigManager**: Codebuddy 配置管理器（复用现有的 AIConfigManager）
+- **CodebuddyExecutor**: Codebuddy 命令执行器（集成到现有的 executeAgentWithConfig 方法中）
+
+### 配置管理
+- **配置文件格式**: JSON
+- **配置位置**: 
+  - 用户级: `~/.codebuddy/settings.json`
+  - 项目级: `.codebuddy/settings.json`
+- **配置验证**: 使用 Zod 进行配置验证
+- **配置方式**: 主要通过环境变量和命令行参数，配置文件为辅
+
+### 命令执行
+- **执行方式**: 子进程执行 `codebuddy` 命令
+- **参数透传**: 通过 `--` 分隔符透传参数
+- **环境变量**: 支持环境变量配置
+
+## 数据库/接口设计
+
+### 配置结构
+```typescript
+interface CodebuddyConfig {
+  type: 'none' | 'custom';
+  apiKey?: string;
+}
+
+// Codebuddy Code CLI 配置特点：
+// 1. 主要通过环境变量 CODEBUDDY_API_KEY 配置
+// 2. 支持 OAuth 身份验证流程
+// 3. MCP 服务器配置由 Codebuddy CLI 自己管理
+// 4. 通过参数透传实现 MCP 命令管理
+```
+
+### 配置验证 Schema
+```typescript
+const CodebuddyConfigSchema = z.discriminatedUnion('type', [
+  z.object({
+    type: z.literal('none')
+  }),
+  z.object({
+    type: z.literal('custom'),
+    apiKey: z.string().optional()
+  })
+])
+```
+
+## 实现策略
+
+### 1. 扩展现有架构
+- 在 `src/utils/ai/const.ts` 中添加 Codebuddy 常量定义
+- 在 `src/utils/ai/router.ts` 中添加 Codebuddy 路由逻辑
+- 在 `src/utils/ai/config.ts` 中添加 Codebuddy 配置管理
+
+### 2. 命令执行流程
+1. 检查 Codebuddy CLI 是否已安装
+2. 验证配置有效性
+3. 解析透传参数
+4. 执行 Codebuddy 命令
+5. 处理执行结果
+
+### 3. 配置管理流程
+1. 检查配置文件是否存在
+2. 验证配置格式
+3. 提供配置向导
+4. 保存配置到指定位置
+
+### 4. MCP 服务器管理
+- 通过参数透传实现 MCP 命令管理
+- 支持三种配置作用域
+- 配置文件自动合并
+
+## 测试策略
+
+### 单元测试
+- 配置验证测试
+- 命令解析测试
+- 参数透传测试
+
+### 集成测试
+- 完整命令执行流程测试
+- 配置管理流程测试
+- 错误处理测试
+
+### 端到端测试
+- 用户场景测试
+- 安装向导测试
+- MCP 服务器管理测试
+
+## 安全性
+
+### 配置安全
+- API 密钥加密存储
+- 配置文件权限控制
+- 敏感信息脱敏显示
+
+### 命令执行安全
+- 参数验证和过滤
+- 环境变量安全传递
+- 子进程权限控制
+
+## 部署和发布
+
+### 开发阶段
+1. 实现核心功能
+2. 添加单元测试
+3. 集成测试验证
+
+### 发布阶段
+1. 更新文档
+2. 版本发布
+3. 用户反馈收集
+
+## 兼容性
+
+### 系统兼容性
+- 支持 macOS、Linux、Windows
+- Node.js 18+ 版本要求
+- 与现有 AI 工具共存
+
+### 配置兼容性
+- 向后兼容现有配置
+- 支持配置迁移
+- 配置文件格式统一

package/specs/codebuddy-integration/requirements.md

@@ -0,0 +1,53 @@
+# 需求文档
+
+## 介绍
+
+在 CloudBase CLI 的 ai 命令中集成 Codebuddy Code CLI，为用户提供统一的 AI 开发工具入口。Codebuddy Code CLI 是一个面向开发者的自主编排的编程智能体，通过命令行界面为开发者提供强大的 AI 编程能力。
+
+## 需求
+
+### 需求 1 - Codebuddy Code CLI 基础集成
+
+**用户故事：** 作为开发者，我希望在 CloudBase CLI 中能够直接启动和使用 Codebuddy Code CLI，这样我就不需要单独安装和配置 Codebuddy Code CLI。
+
+#### 验收标准
+
+1. When 用户运行 `tcb ai -a codebuddy` 时，CloudBase CLI 应当启动 Codebuddy Code CLI 工具。
+2. When Codebuddy Code CLI 未安装时，系统应当提示用户安装并提供安装指导。
+3. When 用户运行 `tcb ai -a codebuddy --setup` 时，系统应当运行 Codebuddy Code CLI 的配置向导。
+4. When 用户运行 `tcb ai -a codebuddy --config` 时，系统应当显示当前的 Codebuddy Code CLI 配置信息。
+5. When 用户运行 `tcb ai -a codebuddy --reset` 时，系统应当重置 Codebuddy Code CLI 的配置。
+
+### 需求 2 - MCP 服务器管理功能
+
+**用户故事：** 作为开发者，我希望能够在 CloudBase CLI 中管理 Codebuddy Code CLI 的 MCP 服务器，这样我就可以方便地连接外部工具和数据源。
+
+#### 验收标准
+
+1. When 用户运行 `tcb ai -a codebuddy -- mcp add <server-name> --env <env-vars> -- <command>` 时，系统应当添加指定的 MCP 服务器。
+2. When 用户运行 `tcb ai -a codebuddy -- mcp list` 时，系统应当显示所有已配置的 MCP 服务器列表。
+3. When 用户运行 `tcb ai -a codebuddy -- mcp get <server-name>` 时，系统应当显示指定 MCP 服务器的详细信息。
+4. When 用户运行 `tcb ai -a codebuddy -- mcp remove <server-name>` 时，系统应当移除指定的 MCP 服务器。
+5. When 用户配置 MCP 服务器时，系统应当支持 Local、Project、User 三种配置作用域。
+
+### 需求 3 - 参数透传和命令执行
+
+**用户故事：** 作为开发者，我希望能够将 CloudBase CLI 的参数透传给 Codebuddy Code CLI，这样我就可以使用 Codebuddy Code CLI 的所有功能。
+
+#### 验收标准
+
+1. When 用户在 `tcb ai -a codebuddy` 后添加 `--` 和参数时，系统应当将这些参数透传给 Codebuddy Code CLI。
+2. When 用户使用 `tcb ai -a codebuddy -- -p "query"` 时，系统应当执行单次查询模式。
+3. When 用户使用 `tcb ai -a codebuddy -- -c` 时，系统应当继续最近的对话。
+4. When 用户使用 `tcb ai -a codebuddy -- -r "session-id" "query"` 时，系统应当恢复特定的会话。
+
+### 需求 4 - 配置管理和验证
+
+**用户故事：** 作为开发者，我希望 CloudBase CLI 能够管理 Codebuddy Code CLI 的配置，并验证配置的有效性。
+
+#### 验收标准
+
+1. When 用户首次使用 Codebuddy Code CLI 时，系统应当检查配置并引导用户完成配置。
+2. When 用户配置 Codebuddy Code CLI 时，系统应当验证配置的有效性。
+3. When 配置无效时，系统应当提供清晰的错误信息和修复建议。
+4. When 用户需要身份验证时，系统应当支持本地开发环境、远程开发环境和无交互环境的认证方式。