@wecom/wecom-openclaw-plugin 2026.4.2 → 2026.4.3-beta.0

package/dist/{esm/types/src → src}/interface.d.ts

@@ -29,8 +29,6 @@ export interface MessageState {
     hasMediaFailed?: boolean;
     /** 媒体发送失败时的纯文本错误摘要（用于替换 thinking 流展示给用户） */
     mediaErrorSummary?: string;
-    /** deliver 回调是否被调用过（用于区分"核心无回复"和"核心回复了空内容"） */
-    deliverCalled?: boolean;
     /** 流式回复是否已过期（errcode 846608，>6分钟），需降级为主动发送 */
     streamExpired?: boolean;
     /** 是否已成功发送过模板卡片 */

package/dist/src/interface.js

@@ -0,0 +1,4 @@
+/**
+ * 企业微信渠道类型定义
+ */
+export {};

package/dist/src/mcp/index.js

@@ -0,0 +1,6 @@
+/**
+ * MCP 模块统一导出
+ */
+export { createWeComMcpTool } from "./tool.js";
+export { sendJsonRpc, clearCategoryCache, McpRpcError, McpHttpError } from "./transport.js";
+export { cleanSchemaForGemini } from "./schema.js";

package/dist/{esm/src → src}/mcp/interceptors/biz-error.js

@@ -1,5 +1,3 @@
-import { clearCategoryCache } from '../transport.js';
-
 /**
  * 业务错误码检查拦截器
  *
@@ -9,6 +7,7 @@ import { clearCategoryCache } from '../transport.js';
  *
  * 此拦截器对所有 call 调用生效。
  */
+import { clearCategoryCache } from "../transport.js";
 // ============================================================================
 // 常量
 // ============================================================================
@@ -24,7 +23,7 @@ const BIZ_CACHE_CLEAR_ERROR_CODES = new Set([850002]);
 // ============================================================================
 // 拦截器实现
 // ============================================================================
-const bizErrorInterceptor = {
+export const bizErrorInterceptor = {
     name: "biz-error",
     /** 对所有 call 调用生效 */
     match: () => true,
@@ -63,6 +62,3 @@ function checkBizErrorAndClearCache(result, category) {
         }
     }
 }
-
-export { bizErrorInterceptor };
-//# sourceMappingURL=biz-error.js.map

package/dist/{esm/src → src}/mcp/interceptors/index.js

@@ -1,8 +1,3 @@
-import { bizErrorInterceptor } from './biz-error.js';
-import { mediaInterceptor } from './msg-media.js';
-import { smartpageCreateInterceptor } from './smartpage-create.js';
-import { smartpageExportInterceptor } from './smartpage-export.js';
-
 /**
  * MCP call 拦截器注册表与调度入口
  *
@@ -13,6 +8,10 @@ import { smartpageExportInterceptor } from './smartpage-export.js';
  *
  * tool.ts 的 handleCall 无需任何改动。
  */
+import { bizErrorInterceptor } from "./biz-error.js";
+import { mediaInterceptor } from "./msg-media.js";
+import { smartpageCreateInterceptor } from "./smartpage-create.js";
+import { smartpageExportInterceptor } from "./smartpage-export.js";
 // ============================================================================
 // 拦截器注册表（按注册顺序执行）
 // ============================================================================
@@ -29,7 +28,7 @@ const interceptors = [
  * - timeoutMs: 取所有拦截器返回值中的最大值
  * - args: 后注册的拦截器覆盖前者（一般同一调用只有一个拦截器会返回 args）
  */
-async function resolveBeforeCall(ctx) {
+export async function resolveBeforeCall(ctx) {
     let mergedTimeoutMs;
     let mergedArgs;
     for (const interceptor of interceptors) {
@@ -56,7 +55,7 @@ async function resolveBeforeCall(ctx) {
  * 前一个拦截器的返回值作为下一个拦截器的输入。
  * 拦截器若不需要修改 result，应原样返回。
  */
-async function runAfterCall(ctx, result) {
+export async function runAfterCall(ctx, result) {
     let current = result;
     for (const interceptor of interceptors) {
         if (!interceptor.match(ctx) || !interceptor.afterCall)
@@ -65,6 +64,3 @@ async function runAfterCall(ctx, result) {
     }
     return current;
 }
-
-export { resolveBeforeCall, runAfterCall };
-//# sourceMappingURL=index.js.map

package/dist/{esm/src → src}/mcp/interceptors/msg-media.js

@@ -1,9 +1,3 @@
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-import { MEDIA_DOWNLOAD_TIMEOUT_MS } from '../transport.js';
-import { getWeComRuntime } from '../../runtime.js';
-import { detectMime } from '../../openclaw-compat.js';
-
 /**
  * get_msg_media 响应拦截器
  *
@@ -13,10 +7,15 @@ import { detectMime } from '../../openclaw-compat.js';
  *    解码为 Buffer 并通过 saveMediaBuffer 保存到本地媒体目录，
  *    替换响应中的 base64_data 为 local_path，避免大模型被 base64 数据消耗 token
  */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { MEDIA_DOWNLOAD_TIMEOUT_MS } from "../transport.js";
+import { getWeComRuntime } from "../../runtime.js";
+import { detectMime } from "../../openclaw-compat.js";
 // ============================================================================
 // 拦截器实现
 // ============================================================================
-const mediaInterceptor = {
+export const mediaInterceptor = {
     name: "media",
     /** 仅对 get_msg_media 方法生效 */
     match: (ctx) => ctx.method === "get_msg_media",
@@ -132,6 +131,3 @@ async function interceptMediaResponse(result) {
             }],
     };
 }
-
-export { mediaInterceptor };
-//# sourceMappingURL=msg-media.js.map

package/dist/{esm/src → src}/mcp/interceptors/smartpage-create.js

@@ -1,5 +1,3 @@
-import * as fs from 'node:fs/promises';
-
 /**
  * smartpage_create 请求拦截器
  *
@@ -28,6 +26,7 @@ import * as fs from 'node:fs/promises';
  * 传给 MCP Server 的格式：
  *   { "title": "...", "pages": [{"page_title": "...", "page_content": "...", "content_type": "..."}] }
  */
+import * as fs from "node:fs/promises";
 // ============================================================================
 // 常量
 // ============================================================================
@@ -111,7 +110,7 @@ async function resolvePages(ctx, pages) {
 // ============================================================================
 // 拦截器实现
 // ============================================================================
-const smartpageCreateInterceptor = {
+export const smartpageCreateInterceptor = {
     name: "smartpage-create",
     /** 仅对 doc 品类的 smartpage_create 方法生效 */
     match: (ctx) => ctx.category === "doc" && ctx.method === "smartpage_create",
@@ -131,6 +130,3 @@ const smartpageCreateInterceptor = {
         return resolvePages(ctx, pages);
     },
 };
-
-export { smartpageCreateInterceptor };
-//# sourceMappingURL=smartpage-create.js.map

package/dist/{esm/src → src}/mcp/interceptors/smartpage-export.js

@@ -1,5 +1,3 @@
-import { getWeComRuntime } from '../../runtime.js';
-
 /**
  * smartpage_get_export_result 响应拦截器
  *
@@ -15,10 +13,11 @@ import { getWeComRuntime } from '../../runtime.js';
  *
  * 这样 LLM 只看到轻量的文件路径信息，Skill 可通过文件路径读取完整内容。
  */
+import { getWeComRuntime } from "../../runtime.js";
 // ============================================================================
 // 拦截器实现
 // ============================================================================
-const smartpageExportInterceptor = {
+export const smartpageExportInterceptor = {
     name: "smartpage-export",
     /** 仅对 doc 品类的 smartpage_get_export_result 方法生效 */
     match: (ctx) => ctx.category === "doc" && ctx.method === "smartpage_get_export_result",
@@ -86,6 +85,3 @@ async function interceptExportResponse(result) {
             }],
     };
 }
-
-export { smartpageExportInterceptor };
-//# sourceMappingURL=smartpage-export.js.map

package/dist/src/mcp/interceptors/types.js

@@ -0,0 +1,7 @@
+/**
+ * MCP call 拦截器类型定义
+ *
+ * 拦截器用于在 tools/call 调用前后注入特殊逻辑，
+ * 如修改超时配置、变换响应结果等，避免在 tool.ts 中堆积 if/else。
+ */
+export {};

package/dist/{esm/src → src}/mcp/schema.js

@@ -15,7 +15,7 @@ const GEMINI_UNSUPPORTED_KEYWORDS = new Set([
  * 清洗 JSON Schema，内联 $ref 引用并移除 Gemini 不支持的关键词，
  * 防止 Gemini 模型解析 function response 时报 400 错误。
  */
-function cleanSchemaForGemini(schema) {
+export function cleanSchemaForGemini(schema) {
     if (!schema || typeof schema !== "object")
         return schema;
     if (Array.isArray(schema))
@@ -97,6 +97,3 @@ function cleanWithDefs(schema, defs, refStack) {
     }
     return cleaned;
 }
-
-export { cleanSchemaForGemini };
-//# sourceMappingURL=schema.js.map

package/dist/{esm/src → src}/mcp/tool.js

@@ -1,7 +1,3 @@
-import { sendJsonRpc } from './transport.js';
-import { cleanSchemaForGemini } from './schema.js';
-import { resolveBeforeCall, runAfterCall } from './interceptors/index.js';
-
 /**
  * wecom_mcp — 模拟 MCP 调用的 Agent Tool
  *
@@ -16,6 +12,9 @@ import { resolveBeforeCall, runAfterCall } from './interceptors/index.js';
  *   wecom_mcp list contact
  *   wecom_mcp call contact getContact '{}'
  */
+import { sendJsonRpc } from "./transport.js";
+import { cleanSchemaForGemini } from "./schema.js";
+import { resolveBeforeCall, runAfterCall } from "./interceptors/index.js";
 // ============================================================================
 // 响应构造辅助
 // ============================================================================
@@ -123,7 +122,7 @@ const parseArgs = (args) => {
 /**
  * 创建 wecom_mcp Agent Tool 定义
  */
-function createWeComMcpTool() {
+export function createWeComMcpTool() {
     return {
         name: "wecom_mcp",
         label: "企业微信 MCP 工具",
@@ -201,6 +200,3 @@ function createWeComMcpTool() {
         },
     };
 }
-
-export { createWeComMcpTool };
-//# sourceMappingURL=tool.js.map

package/dist/{esm/src → src}/mcp/transport.js

@@ -1,10 +1,3 @@
-import { generateReqId } from '@wecom/aibot-node-sdk';
-import { DEFAULT_ACCOUNT_ID } from '../openclaw-compat.js';
-import { getWeComWebSocket } from '../state-manager.js';
-import { MCP_CONFIG_FETCH_TIMEOUT_MS, MCP_GET_CONFIG_CMD } from '../const.js';
-import { withTimeout } from '../timeout.js';
-import { PLUGIN_VERSION } from '../version.js';
-
 /**
  * MCP Streamable HTTP 传输层模块
  *
@@ -16,13 +9,19 @@ import { PLUGIN_VERSION } from '../version.js';
  * - SSE 流式响应解析
  * - MCP 配置运行时缓存（通过 WSClient 拉取 URL 并缓存在内存中）
  */
+import { generateReqId } from "@wecom/aibot-node-sdk";
+import { DEFAULT_ACCOUNT_ID } from "../openclaw-compat.js";
+import { getWeComWebSocket } from "../state-manager.js";
+import { MCP_GET_CONFIG_CMD, MCP_CONFIG_FETCH_TIMEOUT_MS } from "../const.js";
+import { withTimeout } from "../timeout.js";
+import { PLUGIN_VERSION } from "../version.js";
 // ============================================================================
 // 内部状态
 // ============================================================================
 /** HTTP 请求超时时间（毫秒） */
-const HTTP_REQUEST_TIMEOUT_MS = 30000;
+const HTTP_REQUEST_TIMEOUT_MS = 30_000;
 /** 媒体下载请求超时时间（毫秒），base64 编码的媒体文件最大可达 ~27MB */
-const MEDIA_DOWNLOAD_TIMEOUT_MS = 120000;
+export const MEDIA_DOWNLOAD_TIMEOUT_MS = 120_000;
 /** 日志前缀 */
 const LOG_TAG = "[mcp]";
 /**
@@ -31,7 +30,9 @@ const LOG_TAG = "[mcp]";
  * 携带服务端返回的 JSON-RPC error.code，
  * 用于上层按错误码进行差异化处理（如特定错误码触发缓存清理）。
  */
-class McpRpcError extends Error {
+export class McpRpcError extends Error {
+    code;
+    data;
     constructor(code, message, data) {
         super(message);
         this.code = code;
@@ -45,7 +46,8 @@ class McpRpcError extends Error {
  * 携带 HTTP 状态码，用于精确判断 session 失效（404）等场景，
  * 避免通过字符串匹配 "404" 导致的误判。
  */
-class McpHttpError extends Error {
+export class McpHttpError extends Error {
+    statusCode;
     constructor(statusCode, message) {
         super(message);
         this.statusCode = statusCode;
@@ -326,7 +328,7 @@ async function parseSseResponse(response) {
  *
  * @param category - MCP 品类名称
  */
-function clearCategoryCache(category) {
+export function clearCategoryCache(category) {
     console.log(`${LOG_TAG} 清理缓存 (category="${category}")`);
     mcpConfigCache.delete(category);
     mcpSessionCache.delete(category);
@@ -346,7 +348,7 @@ function clearCategoryCache(category) {
  * @param options - 可选配置（如自定义超时）
  * @returns JSON-RPC result
  */
-async function sendJsonRpc(category, method, params, options) {
+export async function sendJsonRpc(category, method, params, options) {
     const url = await getMcpUrl(category);
     const timeoutMs = options?.timeoutMs;
     const body = {
@@ -406,6 +408,3 @@ async function rebuildSession(url, category) {
     inflightInitRequests.set(category, promise);
     return promise;
 }
-
-export { MEDIA_DOWNLOAD_TIMEOUT_MS, McpHttpError, McpRpcError, clearCategoryCache, sendJsonRpc };
-//# sourceMappingURL=transport.js.map

package/dist/{esm/src → src}/media-handler.js

@@ -1,13 +1,12 @@
-import { fileTypeFromBuffer } from 'file-type';
-import { getWeComRuntime } from './runtime.js';
-import { DEFAULT_MEDIA_MAX_MB, IMAGE_DOWNLOAD_TIMEOUT_MS, FILE_DOWNLOAD_TIMEOUT_MS } from './const.js';
-import { withTimeout } from './timeout.js';
-
 /**
  * 企业微信媒体（图片）下载和保存模块
  *
  * 负责下载、检测格式、保存图片到本地，包含超时保护
  */
+import { fileTypeFromBuffer } from "file-type";
+import { getWeComRuntime } from "./runtime.js";
+import { IMAGE_DOWNLOAD_TIMEOUT_MS, FILE_DOWNLOAD_TIMEOUT_MS, DEFAULT_MEDIA_MAX_MB } from "./const.js";
+import { withTimeout } from "./timeout.js";
 // ============================================================================
 // 图片格式检测辅助函数（基于 file-type 包）
 // ============================================================================
@@ -34,7 +33,7 @@ async function detectImageContentType(data) {
 /**
  * 下载并保存所有图片到本地，每张图片的下载带超时保护
  */
-async function downloadAndSaveImages(params) {
+export async function downloadAndSaveImages(params) {
     const { imageUrls, config, runtime, wsClient } = params;
     const core = getWeComRuntime();
     const mediaList = [];
@@ -80,7 +79,7 @@ async function downloadAndSaveImages(params) {
 /**
  * 下载并保存所有文件到本地，每个文件的下载带超时保护
  */
-async function downloadAndSaveFiles(params) {
+export async function downloadAndSaveFiles(params) {
     const { fileUrls, config, runtime, wsClient } = params;
     const core = getWeComRuntime();
     const mediaList = [];
@@ -121,6 +120,3 @@ async function downloadAndSaveFiles(params) {
     }
     return mediaList;
 }
-
-export { downloadAndSaveFiles, downloadAndSaveImages };
-//# sourceMappingURL=media-handler.js.map

package/dist/{esm/src → src}/media-uploader.js

@@ -1,6 +1,3 @@
-import { loadOutboundMediaFromUrl, detectMime } from './openclaw-compat.js';
-import { ABSOLUTE_MAX_BYTES, VOICE_MAX_BYTES, VIDEO_MAX_BYTES, IMAGE_MAX_BYTES } from './const.js';
-
 /**
  * 企业微信出站媒体上传工具模块
  *
@@ -9,6 +6,8 @@ import { ABSOLUTE_MAX_BYTES, VOICE_MAX_BYTES, VIDEO_MAX_BYTES, IMAGE_MAX_BYTES }
  * - 检测 MIME 类型并映射为企微媒体类型
  * - 文件大小检查与降级策略
  */
+import { loadOutboundMediaFromUrl, detectMime, } from "./openclaw-compat.js";
+import { IMAGE_MAX_BYTES, VIDEO_MAX_BYTES, VOICE_MAX_BYTES, ABSOLUTE_MAX_BYTES, } from "./const.js";
 // ============================================================================
 // MIME → 企微媒体类型映射
 // ============================================================================
@@ -18,7 +17,7 @@ import { ABSOLUTE_MAX_BYTES, VOICE_MAX_BYTES, VIDEO_MAX_BYTES, IMAGE_MAX_BYTES }
  * @param mimeType - MIME 类型字符串
  * @returns 企微媒体类型
  */
-function detectWeComMediaType(mimeType) {
+export function detectWeComMediaType(mimeType) {
     const mime = mimeType.toLowerCase();
     // 图片类型
     if (mime.startsWith("image/")) {
@@ -50,7 +49,7 @@ function detectWeComMediaType(mimeType) {
  * @param mediaLocalRoots - 允许读取本地文件的安全白名单目录
  * @returns 解析后的媒体文件信息
  */
-async function resolveMediaFile(mediaUrl, mediaLocalRoots) {
+export async function resolveMediaFile(mediaUrl, mediaLocalRoots) {
     // 使用兼容层加载媒体文件（优先 SDK，不可用时 fallback）
     // 传入足够大的 maxBytes，由我们自己在后续步骤做大小检查
     const result = await loadOutboundMediaFromUrl(mediaUrl, {
@@ -98,7 +97,7 @@ const VOICE_SUPPORTED_MIMES = new Set(["audio/amr"]);
  * @param contentType - 文件的 MIME 类型（用于语音格式校验）
  * @returns 大小检查结果
  */
-function applyFileSizeLimits(fileSize, detectedType, contentType) {
+export function applyFileSizeLimits(fileSize, detectedType, contentType) {
     const fileSizeMB = (fileSize / (1024 * 1024)).toFixed(2);
     // 先检查绝对上限（20MB）
     if (fileSize > ABSOLUTE_MAX_BYTES) {
@@ -150,6 +149,9 @@ function applyFileSizeLimits(fileSize, detectedType, contentType) {
                 };
             }
             break;
+        case "file":
+            // file 类型在绝对上限内即可
+            break;
     }
     // 无需降级
     return {
@@ -227,7 +229,7 @@ function mimeToExtension(mime) {
  * 媒体消息统一走 aibot_send_msg 主动发送，避免多文件场景下 reqId 只能用一次的问题。
  * channel.ts 的 sendMedia 和 monitor.ts 的 deliver 回调都使用此函数。
  */
-async function uploadAndSendMedia(options) {
+export async function uploadAndSendMedia(options) {
     const { wsClient, mediaUrl, chatId, mediaLocalRoots, log, errorLog } = options;
     try {
         // 1. 加载媒体文件
@@ -274,6 +276,58 @@ async function uploadAndSendMedia(options) {
         };
     }
 }
-
-export { applyFileSizeLimits, detectWeComMediaType, resolveMediaFile, uploadAndSendMedia };
-//# sourceMappingURL=media-uploader.js.map
+/**
+ * 被动回复媒体上传+发送流程
+ *
+ * 统一处理：resolveMediaFile → detectType → sizeCheck → uploadMedia → replyMedia
+ * 通过 aibot_respond_msg 被动回复通道发送媒体消息，可以覆盖之前的 THINKING_MESSAGE。
+ *
+ * 适用场景：回包只有媒体没有文本时，第一个媒体文件用此方法发送以清理 thinking 状态。
+ */
+export async function uploadAndReplyMedia(options) {
+    const { wsClient, mediaUrl, frame, mediaLocalRoots, log, errorLog } = options;
+    try {
+        // 1. 加载媒体文件
+        log?.(`[wecom] Uploading media (reply mode): url=${mediaUrl}`);
+        const media = await resolveMediaFile(mediaUrl, mediaLocalRoots);
+        // 2. 检测企微媒体类型
+        const detectedType = detectWeComMediaType(media.contentType);
+        // 3. 文件大小检查与降级策略
+        const sizeCheck = applyFileSizeLimits(media.buffer.length, detectedType, media.contentType);
+        if (sizeCheck.shouldReject) {
+            errorLog?.(`[wecom] Media rejected: ${sizeCheck.rejectReason}`);
+            return {
+                ok: false,
+                rejected: true,
+                rejectReason: sizeCheck.rejectReason,
+                finalType: sizeCheck.finalType,
+            };
+        }
+        const finalType = sizeCheck.finalType;
+        // 4. 分片上传获取 media_id
+        const uploadResult = await wsClient.uploadMedia(media.buffer, {
+            type: finalType,
+            filename: media.fileName,
+        });
+        log?.(`[wecom] Media uploaded: media_id=${uploadResult.media_id}, type=${finalType}`);
+        // 5. 通过 aibot_respond_msg 被动回复发送媒体消息（会覆盖 THINKING_MESSAGE）
+        const result = await wsClient.replyMedia(frame, finalType, uploadResult.media_id);
+        const messageId = result?.headers?.req_id ?? `wecom-reply-media-${Date.now()}`;
+        log?.(`[wecom] Media sent via replyMedia (passive reply): type=${finalType}`);
+        return {
+            ok: true,
+            messageId,
+            finalType,
+            downgraded: sizeCheck.downgraded,
+            downgradeNote: sizeCheck.downgradeNote,
+        };
+    }
+    catch (err) {
+        const errMsg = String(err);
+        errorLog?.(`[wecom] Failed to upload/reply media: url=${mediaUrl}, error=${errMsg}`);
+        return {
+            ok: false,
+            error: errMsg,
+        };
+    }
+}

package/dist/{esm/src → src}/message-parser.js

@@ -50,7 +50,7 @@ function buildTemplateCardEventText(body) {
  * 解析消息内容（支持单条消息、图文混排、事件回调和引用消息）
  * @returns 提取的文本数组、图片URL数组和引用消息内容
  */
-function parseMessageContent(body) {
+export function parseMessageContent(body) {
     const textParts = [];
     const imageUrls = [];
     const imageAesKeys = new Map();
@@ -127,6 +127,3 @@ function parseMessageContent(body) {
     }
     return { textParts, imageUrls, imageAesKeys, fileUrls, fileAesKeys, quoteContent };
 }
-
-export { parseMessageContent };
-//# sourceMappingURL=message-parser.js.map

package/dist/{esm/types/src → src}/message-sender.d.ts

@@ -32,3 +32,21 @@ export declare function sendWeComReply(params: {
     /** 指定 streamId，用于流式回复时保持相同的 streamId */
     streamId?: string;
 }): Promise<string>;
+/**
+ * 非阻塞流式文本回复
+ *
+ * 基于 SDK 的 replyStreamNonBlocking 方法：
+ * - 如果上一条同 reqId 的消息尚未收到 ack，则跳过本次发送（返回 'skipped'），
+ *   避免流式中间帧排队积压导致延迟。
+ * - finish=true 的最终帧不受此限制，始终保证发送。
+ *
+ * @returns 'skipped' 表示被跳过，否则返回 streamId
+ */
+export declare function sendWeComReplyNonBlocking(params: {
+    wsClient: WSClient;
+    frame: WsFrame;
+    text: string;
+    runtime: RuntimeEnv;
+    streamId: string;
+    finish?: boolean;
+}): Promise<string | 'skipped'>;

package/dist/{esm/src → src}/message-sender.js

@@ -1,26 +1,25 @@
-import { generateReqId } from '@wecom/aibot-node-sdk';
-import { REPLY_SEND_TIMEOUT_MS } from './const.js';
-import { withTimeout } from './timeout.js';
-
 /**
  * 企业微信消息发送模块
  *
  * 负责通过 WSClient 发送回复消息，包含超时保护
  */
+import { generateReqId } from "@wecom/aibot-node-sdk";
+import { REPLY_SEND_TIMEOUT_MS } from "./const.js";
+import { withTimeout } from "./timeout.js";
 // ============================================================================
 // 流式过期错误（errcode 846608）
 // ============================================================================
 /** 流式回复超时错误码（>6分钟未更新，服务端拒绝继续流式更新） */
-const STREAM_EXPIRED_ERRCODE = 846608;
+export const STREAM_EXPIRED_ERRCODE = 846608;
 /**
  * 流式回复过期错误
  * 当服务端返回 errcode=846608 时抛出，表示流式消息已超过6分钟无法更新，
  * 调用方需降级为主动发送（sendMessage）方式回复。
  */
-class StreamExpiredError extends Error {
+export class StreamExpiredError extends Error {
+    errcode = STREAM_EXPIRED_ERRCODE;
     constructor(message) {
         super(message ?? `Stream message update expired (errcode=${STREAM_EXPIRED_ERRCODE})`);
-        this.errcode = STREAM_EXPIRED_ERRCODE;
         this.name = "StreamExpiredError";
     }
 }
@@ -33,7 +32,7 @@ class StreamExpiredError extends Error {
  *
  * @returns messageId (streamId)
  */
-async function sendWeComReply(params) {
+export async function sendWeComReply(params) {
     const { wsClient, frame, text, runtime, finish = true, streamId: existingStreamId } = params;
     if (!text) {
         return "";
@@ -80,6 +79,41 @@ async function sendWeComReply(params) {
     runtime.log?.(`[plugin -> server] streamId=${streamId}, finish=${finish}`);
     return streamId;
 }
-
-export { STREAM_EXPIRED_ERRCODE, StreamExpiredError, sendWeComReply };
-//# sourceMappingURL=message-sender.js.map
+// ============================================================================
+// 非阻塞流式发送（用于 onPartialReply 场景）
+// ============================================================================
+/**
+ * 非阻塞流式文本回复
+ *
+ * 基于 SDK 的 replyStreamNonBlocking 方法：
+ * - 如果上一条同 reqId 的消息尚未收到 ack，则跳过本次发送（返回 'skipped'），
+ *   避免流式中间帧排队积压导致延迟。
+ * - finish=true 的最终帧不受此限制，始终保证发送。
+ *
+ * @returns 'skipped' 表示被跳过，否则返回 streamId
+ */
+export async function sendWeComReplyNonBlocking(params) {
+    const { wsClient, frame, text, runtime, streamId, finish = false } = params;
+    if (!text) {
+        return 'skipped';
+    }
+    if (!wsClient.isConnected) {
+        return 'skipped';
+    }
+    try {
+        const result = await wsClient.replyStreamNonBlocking(frame, streamId, text, finish);
+        if (result === 'skipped') {
+            return 'skipped';
+        }
+        return streamId;
+    }
+    catch (err) {
+        // 服务端返回 846608：流式消息超过6分钟无法更新，需降级为主动发送
+        const errMsg = err?.errmsg || err?.message || String(err);
+        if (err?.errcode === STREAM_EXPIRED_ERRCODE ||
+            errMsg.includes(String(STREAM_EXPIRED_ERRCODE))) {
+            throw new StreamExpiredError(errMsg);
+        }
+        throw err;
+    }
+}