@cloudbase/cloudbase-mcp 2.3.0 → 2.3.1

package/README.md

@@ -334,7 +334,7 @@ CodeBuddy 已内置 CloudBase MCP，无需配置即可使用。
 
 ## 🧩 MCP 工具
 
-**39 个工具**覆盖环境管理、数据库、云函数、静态托管、小程序发布等核心功能。
+覆盖环境管理、数据库、云函数、静态托管、小程序发布等核心功能。
 
 | 分类 | 工具 | 核心功能 |
 |------|------|----------|

package/dist/cli.cjs

@@ -135012,7 +135012,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.3.0" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.3.1" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -185485,7 +185485,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.downloadWebTemplate = downloadWebTemplate;
 exports.getClaudePrompt = getClaudePrompt;
 exports.registerRagTools = registerRagTools;
 const adm_zip_1 = __importDefault(__webpack_require__(30283));
@@ -185503,6 +185502,58 @@ const KnowledgeBaseIdMap = {
     scf: "scfsczskzyws_4bdc",
     miniprogram: "xcxzskws_25d8",
 };
+// ============ 缓存配置 ============
+const CACHE_BASE_DIR = path.join(os.homedir(), ".cloudbase-mcp");
+const CACHE_META_FILE = path.join(CACHE_BASE_DIR, "cache-meta.json");
+const DEFAULT_CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 默认 24 小时
+// 支持环境变量 CLOUDBASE_MCP_CACHE_TTL_MS 控制缓存过期时间（毫秒）
+const parsedCacheTTL = process.env.CLOUDBASE_MCP_CACHE_TTL_MS
+    ? parseInt(process.env.CLOUDBASE_MCP_CACHE_TTL_MS, 10)
+    : NaN;
+const CACHE_TTL_MS = Number.isNaN(parsedCacheTTL) || parsedCacheTTL < 0
+    ? DEFAULT_CACHE_TTL_MS
+    : parsedCacheTTL;
+if (!Number.isNaN(parsedCacheTTL) && parsedCacheTTL >= 0) {
+    (0, logger_js_1.debug)("[cache] Using TTL from CLOUDBASE_MCP_CACHE_TTL_MS", {
+        ttlMs: CACHE_TTL_MS,
+    });
+}
+else {
+    (0, logger_js_1.debug)("[cache] Using default TTL", { ttlMs: CACHE_TTL_MS });
+}
+// 共享的下载 Promise，防止并发重复下载
+let resourceDownloadPromise = null;
+// 检查缓存是否可用（未过期）
+async function canUseCache() {
+    try {
+        const content = await fs.readFile(CACHE_META_FILE, "utf8");
+        const meta = JSON.parse(content);
+        if (!meta.timestamp) {
+            (0, logger_js_1.debug)("[cache] cache-meta missing timestamp, treating as invalid", {
+                ttlMs: CACHE_TTL_MS,
+            });
+            return false;
+        }
+        const ageMs = Date.now() - meta.timestamp;
+        const isValid = ageMs <= CACHE_TTL_MS;
+        (0, logger_js_1.debug)("[cache] evaluated cache meta", {
+            timestamp: meta.timestamp,
+            ageMs,
+            ttlMs: CACHE_TTL_MS,
+            valid: isValid,
+        });
+        return isValid;
+    }
+    catch (error) {
+        (0, logger_js_1.debug)("[cache] failed to read cache meta, treating as miss", { error });
+        return false;
+    }
+}
+// 更新缓存时间戳
+async function updateCache() {
+    await fs.mkdir(CACHE_BASE_DIR, { recursive: true });
+    await fs.writeFile(CACHE_META_FILE, JSON.stringify({ timestamp: Date.now() }, null, 2), "utf8");
+}
 // 安全 JSON.parse
 function safeParse(str) {
     try {
@@ -185529,31 +185580,141 @@ function safeStringify(obj) {
         return "";
     }
 }
-// Download and extract web template, return extract directory path
-// Always downloads and overwrites existing template
+// OpenAPI 文档 URL 列表
+const OPENAPI_SOURCES = [
+    {
+        name: "mysqldb",
+        description: "MySQL RESTful API - 云开发 MySQL 数据库 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/mysqldb.v1.openapi.yaml",
+    },
+    {
+        name: "functions",
+        description: "Cloud Functions API - 云函数 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/functions.v1.openapi.yaml",
+    },
+    {
+        name: "auth",
+        description: "Authentication API - 身份认证 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/auth.v1.openapi.yaml",
+    },
+    {
+        name: "cloudrun",
+        description: "CloudRun API - 云托管服务 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/cloudrun.v1.openapi.yaml",
+    },
+    {
+        name: "storage",
+        description: "Storage API - 云存储 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/storage.v1.openapi.yaml",
+    },
+];
 async function downloadWebTemplate() {
-    const baseDir = path.join(os.homedir(), ".cloudbase-mcp");
-    const zipPath = path.join(baseDir, "web-cloudbase-project.zip");
-    const extractDir = path.join(baseDir, "web-template");
+    const zipPath = path.join(CACHE_BASE_DIR, "web-cloudbase-project.zip");
+    const extractDir = path.join(CACHE_BASE_DIR, "web-template");
     const url = "https://static.cloudbase.net/cloudbase-examples/web-cloudbase-project.zip";
-    await fs.mkdir(baseDir, { recursive: true });
-    // Download zip to specified path (overwrite)
     const response = await fetch(url);
     if (!response.ok) {
         throw new Error(`下载模板失败，状态码: ${response.status}`);
     }
     const buffer = Buffer.from(await response.arrayBuffer());
     await fs.writeFile(zipPath, buffer);
-    // Clean and recreate extract directory
     await fs.rm(extractDir, { recursive: true, force: true });
     await fs.mkdir(extractDir, { recursive: true });
     const zip = new adm_zip_1.default(zipPath);
     zip.extractAllTo(extractDir, true);
+    (0, logger_js_1.debug)("[downloadResources] webTemplate 下载完成");
     return extractDir;
 }
-async function prepareKnowledgeBaseWebTemplate() {
-    const extractDir = await downloadWebTemplate();
-    return collectSkillDescriptions(path.join(extractDir, ".claude", "skills"));
+async function downloadOpenAPI() {
+    const baseDir = path.join(CACHE_BASE_DIR, "openapi");
+    await fs.mkdir(baseDir, { recursive: true });
+    const results = [];
+    await Promise.all(OPENAPI_SOURCES.map(async (source) => {
+        try {
+            const response = await fetch(source.url);
+            if (!response.ok) {
+                (0, logger_js_1.warn)(`[downloadOpenAPI] Failed to download ${source.name}`, {
+                    status: response.status,
+                });
+                return;
+            }
+            const content = await response.text();
+            const filePath = path.join(baseDir, `${source.name}.openapi.yaml`);
+            await fs.writeFile(filePath, content, "utf8");
+            results.push({
+                name: source.name,
+                description: source.description,
+                absolutePath: filePath,
+            });
+        }
+        catch (error) {
+            (0, logger_js_1.warn)(`[downloadOpenAPI] Failed to download ${source.name}`, {
+                error,
+            });
+        }
+    }));
+    (0, logger_js_1.debug)("[downloadOpenAPI] openAPIDocs 下载完成", {
+        successCount: results.length,
+        total: OPENAPI_SOURCES.length,
+    });
+    return results;
+}
+// 实际执行下载所有资源的函数（webTemplate 和 openAPI 并发下载）
+async function _doDownloadResources() {
+    // 并发下载 webTemplate 和 openAPIDocs
+    const [webTemplateDir, openAPIDocs] = await Promise.all([
+        // 下载 web 模板
+        downloadWebTemplate(),
+        // 并发下载所有 OpenAPI 文档
+        downloadOpenAPI(),
+    ]);
+    (0, logger_js_1.debug)("[downloadResources] 所有资源下载完成");
+    return { webTemplateDir, openAPIDocs };
+}
+// 下载所有资源（带缓存和共享 Promise 机制）
+async function downloadResources() {
+    const webTemplateDir = path.join(CACHE_BASE_DIR, "web-template");
+    const openAPIDir = path.join(CACHE_BASE_DIR, "openapi");
+    // 检查缓存是否有效
+    if (await canUseCache()) {
+        try {
+            // 检查两个目录都存在
+            await Promise.all([fs.access(webTemplateDir), fs.access(openAPIDir)]);
+            const files = await fs.readdir(openAPIDir);
+            if (files.length > 0) {
+                (0, logger_js_1.debug)("[downloadResources] 使用缓存");
+                return {
+                    webTemplateDir,
+                    openAPIDocs: OPENAPI_SOURCES.map((source) => ({
+                        name: source.name,
+                        description: source.description,
+                        absolutePath: path.join(openAPIDir, `${source.name}.openapi.yaml`),
+                    })).filter((item) => files.includes(`${item.name}.openapi.yaml`)),
+                };
+            }
+        }
+        catch {
+            // 缓存无效，需要重新下载
+        }
+    }
+    // 如果已有下载任务在进行中，共享该 Promise
+    if (resourceDownloadPromise) {
+        (0, logger_js_1.debug)("[downloadResources] 共享已有下载任务");
+        return resourceDownloadPromise;
+    }
+    // 创建新的下载任务
+    (0, logger_js_1.debug)("[downloadResources] 开始新下载任务");
+    await fs.mkdir(CACHE_BASE_DIR, { recursive: true });
+    resourceDownloadPromise = _doDownloadResources()
+        .then(async (result) => {
+        await updateCache();
+        (0, logger_js_1.debug)("[downloadResources] 缓存已更新");
+        return result;
+    })
+        .finally(() => {
+        resourceDownloadPromise = null;
+    });
+    return resourceDownloadPromise;
 }
 // Get CLAUDE.md prompt content
 // Priority: 1. From downloaded template, 2. Fallback to embedded constant
@@ -185677,23 +185838,15 @@ async function registerRagTools(server) {
             };
         }
     });
