@cloudbase/cloudbase-mcp 2.25.0 → 2.25.1

package/dist/index.cjs

@@ -90811,7 +90811,7 @@ function registerFunctionTools(server) {
                         raw: imageResult,
                     }, `已基于镜像 ${createImageConfig.imageUri} 创建 HTTP 函数 ${functionName}。` +
                         `请确认 TCR、SCF 与构建管道处于同一地域；如需通过 URL 访问，请显式调用 ` +
-                        `manageGateway(action="createRoute", type="HTTP") 并按需调整函数安全规则。` +
+                        `manageGateway(action="createRoute", upstreamResourceType="WEB_SCF") 并按需调整函数安全规则。` +
                         `部署后可用 queryFunctions(action="getFunctionDetail") 确认函数已就绪。`, [
                         {
                             tool: "queryFunctions",
@@ -90882,7 +90882,7 @@ function registerFunctionTools(server) {
                     nextActions.push({
                         tool: "manageGateway",
                         action: "createRoute",
-                        reason: "如果需要通过 URL 访问 HTTP 函数，请调用 manageGateway(action=\"createRoute\") 并显式传 type=\"HTTP\"（映射 WEB_SCF），再按实际路径和鉴权需求创建访问入口，不要默认假设 /函数名 已存在",
+                        reason: "如果需要通过 URL 访问 HTTP 函数，请调用 manageGateway(action=\"createRoute\") 并显式传 upstreamResourceType=\"WEB_SCF\"，再按实际路径和鉴权需求创建访问入口，不要默认假设 /函数名 已存在",
                     });
                     nextActions.push({
                         tool: "queryGateway",
@@ -90901,7 +90901,7 @@ function registerFunctionTools(server) {
                     });
                 }
                 const message = func.type === "HTTP"
-                    ? `已创建 HTTP 函数 ${functionName}。如果后续需要通过 URL 访问，请显式调用 manageGateway(action="createRoute")，并把 type="HTTP" 一起传入（映射 UpstreamResourceType=WEB_SCF），再按实际路径和鉴权需求创建访问入口。评测或其他外部调用方可能会以匿名身份访问，而且失败后不一定会把 EXCEED_AUTHORITY 再反馈给 AI；交付前请主动确认访问路径和函数安全规则，若已出现 EXCEED_AUTHORITY，请先调用 queryPermissions(action="getResourcePermission", resourceType="function", resourceId="${functionName}") 查看当前规则，再按需要使用 managePermissions(action="updateResourcePermission") 调整权限。`
+                    ? `已创建 HTTP 函数 ${functionName}。如果后续需要通过 URL 访问，请显式调用 manageGateway(action="createRoute")，并把 upstreamResourceType="WEB_SCF" 一起传入，再按实际路径和鉴权需求创建访问入口。评测或其他外部调用方可能会以匿名身份访问，而且失败后不一定会把 EXCEED_AUTHORITY 再反馈给 AI；交付前请主动确认访问路径和函数安全规则，若已出现 EXCEED_AUTHORITY，请先调用 queryPermissions(action="getResourcePermission", resourceType="function", resourceId="${functionName}") 查看当前规则，再按需要使用 managePermissions(action="updateResourcePermission") 调整权限。`
                     : `已创建函数 ${functionName}`;
                 return buildEnvelope({
                     action: input.action,
@@ -103680,7 +103680,6 @@ const capi_js_1 = __webpack_require__(40738);
 const cloudrun_js_1 = __webpack_require__(35023);
 const dataModel_js_1 = __webpack_require__(34052);
 const gateway_js_1 = __webpack_require__(84319);
-const invite_code_js_1 = __webpack_require__(44760);
 const agents_js_1 = __webpack_require__(9527);
 const app_auth_js_1 = __webpack_require__(5313);
 const apps_js_1 = __webpack_require__(36817);
@@ -103711,7 +103710,6 @@ const DEFAULT_PLUGINS = [
     "logs",
     "agents",
     "download",
-    "invite-code",
     "capi",
 ];
 function registerDatabase(server) {
@@ -103753,7 +103751,6 @@ const AVAILABLE_PLUGINS = {
     logs: { name: "logs", register: logs_js_1.registerLogTools },
     agents: { name: "agents", register: agents_js_1.registerAgentTools },
     apps: { name: "apps", register: apps_js_1.registerAppTools },
-    "invite-code": { name: "invite-code", register: invite_code_js_1.registerInviteCodeTools },
     cloudrun: { name: "cloudrun", register: cloudrun_js_1.registerCloudRunTools },
     capi: { name: "capi", register: capi_js_1.registerCapiTools },
 };
@@ -133297,71 +133294,6 @@ util.inherits(ArchiverError, Error);
 
 exports = module.exports = ArchiverError;
 
-/***/ }),
-
-/***/ 44760:
-/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
-
-"use strict";
-
-Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.registerInviteCodeTools = registerInviteCodeTools;
-const zod_1 = __webpack_require__(21614);
-const cloudbase_manager_js_1 = __webpack_require__(3431);
-function registerInviteCodeTools(server) {
-    const cloudBaseOptions = server.cloudBaseOptions;
-    const getManager = () => (0, cloudbase_manager_js_1.getCloudBaseManager)({ cloudBaseOptions });
-    server.registerTool?.("activateInviteCode", {
-        title: "激活邀请码",
-        description: "云开发 AI编程激励计划，通过邀请码激活用户激励。",
-        inputSchema: {
-            InviteCode: zod_1.z.string().describe("待激活的邀请码")
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: true,
-            category: "invite-code"
-        }
-    }, async ({ InviteCode }) => {
-        if (!InviteCode) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            ErrorCode: 'MissingParameter',
-                            ErrorMsg: '邀请码为必填项',
-                            RequestId: ''
-                        }, null, 2)
-                    }
-                ]
-            };
-        }
-        const manager = await getManager();
-        const EnvId = await (0, cloudbase_manager_js_1.getEnvId)(cloudBaseOptions);
-        const result = await manager.commonService().call({
-            Action: 'ActivateInviteCode',
-            Param: { InviteCode, EnvId }
-        });
-        (0, cloudbase_manager_js_1.logCloudBaseResult)(server.logger, result);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: JSON.stringify({
-                        ErrorCode: result?.ErrorCode || '',
-                        ErrorMsg: result?.ErrorMsg || '',
-                        RequestId: result?.RequestId || ''
-                    }, null, 2)
-                }
-            ]
-        };
-    });
-}
-
-
 /***/ }),
 
 /***/ 44763:
