@cloudbase/cli 2.8.0-beta.4 → 2.8.0-beta.6

package/lib/utils/ai/setup.js

@@ -0,0 +1,550 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AISetupWizard = void 0;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const error_1 = require("../../error");
+const utils_1 = require("../../commands/utils");
+const constants_1 = require("../../commands/constants");
+const const_1 = require("./const");
+const config_1 = require("./config");
+const auth_1 = require("../../auth");
+const output_1 = require("../output");
+class AISetupWizard {
+    constructor(envId) {
+        this.aiConfigManager = new config_1.AIConfigManager();
+        this.envId = envId;
+    }
+    setUpDefault(log) {
+        return __awaiter(this, void 0, void 0, function* () {
+            log.info('🤖 欢迎使用 CloudBase AI ToolKit CLI 配置向导');
+            try {
+                const defaultAgent = yield this.selectAgent('选择默认使用的 AI CLI 工具:', false);
+                yield this.aiConfigManager.updateDefaultAgent(defaultAgent);
+                const currentAgent = defaultAgent;
+                yield this.configureAgent(currentAgent, log);
+                yield this.ensureGitignore();
+                log.info('✅ AI 配置完成！配置信息已保存到 .env.local 文件');
+                log.info('💡 提示：请确保 .env.local 文件已添加到 .gitignore 以保护敏感信息');
+                log.info('🚀 现在可以使用 tcb ai 命令了！');
+                return { defaultAgent };
+            }
+            catch (error) {
+                throw new error_1.CloudBaseError('配置向导执行失败', { original: error });
+            }
+        });
+    }
+    setUp(log) {
+        return __awaiter(this, void 0, void 0, function* () {
+            log.info('🤖 欢迎使用 CloudBase AI ToolKit CLI 配置向导');
+            try {
+                const currentAgent = yield this.selectCurrentAgent();
+                if (currentAgent !== const_1.NONE.value) {
+                    yield this.configureAgent(currentAgent, log);
+                }
+                const defaultAgent = yield this.selectDefaultAgent(log);
+                yield this.aiConfigManager.updateDefaultAgent(defaultAgent);
+                yield this.ensureGitignore();
+                log.info('✅ AI 配置完成！配置信息已保存到 .env.local 文件');
+                log.info('💡 提示：请确保 .env.local 文件已添加到 .gitignore 以保护敏感信息');
+                log.info('🚀 现在可以使用 tcb ai 命令了！');
+                return { defaultAgent };
+            }
+            catch (error) {
+                throw new error_1.CloudBaseError('配置向导执行失败', { original: error });
+            }
+        });
+    }
+    configureEnvId(log, _envId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let envId;
+            if (_envId) {
+                log.info(`使用传入的 envId ${_envId}`);
+                envId = _envId;
+            }
+            else {
+                log.info('未传入 envId，从 cloudbaserc.json 中获取');
+                const parser = (0, config_1.createConfigParser)();
+                const configEnvId = yield parser.get('envId').catch(() => null);
+                if (!configEnvId || configEnvId === '{{env.ENV_ID}}') {
+                    log.info('cloudbaserc.json 中无 envId 配置！');
+                    const { authSupevisor } = yield Promise.resolve().then(() => __importStar(require('../../utils/auth')));
+                    let loginState = yield authSupevisor.getLoginState();
+                    if (!loginState) {
+                        yield (0, auth_1.checkLogin)();
+                        loginState = yield authSupevisor.getLoginState();
+                    }
+                    envId = yield (0, utils_1.selectEnv)({ source: [constants_1.EnvSource.MINIAPP, constants_1.EnvSource.QCLOUD] });
+                    log.info(`已选择 envId: ${envId}`);
+                    if (!configEnvId) {
+                        parser.update('envId', '{{env.ENV_ID}}');
+                    }
+                    yield this.aiConfigManager.updateEnvId(envId);
+                }
+                else {
+                    envId = configEnvId;
+                    log.info(`使用 cloudbaserc.json 中的 envId: ${configEnvId}`);
+                    const { shouldUpdateEnvId } = yield inquirer_1.default.prompt([
+                        {
+                            type: 'confirm',
+                            name: 'shouldUpdateEnvId',
+                            message: `当前使用的 envId 为 ${configEnvId}，是否需要更新？`
+                        }
+                    ]);
+                    if (shouldUpdateEnvId) {
+                        yield (0, auth_1.checkLogin)();
+                        envId = yield (0, utils_1.selectEnv)({ source: [constants_1.EnvSource.MINIAPP, constants_1.EnvSource.QCLOUD] });
+                        log.info(`已选择 envId: ${envId}`);
+                        yield this.aiConfigManager.updateEnvId(envId);
+                    }
+                }
+            }
+            return envId;
+        });
+    }
+    selectDefaultAgent(log) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const config = yield this.aiConfigManager.loadConfig().catch(() => null);
+            const configuredAgents = (config === null || config === void 0 ? void 0 : config.agents) ? Object.keys(config.agents) : [];
+            if (configuredAgents.length === 0) {
+                const errorMsg = '没有已配置的 AI 工具，请先运行 tcb ai --setup 进行配置';
+                log.error(errorMsg);
+                process.exit(1);
+            }
+            if (configuredAgents.length === 1) {
+                const selectedAgent = configuredAgents[0];
+                const agentInfo = [const_1.CLAUDE, const_1.QWEN, const_1.CODEX, const_1.AIDER].find((a) => a.value === selectedAgent);
+                const agentName = (agentInfo === null || agentInfo === void 0 ? void 0 : agentInfo.name) || selectedAgent.toUpperCase();
+                log.info(`🔧 自动选择已配置的唯一 AI 工具: ${agentName}`);
+                return selectedAgent;
+            }
+            const availableChoices = configuredAgents.map((agent) => {
+                const agentInfo = [const_1.CLAUDE, const_1.QWEN, const_1.CODEX, const_1.AIDER].find((a) => a.value === agent);
+                return agentInfo || { name: agent.toUpperCase(), value: agent };
+            });
+            const { agent } = yield inquirer_1.default.prompt([
+                {
+                    type: 'list',
+                    name: 'agent',
+                    message: '选择默认使用的 AI CLI 工具:',
+                    choices: availableChoices,
+                    default: configuredAgents[0]
+                }
+            ]);
+            return agent;
+        });
+    }
+    selectCurrentAgent() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.selectAgent('选择当前要配置的 AI CLI 工具:', true);
+        });
+    }
+    selectAgent(message, includeNone = false) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { agent } = yield inquirer_1.default.prompt([
+                {
+                    type: 'list',
+                    name: 'agent',
+                    message,
+                    choices: [const_1.CLAUDE, const_1.QWEN, const_1.CODEX, const_1.AIDER, ...(includeNone ? [const_1.NONE] : [])],
+                    default: const_1.CLAUDE.value
+                }
+            ]);
+            return agent;
+        });
+    }
+    configureAgent(agent, log) {
+        return __awaiter(this, void 0, void 0, function* () {
+            log.info(`\n📝 配置 ${agent.toUpperCase()}:`);
+            switch (agent) {
+                case const_1.CLAUDE.value:
+                    return yield this.configureClaudeAgent(log);
+                case const_1.QWEN.value:
+                    return yield this.configureQwenAgent(log);
+                case const_1.CODEX.value:
+                    return yield this.configureCodexAgent(log);
+                case const_1.AIDER.value:
+                    return yield this.configureAiderAgent(log);
+                default:
+                    throw new Error(`不支持的 AI 工具: ${agent}`);
+            }
+        });
+    }
+    configureClaudeAgent(log) {
+        return __awaiter(this, void 0, void 0, function* () {
+            log.info(`配置说明可参考 ${(0, output_1.genClickableLink)('https://docs.cloudbase.net/cli-v1/ai/claude')}`);
+            const { configMethod } = yield inquirer_1.default.prompt([
+                {
+                    type: 'list',
+                    name: 'configMethod',
+                    message: '选择配置方式:',
+                    choices: [
+                        { name: '使用 CloudBase 服务，一键登录，无需配置', value: 'cloudbase' },
+                        { name: '自配置 API KEY 和 Base URL', value: 'custom' }
+                    ],
+                    default: 'cloudbase'
+                }
+            ]);
+            if (configMethod === 'cloudbase') {
+                yield this.configureEnvId(log, this.envId);
+                const { provider, model, transformer } = yield this.selectCloudBaseProvider();
+                yield this.aiConfigManager.updateClaudeConfig('cloudbase', Object.assign({ provider,
+                    model }, (transformer && { transformer })));
+            }
+            else {
+                const { baseUrlChoice } = yield inquirer_1.default.prompt([
+                    {
+                        type: 'list',
+                        name: 'baseUrlChoice',
+                        message: '选择 API Base URL:',
+                        choices: [
+                            { name: 'Kimi - https://api.moonshot.cn/anthropic', value: 'https://api.moonshot.cn/anthropic' },
+                            { name: '智谱 - https://open.bigmodel.cn/api/anthropic', value: 'https://open.bigmodel.cn/api/anthropic' },
+                            { name: '🛠️ 自定义 URL', value: 'custom' }
+                        ],
+                        default: 'https://api.moonshot.cn/anthropic'
+                    }
+                ]);
+                let baseUrl;
+                if (baseUrlChoice === 'custom') {
+                    const { customUrl } = yield inquirer_1.default.prompt([
+                        {
+                            type: 'input',
+                            name: 'customUrl',
+                            message: '请输入自定义 API Base URL:',
+                            validate: (input) => input.trim().length > 0 || '请输入有效的 Base URL'
+                        }
+                    ]);
+                    baseUrl = customUrl;
+                }
+                else {
+                    baseUrl = baseUrlChoice;
+                }
+                const { apikey } = yield inquirer_1.default.prompt([
+                    {
+                        type: 'password',
+                        name: 'apikey',
+                        message: 'Claude Auth Token:',
+                        validate: (input) => input.length > 0 || '请输入有效的 Auth Token'
+                    }
+                ]);
+                yield this.aiConfigManager.updateClaudeConfig('custom', { baseUrl, apiKey: apikey });
+            }
+        });
+    }
+    configureQwenAgent(log) {
+        return __awaiter(this, void 0, void 0, function* () {
+            log.info(`配置说明可参考 ${(0, output_1.genClickableLink)('https://docs.cloudbase.net/cli-v1/ai/qwen')}`);
+            const { configMethod } = yield inquirer_1.default.prompt([
+                {
+                    type: 'list',
+                    name: 'configMethod',
+                    message: '选择配置方式:',
+                    choices: [
+                        { name: '使用 CloudBase 服务，一键登录，无需配置', value: 'cloudbase' },
+                        { name: '自配置 API KEY 和 Base URL', value: 'custom' }
+                    ],
+                    default: 'cloudbase'
+                }
+            ]);
+            if (configMethod === 'cloudbase') {
+                yield this.configureEnvId(log, this.envId);
+                const { provider, model } = yield this.selectCloudBaseProvider();
+                yield this.aiConfigManager.updateQwenConfig('cloudbase', {
+                    provider,
+                    model
+                });
+            }
+            else {
+                const { apiKey, baseUrl, model } = yield inquirer_1.default.prompt([
+                    {
+                        type: 'input',
+                        name: 'baseUrl',
+                        message: 'API Base URL (留空使用默认):',
+                        default: 'https://dashscope.aliyuncs.com/compatible-mode/v1'
+                    },
+                    {
+                        type: 'password',
+                        name: 'apiKey',
+                        message: 'Qwen API Key:',
+                        validate: (input) => input.length > 0 || '请输入有效的 API Key'
+                    },
+                    {
+                        type: 'input',
+                        name: 'model',
+                        message: '模型名称 (留空使用默认):',
+                        default: 'qwen-turbo'
+                    }
+                ]);
+                yield this.aiConfigManager.updateQwenConfig('custom', { baseUrl, apiKey, model });
+            }
+        });
+    }
+    configureCodexAgent(log) {
+        return __awaiter(this, void 0, void 0, function* () {
+            log.info(`配置说明可参考 ${(0, output_1.genClickableLink)('https://docs.cloudbase.net/cli-v1/ai/codex')}`);
+            const { configMethod } = yield inquirer_1.default.prompt([
+                {
+                    type: 'list',
+                    name: 'configMethod',
+                    message: '选择配置方式:',
+                    choices: [
+                        { name: '使用 CloudBase 服务，一键登录，无需配置', value: 'cloudbase' },
+                        { name: '自配置 API KEY 和 Base URL', value: 'custom' }
+                    ],
+                    default: 'cloudbase'
+                }
+            ]);
+            if (configMethod === 'cloudbase') {
+                yield this.configureEnvId(log, this.envId);
+                const { provider, model } = yield this.selectCloudBaseProvider();
+                yield this.aiConfigManager.updateCodexConfig('cloudbase', {
+                    provider,
+                    model
+                });
+            }
+            else {
+                const { baseUrlChoice } = yield inquirer_1.default.prompt([
+                    {
+                        type: 'list',
+                        name: 'baseUrlChoice',
+                        message: '选择 API Base URL:',
+                        choices: [
+                            { name: 'Kimi - https://api.moonshot.cn/v1', value: 'https://api.moonshot.cn/v1' },
+                            { name: '智谱 - https://open.bigmodel.cn/api/paas/v4', value: 'https://open.bigmodel.cn/api/paas/v4' },
+                            { name: '🛠️ 自定义 URL', value: 'custom' }
+                        ],
+                        default: 'https://api.moonshot.cn/v1'
+                    }
+                ]);
+                let baseUrl;
+                if (baseUrlChoice === 'custom') {
+                    const { customUrl } = yield inquirer_1.default.prompt([
+                        {
+                            type: 'input',
+                            name: 'customUrl',
+                            message: '请输入自定义 API Base URL:',
+                            validate: (input) => input.trim().length > 0 || '请输入有效的 Base URL'
+                        }
+                    ]);
+                    baseUrl = customUrl;
+                }
+                else {
+                    baseUrl = baseUrlChoice;
+                }
+                const { apiKey, model } = yield inquirer_1.default.prompt([
+                    {
+                        type: 'password',
+                        name: 'apiKey',
+                        message: 'API Key:',
+                        validate: (input) => input.length > 0 || '请输入有效的 API Key'
+                    },
+                    {
+                        type: 'input',
+                        name: 'model',
+                        message: '模型名称 (留空使用默认):',
+                        default: (0, const_1.getDefaultModelByBaseUrl)(baseUrl)
+                    }
+                ]);
+                yield this.aiConfigManager.updateCodexConfig('custom', { baseUrl, apiKey, model });
+            }
+        });
+    }
+    configureAiderAgent(log) {
+        return __awaiter(this, void 0, void 0, function* () {
+            log.info(`配置说明可参考 ${(0, output_1.genClickableLink)('https://docs.cloudbase.net/cli-v1/ai/aider')}`);
+            const { configMethod } = yield inquirer_1.default.prompt([
+                {
+                    type: 'list',
+                    name: 'configMethod',
+                    message: '选择配置方式:',
+                    choices: [
+                        { name: '使用 CloudBase 服务，一键登录，无需配置', value: 'cloudbase' },
+                        { name: '自配置 API KEY 和 Base URL', value: 'custom' }
+                    ],
+                    default: 'cloudbase'
+                }
+            ]);
+            if (configMethod === 'cloudbase') {
+                yield this.configureEnvId(log, this.envId);
+                const { provider, model } = yield this.selectCloudBaseProvider();
+                yield this.aiConfigManager.updateAiderConfig('cloudbase', {
+                    provider,
+                    model
+                });
+            }
+            else {
+                const { baseUrlChoice } = yield inquirer_1.default.prompt([
+                    {
+                        type: 'list',
+                        name: 'baseUrlChoice',
+                        message: '选择 API Base URL:',
+                        choices: [
+                            { name: 'Kimi - https://api.moonshot.cn/v1', value: 'https://api.moonshot.cn/v1' },
+                            { name: '智谱 - https://open.bigmodel.cn/api/paas/v4', value: 'https://open.bigmodel.cn/api/paas/v4' },
+                            { name: '🛠️ 自定义 URL', value: 'custom' }
+                        ],
+                        default: 'https://api.moonshot.cn/v1'
+                    }
+                ]);
+                let baseUrl;
+                if (baseUrlChoice === 'custom') {
+                    const { customUrl } = yield inquirer_1.default.prompt([
+                        {
+                            type: 'input',
+                            name: 'customUrl',
+                            message: '请输入自定义 API Base URL:',
+                            validate: (input) => input.trim().length > 0 || '请输入有效的 Base URL'
+                        }
+                    ]);
+                    baseUrl = customUrl;
+                }
+                else {
+                    baseUrl = baseUrlChoice;
+                }
+                const { apiKey, model } = yield inquirer_1.default.prompt([
+                    {
+                        type: 'password',
+                        name: 'apiKey',
+                        message: 'API Key:',
+                        validate: (input) => input.length > 0 || '请输入有效的 API Key'
+                    },
+                    {
+                        type: 'input',
+                        name: 'model',
+                        message: '模型名称:',
+                        default: (0, const_1.getDefaultModelByBaseUrl)(baseUrl),
+                        validate: (input) => input.length > 0 || '请输入有效的模型名称'
+                    }
+                ]);
+                yield this.aiConfigManager.updateAiderConfig('custom', { baseUrl, apiKey, model });
+            }
+        });
+    }
+    ensureGitignore() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const gitignorePath = path_1.default.join(process.cwd(), '.gitignore');
+            try {
+                let gitignoreContent = '';
+                if (yield fs_extra_1.default.pathExists(gitignorePath)) {
+                    gitignoreContent = yield fs_extra_1.default.readFile(gitignorePath, 'utf8');
+                }
+                const patterns = ['.env.local', '.env'];
+                let needsUpdate = false;
+                for (const pattern of patterns) {
+                    if (!gitignoreContent.includes(pattern)) {
+                        if (!needsUpdate) {
+                            gitignoreContent += '\n# Environment variables\n';
+                            needsUpdate = true;
+                        }
+                        gitignoreContent += `${pattern}\n`;
+                    }
+                }
+                if (needsUpdate) {
+                    yield fs_extra_1.default.writeFile(gitignorePath, gitignoreContent);
+                }
+            }
+            catch (error) {
+            }
+        });
+    }
+    selectCloudBaseProvider() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { selectedProvider } = yield inquirer_1.default.prompt([
+                {
+                    type: 'list',
+                    name: 'selectedProvider',
+                    message: '选择大模型供应商:',
+                    choices: const_1.CLOUDBASE_PROVIDERS.map(p => ({ name: p.name, value: p.value })),
+                    default: 'deepseek'
+                }
+            ]);
+            if (selectedProvider === 'custom') {
+                const { provider, model } = yield inquirer_1.default.prompt([
+                    {
+                        type: 'input',
+                        name: 'provider',
+                        message: '请输入自定义供应商名称:',
+                        validate: (input) => input.trim().length > 0 || '供应商名称不能为空'
+                    },
+                    {
+                        type: 'input',
+                        name: 'model',
+                        message: '请输入模型名称:',
+                        validate: (input) => input.trim().length > 0 || '模型名称不能为空'
+                    }
+                ]);
+                return { provider, model, isCustom: true, transformer: undefined };
+            }
+            else {
+                const selectedConfig = const_1.CLOUDBASE_PROVIDERS.find(p => p.value === selectedProvider);
+                const modelChoices = [
+                    ...selectedConfig.models.map(m => ({ name: m, value: m })),
+                    { name: '🛠️ 自定义', value: 'custom' }
+                ];
+                const { selectedModel } = yield inquirer_1.default.prompt([
+                    {
+                        type: 'list',
+                        name: 'selectedModel',
+                        message: '选择模型:',
+                        choices: modelChoices,
+                        default: selectedConfig.models[0]
+                    }
+                ]);
+                let model;
+                if (selectedModel === 'custom') {
+                    const { customModel } = yield inquirer_1.default.prompt([
+                        {
+                            type: 'input',
+                            name: 'customModel',
+                            message: '请输入自定义模型名称:',
+                            validate: (input) => input.trim().length > 0 || '模型名称不能为空'
+                        }
+                    ]);
+                    model = customModel;
+                }
+                else {
+                    model = selectedModel;
+                }
+                return { provider: selectedProvider, model, isCustom: false, transformer: selectedConfig.transformer };
+            }
+        });
+    }
+}
+exports.AISetupWizard = AISetupWizard;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cloudbase/cli",
-    "version": "2.8.0-beta.4",
+    "version": "2.8.0-beta.6",
     "description": "cli tool for cloudbase",
     "main": "lib/index.js",
     "scripts": {
@@ -21,7 +21,8 @@
     },
     "bin": {
         "cloudbase": "bin/cloudbase.js",
-        "tcb": "bin/tcb.js"
+        "tcb": "bin/tcb.js",
+        "cloudbase-mcp": "bin/cloudbase-mcp.js"
     },
     "husky": {
         "hooks": {
@@ -32,12 +33,14 @@
     "license": "ISC",
     "dependencies": {
         "@cloudbase/cloud-api": "^0.5.5",
+        "@cloudbase/cloudbase-mcp": "^1.8.17",
         "@cloudbase/framework-core": "^1.9.7",
         "@cloudbase/functions-framework": "1.16.0",
         "@cloudbase/iac-core": "0.0.3-alpha.11",
         "@cloudbase/lowcode-cli": "^0.22.2",
         "@cloudbase/manager-node": "4.3.3",
         "@cloudbase/toolbox": "^0.7.5",
+        "@dotenvx/dotenvx": "^1.48.3",
         "address": "^1.1.2",
         "camelcase-keys": "^7.0.2",
         "chalk": "^2.4.2",
@@ -47,7 +50,9 @@
         "didyoumean": "^1.2.2",
         "enquirer": "^2.3.6",
         "execa": "^4.0.3",
+        "figlet": "^1.7.0",
         "fs-extra": "^8.1.0",
+        "gradient-string": "^2.0.2",
         "https-proxy-agent": "^5.0.1",
         "inquirer": "^6.5.0",
         "json-schema-to-typescript": "^14.0.5",
@@ -66,11 +71,13 @@
         "semver": "^7.3.7",
         "tar-fs": "^2.0.1",
         "terminal-link": "^2.1.1",
+        "toml": "^3.0.0",
         "unzipper": "^0.10.10",
         "update-notifier": "^4.0.0",
         "xdg-basedir": "^4.0.0",
         "yargs": "^16.2.0",
-        "yargs-parser": "^21.0.1"
+        "yargs-parser": "^21.0.1",
+        "zod": "^4.0.13"
     },
     "devDependencies": {
         "@types/fs-extra": "^11.0.4",
@@ -81,6 +88,7 @@
         "@types/node-fetch": "^2.5.4",
         "@types/react": "^17.0.37",
         "@types/semver": "^7.3.9",
+        "@types/unzipper": "^0.10.11",
         "@types/webpack-dev-server": "^3.11.1",
         "@typescript-eslint/eslint-plugin": "^4.8.1",
         "@typescript-eslint/parser": "^4.8.1",

package/rules/cloudbase-platform.mdc

@@ -0,0 +1,44 @@
+---
+description: CloudBase 平台知识和最佳实践
+globs: ["**/cloudbaserc.json", "**/cloudfunctions/**/*"]
+alwaysApply: false
+---
+
+# CloudBase 平台知识
+
+## 存储和托管
+1. 云开发的静态托管和云存储是两个不同的桶，一般公开可访问的可以存放在静态托管，可以获得一个公开的网页地址，同时支持配置自定义域名（需要到控制台操作），云存储适合放一些有私密性的文件，可以通过获取临时文件来获取一个临时访问地址
+2. 云开发的静态托管域名可以通过 getWebsiteConfig 来获取，然后结合静态托管文件的路径可以拼出最终访问地址，记住如果访问地址是个目录，最后必须带有 /
+
+## 环境和认证
+1. 云开发的 SDK 初始化时都需要填写环境 id，可以通过 envQuery 工具来查询环境 id，然后进行登录，例如使用匿名登录
+
+## 云函数
+1. Node.js 的云函数中需要包含package.json，声明所需的依赖，可以使用 createFunction 来创建函数，使用 updateFunctionCode 来部署云函数，优先采用云端安装依赖，不上传 node_modules，functionRootPath 指的是函数目录的父目录，例如 cloudfuncitons 这个目录
+
+## 数据库权限
+1. 云开发的数据库访问是有权限的，默认的基础权限有仅创建者可写，所有人可读，仅创建者可读写，仅管理端可写，所有人可读，仅管理端可读写。如果直接从 web 端或者小程序端请求数据库，需要考虑配置合适的数据库权限，在云函数中，默认没有权限控制
+2. 如用户无特殊要求，涉及到跨数据库集合的操作必须通过云函数实现
+3. 如果用涉及到云函数，在保证安全的情况下，可以尽可能可能缩减云函数的数量，例如实现一个面向 c 端请求的云函数，实现一个初始化数据的云函数
+
+## 数据模型
+1. 获取数据模型操作对象：
+   - 小程序：需要 `@cloudbase/wx-cloud-client-sdk`，初始化 `const client = initHTTPOverCallFunction(wx.cloud)`，使用 `client.models`
+   - 云函数：需要 `@cloudbase/node-sdk@3.10+`，初始化 `const app = cloudbase.init({env})`，使用 `app.models`
+   - Web：需要 `@cloudbase/js-sdk`，初始化 `const app = cloudbase.init({env})`，登录后使用 `app.models`
+2. 数据模型查询：可调用 MCP manageDataModel 工具查询模型列表、获取模型详细信息（含Schema字段）、获取具体的 models SDK使用文档
+3. MySQL 数据模型调用规则
+   - MySQL 数据模型不能使用 collection 方式调用，必须使用数据模型 SDK
+   - 错误：`db.collection('model_name').get()`
+   - 正确：`app.models.model_name.list({ filter: { where: {} } })`
+   - 使用 manageDataModel 工具的 docs 方法获取具体 SDK 用法
+
+## 控制台管理
+创建/部署资源后，提供对应的控制台管理页面链接：
+
+1. 静态托管：https://console.cloud.tencent.com/tcb/hosting
+2. 云函数：https://tcb.cloud.tencent.com/dev?envId=${envId}#/scf/detail?id=${functionName}&NameSpace=${envId}
+3. 数据库集合：https://tcb.cloud.tencent.com/dev?envId=${envId}#/db/doc/collection/${collectionName}
+4. 数据模型：https://tcb.cloud.tencent.com/dev?envId=${envId}#/db/doc/model/${modelName}
+
+使用方式：创建对应资源后，将变量替换为实际值，提供给用户进行管理操作。