-    let skills = [];
     let openapis = [];
-    // 知识库检索
-    try {
-        skills = await prepareKnowledgeBaseWebTemplate();
-    }
-    catch (error) {
-        (0, logger_js_1.warn)("[searchKnowledgeBase] Failed to prepare web template", {
-            error,
-        });
-    }
-    // OpenAPI 文档准备
+    let skills = [];
     try {
-        openapis = await prepareOpenAPIDocs();
+        const { webTemplateDir, openAPIDocs } = await downloadResources();
+        openapis = openAPIDocs;
+        skills = await collectSkillDescriptions(path.join(webTemplateDir, ".claude", "skills"));
     }
     catch (error) {
-        (0, logger_js_1.warn)("[searchKnowledgeBase] Failed to prepare OpenAPI docs", {
+        (0, logger_js_1.warn)("[downloadResources] Failed to download resources", {
             error,
         });
     }
@@ -185860,65 +186013,6 @@ function extractDescriptionFromFrontMatter(content) {
         .match(/^(?:decsription|description)\s*:\s*(.*)$/m);
     return match ? match[1].trim() : null;
 }
-// OpenAPI 文档 URL 列表
-const OPENAPI_SOURCES = [
-    {
-        name: "mysqldb",
-        description: "MySQL RESTful API - 云开发 MySQL 数据库 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/mysqldb.v1.openapi.yaml",
-    },
-    {
-        name: "functions",
-        description: "Cloud Functions API - 云函数 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/functions.v1.openapi.yaml",
-    },
-    {
-        name: "auth",
-        description: "Authentication API - 身份认证 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/auth.v1.openapi.yaml",
-    },
-    {
-        name: "cloudrun",
-        description: "CloudRun API - 云托管服务 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/cloudrun.v1.openapi.yaml",
-    },
-    {
-        name: "storage",
-        description: "Storage API - 云存储 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/storage.v1.openapi.yaml",
-    },
-];
-// 下载并准备 OpenAPI 文档
-async function prepareOpenAPIDocs() {
-    const baseDir = path.join(os.homedir(), ".cloudbase-mcp", "openapi");
-    await fs.mkdir(baseDir, { recursive: true });
-    const results = [];
-    await Promise.all(OPENAPI_SOURCES.map(async (source) => {
-        try {
-            const response = await fetch(source.url);
-            if (!response.ok) {
-                (0, logger_js_1.warn)(`[prepareOpenAPIDocs] Failed to download ${source.name}`, {
-                    status: response.status,
-                });
-                return;
-            }
-            const content = await response.text();
-            const filePath = path.join(baseDir, `${source.name}.openapi.yaml`);
-            await fs.writeFile(filePath, content, "utf8");
-            results.push({
-                name: source.name,
-                description: source.description,
-                absolutePath: filePath,
-            });
-        }
-        catch (error) {
-            (0, logger_js_1.warn)(`[prepareOpenAPIDocs] Failed to download ${source.name}`, {
-                error,
-            });
-        }
-    }));
-    return results;
-}
 async function collectSkillDescriptions(rootDir) {
     const result = [];
     async function walk(dir) {
@@ -200756,7 +200850,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.3.0" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.3.1" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -215401,7 +215495,7 @@ function registerSetupTools(server) {
         title: "下载项目模板",
         description: `自动下载并部署CloudBase项目模板。⚠️ **MANDATORY FOR NEW PROJECTS** ⚠️
 
-**CRITICAL**: This tool MUST be called FIRST when starting a new project.\n\n支持的模板:\n- react: React + CloudBase 全栈应用模板\n- vue: Vue + CloudBase 全栈应用模板\n- miniprogram: 微信小程序 + 云开发模板  \n- uniapp: UniApp + CloudBase 跨端应用模板\n- rules: 只包含AI编辑器配置文件（包含Cursor、WindSurf、CodeBuddy等所有主流编辑器配置），适合在已有项目中补充AI编辑器配置\n\n支持的IDE类型:\n- all: 下载所有IDE配置（默认）\n- cursor: Cursor AI编辑器\n- windsurf: WindSurf AI编辑器\n- codebuddy: CodeBuddy AI编辑器\n- claude-code: Claude Code AI编辑器\n- cline: Cline AI编辑器\n- gemini-cli: Gemini CLI\n- opencode: OpenCode AI编辑器\n- qwen-code: 通义灵码\n- baidu-comate: 百度Comate\n- openai-codex-cli: OpenAI Codex CLI\n- augment-code: Augment Code\n- github-copilot: GitHub Copilot\n- roocode: RooCode AI编辑器\n- tongyi-lingma: 通义灵码\n- trae: Trae AI编辑器\n- qoder: Qoder AI编辑器\n- antigravity: Google Antigravity AI编辑器\n- vscode: Visual Studio Code\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.3.0" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
+**CRITICAL**: This tool MUST be called FIRST when starting a new project.\n\n支持的模板:\n- react: React + CloudBase 全栈应用模板\n- vue: Vue + CloudBase 全栈应用模板\n- miniprogram: 微信小程序 + 云开发模板  \n- uniapp: UniApp + CloudBase 跨端应用模板\n- rules: 只包含AI编辑器配置文件（包含Cursor、WindSurf、CodeBuddy等所有主流编辑器配置），适合在已有项目中补充AI编辑器配置\n\n支持的IDE类型:\n- all: 下载所有IDE配置（默认）\n- cursor: Cursor AI编辑器\n- windsurf: WindSurf AI编辑器\n- codebuddy: CodeBuddy AI编辑器\n- claude-code: Claude Code AI编辑器\n- cline: Cline AI编辑器\n- gemini-cli: Gemini CLI\n- opencode: OpenCode AI编辑器\n- qwen-code: 通义灵码\n- baidu-comate: 百度Comate\n- openai-codex-cli: OpenAI Codex CLI\n- augment-code: Augment Code\n- github-copilot: GitHub Copilot\n- roocode: RooCode AI编辑器\n- tongyi-lingma: 通义灵码\n- trae: Trae AI编辑器\n- qoder: Qoder AI编辑器\n- antigravity: Google Antigravity AI编辑器\n- vscode: Visual Studio Code\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.3.1" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])

package/dist/index.cjs

@@ -134861,7 +134861,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.3.0" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.3.1" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -185334,7 +185334,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.downloadWebTemplate = downloadWebTemplate;
 exports.getClaudePrompt = getClaudePrompt;
 exports.registerRagTools = registerRagTools;
 const adm_zip_1 = __importDefault(__webpack_require__(30283));
@@ -185352,6 +185351,58 @@ const KnowledgeBaseIdMap = {
     scf: "scfsczskzyws_4bdc",
     miniprogram: "xcxzskws_25d8",
 };
+// ============ 缓存配置 ============
+const CACHE_BASE_DIR = path.join(os.homedir(), ".cloudbase-mcp");
+const CACHE_META_FILE = path.join(CACHE_BASE_DIR, "cache-meta.json");
+const DEFAULT_CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 默认 24 小时
+// 支持环境变量 CLOUDBASE_MCP_CACHE_TTL_MS 控制缓存过期时间（毫秒）
+const parsedCacheTTL = process.env.CLOUDBASE_MCP_CACHE_TTL_MS
+    ? parseInt(process.env.CLOUDBASE_MCP_CACHE_TTL_MS, 10)
+    : NaN;
+const CACHE_TTL_MS = Number.isNaN(parsedCacheTTL) || parsedCacheTTL < 0
+    ? DEFAULT_CACHE_TTL_MS
+    : parsedCacheTTL;
+if (!Number.isNaN(parsedCacheTTL) && parsedCacheTTL >= 0) {
+    (0, logger_js_1.debug)("[cache] Using TTL from CLOUDBASE_MCP_CACHE_TTL_MS", {
+        ttlMs: CACHE_TTL_MS,
+    });
+}
+else {
+    (0, logger_js_1.debug)("[cache] Using default TTL", { ttlMs: CACHE_TTL_MS });
+}
+// 共享的下载 Promise，防止并发重复下载
+let resourceDownloadPromise = null;
+// 检查缓存是否可用（未过期）
+async function canUseCache() {
+    try {
+        const content = await fs.readFile(CACHE_META_FILE, "utf8");
+        const meta = JSON.parse(content);
+        if (!meta.timestamp) {
+            (0, logger_js_1.debug)("[cache] cache-meta missing timestamp, treating as invalid", {
+                ttlMs: CACHE_TTL_MS,
+            });
+            return false;
+        }
+        const ageMs = Date.now() - meta.timestamp;
+        const isValid = ageMs <= CACHE_TTL_MS;
+        (0, logger_js_1.debug)("[cache] evaluated cache meta", {
+            timestamp: meta.timestamp,
+            ageMs,
+            ttlMs: CACHE_TTL_MS,
+            valid: isValid,
+        });
+        return isValid;
+    }
+    catch (error) {
+        (0, logger_js_1.debug)("[cache] failed to read cache meta, treating as miss", { error });
+        return false;
+    }
+}
+// 更新缓存时间戳
+async function updateCache() {
+    await fs.mkdir(CACHE_BASE_DIR, { recursive: true });
+    await fs.writeFile(CACHE_META_FILE, JSON.stringify({ timestamp: Date.now() }, null, 2), "utf8");
+}
 // 安全 JSON.parse
 function safeParse(str) {
     try {
@@ -185378,31 +185429,141 @@ function safeStringify(obj) {
         return "";
     }
 }
-// Download and extract web template, return extract directory path
-// Always downloads and overwrites existing template
+// OpenAPI 文档 URL 列表
+const OPENAPI_SOURCES = [
+    {
+        name: "mysqldb",
+        description: "MySQL RESTful API - 云开发 MySQL 数据库 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/mysqldb.v1.openapi.yaml",
+    },
+    {
+        name: "functions",
+        description: "Cloud Functions API - 云函数 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/functions.v1.openapi.yaml",
+    },
+    {
+        name: "auth",
+        description: "Authentication API - 身份认证 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/auth.v1.openapi.yaml",
+    },
+    {
+        name: "cloudrun",
+        description: "CloudRun API - 云托管服务 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/cloudrun.v1.openapi.yaml",
+    },
+    {
+        name: "storage",
+        description: "Storage API - 云存储 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/storage.v1.openapi.yaml",
+    },
+];
 async function downloadWebTemplate() {
-    const baseDir = path.join(os.homedir(), ".cloudbase-mcp");
-    const zipPath = path.join(baseDir, "web-cloudbase-project.zip");
-    const extractDir = path.join(baseDir, "web-template");
+    const zipPath = path.join(CACHE_BASE_DIR, "web-cloudbase-project.zip");
+    const extractDir = path.join(CACHE_BASE_DIR, "web-template");
     const url = "https://static.cloudbase.net/cloudbase-examples/web-cloudbase-project.zip";
-    await fs.mkdir(baseDir, { recursive: true });
-    // Download zip to specified path (overwrite)
     const response = await fetch(url);
     if (!response.ok) {
         throw new Error(`下载模板失败，状态码: ${response.status}`);
     }
     const buffer = Buffer.from(await response.arrayBuffer());
     await fs.writeFile(zipPath, buffer);
-    // Clean and recreate extract directory
     await fs.rm(extractDir, { recursive: true, force: true });
     await fs.mkdir(extractDir, { recursive: true });
     const zip = new adm_zip_1.default(zipPath);
     zip.extractAllTo(extractDir, true);
+    (0, logger_js_1.debug)("[downloadResources] webTemplate 下载完成");
     return extractDir;
 }
-async function prepareKnowledgeBaseWebTemplate() {
-    const extractDir = await downloadWebTemplate();
-    return collectSkillDescriptions(path.join(extractDir, ".claude", "skills"));
+async function downloadOpenAPI() {
+    const baseDir = path.join(CACHE_BASE_DIR, "openapi");
+    await fs.mkdir(baseDir, { recursive: true });
+    const results = [];
+    await Promise.all(OPENAPI_SOURCES.map(async (source) => {
+        try {
+            const response = await fetch(source.url);
+            if (!response.ok) {
+                (0, logger_js_1.warn)(`[downloadOpenAPI] Failed to download ${source.name}`, {
+                    status: response.status,
+                });
+                return;
+            }
+            const content = await response.text();
+            const filePath = path.join(baseDir, `${source.name}.openapi.yaml`);
+            await fs.writeFile(filePath, content, "utf8");
+            results.push({
+                name: source.name,
+                description: source.description,
+                absolutePath: filePath,
+            });
+        }
+        catch (error) {
+            (0, logger_js_1.warn)(`[downloadOpenAPI] Failed to download ${source.name}`, {
+                error,
+            });
+        }
+    }));
+    (0, logger_js_1.debug)("[downloadOpenAPI] openAPIDocs 下载完成", {
+        successCount: results.length,
+        total: OPENAPI_SOURCES.length,
+    });
+    return results;
+}
+// 实际执行下载所有资源的函数（webTemplate 和 openAPI 并发下载）
+async function _doDownloadResources() {
+    // 并发下载 webTemplate 和 openAPIDocs
+    const [webTemplateDir, openAPIDocs] = await Promise.all([
+        // 下载 web 模板
+        downloadWebTemplate(),
+        // 并发下载所有 OpenAPI 文档
+        downloadOpenAPI(),
+    ]);
+    (0, logger_js_1.debug)("[downloadResources] 所有资源下载完成");
+    return { webTemplateDir, openAPIDocs };
+}
+// 下载所有资源（带缓存和共享 Promise 机制）
+async function downloadResources() {
+    const webTemplateDir = path.join(CACHE_BASE_DIR, "web-template");
+    const openAPIDir = path.join(CACHE_BASE_DIR, "openapi");
+    // 检查缓存是否有效
+    if (await canUseCache()) {
+        try {
+            // 检查两个目录都存在
+            await Promise.all([fs.access(webTemplateDir), fs.access(openAPIDir)]);
+            const files = await fs.readdir(openAPIDir);
+            if (files.length > 0) {
+                (0, logger_js_1.debug)("[downloadResources] 使用缓存");
+                return {
+                    webTemplateDir,
+                    openAPIDocs: OPENAPI_SOURCES.map((source) => ({
+                        name: source.name,
+                        description: source.description,
+                        absolutePath: path.join(openAPIDir, `${source.name}.openapi.yaml`),
+                    })).filter((item) => files.includes(`${item.name}.openapi.yaml`)),
+                };
+            }
+        }
+        catch {
+            // 缓存无效，需要重新下载
+        }
+    }
+    // 如果已有下载任务在进行中，共享该 Promise
+    if (resourceDownloadPromise) {
+        (0, logger_js_1.debug)("[downloadResources] 共享已有下载任务");
+        return resourceDownloadPromise;
+    }
+    // 创建新的下载任务
+    (0, logger_js_1.debug)("[downloadResources] 开始新下载任务");
+    await fs.mkdir(CACHE_BASE_DIR, { recursive: true });
+    resourceDownloadPromise = _doDownloadResources()
+        .then(async (result) => {
+        await updateCache();
+        (0, logger_js_1.debug)("[downloadResources] 缓存已更新");
+        return result;
+    })
+        .finally(() => {
+        resourceDownloadPromise = null;
+    });
+    return resourceDownloadPromise;
 }
 // Get CLAUDE.md prompt content
 // Priority: 1. From downloaded template, 2. Fallback to embedded constant
@@ -185526,23 +185687,15 @@ async function registerRagTools(server) {
             };
         }
     });
-    let skills = [];
     let openapis = [];
-    // 知识库检索
-    try {
-        skills = await prepareKnowledgeBaseWebTemplate();
-    }
-    catch (error) {
-        (0, logger_js_1.warn)("[searchKnowledgeBase] Failed to prepare web template", {
-            error,
-        });
-    }
-    // OpenAPI 文档准备
+    let skills = [];
     try {
-        openapis = await prepareOpenAPIDocs();
+        const { webTemplateDir, openAPIDocs } = await downloadResources();
+        openapis = openAPIDocs;
+        skills = await collectSkillDescriptions(path.join(webTemplateDir, ".claude", "skills"));
     }
     catch (error) {
-        (0, logger_js_1.warn)("[searchKnowledgeBase] Failed to prepare OpenAPI docs", {
+        (0, logger_js_1.warn)("[downloadResources] Failed to download resources", {
             error,
         });
     }
@@ -185709,65 +185862,6 @@ function extractDescriptionFromFrontMatter(content) {
         .match(/^(?:decsription|description)\s*:\s*(.*)$/m);
     return match ? match[1].trim() : null;
 }
-// OpenAPI 文档 URL 列表
-const OPENAPI_SOURCES = [
-    {
-        name: "mysqldb",
-        description: "MySQL RESTful API - 云开发 MySQL 数据库 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/mysqldb.v1.openapi.yaml",
-    },
-    {
-        name: "functions",
-        description: "Cloud Functions API - 云函数 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/functions.v1.openapi.yaml",
-    },
-    {
-        name: "auth",
-        description: "Authentication API - 身份认证 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/auth.v1.openapi.yaml",
-    },
-    {
-        name: "cloudrun",
-        description: "CloudRun API - 云托管服务 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/cloudrun.v1.openapi.yaml",
-    },
-    {
-        name: "storage",
-        description: "Storage API - 云存储 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/storage.v1.openapi.yaml",
-    },
-];
-// 下载并准备 OpenAPI 文档
-async function prepareOpenAPIDocs() {
-    const baseDir = path.join(os.homedir(), ".cloudbase-mcp", "openapi");
-    await fs.mkdir(baseDir, { recursive: true });
-    const results = [];
-    await Promise.all(OPENAPI_SOURCES.map(async (source) => {
-        try {
-            const response = await fetch(source.url);
-            if (!response.ok) {
-                (0, logger_js_1.warn)(`[prepareOpenAPIDocs] Failed to download ${source.name}`, {
-                    status: response.status,
-                });
-                return;
-            }
-            const content = await response.text();
-            const filePath = path.join(baseDir, `${source.name}.openapi.yaml`);
-            await fs.writeFile(filePath, content, "utf8");
-            results.push({
-                name: source.name,
-                description: source.description,
-                absolutePath: filePath,
-            });
-        }
-        catch (error) {
-            (0, logger_js_1.warn)(`[prepareOpenAPIDocs] Failed to download ${source.name}`, {
-                error,
-            });
-        }
-    }));
-    return results;
-}
 async function collectSkillDescriptions(rootDir) {
     const result = [];
     async function walk(dir) {
@@ -200605,7 +200699,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.3.0" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.3.1" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -215250,7 +215344,7 @@ function registerSetupTools(server) {
         title: "下载项目模板",
         description: `自动下载并部署CloudBase项目模板。⚠️ **MANDATORY FOR NEW PROJECTS** ⚠️
 
-**CRITICAL**: This tool MUST be called FIRST when starting a new project.\n\n支持的模板:\n- react: React + CloudBase 全栈应用模板\n- vue: Vue + CloudBase 全栈应用模板\n- miniprogram: 微信小程序 + 云开发模板  \n- uniapp: UniApp + CloudBase 跨端应用模板\n- rules: 只包含AI编辑器配置文件（包含Cursor、WindSurf、CodeBuddy等所有主流编辑器配置），适合在已有项目中补充AI编辑器配置\n\n支持的IDE类型:\n- all: 下载所有IDE配置（默认）\n- cursor: Cursor AI编辑器\n- windsurf: WindSurf AI编辑器\n- codebuddy: CodeBuddy AI编辑器\n- claude-code: Claude Code AI编辑器\n- cline: Cline AI编辑器\n- gemini-cli: Gemini CLI\n- opencode: OpenCode AI编辑器\n- qwen-code: 通义灵码\n- baidu-comate: 百度Comate\n- openai-codex-cli: OpenAI Codex CLI\n- augment-code: Augment Code\n- github-copilot: GitHub Copilot\n- roocode: RooCode AI编辑器\n- tongyi-lingma: 通义灵码\n- trae: Trae AI编辑器\n- qoder: Qoder AI编辑器\n- antigravity: Google Antigravity AI编辑器\n- vscode: Visual Studio Code\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.3.0" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
+**CRITICAL**: This tool MUST be called FIRST when starting a new project.\n\n支持的模板:\n- react: React + CloudBase 全栈应用模板\n- vue: Vue + CloudBase 全栈应用模板\n- miniprogram: 微信小程序 + 云开发模板  \n- uniapp: UniApp + CloudBase 跨端应用模板\n- rules: 只包含AI编辑器配置文件（包含Cursor、WindSurf、CodeBuddy等所有主流编辑器配置），适合在已有项目中补充AI编辑器配置\n\n支持的IDE类型:\n- all: 下载所有IDE配置（默认）\n- cursor: Cursor AI编辑器\n- windsurf: WindSurf AI编辑器\n- codebuddy: CodeBuddy AI编辑器\n- claude-code: Claude Code AI编辑器\n- cline: Cline AI编辑器\n- gemini-cli: Gemini CLI\n- opencode: OpenCode AI编辑器\n- qwen-code: 通义灵码\n- baidu-comate: 百度Comate\n- openai-codex-cli: OpenAI Codex CLI\n- augment-code: Augment Code\n- github-copilot: GitHub Copilot\n- roocode: RooCode AI编辑器\n- tongyi-lingma: 通义灵码\n- trae: Trae AI编辑器\n- qoder: Qoder AI编辑器\n- antigravity: Google Antigravity AI编辑器\n- vscode: Visual Studio Code\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.3.1" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])

package/dist/index.js

@@ -2525,7 +2525,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.downloadWebTemplate = downloadWebTemplate;
 exports.getClaudePrompt = getClaudePrompt;
 exports.registerRagTools = registerRagTools;
 const adm_zip_1 = __importDefault(__webpack_require__(872));
@@ -2543,6 +2542,58 @@ const KnowledgeBaseIdMap = {
     scf: "scfsczskzyws_4bdc",
     miniprogram: "xcxzskws_25d8",
 };
+// ============ 缓存配置 ============
+const CACHE_BASE_DIR = path.join(os.homedir(), ".cloudbase-mcp");
+const CACHE_META_FILE = path.join(CACHE_BASE_DIR, "cache-meta.json");
+const DEFAULT_CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 默认 24 小时
+// 支持环境变量 CLOUDBASE_MCP_CACHE_TTL_MS 控制缓存过期时间（毫秒）
+const parsedCacheTTL = process.env.CLOUDBASE_MCP_CACHE_TTL_MS
+    ? parseInt(process.env.CLOUDBASE_MCP_CACHE_TTL_MS, 10)
+    : NaN;
+const CACHE_TTL_MS = Number.isNaN(parsedCacheTTL) || parsedCacheTTL < 0
+    ? DEFAULT_CACHE_TTL_MS
+    : parsedCacheTTL;
+if (!Number.isNaN(parsedCacheTTL) && parsedCacheTTL >= 0) {
+    (0, logger_js_1.debug)("[cache] Using TTL from CLOUDBASE_MCP_CACHE_TTL_MS", {
+        ttlMs: CACHE_TTL_MS,
+    });
+}
+else {
+    (0, logger_js_1.debug)("[cache] Using default TTL", { ttlMs: CACHE_TTL_MS });
+}
+// 共享的下载 Promise，防止并发重复下载
+let resourceDownloadPromise = null;
+// 检查缓存是否可用（未过期）
+async function canUseCache() {
+    try {
+        const content = await fs.readFile(CACHE_META_FILE, "utf8");
+        const meta = JSON.parse(content);
+        if (!meta.timestamp) {
+            (0, logger_js_1.debug)("[cache] cache-meta missing timestamp, treating as invalid", {
+                ttlMs: CACHE_TTL_MS,
+            });
+            return false;
+        }
+        const ageMs = Date.now() - meta.timestamp;
+        const isValid = ageMs <= CACHE_TTL_MS;
+        (0, logger_js_1.debug)("[cache] evaluated cache meta", {
+            timestamp: meta.timestamp,
+            ageMs,
+            ttlMs: CACHE_TTL_MS,
+            valid: isValid,
+        });
+        return isValid;
+    }
+    catch (error) {
+        (0, logger_js_1.debug)("[cache] failed to read cache meta, treating as miss", { error });
+        return false;
+    }
+}
+// 更新缓存时间戳
+async function updateCache() {
+    await fs.mkdir(CACHE_BASE_DIR, { recursive: true });
+    await fs.writeFile(CACHE_META_FILE, JSON.stringify({ timestamp: Date.now() }, null, 2), "utf8");
+}
 // 安全 JSON.parse
 function safeParse(str) {
     try {
@@ -2569,31 +2620,141 @@ function safeStringify(obj) {
         return "";
     }
 }
-// Download and extract web template, return extract directory path
-// Always downloads and overwrites existing template
+// OpenAPI 文档 URL 列表
+const OPENAPI_SOURCES = [
+    {
+        name: "mysqldb",
+        description: "MySQL RESTful API - 云开发 MySQL 数据库 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/mysqldb.v1.openapi.yaml",
+    },
+    {
+        name: "functions",
+        description: "Cloud Functions API - 云函数 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/functions.v1.openapi.yaml",
+    },
+    {
+        name: "auth",
+        description: "Authentication API - 身份认证 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/auth.v1.openapi.yaml",
+    },
+    {
+        name: "cloudrun",
+        description: "CloudRun API - 云托管服务 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/cloudrun.v1.openapi.yaml",
+    },
+    {
+        name: "storage",
+        description: "Storage API - 云存储 HTTP API",
+        url: "https://docs.cloudbase.net/openapi/storage.v1.openapi.yaml",
+    },
+];
 async function downloadWebTemplate() {
-    const baseDir = path.join(os.homedir(), ".cloudbase-mcp");
-    const zipPath = path.join(baseDir, "web-cloudbase-project.zip");
-    const extractDir = path.join(baseDir, "web-template");
+    const zipPath = path.join(CACHE_BASE_DIR, "web-cloudbase-project.zip");
+    const extractDir = path.join(CACHE_BASE_DIR, "web-template");
     const url = "https://static.cloudbase.net/cloudbase-examples/web-cloudbase-project.zip";
-    await fs.mkdir(baseDir, { recursive: true });
-    // Download zip to specified path (overwrite)
     const response = await fetch(url);
     if (!response.ok) {
         throw new Error(`下载模板失败，状态码: ${response.status}`);
     }
     const buffer = Buffer.from(await response.arrayBuffer());
     await fs.writeFile(zipPath, buffer);
-    // Clean and recreate extract directory
     await fs.rm(extractDir, { recursive: true, force: true });
     await fs.mkdir(extractDir, { recursive: true });
     const zip = new adm_zip_1.default(zipPath);
     zip.extractAllTo(extractDir, true);
+    (0, logger_js_1.debug)("[downloadResources] webTemplate 下载完成");
     return extractDir;
 }
-async function prepareKnowledgeBaseWebTemplate() {
-    const extractDir = await downloadWebTemplate();
-    return collectSkillDescriptions(path.join(extractDir, ".claude", "skills"));
+async function downloadOpenAPI() {
+    const baseDir = path.join(CACHE_BASE_DIR, "openapi");
+    await fs.mkdir(baseDir, { recursive: true });
+    const results = [];
+    await Promise.all(OPENAPI_SOURCES.map(async (source) => {
+        try {
+            const response = await fetch(source.url);
+            if (!response.ok) {
+                (0, logger_js_1.warn)(`[downloadOpenAPI] Failed to download ${source.name}`, {
+                    status: response.status,
+                });
+                return;
+            }
+            const content = await response.text();
+            const filePath = path.join(baseDir, `${source.name}.openapi.yaml`);
+            await fs.writeFile(filePath, content, "utf8");
+            results.push({
+                name: source.name,
+                description: source.description,
+                absolutePath: filePath,
+            });
+        }
+        catch (error) {
+            (0, logger_js_1.warn)(`[downloadOpenAPI] Failed to download ${source.name}`, {
+                error,
+            });
+        }
+    }));
+    (0, logger_js_1.debug)("[downloadOpenAPI] openAPIDocs 下载完成", {
+        successCount: results.length,
+        total: OPENAPI_SOURCES.length,
+    });
+    return results;
+}
+// 实际执行下载所有资源的函数（webTemplate 和 openAPI 并发下载）
+async function _doDownloadResources() {
+    // 并发下载 webTemplate 和 openAPIDocs
+    const [webTemplateDir, openAPIDocs] = await Promise.all([
+        // 下载 web 模板
+        downloadWebTemplate(),
+        // 并发下载所有 OpenAPI 文档
+        downloadOpenAPI(),
+    ]);
+    (0, logger_js_1.debug)("[downloadResources] 所有资源下载完成");
+    return { webTemplateDir, openAPIDocs };
+}
+// 下载所有资源（带缓存和共享 Promise 机制）
+async function downloadResources() {
+    const webTemplateDir = path.join(CACHE_BASE_DIR, "web-template");
+    const openAPIDir = path.join(CACHE_BASE_DIR, "openapi");
+    // 检查缓存是否有效
+    if (await canUseCache()) {
+        try {
+            // 检查两个目录都存在
+            await Promise.all([fs.access(webTemplateDir), fs.access(openAPIDir)]);
+            const files = await fs.readdir(openAPIDir);
+            if (files.length > 0) {
+                (0, logger_js_1.debug)("[downloadResources] 使用缓存");
+                return {
+                    webTemplateDir,
+                    openAPIDocs: OPENAPI_SOURCES.map((source) => ({
+                        name: source.name,
+                        description: source.description,
+                        absolutePath: path.join(openAPIDir, `${source.name}.openapi.yaml`),
+                    })).filter((item) => files.includes(`${item.name}.openapi.yaml`)),
+                };
+            }
+        }
+        catch {
+            // 缓存无效，需要重新下载
+        }
+    }
+    // 如果已有下载任务在进行中，共享该 Promise
+    if (resourceDownloadPromise) {
+        (0, logger_js_1.debug)("[downloadResources] 共享已有下载任务");
+        return resourceDownloadPromise;
+    }
+    // 创建新的下载任务
+    (0, logger_js_1.debug)("[downloadResources] 开始新下载任务");
+    await fs.mkdir(CACHE_BASE_DIR, { recursive: true });
+    resourceDownloadPromise = _doDownloadResources()
+        .then(async (result) => {
+        await updateCache();
+        (0, logger_js_1.debug)("[downloadResources] 缓存已更新");
+        return result;
+    })
+        .finally(() => {
+        resourceDownloadPromise = null;
+    });
+    return resourceDownloadPromise;
 }
 // Get CLAUDE.md prompt content
 // Priority: 1. From downloaded template, 2. Fallback to embedded constant
@@ -2717,23 +2878,15 @@ async function registerRagTools(server) {
             };
         }
     });
-    let skills = [];
     let openapis = [];
-    // 知识库检索
-    try {
-        skills = await prepareKnowledgeBaseWebTemplate();
-    }
-    catch (error) {
-        (0, logger_js_1.warn)("[searchKnowledgeBase] Failed to prepare web template", {
-            error,
-        });
-    }
-    // OpenAPI 文档准备
+    let skills = [];
     try {
-        openapis = await prepareOpenAPIDocs();
+        const { webTemplateDir, openAPIDocs } = await downloadResources();
+        openapis = openAPIDocs;
+        skills = await collectSkillDescriptions(path.join(webTemplateDir, ".claude", "skills"));
     }
     catch (error) {
-        (0, logger_js_1.warn)("[searchKnowledgeBase] Failed to prepare OpenAPI docs", {
+        (0, logger_js_1.warn)("[downloadResources] Failed to download resources", {
             error,
         });
     }
@@ -2900,65 +3053,6 @@ function extractDescriptionFromFrontMatter(content) {
         .match(/^(?:decsription|description)\s*:\s*(.*)$/m);
     return match ? match[1].trim() : null;
 }
-// OpenAPI 文档 URL 列表
-const OPENAPI_SOURCES = [
-    {
-        name: "mysqldb",
-        description: "MySQL RESTful API - 云开发 MySQL 数据库 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/mysqldb.v1.openapi.yaml",
-    },
-    {
-        name: "functions",
-        description: "Cloud Functions API - 云函数 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/functions.v1.openapi.yaml",
-    },
-    {
-        name: "auth",
-        description: "Authentication API - 身份认证 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/auth.v1.openapi.yaml",
-    },
-    {
-        name: "cloudrun",
-        description: "CloudRun API - 云托管服务 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/cloudrun.v1.openapi.yaml",
-    },
-    {
-        name: "storage",
-        description: "Storage API - 云存储 HTTP API",
-        url: "https://docs.cloudbase.net/openapi/storage.v1.openapi.yaml",
-    },
-];
-// 下载并准备 OpenAPI 文档
-async function prepareOpenAPIDocs() {
-    const baseDir = path.join(os.homedir(), ".cloudbase-mcp", "openapi");
-    await fs.mkdir(baseDir, { recursive: true });
-    const results = [];
-    await Promise.all(OPENAPI_SOURCES.map(async (source) => {
-        try {
-            const response = await fetch(source.url);
-            if (!response.ok) {
-                (0, logger_js_1.warn)(`[prepareOpenAPIDocs] Failed to download ${source.name}`, {
-                    status: response.status,
-                });
-                return;
-            }
-            const content = await response.text();
-            const filePath = path.join(baseDir, `${source.name}.openapi.yaml`);
-            await fs.writeFile(filePath, content, "utf8");
-            results.push({
-                name: source.name,
-                description: source.description,
-                absolutePath: filePath,
-            });
-        }
-        catch (error) {
-            (0, logger_js_1.warn)(`[prepareOpenAPIDocs] Failed to download ${source.name}`, {
-                error,
-            });
-        }
-    }));
-    return results;
-}
 async function collectSkillDescriptions(rootDir) {
     const result = [];
     async function walk(dir) {
@@ -6224,7 +6318,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.3.0" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.3.1" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -7471,7 +7565,7 @@ function registerSetupTools(server) {
         title: "下载项目模板",
         description: `自动下载并部署CloudBase项目模板。⚠️ **MANDATORY FOR NEW PROJECTS** ⚠️
 
-**CRITICAL**: This tool MUST be called FIRST when starting a new project.\n\n支持的模板:\n- react: React + CloudBase 全栈应用模板\n- vue: Vue + CloudBase 全栈应用模板\n- miniprogram: 微信小程序 + 云开发模板  \n- uniapp: UniApp + CloudBase 跨端应用模板\n- rules: 只包含AI编辑器配置文件（包含Cursor、WindSurf、CodeBuddy等所有主流编辑器配置），适合在已有项目中补充AI编辑器配置\n\n支持的IDE类型:\n- all: 下载所有IDE配置（默认）\n- cursor: Cursor AI编辑器\n- windsurf: WindSurf AI编辑器\n- codebuddy: CodeBuddy AI编辑器\n- claude-code: Claude Code AI编辑器\n- cline: Cline AI编辑器\n- gemini-cli: Gemini CLI\n- opencode: OpenCode AI编辑器\n- qwen-code: 通义灵码\n- baidu-comate: 百度Comate\n- openai-codex-cli: OpenAI Codex CLI\n- augment-code: Augment Code\n- github-copilot: GitHub Copilot\n- roocode: RooCode AI编辑器\n- tongyi-lingma: 通义灵码\n- trae: Trae AI编辑器\n- qoder: Qoder AI编辑器\n- antigravity: Google Antigravity AI编辑器\n- vscode: Visual Studio Code\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.3.0" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
+**CRITICAL**: This tool MUST be called FIRST when starting a new project.\n\n支持的模板:\n- react: React + CloudBase 全栈应用模板\n- vue: Vue + CloudBase 全栈应用模板\n- miniprogram: 微信小程序 + 云开发模板  \n- uniapp: UniApp + CloudBase 跨端应用模板\n- rules: 只包含AI编辑器配置文件（包含Cursor、WindSurf、CodeBuddy等所有主流编辑器配置），适合在已有项目中补充AI编辑器配置\n\n支持的IDE类型:\n- all: 下载所有IDE配置（默认）\n- cursor: Cursor AI编辑器\n- windsurf: WindSurf AI编辑器\n- codebuddy: CodeBuddy AI编辑器\n- claude-code: Claude Code AI编辑器\n- cline: Cline AI编辑器\n- gemini-cli: Gemini CLI\n- opencode: OpenCode AI编辑器\n- qwen-code: 通义灵码\n- baidu-comate: 百度Comate\n- openai-codex-cli: OpenAI Codex CLI\n- augment-code: Augment Code\n- github-copilot: GitHub Copilot\n- roocode: RooCode AI编辑器\n- tongyi-lingma: 通义灵码\n- trae: Trae AI编辑器\n- qoder: Qoder AI编辑器\n- antigravity: Google Antigravity AI编辑器\n- vscode: Visual Studio Code\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.3.1" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])
@@ -8569,7 +8663,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.3.0" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.3.1" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudbase/cloudbase-mcp",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "腾讯云开发 MCP Server，通过AI提示词和MCP协议+云开发，让开发更智能、更高效,当你在Cursor/ VSCode GitHub Copilot/WinSurf/CodeBuddy/Augment Code/Claude Code等AI编程工具里写代码时，它能自动帮你生成可直接部署的前后端应用+小程序，并一键发布到腾讯云开发 CloudBase。",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",