@jerryliang122/openclaw-qqbot 1.0.3 → 1.0.5

package/dist/index.d.cts

@@ -860,8 +860,13 @@ declare class StreamingController {
     private session;
     /** QQ 已接受的最新文本 — 单源真理 */
     private lastAcceptedFull;
-    /** 已成功发送的分片数（降级：=0 则走静态消息兜底） */
+    /** 已成功发送的分片数（降级：=0 且无外部投递则走静态消息兜底） */
     private sentChunkCount;
+    /**
+     * 标记：内容已通过非流式通道成功投递（如 ask_user 按钮卡片）。
+     * 置 true 后 handleFinalize 不再走 fallback 路径，避免框架误报 outcome=error。
+     */
+    private _deliveredExternally;
     /** 同步标志：收到第一个 onPartialReply 即置 true（不等 async 完成） */
     private _hasStarted;
     /** 串行队列 */
@@ -882,6 +887,11 @@ declare class StreamingController {
     get hasStarted(): boolean;
     get isTerminal(): boolean;
     get shouldFallbackToStatic(): boolean;
+    /**
+     * 告知控制器内容已通过外部通道投递（如 ask_user 卡片）。
+     * 后续 finalize() 不会走 fallback 路径，框架不会误报 outcome=error。
+     */
+    markDeliveredExternally(): void;
     onPartialReply(text: string): Promise<void>;
     finalize(): Promise<void>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jerryliang122/openclaw-qqbot",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "QQ Bot channel plugin for OpenClaw (independently maintained fork)",
   "publishConfig": {
     "access": "public",

package/src/dispatch/dispatch.ts

@@ -298,6 +298,8 @@ export async function dispatchToOpenClaw(
             try {
               await bot.sendTextWithKeyboard(replyTarget, text, keyboard as never);
               outboundSendOk++;
+              // 标记流式控制器：内容已通过外部通道投递，finalize 不走 fallback
+              streamingController?.markDeliveredExternally();
               dlog?.debug(`[question] sent ask_user with keyboard questionId=${questionId} options=${optionValues.length}`);
               return;
             } catch (err) {
@@ -331,6 +333,8 @@ export async function dispatchToOpenClaw(
                 await bot.sendTextWithKeyboard(replyTarget, cardText, keyboard as never);
                 outboundSendOk++;
               }
+              // 标记流式控制器：内容已通过外部通道投递，finalize 不走 fallback
+              streamingController?.markDeliveredExternally();
               dlog?.debug(`[question] sent multi-question ask_user questionId=${questionId} questions=${questions.length}`);
               return;
             } catch (err) {
@@ -356,6 +360,10 @@ export async function dispatchToOpenClaw(
       }
 
       // ── 2. 流式路径：流式已启动且未降级 -> 跳过静态发送 ──
+      // 例外：isError payload（agent run 失败通知）必须落到默认路径发出。
+      // 失败文案从未进入流式通道（模型死在半路），「final 已由流式发过」的
+      // 去重假设不成立——早退 return 会把通知吞掉，用户只见首分片后静默
+      // （issue #8：静态流式首分片 1062 字符已发，模型超时后无任何提示）。
       if (streamingController?.hasStarted && !streamingController?.shouldFallbackToStatic) {
         if (streamingController.isStaticSendMode) {
           // static 模式：flush 主路径由 onToolStart 驱动（工具开始前，绕开 SDK
@@ -370,8 +378,13 @@ export async function dispatchToOpenClaw(
           // stream 模式：tool/final 时收尾当前打字机流（原行为）
           await streamingController.finalize();
         }
-        if (!streamingController.shouldFallbackToStatic) return;
-        dlog?.warn(`streaming fallback to static`);
+        if (payload.isError === true) {
+          dlog?.info(`run-failure notice bypasses streaming dedup (kind=${kind ?? 'none'} textLen=${text.length})`);
+        } else if (!streamingController.shouldFallbackToStatic) {
+          return;
+        } else {
+          dlog?.warn(`streaming fallback to static`);
+        }
       }
 
       // ── 3. 文本去重：同文本已发过 -> 跳过 ──

package/src/outbound/deliver-pipeline.ts

@@ -27,6 +27,11 @@ export interface DeliverPayload {
   mediaUrl?: string;
   mediaUrls?: string[];
   audioAsVoice?: boolean;
+  /**
+   * agent run 失败通知 payload（框架 markAgentRunFailureReplyPayload 必置 true）。
+   * 这类文本从未进入流式通道（模型死在半路），流式去重早退对它不适用。
+   */
+  isError?: boolean;
 }
 
 export interface DeliverInfo {

package/src/outbound/streaming-controller.ts

@@ -51,9 +51,15 @@ export class StreamingController {
   /** QQ 已接受的最新文本 — 单源真理 */
   private lastAcceptedFull = '';
 
-  /** 已成功发送的分片数（降级：=0 则走静态消息兜底） */
+  /** 已成功发送的分片数（降级：=0 且无外部投递则走静态消息兜底） */
   private sentChunkCount = 0;
 
+  /**
+   * 标记：内容已通过非流式通道成功投递（如 ask_user 按钮卡片）。
+   * 置 true 后 handleFinalize 不再走 fallback 路径，避免框架误报 outcome=error。
+   */
+  private _deliveredExternally = false;
+
   /** 同步标志：收到第一个 onPartialReply 即置 true（不等 async 完成） */
   private _hasStarted = false;
 
@@ -87,7 +93,15 @@ export class StreamingController {
   }
 
   get shouldFallbackToStatic(): boolean {
-    return this.isTerminal && this.sentChunkCount === 0;
+    return this.isTerminal && this.sentChunkCount === 0 && !this._deliveredExternally;
+  }
+
+  /**
+   * 告知控制器内容已通过外部通道投递（如 ask_user 卡片）。
+   * 后续 finalize() 不会走 fallback 路径，框架不会误报 outcome=error。
+   */
+  markDeliveredExternally(): void {
+    this._deliveredExternally = true;
   }
 
   // ── 入口 ──
@@ -212,6 +226,9 @@ export class StreamingController {
       } else if (this.sentChunkCount > 0 && this.lastAcceptedFull) {
         // 未提供 sendStatic → 降级标记，由上层兜底发送
         this.transition('failed', 'finalize:no_sendstatic');
+      } else if (this._deliveredExternally) {
+        // 内容已通过外部通道投递（如 ask_user 卡片），非失败
+        this.transition('done', 'finalize');
       } else {
         this.transition('done', 'finalize:fallback');
       }
@@ -227,8 +244,8 @@ export class StreamingController {
     }
 
     // 无会话 — 视有无下发决定终态
-    if (this.sentChunkCount > 0) {
-      this.transition('done', 'finalize:no_session');
+    if (this.sentChunkCount > 0 || this._deliveredExternally) {
+      this.transition('done', this.sentChunkCount > 0 ? 'finalize:no_session' : 'finalize');
     } else {
       this.transition('done', 'finalize:fallback');
     }