@cloudbase/cloudbase-mcp 2.32.0 → 2.32.2

package/dist/index.cjs

@@ -72571,6 +72571,8 @@ exports.QbaseError = exports.MSG_TYPES = exports.XPAY_EVENT_TYPES = void 0;
 exports.mergeSubscribeList = mergeSubscribeList;
 exports.mergeUnsubscribeList = mergeUnsubscribeList;
 exports.mergeSetEnableList = mergeSetEnableList;
+exports.resolvePushMode = resolvePushMode;
+exports.pickContainerConfigPublic = pickContainerConfigPublic;
 exports.registerMsgPushTools = registerMsgPushTools;
 const zod_1 = __webpack_require__(7552);
 const tool_result_js_1 = __webpack_require__(9835);
@@ -72857,6 +72859,25 @@ async function uploadCallbackConfig(server, appid, state) {
         throw new QbaseError(ret, `uploadappconfig 失败(ret=${ret}): ${errmsg || "未知错误"}。请重新查询最新配置后重试。`);
     }
 }
+function resolvePushMode(container) {
+    return container?.qbase_open === true ? "container" : "cloudfunction";
+}
+/** Public subset of container callback fields returned to agents */
+function pickContainerConfigPublic(container) {
+    if (!container)
+        return undefined;
+    return {
+        qbase_open: container.qbase_open === true,
+        qbase_container_path: typeof container.qbase_container_path === "string"
+            ? container.qbase_container_path
+            : undefined,
+        qbase_env: typeof container.qbase_env === "string" ? container.qbase_env : undefined,
+        text_mode: typeof container.text_mode === "number" ? container.text_mode : undefined,
+    };
+}
+const CONTAINER_MODE_BLOCK_NOTE = "当前为云托管模式（整包接收），云函数 callbacks 存在但不生效；如需云函数模式请调 ensureCloudFunctionMode 切换";
+const CONTAINER_MODE_WRITE_ERROR = "当前 pushMode=container（云托管整包接收），云函数回调配置存在但不生效。" +
+    "如需云函数模式请调 action=ensureCloudFunctionMode 切换。";
 /** 读取云托管消息推送配置；无配置（云函数模式）返回 null */
 async function readContainerConfig(server, appid) {
     const resp = await callQbase(server, appid, "getContainerCallbackConfig", {});
@@ -72877,6 +72898,55 @@ async function setContainerConfig(server, appid, cfg) {
         throw new QbaseError(ret, `setcontainercallbackconfig 失败(ret=${ret}): ${resp.base_resp?.errmsg ?? "未知错误"}`);
     }
 }