@@ -137273,7 +137205,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.25.0" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.25.1" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -197369,7 +197301,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.25.0" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.25.1" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -197450,7 +197382,7 @@ function createWrappedHandler(name, handler, server) {
                 requestId: (typeof error === 'object' && error && 'requestId' in error) ? error.requestId : '',
                 ide: server.ide || process.env.INTEGRATION_IDE || ''
             });
-            const mcpVersion =  true ? "2.25.0" : 0;
+            const mcpVersion =  true ? "2.25.1" : 0;
             const requestIdSuffix = requestId ? `\n🆔 RequestId: ${requestId}` : '';
             const enhancedErrorMessage = `${errorMessage}${requestIdSuffix}\n\n📦 CloudBase MCP v${mcpVersion}\n🔗 遇到问题？请复制以下链接到浏览器打开\n即可自动携带错误详情快速创建 GitHub Issue：\n${issueLink}`;
             // 创建新的错误对象，保持原有的错误类型但更新消息
@@ -214038,7 +213970,7 @@ function registerSetupTools(server) {
     server.registerTool("downloadTemplate", {
         title: "下载项目模板",
         description: `自动下载并部署CloudBase项目模板。
-**Note**: Call this tool when the user requests to create a new project using a CloudBase template.\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- 其他IDE类型见下方列表\n\n注意：如果未传入 ide 参数且无法从环境变量检测到 IDE，将提示错误并要求传入 ide 参数\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- kiro: Kiro AI编辑器\n- aider: Aider AI编辑器\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.25.0" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
+**Note**: Call this tool when the user requests to create a new project using a CloudBase template.\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- 其他IDE类型见下方列表\n\n注意：如果未传入 ide 参数且无法从环境变量检测到 IDE，将提示错误并要求传入 ide 参数\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- kiro: Kiro AI编辑器\n- aider: Aider AI编辑器\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.25.1" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])
@@ -231232,36 +231164,24 @@ function registerGatewayTools(server) {
         }
         return resolveDefaultHttpDomain();
     };
-    const mapUpstreamResourceType = (input) => {
-        if (input.upstreamResourceType) {
-            return input.upstreamResourceType;
-        }
-        if (input.type === "HTTP") {
-            return "WEB_SCF";
-        }
-        if (input.type === "Event") {
-            return "SCF";
-        }
-        if (input.requiresFunctionType || input.targetType === "function") {
-            throw new Error("为云函数创建/更新路由时必须显式提供 type（HTTP→WEB_SCF，Event→SCF）或 route.upstreamResourceType。省略会导致 HTTP 与 Event 函数互相误标，访问时可能返回 FUNCTION_PARAM_INVALID 或网关内部错误。");
-        }
-        throw new Error("必须提供 route.upstreamResourceType（SCF / WEB_SCF / CBR / STATIC_STORE / LH），或在函数场景提供 type=\"HTTP\"|\"Event\"。");
+    const resolveUpstreamResourceType = (input) => {
+        const resolved = input.routeUpstreamResourceType ?? input.upstreamResourceType;
+        if (resolved) {
+            return resolved;
+        }
+        throw new Error("必须提供 upstreamResourceType（或 route.upstreamResourceType）：" +
+            "WEB_SCF=HTTP云函数，SCF=Event云函数，CBR=云托管，STATIC_STORE=静态托管，LH=轻量应用服务器。" +
+            "禁止仅凭 targetName/serviceName 推断上游类型。");
     };
     const normalizeRoutePayload = async (input) => {
         const upstreamResourceName = input.route?.serviceName ?? input.targetName;
         if (!upstreamResourceName) {
-            throw new Error("必须提供 targetName 或 route.serviceName 作为上游资源名称（例如云函数名）");
-        }
-        const isFunctionRoute = input.targetType === "function" ||
-            input.type !== undefined ||
-            input.route?.upstreamResourceType === "SCF" ||
-            input.route?.upstreamResourceType === "WEB_SCF" ||
-            (!input.route?.upstreamResourceType && Boolean(input.targetName));
-        const upstreamResourceType = mapUpstreamResourceType({
-            type: input.type,
-            targetType: input.targetType,
-            upstreamResourceType: input.route?.upstreamResourceType,
-            requiresFunctionType: isFunctionRoute,
+            throw new Error("必须提供 targetName 或 route.serviceName 作为上游资源名称：" +
+                "云函数名、云托管服务名，或静态托管实例名（常见为 staticstore）。");
+        }
+        const upstreamResourceType = resolveUpstreamResourceType({
+            upstreamResourceType: input.upstreamResourceType,
+            routeUpstreamResourceType: input.route?.upstreamResourceType,
         });
         const path = normalizeAccessPath(input.route?.path ?? input.path ?? `/${upstreamResourceName}`);
         const domain = await resolveRouteDomain(input.domain);
@@ -231270,18 +231190,25 @@ function registerGatewayTools(server) {
             : input.auth !== undefined
                 ? input.auth
                 : undefined;
+        const enablePathTransmission = input.route?.enablePathTransmission !== undefined
+            ? input.route.enablePathTransmission
+            : input.enablePathTransmission !== undefined
+                ? input.enablePathTransmission
+                : undefined;
+        const route = {
+            Path: path,
+            UpstreamResourceType: upstreamResourceType,
+            UpstreamResourceName: upstreamResourceName,
+            EnableAuth: enableAuth,
+        };
+        if (enablePathTransmission !== undefined) {
+            route.EnablePathTransmission = enablePathTransmission;
+        }
         return {
             EnvId: await resolveEnvId(),
             Domain: {
                 Domain: domain,
-                Routes: [
-                    {
-                        Path: path,
-                        UpstreamResourceType: upstreamResourceType,
-                        UpstreamResourceName: upstreamResourceName,
-                        EnableAuth: enableAuth,
-                    },
-                ],
+                Routes: [route],
             },
             resolved: {
                 domain,
@@ -231289,6 +231216,7 @@ function registerGatewayTools(server) {
                 upstreamResourceType,
                 upstreamResourceName,
                 enableAuth,
+                enablePathTransmission,
             },
         };
     };
@@ -231402,9 +231330,10 @@ function registerGatewayTools(server) {
                     const message = err instanceof Error ? err.message : String(err);
                     if (message.includes("An error has occurred")) {
                         let hint = "为目标资源配置访问路由失败（后端内部错误）。请确保：1) 目标云函数已成功创建并处于 Active 状态；2) 环境默认 HTTP 域名已完成初始化（IsDefault）；3) 该访问路径未被占用。";
-                        if (input.type === "HTTP") {
+                        if (payload.resolved.upstreamResourceType === "WEB_SCF" ||
+                            payload.resolved.upstreamResourceType === "SCF") {
                             hint +=
-                                "此外注意：如果目标函数最初是作为 Event 函数创建的，这里 type 仍必须传 Event（UpstreamResourceType=SCF）；误传 HTTP/WEB_SCF 会导致此错误。";
+                                "此外注意：HTTP 云函数必须用 upstreamResourceType=WEB_SCF，Event 云函数必须用 SCF；互标会导致此错误。";
                         }
                         throw new Error(`${hint} 原始错误：${message}`);
                     }
@@ -231414,15 +231343,21 @@ function registerGatewayTools(server) {
                 return buildEnvelope({
                     action: input.action,
                     model: "httpServiceRoute",
-                    targetType: input.targetType ?? null,
                     targetName: payload.resolved.upstreamResourceName,
                     domain: payload.resolved.domain,
                     path: payload.resolved.path,
                     upstreamResourceType: payload.resolved.upstreamResourceType,
                     upstreamResourceName: payload.resolved.upstreamResourceName,
                     auth: payload.resolved.enableAuth ?? null,
+                    enablePathTransmission: payload.resolved.enablePathTransmission ?? null,
                     raw: result,
-                }, `已为目标 ${payload.resolved.upstreamResourceName} 在域名 ${payload.resolved.domain} 创建路由 ${payload.resolved.path}（${payload.resolved.upstreamResourceType}）。注意：路由配置传播通常需要等待 30 秒到 3 分钟，请勿立即访问。该操作只创建网关入口，不会自动放开函数安全规则；若需要匿名或浏览器直接访问，请继续检查函数资源权限。`, routeMutationNextActions(payload.resolved.upstreamResourceName));
+                }, `已为目标 ${payload.resolved.upstreamResourceName} 在域名 ${payload.resolved.domain} 创建路由 ${payload.resolved.path}（${payload.resolved.upstreamResourceType}）` +
+                    (payload.resolved.enablePathTransmission === true
+                        ? "；已开启路径透传（后端收到完整请求路径）"
+                        : payload.resolved.enablePathTransmission === false
+                            ? "；路径透传关闭（网关会剥掉触发路径前缀后再转发给后端）"
+                            : "；路径透传未显式设置（平台默认 false，会剥掉触发路径前缀）") +
+                    `。注意：路由配置传播通常需要等待 30 秒到 3 分钟，请勿立即访问。该操作只创建网关入口，不会自动放开上游权限；若上游是云函数且需要匿名或浏览器直接访问，请继续检查函数资源权限。`, routeMutationNextActions(payload.resolved.upstreamResourceName));
             }
             case "updateRoute": {
                 const cloudbase = await getManager();
@@ -231440,8 +231375,15 @@ function registerGatewayTools(server) {
                     upstreamResourceType: payload.resolved.upstreamResourceType,
                     upstreamResourceName: payload.resolved.upstreamResourceName,
                     auth: payload.resolved.enableAuth ?? null,
+                    enablePathTransmission: payload.resolved.enablePathTransmission ?? null,
                     raw: result,
-                }, `HTTP 路由更新成功（${payload.resolved.domain}${payload.resolved.path}）`, routeMutationNextActions(payload.resolved.upstreamResourceName));
+                }, `HTTP 路由更新成功（${payload.resolved.domain}${payload.resolved.path}` +
+                    (payload.resolved.enablePathTransmission === true
+                        ? "，路径透传=开启"
+                        : payload.resolved.enablePathTransmission === false
+                            ? "，路径透传=关闭"
+                            : "") +
+                    `）`, routeMutationNextActions(payload.resolved.upstreamResourceName));
             }
             case "deleteRoute": {
                 const routePath = input.route?.path ?? input.path;
@@ -231507,19 +231449,17 @@ function registerGatewayTools(server) {
     };
     server.registerTool?.("queryGateway", {
         title: "查询 CloudBase 网关",
-        description: "CloudBase 网关统一只读入口（Domain/Route 模型）。通过 listRoutes / getRoute / listCustomDomains 查询域名与路由；主键为 Domain + Path，上游类型为 SCF / WEB_SCF / CBR / STATIC_STORE / LH。",
+        description: "CloudBase HTTP 网关统一只读入口（Domain/Route）。查询域名下路径路由及其上游：" +
+            "WEB_SCF/SCF=云函数，CBR=云托管，STATIC_STORE=静态托管，LH=轻量应用服务器。" +
+            "主键为 Domain + Path；listRoutes / getRoute / listCustomDomains。",
         inputSchema: {
             action: zod_1.z
                 .enum(QUERY_GATEWAY_ACTIONS)
                 .describe("只读操作类型：listRoutes、getRoute、listCustomDomains"),
-            targetType: zod_1.z
-                .enum(["function"])
-                .optional()
-                .describe("目标资源类型。当前支持 function"),
             targetName: zod_1.z
                 .string()
                 .optional()
-                .describe("上游资源名称。getRoute 时可按云函数名过滤"),
+                .describe("上游资源名过滤（UpstreamResourceName）：云函数名、云托管服务名，或静态托管实例名（常见 staticstore）。"),
             routeId: zod_1.z.string().optional().describe("路由 ID。getRoute 时可选"),
             path: zod_1.z
                 .string()
@@ -231538,40 +231478,68 @@ function registerGatewayTools(server) {
     }, async (input) => withEnvelope(() => handleQueryGateway(input)));
     server.registerTool?.("manageGateway", {
         title: "管理 CloudBase 网关",
-        description: "CloudBase 网关统一写入口（Domain/Route 模型）。为已存在的 HTTP 云函数补默认域名访问时，使用 createRoute，并提供 targetType=\"function\"、targetName、type=\"HTTP\"（映射 WEB_SCF）与期望 path；Event 函数传 type=\"Event\"（映射 SCF）。未传 domain 时自动解析 IsDefault 默认域名。注意 createRoute 只创建网关入口，不会自动修改函数资源权限。更新鉴权用 updateRoute；删除用 deleteRoute（Domain+Path）。⚠️ 绑定带 SSL 证书的自定义域名用 bindCustomDomain；CORS/安全域名请使用 envDomainManagement。",
+        description: "CloudBase HTTP 网关统一写入口（Domain/Route）。createRoute/updateRoute/deleteRoute 把域名下的 path 转到上游；未传 domain 时用 IsDefault 默认域名。" +
+            "上游类型只用一个参数 upstreamResourceType（也可写在 route.upstreamResourceType，route 优先）：" +
+            "WEB_SCF=HTTP云函数，SCF=Event云函数，CBR=云托管，STATIC_STORE=静态托管，LH=轻量应用服务器；" +
+            "配合 targetName 或 route.serviceName（云函数名/云托管服务名/静态托管实例名，常见 staticstore）。" +
+            "createRoute 只建网关入口，不改上游权限。" +
+            "enablePathTransmission：默认 false 剥触发路径前缀；true 透传完整路径（CBR 多路由、WEB_SCF 自管子路径常需 true；STATIC_STORE 自定义触发路径映射站点根通常 false）。" +
+            "⚠️ SSL 自定义域名用 bindCustomDomain；CORS/安全域名用 envDomainManagement。",
         inputSchema: {
             action: zod_1.z
                 .enum(MANAGE_GATEWAY_ACTIONS)
-                .describe("写操作类型。为已有函数补默认域名访问入口时使用 createRoute；函数场景必须显式提供 type（HTTP→WEB_SCF，Event→SCF）或 route.upstreamResourceType。"),
-            targetType: zod_1.z
-                .enum(["function"])
-                .optional()
-                .describe("目标资源类型。当前支持 function"),
+                .describe("写操作：createRoute/updateRoute/deleteRoute 管理路由；bindCustomDomain/deleteCustomDomain 管理自定义域名。" +
+                "createRoute/updateRoute 必须提供 upstreamResourceType。"),
             targetName: zod_1.z
                 .string()
                 .optional()
-                .describe("目标资源名称。createRoute 到云函数时填写函数名"),
+                .describe("上游资源名称（UpstreamResourceName），与 route.serviceName 二选一（route 优先）。" +
+                "云函数=函数名；云托管=服务名；静态托管=实例名（常见 staticstore）。不会自动推断上游类型。"),
             path: zod_1.z
                 .string()
                 .optional()
-                .describe("访问路径，默认 /{targetName}。例如为 HTTP 函数暴露 /api/hello 时传 /api/hello。该参数只创建网关入口，不会自动放开函数资源权限。"),
-            type: zod_1.z
-                .enum(["Event", "HTTP"])
+                .describe("触发路径（网关匹配前缀），默认 /{上游名}。例：云函数 /api/hello、云托管 /api、静态托管 / 或 /app。" +
+                "只建网关入口；与 enablePathTransmission 共同决定上游实际收到的路径。"),
+            upstreamResourceType: zod_1.z
+                .enum(UPSTREAM_RESOURCE_TYPES)
                 .optional()
-                .describe("目标函数运行时类型，不是接入协议。HTTP 云函数传 HTTP（UpstreamResourceType=WEB_SCF）；Event 函数传 Event（SCF）。误标会导致 FUNCTION_PARAM_INVALID 或网关错误。函数路由场景必须显式提供 type 或 route.upstreamResourceType。"),
+                .describe("上游类型（与 route.upstreamResourceType 二选一，route 优先）。" +
+                "WEB_SCF=HTTP云函数，SCF=Event云函数，CBR=云托管，STATIC_STORE=静态托管，LH=轻量应用服务器。" +
+                "createRoute/updateRoute 必填其一；勿把 manageFunctions 的 type=HTTP|Event 传到本字段。"),
             auth: zod_1.z
                 .boolean()
                 .optional()
-                .describe("是否开启网关路径鉴权（EnableAuth）。若要走默认域名做匿名或浏览器访问，通常设为 false；该开关仅控制网关入口本身，不会修改函数资源权限。"),
+                .describe("网关路径鉴权（EnableAuth）。匿名/浏览器公网访问通常 false。" +
+                "只控制网关入口；云函数安全规则、云托管鉴权、静态托管权限需各自工具另行配置。"),
+            enablePathTransmission: zod_1.z
+                .boolean()
+                .optional()
+                .describe("路径透传（EnablePathTransmission），平台默认 false。例 path=/api 且请求 /api/users：" +
+                "false→上游收到 /users；true→上游收到 /api/users。" +
+                "CBR 云托管（Express 等自管子路由）与 WEB_SCF 多路径函数常需 true；" +
+                "STATIC_STORE 把触发路径映射到站点根目录（如 /app → 托管 /）时通常 false；" +
+                "单入口/根路径处理保持 false。也可用 route.enablePathTransmission（route 优先）。"),
             route: zod_1.z
                 .object({
                 path: zod_1.z.string().optional(),
-                serviceName: zod_1.z.string().optional(),
-                upstreamResourceType: zod_1.z.enum(UPSTREAM_RESOURCE_TYPES).optional(),
+                serviceName: zod_1.z
+                    .string()
+                    .optional()
+                    .describe("上游实例名：云函数名 / 云托管服务名 / 静态托管实例名（常见 staticstore）/ LH 实例。优先于顶层 targetName。"),
+                upstreamResourceType: zod_1.z
+                    .enum(UPSTREAM_RESOURCE_TYPES)
+                    .optional()
+                    .describe("同顶层 upstreamResourceType。route 内设置时优先于顶层。"),
                 auth: zod_1.z.boolean().optional(),
+                enablePathTransmission: zod_1.z
+                    .boolean()
+                    .optional()
+                    .describe("同顶层 enablePathTransmission。route 内设置时优先于顶层。"),
             })
                 .optional()
-                .describe("HTTP 路由配置。upstreamResourceType 可选 SCF / WEB_SCF / CBR / STATIC_STORE / LH"),
+                .describe("路由对象（可选写法）。例：云函数 {upstreamResourceType:\"WEB_SCF\",serviceName:\"fn\",path:\"/api\"}；" +
+                "云托管 {upstreamResourceType:\"CBR\",serviceName:\"svc\",path:\"/api\"}；" +
+                "静态托管 {upstreamResourceType:\"STATIC_STORE\",serviceName:\"staticstore\",path:\"/\"}。"),
             domain: zod_1.z
                 .string()
                 .optional()