@tencent-connect/openclaw-qqbot 1.6.2-alpha.2 → 1.6.3-alpha.channel

package/README.md

@@ -10,7 +10,7 @@
 
 **Connect your AI assistant to QQ — private chat, group chat, and rich media, all in one plugin.**
 
-### 🚀 Current Version: `v1.6.1`
+### 🚀 Current Version: `v1.6.2`
 
 [![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
 [![QQ Bot](https://img.shields.io/badge/QQ_Bot-API_v2-red)](https://bot.q.qq.com/wiki/)
@@ -149,9 +149,9 @@ AI can send videos directly. Supports local files and URLs.
 
 The plugin provides built-in slash commands that are intercepted before reaching the AI queue, giving instant responses for diagnostics and management.
 
-#### `/qqbot-ping` — Latency Test
+#### `/bot-ping` — Latency Test
 
-> **You**: `/qqbot-ping`
+> **You**: `/bot-ping`
 >
 > **QQBot**: ✅ pong！⏱ Latency: 602ms (network: 602ms, plugin: 0ms)
 
@@ -159,27 +159,27 @@ Measures end-to-end latency from QQ server push to plugin response, broken down
 
 <img width="360" src="docs/images/slash-ping.jpg" alt="Ping Demo" />
 
-#### `/qqbot-version` — Version Info
+#### `/bot-version` — Version Info
 
-> **You**: `/qqbot-version`
+> **You**: `/bot-version`
 >
-> **QQBot**: 🦞 Framework: OpenClaw 2026.3.13 (61d171a) / 🤖 Plugin: v1.6.1 / 🌟 GitHub repo
+> **QQBot**: 🦞 Framework: OpenClaw 2026.3.13 (61d171a) / 🤖 Plugin: v1.6.3 / 🌟 GitHub repo
 
 Shows framework version, plugin version, and a direct link to the official repository.
 
 <img width="360" src="docs/images/slash-version.jpg" alt="Version Demo" />
 
-#### `/qqbot-help` — Command List
+#### `/bot-help` — Command List
 
-> **You**: `/qqbot-help`
+> **You**: `/bot-help`
 >
 > **QQBot**: Lists all available slash commands with clickable shortcuts.
 
 <img width="360" src="docs/images/slash-help.jpg" alt="Help Demo" />
 
-#### `/qqbot-upgrade` — Upgrade Guide
+#### `/bot-upgrade` — Upgrade Guide
 
-> **You**: `/qqbot-upgrade`
+> **You**: `/bot-upgrade`
 >
 > **QQBot**: 📌 Current version / ✅ Up to date / ⬆️ Upgrade guide / 🌟 GitHub repo
 
@@ -187,9 +187,9 @@ Shows current version, update status, upgrade guide link, and official repositor
 
 <img width="360" src="docs/images/slash-upgrade.jpg" alt="Upgrade Demo" /> 
 
-#### `/qqbot-logs` — Log Export
+#### `/bot-logs` — Log Export
 
-> **You**: `/qqbot-logs`
+> **You**: `/bot-logs`
 >
 > **QQBot**: 📋 Logs packaged (~2000 lines), sending file... *(sends a .txt file)*
 

package/README.zh.md

@@ -9,7 +9,7 @@
 
 **让你的 AI 助手接入 QQ — 私聊、群聊、富媒体，一个插件全搞定。**
 
-### 🚀 当前版本： `v1.6.1`
+### 🚀 当前版本： `v1.6.2`
 
 [![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
 [![QQ Bot](https://img.shields.io/badge/QQ_Bot-API_v2-red)](https://bot.q.qq.com/wiki/)
@@ -144,9 +144,9 @@ AI 可直接发送视频，支持本地文件和公网 URL。
 
 插件内置一组斜杠指令，在消息进入 AI 队列前拦截处理，即时响应，用于诊断和管理。
 
-#### `/qqbot-ping` — 延迟测试
+#### `/bot-ping` — 延迟测试
 
-> **你**：`/qqbot-ping`
+> **你**：`/bot-ping`
 >
 > **QQBot**：✅ pong！⏱ 延迟: 602ms（网络传输: 602ms，插件处理: 0ms）
 
@@ -154,27 +154,27 @@ AI 可直接发送视频，支持本地文件和公网 URL。
 
 <img width="360" src="docs/images/slash-ping.jpg" alt="Ping 演示" />
 
-#### `/qqbot-version` — 版本信息
+#### `/bot-version` — 版本信息
 
-> **你**：`/qqbot-version`
+> **你**：`/bot-version`
 >
-> **QQBot**：🦞框架版本：OpenClaw 2026.3.13 (61d171a) / 🤖QQBot 插件版本：v1.6.1 / 🌟官方 GitHub 仓库
+> **QQBot**：🦞框架版本：OpenClaw 2026.3.13 (61d171a) / 🤖QQBot 插件版本：v1.6.3 / 🌟官方 GitHub 仓库
 
 一目了然查看框架版本、插件版本，并可直接跳转官方仓库。
 
 <img width="360" src="docs/images/slash-version.jpg" alt="Version 演示" />
 
-#### `/qqbot-help` — 指令列表
+#### `/bot-help` — 指令列表
 
-> **你**：`/qqbot-help`
+> **你**：`/bot-help`
 >
 > **QQBot**：列出所有可用的斜杠指令及说明，指令可点击快速输入。
 
 <img width="360" src="docs/images/slash-help.jpg" alt="Help 演示" />
 
-#### `/qqbot-upgrade` — 升级指引
+#### `/bot-upgrade` — 升级指引
 
-> **你**：`/qqbot-upgrade`
+> **你**：`/bot-upgrade`
 >
 > **QQBot**：📌当前版本 / ✅当前已是最新版本 / ⬆️升级指引 / 🌟官方 GitHub 仓库
 
@@ -182,9 +182,9 @@ AI 可直接发送视频，支持本地文件和公网 URL。
 
 <img width="360" src="docs/images/slash-upgrade.jpg" alt="Upgrade 演示" /> 
 
-#### `/qqbot-logs` — 日志导出
+#### `/bot-logs` — 日志导出
 
-> **你**：`/qqbot-logs`
+> **你**：`/bot-logs`
 >
 > **QQBot**：📋 日志已打包（约 2000 行），正在发送文件… *（发送 .txt 文件）*
 

package/dist/src/channel.d.ts

@@ -1,3 +1,11 @@
 import { type ChannelPlugin } from "openclaw/plugin-sdk";
 import type { ResolvedQQBotAccount } from "./types.js";
+/** QQ Bot 单条消息文本长度上限 */
+export declare const TEXT_CHUNK_LIMIT = 5000;
+/**
+ * Markdown 感知的文本分块函数
+ * 委托给 SDK 内置的 channel.text.chunkMarkdownText
+ * 支持代码块自动关闭/重开、括号感知等
+ */
+export declare function chunkText(text: string, limit: number): string[];
 export declare const qqbotPlugin: ChannelPlugin<ResolvedQQBotAccount>;

package/dist/src/channel.js

@@ -4,34 +4,16 @@ import { sendText, sendMedia } from "./outbound.js";
 import { startGateway } from "./gateway.js";
 import { qqbotOnboardingAdapter } from "./onboarding.js";
 import { getQQBotRuntime } from "./runtime.js";
+/** QQ Bot 单条消息文本长度上限 */
+export const TEXT_CHUNK_LIMIT = 5000;
 /**
- * 简单的文本分块函数
- * 用于预先分块长文本
+ * Markdown 感知的文本分块函数
+ * 委托给 SDK 内置的 channel.text.chunkMarkdownText
+ * 支持代码块自动关闭/重开、括号感知等
  */
-function chunkText(text, limit) {
-    if (text.length <= limit)
-        return [text];
-    const chunks = [];
-    let remaining = text;
-    while (remaining.length > 0) {
-        if (remaining.length <= limit) {
-            chunks.push(remaining);
-            break;
-        }
-        // 尝试在换行处分割
-        let splitAt = remaining.lastIndexOf("\n", limit);
-        if (splitAt <= 0 || splitAt < limit * 0.5) {
-            // 没找到合适的换行，尝试在空格处分割
-            splitAt = remaining.lastIndexOf(" ", limit);
-        }
-        if (splitAt <= 0 || splitAt < limit * 0.5) {
-            // 还是没找到，强制在 limit 处分割
-            splitAt = limit;
-        }
-        chunks.push(remaining.slice(0, splitAt));
-        remaining = remaining.slice(splitAt).trimStart();
-    }
-    return chunks;
+export function chunkText(text, limit) {
+    const runtime = getQQBotRuntime();
+    return runtime.channel.text.chunkMarkdownText(text, limit);
 }
 export const qqbotPlugin = {
     id: "qqbot",
@@ -52,7 +34,7 @@ export const qqbotPlugin = {
          * blockStreaming: true 表示该 Channel 支持块流式
          * 框架会收集流式响应，然后通过 deliver 回调发送
          */
-        blockStreaming: false,
+        blockStreaming: true,
     },
     reload: { configPrefixes: ["channels.qqbot"] },
     // CLI onboarding wizard
@@ -205,9 +187,9 @@ export const qqbotPlugin = {
     },
     outbound: {
         deliveryMode: "direct",
-        chunker: chunkText,
+        chunker: (text, limit) => getQQBotRuntime().channel.text.chunkMarkdownText(text, limit),
         chunkerMode: "markdown",
-        textChunkLimit: 20000,
+        textChunkLimit: 5000,
         sendText: async ({ to, text, accountId, replyToId, cfg }) => {
             console.log(`[qqbot:channel] sendText called — accountId=${accountId}, to=${to}, replyToId=${replyToId}, text.length=${text?.length ?? 0}`);
             console.log(`[qqbot:channel] sendText text preview: ${text?.slice(0, 100)}${(text?.length ?? 0) > 100 ? "..." : ""}`);

package/dist/src/gateway.js

@@ -7,7 +7,7 @@ import { recordKnownUser, flushKnownUsers, listKnownUsers } from "./known-users.
 import { getQQBotRuntime } from "./runtime.js";
 import { setRefIndex, getRefIndex, formatRefEntryForAgent, flushRefIndex } from "./ref-index-store.js";
 import { matchSlashCommand, getPluginVersion } from "./slash-commands.js";
-import { triggerUpdateCheck, onUpdateFound, formatUpdateNotice } from "./update-checker.js";
+import { triggerUpdateCheck } from "./update-checker.js";
 import { startImageServer, isImageServerRunning, downloadFile } from "./image-server.js";
 import { getImageSize, formatQQBotMarkdownImage, hasQQBotImageSize } from "./utils/image-size.js";
 import { parseQQBotPayload, encodePayloadForCron, isCronReminderPayload, isMediaPayload } from "./utils/payload.js";
@@ -15,8 +15,8 @@ import { convertSilkToWav, isVoiceAttachment, formatDuration, resolveTTSConfig,
 import { normalizeMediaTags } from "./utils/media-tags.js";
 import { checkFileSize, readFileAsync, fileExistsAsync, formatFileSize } from "./utils/file-utils.js";
 import { getQQBotDataDir, isLocalPath as isLocalFilePath, normalizePath, sanitizeFileName, runDiagnostics } from "./utils/platform.js";
-import { MSG } from "./user-messages.js";
 import { sendPhoto, sendVoice, sendVideoMsg, sendDocument, sendMedia as sendMediaAuto } from "./outbound.js";
+import { chunkText, TEXT_CHUNK_LIMIT } from "./channel.js";
 function resolveSTTConfig(cfg) {
     const c = cfg;
     // 优先使用 channels.qqbot.stt（插件专属配置）
@@ -172,6 +172,7 @@ function parseFaceTags(text) {
         }
     });
 }
+// formatMediaErrorMessage 已移至 user-messages.ts 集中管理
 // ============ 内部标记过滤 ============
 /**
  * 过滤内部标记（如 [[reply_to: xxx]]）
@@ -314,36 +315,8 @@ export async function startGateway(ctx) {
             log?.info(`[qqbot:${account.accountId}] ${w}`);
         }
     }
-    // 后台版本检查（detached 子进程，零阻塞）
+    // 后台版本检查（供 /bot-version、/bot-upgrade 指令被动查询）
     triggerUpdateCheck(log);
-    // 注册新版本通知回调：仅发给管理员，带防抖
-    let lastUpdateNotifyAt = 0;
-    const UPDATE_NOTIFY_DEBOUNCE_MS = 5 * 60 * 1000; // 5 分钟内不重复通知
-    onUpdateFound(async (info) => {
-        try {
-            // 防抖：避免短时间内重复推送
-            const now = Date.now();
-            if (now - lastUpdateNotifyAt < UPDATE_NOTIFY_DEBOUNCE_MS) {
-                log?.debug?.(`[qqbot:${account.accountId}] Update notification debounced`);
-                return;
-            }
-            const notice = formatUpdateNotice(info);
-            if (!notice)
-                return;
-            const adminId = resolveAdminOpenId();
-            if (!adminId) {
-                log?.debug?.(`[qqbot:${account.accountId}] No admin or known user to send update notification`);
-                return;
-            }
-            const token = await getAccessToken(account.appId, account.clientSecret);
-            await sendProactiveC2CMessage(token, adminId, notice);
-            lastUpdateNotifyAt = Date.now();
-            log?.info(`[qqbot:${account.accountId}] Sent update notification to admin: ${adminId}`);
-        }
-        catch (err) {
-            log?.debug?.(`[qqbot:${account.accountId}] Failed to send update notification to admin: ${err}`);
-        }
-    });
     // 初始化 API 配置（markdown 支持）
     initApiConfig({
         markdownSupport: account.markdownSupport,
@@ -373,7 +346,7 @@ export async function startGateway(ctx) {
             attachments.push(attachment);
         }
         setRefIndex(refIdx, {
-            content: (meta.text ?? "").slice(0, 500),
+            content: meta.text ?? "",
             senderId: account.accountId,
             senderName: account.accountId,
             timestamp: Date.now(),
@@ -465,21 +438,23 @@ export async function startGateway(ctx) {
                 const greeting = getStartupGreeting();
                 if (!greeting) {
                     log?.info(`[qqbot:${account.accountId}] Skipping startup greeting (debounced, trigger=${trigger})`);
-                    return;
                 }
-                const adminId = resolveAdminOpenId();
-                if (!adminId) {
-                    log?.info(`[qqbot:${account.accountId}] Skipping startup greeting (no admin or known user)`);
-                    return;
+                else {
+                    const adminId = resolveAdminOpenId();
+                    if (!adminId) {
+                        log?.info(`[qqbot:${account.accountId}] Skipping startup greeting (no admin or known user)`);
+                    }
+                    else {
+                        log?.info(`[qqbot:${account.accountId}] Sending startup greeting to admin (trigger=${trigger}): "${greeting}"`);
+                        const token = await getAccessToken(account.appId, account.clientSecret);
+                        const GREETING_TIMEOUT_MS = 10_000;
+                        await Promise.race([
+                            sendProactiveC2CMessage(token, adminId, greeting),
+                            new Promise((_, reject) => setTimeout(() => reject(new Error("Startup greeting send timeout (10s)")), GREETING_TIMEOUT_MS)),
+                        ]);
+                        log?.info(`[qqbot:${account.accountId}] Sent startup greeting to admin: ${adminId}`);
+                    }
                 }
-                log?.info(`[qqbot:${account.accountId}] Sending startup greeting to admin (trigger=${trigger}): "${greeting}"`);
-                const token = await getAccessToken(account.appId, account.clientSecret);
-                const GREETING_TIMEOUT_MS = 10_000;
-                await Promise.race([
-                    sendProactiveC2CMessage(token, adminId, greeting),
-                    new Promise((_, reject) => setTimeout(() => reject(new Error("Startup greeting send timeout (10s)")), GREETING_TIMEOUT_MS)),
-                ]);
-                log?.info(`[qqbot:${account.accountId}] Sent startup greeting to admin: ${adminId}`);
             }
             catch (err) {
                 log?.error(`[qqbot:${account.accountId}] Failed to send startup greeting: ${err}`);
@@ -1506,23 +1481,27 @@ export async function startGateway(ctx) {
                                     };
                                     for (const item of sendQueue) {
                                         if (item.type === "text") {
-                                            try {
-                                                await sendWithTokenRetry(async (token) => {
-                                                    const ref = consumeQuoteRef();
-                                                    if (event.type === "c2c") {
-                                                        return await sendC2CMessage(token, event.senderId, item.content, event.messageId, ref);
-                                                    }
-                                                    else if (event.type === "group" && event.groupOpenid) {
-                                                        return await sendGroupMessage(token, event.groupOpenid, item.content, event.messageId);
-                                                    }
-                                                    else if (event.channelId) {
-                                                        return await sendChannelMessage(token, event.channelId, item.content, event.messageId);
-                                                    }
-                                                });
-                                                log?.info(`[qqbot:${account.accountId}] Sent text: ${item.content.slice(0, 50)}...`);
-                                            }
-                                            catch (err) {
-                                                log?.error(`[qqbot:${account.accountId}] Failed to send text: ${err}`);
+                                            // 对长文本进行分块发送
+                                            const textChunks = getQQBotRuntime().channel.text.chunkMarkdownText(item.content, TEXT_CHUNK_LIMIT);
+                                            for (const chunk of textChunks) {
+                                                try {
+                                                    await sendWithTokenRetry(async (token) => {
+                                                        const ref = consumeQuoteRef();
+                                                        if (event.type === "c2c") {
+                                                            return await sendC2CMessage(token, event.senderId, chunk, event.messageId, ref);
+                                                        }
+                                                        else if (event.type === "group" && event.groupOpenid) {
+                                                            return await sendGroupMessage(token, event.groupOpenid, chunk, event.messageId);
+                                                        }
+                                                        else if (event.channelId) {
+                                                            return await sendChannelMessage(token, event.channelId, chunk, event.messageId);
+                                                        }
+                                                    });
+                                                    log?.info(`[qqbot:${account.accountId}] Sent text chunk (${chunk.length}/${item.content.length} chars): ${chunk.slice(0, 50)}...`);
+                                                }
+                                                catch (err) {
+                                                    log?.error(`[qqbot:${account.accountId}] Failed to send text chunk: ${err}`);
+                                                }
                                             }
                                         }
                                         else if (item.type === "image") {
@@ -1589,9 +1568,7 @@ export async function startGateway(ctx) {
                                 const payloadResult = parseQQBotPayload(replyText);
                                 if (payloadResult.isPayload) {
                                     if (payloadResult.error) {
-                                        // 载荷解析失败，发送错误提示
                                         log?.error(`[qqbot:${account.accountId}] Payload parse error: ${payloadResult.error}`);
-                                        await sendErrorMessage(MSG.PAYLOAD_PARSE_ERROR);
                                         return;
                                     }
                                     if (payloadResult.payload) {
@@ -1662,7 +1639,7 @@ export async function startGateway(ctx) {
                                                         };
                                                         const mimeType = mimeTypes[ext];
                                                         if (!mimeType) {
-                                                            await sendErrorMessage(MSG.IMAGE_FORMAT_UNSUPPORTED(ext));
+                                                            log?.error(`[qqbot:${account.accountId}] Unsupported image format: ${ext}`);
                                                             return;
                                                         }
                                                         imageUrl = `data:${mimeType};base64,${base64Data}`;
@@ -1712,7 +1689,7 @@ export async function startGateway(ctx) {
                                                 try {
                                                     const ttsText = parsedPayload.caption || parsedPayload.path;
                                                     if (!ttsText?.trim()) {
-                                                        await sendErrorMessage(MSG.VOICE_MISSING_TEXT);
+                                                        log?.error(`[qqbot:${account.accountId}] Voice missing text`);
                                                     }
                                                     else {
                                                         const ttsCfg = resolveTTSConfig(cfg);
@@ -1732,7 +1709,8 @@ export async function startGateway(ctx) {
                                                                     await sendGroupVoiceMessage(token, event.groupOpenid, silkBase64, event.messageId);
                                                                 }
                                                                 else if (event.channelId) {
-                                                                    await sendChannelMessage(token, event.channelId, `${MSG.VOICE_CHANNEL_UNSUPPORTED}\n${ttsText}`, event.messageId);
+                                                                    log?.error(`[qqbot:${account.accountId}] Voice not supported in channel, sending text fallback`);
+                                                                    await sendChannelMessage(token, event.channelId, ttsText, event.messageId);
                                                                 }
                                                             });
                                                             log?.info(`[qqbot:${account.accountId}] Voice message sent`);
@@ -1748,7 +1726,7 @@ export async function startGateway(ctx) {
                                                 try {
                                                     const videoPath = normalizePath(parsedPayload.path ?? "");
                                                     if (!videoPath?.trim()) {
-                                                        await sendErrorMessage(MSG.VIDEO_MISSING_PATH);
+                                                        log?.error(`[qqbot:${account.accountId}] Video missing path`);
                                                     }
                                                     else {
                                                         const isHttpUrl = videoPath.startsWith("http://") || videoPath.startsWith("https://");
@@ -1763,7 +1741,7 @@ export async function startGateway(ctx) {
                                                                     await sendGroupVideoMessage(token, event.groupOpenid, videoPath, undefined, event.messageId);
                                                                 }
                                                                 else if (event.channelId) {
-                                                                    await sendChannelMessage(token, event.channelId, MSG.VIDEO_CHANNEL_UNSUPPORTED, event.messageId);
+                                                                    log?.error(`[qqbot:${account.accountId}] Video not supported in channel`);
                                                                 }
                                                             }
                                                             else {
@@ -1785,7 +1763,7 @@ export async function startGateway(ctx) {
                                                                     await sendGroupVideoMessage(token, event.groupOpenid, undefined, videoBase64, event.messageId);
                                                                 }
                                                                 else if (event.channelId) {
-                                                                    await sendChannelMessage(token, event.channelId, MSG.VIDEO_CHANNEL_UNSUPPORTED, event.messageId);
+                                                                    log?.error(`[qqbot:${account.accountId}] Video not supported in channel`);
                                                                 }
                                                             }
                                                         });
@@ -1815,7 +1793,7 @@ export async function startGateway(ctx) {
                                                 try {
                                                     const filePath = normalizePath(parsedPayload.path ?? "");
                                                     if (!filePath?.trim()) {
-                                                        await sendErrorMessage(MSG.FILE_MISSING_PATH);
+                                                        log?.error(`[qqbot:${account.accountId}] File missing path`);
                                                     }
                                                     else {
                                                         const isHttpUrl = filePath.startsWith("http://") || filePath.startsWith("https://");
@@ -1830,7 +1808,7 @@ export async function startGateway(ctx) {
                                                                     await sendGroupFileMessage(token, event.groupOpenid, undefined, filePath, event.messageId, fileName);
                                                                 }
                                                                 else if (event.channelId) {
-                                                                    await sendChannelMessage(token, event.channelId, MSG.FILE_CHANNEL_UNSUPPORTED, event.messageId);
+                                                                    log?.error(`[qqbot:${account.accountId}] File not supported in channel`);
                                                                 }
                                                             }
                                                             else {
@@ -1850,7 +1828,7 @@ export async function startGateway(ctx) {
                                                                     await sendGroupFileMessage(token, event.groupOpenid, fileBase64, undefined, event.messageId, fileName);
                                                                 }
                                                                 else if (event.channelId) {
-                                                                    await sendChannelMessage(token, event.channelId, MSG.FILE_CHANNEL_UNSUPPORTED, event.messageId);
+                                                                    log?.error(`[qqbot:${account.accountId}] File not supported in channel`);
                                                                 }
                                                             }
                                                         });
@@ -1863,7 +1841,6 @@ export async function startGateway(ctx) {
                                             }
                                             else {
                                                 log?.error(`[qqbot:${account.accountId}] Unknown media type: ${parsedPayload.mediaType}`);
-                                                await sendErrorMessage(MSG.UNSUPPORTED_MEDIA_TYPE);
                                             }
                                             // 记录活动并返回
                                             pluginRuntime.channel.activity.record({
@@ -1876,7 +1853,6 @@ export async function startGateway(ctx) {
                                         else {
                                             // 未知的载荷类型
                                             log?.error(`[qqbot:${account.accountId}] Unknown payload type: ${parsedPayload.type}`);
-                                            await sendErrorMessage(MSG.UNSUPPORTED_PAYLOAD_TYPE);
                                             return;
                                         }
                                     }
@@ -2064,23 +2040,26 @@ export async function startGateway(ctx) {
                                     }
                                     // 🔹 第三步：发送带公网图片的 markdown 消息
                                     if (textWithoutImages.trim()) {
-                                        try {
-                                            await sendWithTokenRetry(async (token) => {
-                                                const ref = consumeQuoteRef();
-                                                if (event.type === "c2c") {
-                                                    return await sendC2CMessage(token, event.senderId, textWithoutImages, event.messageId, ref);
-                                                }
-                                                else if (event.type === "group" && event.groupOpenid) {
-                                                    return await sendGroupMessage(token, event.groupOpenid, textWithoutImages, event.messageId);
-                                                }
-                                                else if (event.channelId) {
-                                                    return await sendChannelMessage(token, event.channelId, textWithoutImages, event.messageId);
-                                                }
-                                            });
-                                            log?.info(`[qqbot:${account.accountId}] Sent markdown message with ${httpImageUrls.length} HTTP images (${event.type})`);
-                                        }
-                                        catch (err) {
-                                            log?.error(`[qqbot:${account.accountId}] Failed to send markdown message: ${err}`);
+                                        const mdChunks = chunkText(textWithoutImages, TEXT_CHUNK_LIMIT);
+                                        for (const chunk of mdChunks) {
+                                            try {
+                                                await sendWithTokenRetry(async (token) => {
+                                                    const ref = consumeQuoteRef();
+                                                    if (event.type === "c2c") {
+                                                        return await sendC2CMessage(token, event.senderId, chunk, event.messageId, ref);
+                                                    }
+                                                    else if (event.type === "group" && event.groupOpenid) {
+                                                        return await sendGroupMessage(token, event.groupOpenid, chunk, event.messageId);
+                                                    }
+                                                    else if (event.channelId) {
+                                                        return await sendChannelMessage(token, event.channelId, chunk, event.messageId);
+                                                    }
+                                                });
+                                                log?.info(`[qqbot:${account.accountId}] Sent markdown chunk (${chunk.length}/${textWithoutImages.length} chars) with ${httpImageUrls.length} HTTP images (${event.type})`);
+                                            }
+                                            catch (err) {
+                                                log?.error(`[qqbot:${account.accountId}] Failed to send markdown message chunk: ${err}`);
+                                            }
                                         }
                                     }
                                 }
@@ -2120,21 +2099,24 @@ export async function startGateway(ctx) {
                                                 log?.error(`[qqbot:${account.accountId}] Failed to send image: ${imgErr}`);
                                             }
                                         }
-                                        // 发送文本消息
+                                        // 发送文本消息（分块）
                                         if (textWithoutImages.trim()) {
-                                            await sendWithTokenRetry(async (token) => {
-                                                const ref = consumeQuoteRef();
-                                                if (event.type === "c2c") {
-                                                    return await sendC2CMessage(token, event.senderId, textWithoutImages, event.messageId, ref);
-                                                }
-                                                else if (event.type === "group" && event.groupOpenid) {
-                                                    return await sendGroupMessage(token, event.groupOpenid, textWithoutImages, event.messageId);
-                                                }
-                                                else if (event.channelId) {
-                                                    return await sendChannelMessage(token, event.channelId, textWithoutImages, event.messageId);
-                                                }
-                                            });
-                                            log?.info(`[qqbot:${account.accountId}] Sent text reply (${event.type})`);
+                                            const plainChunks = chunkText(textWithoutImages, TEXT_CHUNK_LIMIT);
+                                            for (const chunk of plainChunks) {
+                                                await sendWithTokenRetry(async (token) => {
+                                                    const ref = consumeQuoteRef();
+                                                    if (event.type === "c2c") {
+                                                        return await sendC2CMessage(token, event.senderId, chunk, event.messageId, ref);
+                                                    }
+                                                    else if (event.type === "group" && event.groupOpenid) {
+                                                        return await sendGroupMessage(token, event.groupOpenid, chunk, event.messageId);
+                                                    }
+                                                    else if (event.channelId) {
+                                                        return await sendChannelMessage(token, event.channelId, chunk, event.messageId);
+                                                    }
+                                                });
+                                                log?.info(`[qqbot:${account.accountId}] Sent text chunk (${chunk.length}/${textWithoutImages.length} chars) (${event.type})`);
+                                            }
                                         }
                                     }
                                     catch (err) {
@@ -2219,7 +2201,7 @@ export async function startGateway(ctx) {
                             },
                         },
                         replyOptions: {
-                            disableBlockStreaming: false,
+                            disableBlockStreaming: true,
                         },
                     });
                     // 等待分发完成或超时
@@ -2352,6 +2334,7 @@ export async function startGateway(ctx) {
                             }
                             else if (t === "RESUMED") {
                                 log?.info(`[qqbot:${account.accountId}] Session resumed`);
+                                onReady?.(d); // 通知框架连接已恢复，避免 health-monitor 误判 disconnected
                                 // RESUMED 也属于首次启动（gateway restart 通常走 resume）
                                 if (isFirstReadyGlobal) {
                                     isFirstReadyGlobal = false;