+function buildContainerModeBlockedPayload(action) {
+    return (0, tool_result_js_1.buildJsonToolResult)({
+        ok: false,
+        code: "CONTAINER_MODE_ACTIVE",
+        pushMode: "container",
+        message: CONTAINER_MODE_WRITE_ERROR,
+        next_step: {
+            tool: "manageMessagePush",
+            action: "ensureCloudFunctionMode",
+            required_params: ["appid", "env_id", "function_name", "confirm"],
+            hint: `先切换到云函数模式后再执行 ${action}`,
+        },
+    });
+}
+/**
+ * Verify function_name exists in envId via optional host hook or CloudBase Manager list.
+ * Returns an error tool result when missing / unreadable; null when OK.
+ */
+async function assertCloudFunctionExists(server, envId, functionName) {
+    const override = server.pluginOptions?.msgPush?.listCloudFunctions;
+    // 兼容性降级：host 未提供 listCloudFunctions hook（如微信 IDE 无腾讯云凭据）时
+    // 跳过存在性校验，保持原有 subscribe 行为（写配置不阻断）；仅 host 显式启用时校验。
+    if (!override) {
+        return null;
+    }
+    let names;
+    try {
+        names = await override(envId);
+    }
+    catch (e) {
+        // hook 本身失败（如网络/权限）时降级放行，不阻断订阅
+        return null;
+    }
+    if (!names.includes(functionName)) {
+        return (0, tool_result_js_1.buildJsonToolResult)({
+            ok: false,
+            code: "FUNCTION_NOT_FOUND",
+            message: `云函数 ${functionName} 不存在于环境 ${envId}，请先创建或修正参数`,
+            envId,
+            function_name: functionName,
+            next_step: {
+                tool: "manageFunctions",
+                action: "createFunction",
+                required_params: ["functionName"],
+            },
+        });
+    }
+    return null;
+}
 function buildTransportUnavailablePayload(toolName, action) {
     return (0, tool_result_js_1.buildJsonToolResult)({
         ok: false,
@@ -72945,11 +73015,11 @@ function registerMsgPushTools(server) {
     server.registerTool?.("queryMessagePush", {
         title: "查询小程序消息推送配置",
         description: "查询小程序云开发消息推送配置（qbase getappconfig）或全部合法消息推送事件约束（getcallbacksupportlist）。" +
-            "消息推送把小程序事件/消息（含虚拟支付回调、text/image 等消息类型）送到云函数，无需自建服务器。" +
-            "action=list 返回当前配置列表（msgType/event/env/functionName/enable）与 version（乐观锁版本号）；" +
-            "action=listSupportedEvents 返回全部合法约束（按消息类型分组：event 组含事件名列表；text/image/voice/video/miniprogrampage 组 events 为空数组），" +
-            "事件类用 manageMessagePush(event_types=...)，消息类型用 manageMessagePush(msg_type=...)。" +
-            "需要微信 IDE 登录态通道（宿主注入 cloudBaseOptions.requestFn），独立 CloudBase MCP 运行会返回指引错误。",
+            "推送模式有两种：云函数（默认，按 (msgType,event) 逐条回调）与云托管（qbase_open=true，整包接收所有消息到容器 path）。" +
+            "action=list 同时返回 pushMode（cloudfunction|container）、containerConfig、callbacks 与 version；" +
+            "云托管模式下 callbacks 可能仍存在但不生效（见 note），需 ensureCloudFunctionMode 切回云函数模式后才会按回调推送。" +
+            "action=listSupportedEvents 返回全部合法约束（按消息类型分组）。" +
+            "需要微信 IDE 登录态通道（宿主注入 cloudBaseOptions.requestFn）。",
         inputSchema: {
             appid: zod_1.z
                 .string()
@@ -72957,7 +73027,7 @@ function registerMsgPushTools(server) {
             env: zod_1.z.string().optional().describe("可选：环境 ID；传入时 list 仅返回该环境的订阅条目"),
             action: zod_1.z
                 .enum(["list", "listSupportedEvents"])
-                .describe("list: 查询当前消息推送配置列表\nlistSupportedEvents: 查询全部合法消息推送事件约束（按 msgType 分组）"),
+                .describe("list: 查询当前消息推送配置列表（含 pushMode/containerConfig）\nlistSupportedEvents: 查询全部合法消息推送事件约束（按 msgType 分组）"),
         },
         annotations: {
             readOnlyHint: true,
@@ -72969,7 +73039,17 @@ function registerMsgPushTools(server) {
             return buildTransportUnavailablePayload("queryMessagePush", action);
         }
         if (action === "list") {
-            const state = await readCallbackConfig(server, appid);
+            const [state, containerRaw] = await Promise.all([
+                readCallbackConfig(server, appid),
+                // 兼容性降级：微信侧 apihttpagent 通道不支持 getcontainercallbackconfig
+                // （ret=-9991）时，容器配置读取失败不阻断 list（pushMode 默认 cloudfunction）
+                readContainerConfig(server, appid).catch((e) => {
+                    console.warn(`[msg-push] 读取云托管容器配置失败，降级为云函数模式推断: ${e instanceof Error ? e.message : String(e)}`);
+                    return null;
+                }),
+            ]);
+            const container = containerRaw;
+            const pushMode = resolvePushMode(container);
             const callbacks = env
                 ? state.list.filter((c) => c.env === env)
                 : state.list;
@@ -72979,12 +73059,22 @@ function registerMsgPushTools(server) {
                 message: "查询消息推送配置成功",
                 version: state.version,
                 enable: state.enable,
+                pushMode,
+                containerConfig: pickContainerConfigPublic(container),
                 callbacks,
+                note: pushMode === "container" ? CONTAINER_MODE_BLOCK_NOTE : undefined,
                 filteredByEnv: env ?? undefined,
-                next_steps: [
-                    "manageMessagePush(action=subscribe) 订阅事件（缺省 event_types 时默认订阅虚拟支付 7 事件）",
-                    "queryMessagePush(action=listSupportedEvents) 查看全部合法事件",
-                ],
+                next_steps: pushMode === "container"
+                    ? [
+                        "当前为云托管模式：云函数 subscribe/unsubscribe/setEnable 会被拒绝",
+                        "manageMessagePush(action=ensureCloudFunctionMode) 切回云函数模式",
+                        "manageMessagePush(action=setContainerCallback) 更新云托管 path/env/text_mode",
+                    ]
+                    : [
+                        "manageMessagePush(action=subscribe) 订阅事件（缺省 event_types 时默认订阅虚拟支付 7 事件）",
+                        "manageMessagePush(action=ensureContainerMode) 切换到云托管整包接收",
+                        "queryMessagePush(action=listSupportedEvents) 查看全部合法事件",
+                    ],
             });
         }
         if (action === "listSupportedEvents") {
@@ -73029,29 +73119,38 @@ function registerMsgPushTools(server) {
     server.registerTool?.("manageMessagePush", {
         title: "管理小程序消息推送配置",
         description: "管理小程序云开发消息推送配置（写操作，需 confirm=\"yes\" 确认）。" +
-            "基于「读全量 → merge → 全量覆盖（带 version 乐观锁）」实现声明式幂等（对齐 kubectl apply：event_types 是期望集合，重复执行收敛到同一状态；" +
-            "version 冲突即 RFC 7232 If-Match 412，返回可重试错误：重读 → merge → 重试）。" +
-            "msg_type 区分两类条目（缺省 \"event\"，向后兼容）：" +
-            "msg_type=\"event\" 操作事件类（需 event_types；subscribe 缺省时默认虚拟支付 7 个 xpay_* 事件）；" +
-            "msg_type=\"text\"|\"image\"|\"voice\"|\"video\"|\"miniprogrampage\" 操作消息类型条目（event 固定空串，勿传 event_types）。" +
-            "action=subscribe 订阅到指定云函数；同一 (msgType,event) 只能推到一个云函数（一事一函数），已绑定其他函数会自动重绑并说明。" +
-            "action=unsubscribe 移除匹配订阅（msg_type=event 时 event_types 必填；消息类型时按 msg_type 移除）。" +
-            "action=setEnable 启用/停用匹配订阅（msg_type=event 时 event_types + enable 必填；消息类型时 msg_type + enable）。" +
-            "action=ensureCloudFunctionMode 确保推送模式为云函数（若为云托管整包接收则切换 qbase_open=false，需确认）。" +
-            "集合无变化时不发起写请求（幂等 no-op，无需确认）。" +
-            "需要微信 IDE 登录态通道（宿主注入 cloudBaseOptions.requestFn）。",
+            "推送模式：云函数（默认，按 (msgType,event) 回调）vs 云托管（整包接收；云托管模式下 subscribe/unsubscribe/setEnable 会被拒绝，先 ensureCloudFunctionMode）。" +
+            "基于「读全量 → merge → 全量覆盖（带 version 乐观锁）」实现声明式幂等。" +
+            "msg_type 缺省 \"event\"；消息类型用 msg_type=text|image|voice|video|miniprogrampage。" +
+            "action=subscribe 前会校验 function_name 在环境中真实存在。" +
+            "action=ensureCloudFunctionMode 关闭云托管整包接收；action=ensureContainerMode 开启云托管（需 qbase_container_path/qbase_env/text_mode）；" +
+            "action=setContainerCallback 更新云托管 path/env/text_mode。" +
+            "集合无变化时不发起写请求（幂等 no-op）。需要微信 IDE 登录态通道。",
         inputSchema: {
             appid: zod_1.z
                 .string()
                 .describe("小程序 AppID（必填，与微信开发者工具一致；用于选择微信登录态会话）"),
-            env_id: zod_1.z.string().describe("环境 ID（订阅条目绑定的云开发环境）"),
-            function_name: zod_1.z.string().describe("接收消息推送的云函数名"),
+            env_id: zod_1.z
+                .string()
+                .describe("环境 ID（云函数订阅绑定的云开发环境；ensureContainerMode/setContainerCallback 未传 qbase_env 时也可作为云托管环境默认值）"),
+            function_name: zod_1.z
+                .string()
+                .describe("接收消息推送的云函数名（subscribe/unsubscribe/setEnable/ensureCloudFunctionMode 使用；云托管相关 action 可传占位）"),
             action: zod_1.z
-                .enum(["subscribe", "unsubscribe", "setEnable", "ensureCloudFunctionMode"])
-                .describe("subscribe: 订阅到指定云函数（msg_type=event 时 event_types 缺省=虚拟支付 7 事件；消息类型时按 msg_type 订阅）\n" +
-                "unsubscribe: 移除匹配订阅（msg_type=event 时 event_types 必填）\n" +
-                "setEnable: 启用/停用匹配订阅（msg_type=event 时 event_types + enable 必填）\n" +
-                "ensureCloudFunctionMode: 确保为云函数推送模式（云托管整包接收时切换，需确认）"),
+                .enum([
+                "subscribe",
+                "unsubscribe",
+                "setEnable",
+                "ensureCloudFunctionMode",
+                "ensureContainerMode",
+                "setContainerCallback",
+            ])
+                .describe("subscribe: 订阅到指定云函数（云托管模式下拒绝）\n" +
+                "unsubscribe: 移除匹配订阅（云托管模式下拒绝）\n" +
+                "setEnable: 启用/停用匹配订阅（云托管模式下拒绝）\n" +
+                "ensureCloudFunctionMode: 切到云函数推送模式（关闭 qbase_open）\n" +
+                "ensureContainerMode: 切到云托管整包接收（需 qbase_container_path + text_mode）\n" +
+                "setContainerCallback: 更新云托管回调 path/env/text_mode"),
             msg_type: zod_1.z
                 .enum(exports.MSG_TYPES)
                 .optional()
@@ -73062,10 +73161,20 @@ function registerMsgPushTools(server) {
                 .array(zod_1.z.string())
                 .optional()
                 .describe("要操作的事件列表（仅 msg_type=\"event\" 时使用；可先 queryMessagePush(action=listSupportedEvents) 查询全量约束）。" +
-                "subscribe 缺省时默认订阅虚拟支付 7 个事件：xpay_goods_deliver_notify、xpay_coin_pay_notify、xpay_complaint_notify、" +
-                "xpay_subscribe_signing_result_notify、xpay_subscribe_pay_fail_notify、xpay_subscribe_ios_refund_query_notify、xpay_refund_notify；" +
-                "unsubscribe / setEnable 且 msg_type=event 时必填。消息类型操作请勿传本参数。"),
+                "subscribe 缺省时默认订阅虚拟支付 7 个事件；unsubscribe / setEnable 且 msg_type=event 时必填。"),
             enable: zod_1.z.boolean().optional().describe("setEnable 时必填：true 启用订阅 / false 停用订阅"),
+            qbase_container_path: zod_1.z
+                .string()
+                .optional()
+                .describe("云托管回调路径/URL（ensureContainerMode 必填；setContainerCallback 可选更新）"),
+            qbase_env: zod_1.z
+                .string()
+                .optional()
+                .describe("云托管服务所在环境 ID（ensureContainerMode/setContainerCallback 可选；缺省用 env_id）"),
+            text_mode: zod_1.z
+                .union([zod_1.z.literal(1), zod_1.z.literal(2)])
+                .optional()
+                .describe("云托管消息正文编码：1=json，2=xml（ensureContainerMode 必填；setContainerCallback 可选更新）"),
             confirm: zod_1.z
                 .string()
                 .optional()
@@ -73078,7 +73187,7 @@ function registerMsgPushTools(server) {
             openWorldHint: true,
             category: CATEGORY,
         },
-    }, async ({ appid, env_id, function_name, action, msg_type, event_types, enable, confirm, }) => {
+    }, async ({ appid, env_id, function_name, action, msg_type, event_types, enable, qbase_container_path, qbase_env, text_mode, confirm, }) => {
         if (!getTransport(server)) {
             return buildTransportUnavailablePayload("manageMessagePush", action);
         }
@@ -73093,16 +73202,16 @@ function registerMsgPushTools(server) {
                     success: true,
                     code: "NO_CHANGE",
                     message: "当前已是云函数推送模式（云托管整包接收未开启），无需变更",
-                    containerConfig: current ?? undefined,
+                    pushMode: "cloudfunction",
+                    containerConfig: pickContainerConfigPublic(current),
                 });
             }
             if (!confirmed) {
                 return buildConfirmPayload({
                     toolName: "manageMessagePush",
                     action,
-                    message: `当前推送模式为云托管整包接收（qbase_open=true，环境 ${current.qbase_env ?? "-"}，路径 ${current.qbase_container_path ?? "-"}），` +
-                        `事件会整包进入云托管而非云函数。\n即将执行 setcontainercallbackconfig 关闭云托管整包接收（qbase_open=false），` +
-                        `使消息推送按事件进入云函数 ${env_id}/${function_name}。`,
+                    message: `切换后停止云托管整包接收（qbase_open=false），消息按云函数回调推送；若 callbacks 为空则收不到任何消息。\n` +
+                        `当前云托管配置：环境 ${current.qbase_env ?? "-"}，路径 ${current.qbase_container_path ?? "-"}，text_mode=${current.text_mode ?? "-"}。`,
                     requiredParams: ["appid", "env_id", "function_name", "confirm"],
                 });
             }
@@ -73122,6 +73231,140 @@ function registerMsgPushTools(server) {
                 success: true,
                 message: "已切换到云函数推送模式（setcontainercallbackconfig qbase_open=false 成功）",
                 action,
+                pushMode: "cloudfunction",
+            });
+        }
+        if (action === "ensureContainerMode") {
+            const path = qbase_container_path?.trim();
+            const containerEnv = (qbase_env ?? env_id)?.trim();
+            if (!path) {
+                throw new Error('ensureContainerMode 必须提供 qbase_container_path（云托管回调路径/URL）');
+            }
+            if (text_mode !== 1 && text_mode !== 2) {
+                throw new Error("ensureContainerMode 必须提供 text_mode（1=json / 2=xml）");
+            }
+            if (!containerEnv) {
+                throw new Error("ensureContainerMode 必须提供 qbase_env 或 env_id（云托管服务所在环境）");
+            }
+            const current = await readContainerConfig(server, appid);
+            const alreadySame = current?.qbase_open === true &&
+                current.qbase_container_path === path &&
+                current.qbase_env === containerEnv &&
+                Number(current.text_mode) === text_mode;
+            if (alreadySame) {
+                return (0, tool_result_js_1.buildJsonToolResult)({
+                    ok: true,
+                    success: true,
+                    code: "NO_CHANGE",
+                    message: "当前已是云托管推送模式且配置一致，无需变更",
+                    pushMode: "container",
+                    containerConfig: pickContainerConfigPublic(current),
+                });
+            }
+            if (!confirmed) {
+                return buildConfirmPayload({
+                    toolName: "manageMessagePush",
+                    action,
+                    message: `切换后所有消息类型整包推送到云托管服务（path=${path}，env=${containerEnv}，text_mode=${text_mode}），云函数回调失效。\n` +
+                        `当前：pushMode=${resolvePushMode(current)}，` +
+                        `path=${current?.qbase_container_path ?? "-"}，env=${current?.qbase_env ?? "-"}，text_mode=${current?.text_mode ?? "-"}。`,
+                    requiredParams: [
+                        "appid",
+                        "env_id",
+                        "qbase_container_path",
+                        "text_mode",
+                        "confirm",
+                    ],
+                });
+            }
+            const nextCfg = {
+                ...(current ?? {}),
+                qbase_open: true,
+                qbase_container_path: path,
+                qbase_env: containerEnv,
+                text_mode,
+            };
+            await setContainerConfig(server, appid, nextCfg);
+            logger?.({
+                type: "toolInfo",
+                toolName: "manageMessagePush",
+                message: "已切换到云托管推送模式",
+                appid,
+                envId: containerEnv,
+            });
+            return (0, tool_result_js_1.buildJsonToolResult)({
+                ok: true,
+                success: true,
+                message: "已切换到云托管推送模式（qbase_open=true）",
+                action,
+                pushMode: "container",
+                containerConfig: pickContainerConfigPublic(nextCfg),
+            });
+        }
+        if (action === "setContainerCallback") {
+            const current = await readContainerConfig(server, appid);
+            const nextPath = qbase_container_path?.trim() ||
+                (typeof current?.qbase_container_path === "string"
+                    ? current.qbase_container_path
+                    : undefined);
+            const nextEnv = (qbase_env ?? env_id)?.trim() ||
+                (typeof current?.qbase_env === "string" ? current.qbase_env : undefined);
+            const nextTextMode = text_mode === 1 || text_mode === 2
+                ? text_mode
+                : typeof current?.text_mode === "number"
+                    ? current.text_mode
+                    : undefined;
+            if (!nextPath) {
+                throw new Error("setContainerCallback 需要 qbase_container_path（或当前已有配置可沿用）");
+            }
+            if (!nextEnv) {
+                throw new Error("setContainerCallback 需要 qbase_env 或 env_id（或当前已有配置可沿用）");
+            }
+            if (nextTextMode !== 1 && nextTextMode !== 2) {
+                throw new Error("setContainerCallback 需要 text_mode（1=json / 2=xml，或当前已有配置可沿用）");
+            }
+            const nextCfg = {
+                ...(current ?? {}),
+                qbase_open: current?.qbase_open === true,
+                qbase_container_path: nextPath,
+                qbase_env: nextEnv,
+                text_mode: nextTextMode,
+            };
+            const same = current?.qbase_container_path === nextPath &&
+                current?.qbase_env === nextEnv &&
+                Number(current?.text_mode) === nextTextMode &&
+                (current?.qbase_open === true) === (nextCfg.qbase_open === true);
+            if (same) {
+                return (0, tool_result_js_1.buildJsonToolResult)({
+                    ok: true,
+                    success: true,
+                    code: "NO_CHANGE",
+                    message: "云托管回调配置无变化（幂等）",
+                    pushMode: resolvePushMode(current),
+                    containerConfig: pickContainerConfigPublic(current),
+                });
+            }
+            if (!confirmed) {
+                const before = pickContainerConfigPublic(current) ?? {};
+                const after = pickContainerConfigPublic(nextCfg) ?? {};
+                return buildConfirmPayload({
+                    toolName: "manageMessagePush",
+                    action,
+                    message: `即将更新云托管回调配置：\n` +
+                        `- 旧: path=${before.qbase_container_path ?? "-"}, env=${before.qbase_env ?? "-"}, text_mode=${before.text_mode ?? "-"}, qbase_open=${before.qbase_open ?? false}\n` +
+                        `- 新: path=${after.qbase_container_path ?? "-"}, env=${after.qbase_env ?? "-"}, text_mode=${after.text_mode ?? "-"}, qbase_open=${after.qbase_open ?? false}`,
+                    requiredParams: ["appid", "confirm"],
+                });
+            }
+            await setContainerConfig(server, appid, nextCfg);
+            return (0, tool_result_js_1.buildJsonToolResult)({
+                ok: true,
+                success: true,
+                message: "已更新云托管回调配置",
+                action,
+                pushMode: resolvePushMode(nextCfg),
+                before: pickContainerConfigPublic(current),
+                after: pickContainerConfigPublic(nextCfg),
             });
         }
         // Message-type entries use a fixed empty event; event_types must not be supplied
@@ -73129,6 +73372,13 @@ function registerMsgPushTools(server) {
             throw new Error(`msg_type="${resolvedMsgType}" 时不应传 event_types（消息类型条目的 event 固定为空串 ""）；` +
                 `请去掉 event_types，仅传 msg_type / function_name / enable（setEnable 时）`);
         }
+        // Reject cloud-function callback writes while container mode is active (silent-failure guard)
+        {
+            const container = await readContainerConfig(server, appid);
+            if (resolvePushMode(container) === "container") {
+                return buildContainerModeBlockedPayload(action);
+            }
+        }
         // subscribe / unsubscribe / setEnable 共用流程：读 → 校验 → merge → 确认 → 覆盖写
         let eventList;
         if (!isEventMsgType) {
@@ -73224,6 +73474,12 @@ function registerMsgPushTools(server) {
                 warnings: warnings.length ? warnings : undefined,
             });
         }
+        // 4b. subscribe：校验云函数真实存在（仅有变更时）
+        if (action === "subscribe") {
+            const missing = await assertCloudFunctionExists(server, env_id, function_name);
+            if (missing)
+                return missing;
+        }
         // 5. 有变更 → 需确认
         const diffText = buildMergeDiffText(action, result, env_id, function_name);
         if (!confirmed) {
@@ -149159,7 +149415,7 @@ class TelemetryReporter {
         const arch = os_1.default.arch(); // 系统架构
         // Build-time injected version; guard for vitest / non-webpack runtimes.
         const mcpVersion = process.env.npm_package_version ||
-            ( true ? "2.32.0" : 0);
+            ( true ? "2.32.2" : 0);
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -222437,7 +222693,7 @@ Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.CloudBaseContext = void 0;
 const constant_1 = __webpack_require__(40762);
 class CloudBaseContext {
-    constructor({ secretId = '', secretKey = '', token = '', proxy = '', region = '', envType = '', useInternalEndpoint = undefined, internalEndpointRegion = undefined }) {
+    constructor({ secretId = '', secretKey = '', token = '', proxy = '', region = '', envType = '', useInternalEndpoint = undefined, internalEndpointRegion = undefined, requestFn = undefined }) {
         this.secretId = secretId;
         this.secretKey = secretKey;
         this.token = token;
@@ -222446,6 +222702,7 @@ class CloudBaseContext {
         this.envType = envType;
         this.useInternalEndpoint = useInternalEndpoint;
         this.internalEndpointRegion = internalEndpointRegion;
+        this.requestFn = requestFn;
     }
     isInternalEndpoint() {
         return this.useInternalEndpoint !== undefined ? this.useInternalEndpoint : constant_1.USE_INTERNAL_ENDPOINT;
@@ -232930,7 +233187,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || ( true ? "2.32.0" : 0)}
+- MCP 版本：${process.env.npm_package_version || ( true ? "2.32.2" : 0)}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -233011,7 +233268,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.32.0" : 0;
+            const mcpVersion =  true ? "2.32.2" : 0;
             const requestIdSuffix = requestId ? `\n🆔 RequestId: ${requestId}` : '';
             const enhancedErrorMessage = `${errorMessage}${requestIdSuffix}\n\n📦 CloudBase MCP v${mcpVersion}\n🔗 遇到问题？请复制以下链接到浏览器打开\n即可自动携带错误详情快速创建 GitHub Issue：\n${issueLink}`;
             // 创建新的错误对象，保持原有的错误类型但更新消息
@@ -252400,7 +252657,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.32.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.32.2" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])
@@ -270263,12 +270520,13 @@ function getDate(timestamp) {
 }
 class CloudService {
     /* eslint-disable-next-line */
-    constructor(context, service, version, baseParams) {
+    constructor(context, service, version, baseParams, requestFn) {
         this.service = service;
         this.version = version;
         this.timeout = 60000;
         this.baseParams = baseParams || {};
         this.cloudBaseContext = context;
+        this.requestFn = requestFn !== null && requestFn !== void 0 ? requestFn : context === null || context === void 0 ? void 0 : context.requestFn;
     }
     get baseUrl() {
         const internalEndpoint = this.cloudBaseContext.isInternalEndpoint();
@@ -270300,9 +270558,32 @@ class CloudService {
         }
     }
     async request(action, data = {}, method = 'POST') {
+        var _a;
         this.action = action;
-        this.data = deepRemoveVoid(Object.assign(Object.assign({}, data), this.baseParams));
         this.method = method;
+        this.data = deepRemoveVoid(Object.assign(Object.assign({}, data), this.baseParams));
+        // 如果注入了 requestFn，直接委托，跳过 TC3 签名逻辑
+        if (this.requestFn) {
+            try {
+                const result = await this.requestFn({
+                    service: this.service,
+                    action,
+                    version: this.version,
+                    region: (_a = this.cloudBaseContext.region) !== null && _a !== void 0 ? _a : '',
+                    payload: this.data,
+                });
+                return result;
+            }
+            catch (e) {
+                if (e.name === 'CloudBaseError') {
+                    throw e;
+                }
+                throw new error_1.CloudBaseError(e.message, {
+                    action,
+                    code: e.code
+                });
+            }
+        }
         this.url = this.baseUrl;
         let { secretId, secretKey, token } = this.cloudBaseContext;
         // 当在云函数环境下执行时，可init时不传入密钥，取环境变量中密钥使用
@@ -315517,9 +315798,9 @@ class CloudBase {
     }
     constructor(config = {}) {
         this.cloudBaseConfig = {};
-        let { secretId, secretKey, token, envId, proxy, region, envType, useInternalEndpoint, internalEndpointRegion } = config;
-        // config 中传入的 secretId secretkey 必须同时存在
-        if ((secretId && !secretKey) || (!secretId && secretKey)) {
+        let { secretId, secretKey, token, envId, proxy, region, envType, useInternalEndpoint, internalEndpointRegion, requestFn } = config;
+        // config 中传入的 secretId secretkey 必须同时存在（有 requestFn 时可以不传）
+        if (!requestFn && ((secretId && !secretKey) || (!secretId && secretKey))) {
             throw new Error('secretId and secretKey must be a pair');
         }
         this.cloudBaseConfig = {
@@ -315532,6 +315813,7 @@ class CloudBase {
             region,
             useInternalEndpoint,
             internalEndpointRegion,
+            requestFn,
         };
         // 初始化 context
         this.context = new context_1.CloudBaseContext(this.cloudBaseConfig);

package/dist/index.d.ts

@@ -391,6 +391,12 @@ export declare type MsgPushAction = "getAppConfig" | "uploadAppConfig" | "getCal
 export declare interface MsgPushOverrides {
     /** 消息推送 qbase CGI 对应的 Cloud API service 名（默认 "qbase"）；宿主可按后端契约覆盖 */
     service?: string;
+    /**
+     * Optional readonly hook to list cloud function names in an env.
+     * Used by manageMessagePush(action=subscribe) to reject unknown function_name.
+     * Hosts may inject this; when omitted the tool falls back to CloudBase Manager getFunctionList.
+     */
+    listCloudFunctions?: (envId: string) => Promise<string[]>;
 }
 
 /** 消息推送 qbase 响应（业务码 ret === 0 为成功；由宿主 requestFn 解包后返回） */