chatccc 0.2.204 → 0.2.206

package/src/session.ts

@@ -21,7 +21,12 @@ import {
   toolDisplayName,
   ts,
 } from "./config.ts";
-import { buildProgressCard, getToolEmoji, isCodeBlockOpen, truncateContent } from "./cards.ts";
+import { buildProgressCard, getToolEmoji, isCodeBlockOpen, truncateContent } from "./cards.ts";
+import {
+  createAgentActivityTracker,
+  formatAgentActivityTitle,
+  updateAgentActivity,
+} from "./agent-activity.ts";
 import { simplifyToolUse, simplifyToolResult } from "./simplify.ts";
 import { logTrace } from "./trace.ts";
 import type { UnifiedBlock } from "./adapters/adapter-interface.ts";
@@ -31,9 +36,11 @@ import { createClaudeAdapter } from "./adapters/claude-adapter.ts";
 import { createCursorAdapter } from "./adapters/cursor-adapter.ts";
 import { createCodexAdapter } from "./adapters/codex-adapter.ts";
 import { createCccAdapter } from "./adapters/ccc-adapter.ts";
-import { resourceMonitor, registerProcess, unregisterProcess } from "./adapters/resource-monitor.ts";
-import { buildImSkillsPromptCached, exportSkillSubDocs, clearImSkillsPromptCache } from "./im-skills.ts";
-import type { PlatformAdapter } from "./platform-adapter.ts";
+import { killProcessTree } from "./adapters/proc-tree-kill.ts";
+import { resourceMonitor, registerProcess, unregisterProcess } from "./adapters/resource-monitor.ts";
+import { buildImSkillsPromptCached, exportSkillSubDocs, clearImSkillsPromptCache } from "./im-skills.ts";
+import type { PlatformAdapter } from "./platform-adapter.ts";
+import { hasResponseStalled, observeResponseProgress } from "./response-stall.ts";
 
 // 微信显示循环压缩：头5 + ... + 尾5，避免在最后一步 sendText 中压缩指令回复
 function compressWechatDisplayText(text: string): string {
@@ -82,18 +89,19 @@ async function sendFinalReplyTextOnce(
   return sent;
 }
 
-async function createVisibleProgressCard(
+async function createVisibleProgressCard(
   platform: PlatformAdapter,
   chatId: string,
   sessionId: string,
-  turnCount: number,
-  notifyFailureText?: string,
-): Promise<string | null> {
+  turnCount: number,
+  notifyFailureText?: string,
+  headerTitle = "正在启动 Agent · 0秒",
+): Promise<string | null> {
   for (let attempt = 1; attempt <= 2; attempt++) {
     let cardId: string | null = null;
     try {
-      cardId = await platform.cardCreate(
-        buildProgressCard("", { showStop: true, headerTitle: "生成中..." }),
+      cardId = await platform.cardCreate(
+        buildProgressCard("等待 Agent 输出...", { showStop: true, headerTitle }),
       );
       if (!cardId) throw new Error("empty card id");
       await platform.cardSend(chatId, cardId);
@@ -148,8 +156,12 @@ function platformForChat(chatId: string): PlatformAdapter | null {
   return chatPlatformMap.get(chatId) ?? platformRef;
 }
 
-const DEFAULT_PROCESS_MONITOR_INTERVAL_MS = 5000;
-let processMonitorIntervalMs = DEFAULT_PROCESS_MONITOR_INTERVAL_MS;
+const DEFAULT_PROCESS_MONITOR_INTERVAL_MS = 5000;
+const DEFAULT_RESPONSE_STALL_TIMEOUT_MS = 3 * 60 * 1000;
+const DEFAULT_RESPONSE_STALL_CHECK_INTERVAL_MS = 5000;
+let processMonitorIntervalMs = DEFAULT_PROCESS_MONITOR_INTERVAL_MS;
+let responseStallTimeoutMs = DEFAULT_RESPONSE_STALL_TIMEOUT_MS;
+let responseStallCheckIntervalMs = DEFAULT_RESPONSE_STALL_CHECK_INTERVAL_MS;
 let isProcessAliveImpl = (pid: number): boolean => {
   try {
     process.kill(pid, 0);
@@ -178,29 +190,68 @@ export function _setProcessMonitorIntervalForTest(ms: number): void {
   processMonitorIntervalMs = ms;
 }
 
-export function _resetProcessMonitorIntervalForTest(): void {
-  processMonitorIntervalMs = DEFAULT_PROCESS_MONITOR_INTERVAL_MS;
-}
+export function _resetProcessMonitorIntervalForTest(): void {
+  processMonitorIntervalMs = DEFAULT_PROCESS_MONITOR_INTERVAL_MS;
+}
+
+export function _setResponseStallTimeoutForTest(ms: number): void {
+  responseStallTimeoutMs = ms;
+}
+
+export function _resetResponseStallTimeoutForTest(): void {
+  responseStallTimeoutMs = DEFAULT_RESPONSE_STALL_TIMEOUT_MS;
+}
+
+export function _setResponseStallCheckIntervalForTest(ms: number): void {
+  responseStallCheckIntervalMs = ms;
+}
+
+export function _resetResponseStallCheckIntervalForTest(): void {
+  responseStallCheckIntervalMs = DEFAULT_RESPONSE_STALL_CHECK_INTERVAL_MS;
+}
 
-function clearPromptProcessMonitor(sessionId: string): void {
+function clearPromptProcessMonitor(sessionId: string): void {
   const prompt = activePrompts.get(sessionId);
   if (!prompt?.processMonitor) return;
   clearInterval(prompt.processMonitor);
   prompt.processMonitor = undefined;
-}
-
-function formatTerminalHeader(status: "running" | "done" | "stopped" | "error"): {
-  title: string;
-  template?: string;
-} {
-  if (status === "stopped") return { title: "已停止", template: "red" };
-  if (status === "error") return { title: "异常结束", template: "red" };
-  return { title: "完成" };
-}
-
-function turnFinalStatus(status: "running" | "done" | "stopped" | "error"): "done" | "stopped" {
-  return status === "stopped" || status === "error" ? "stopped" : "done";
-}
+}
+
+function clearPromptResponseStallMonitor(sessionId: string): void {
+  const prompt = activePrompts.get(sessionId);
+  if (!prompt?.responseStallMonitor) return;
+  clearInterval(prompt.responseStallMonitor);
+  prompt.responseStallMonitor = undefined;
+}
+
+function formatTerminalHeader(status: "running" | "done" | "stopped" | "error" | "auto_ended"): {
+  title: string;
+  template?: string;
+} {
+  if (status === "auto_ended") return { title: "已自动结束 · 3分钟无新内容", template: "orange" };
+  if (status === "stopped") return { title: "已停止", template: "red" };
+  if (status === "error") return { title: "异常结束", template: "red" };
+  return { title: "完成" };
+}
+
+function turnFinalStatus(status: "running" | "done" | "stopped" | "error" | "auto_ended"): "done" | "stopped" {
+  return status === "stopped" || status === "error" || status === "auto_ended" ? "stopped" : "done";
+}
+
+function formatAutoEndedReply(finalReply: string): string {
+  const reason = "⚠️ 已自动结束：连续 3 分钟处于“正在生成回复”且回复字符总数没有变化。";
+  return finalReply
+    ? `${reason}以下回复可能不完整。\n\n${finalReply}`
+    : `${reason}本轮没有可发送的回复内容。`;
+}
+
+function formatTerminalReply(
+  status: "running" | "done" | "stopped" | "error" | "auto_ended",
+  finalReply: string,
+): string | null {
+  if (status === "auto_ended") return formatAutoEndedReply(finalReply);
+  return finalReply || null;
+}
 
 function isCardKitSequenceConflict(err: unknown): boolean {
   return err instanceof Error && err.message.includes("300317");
@@ -218,7 +269,7 @@ function startPromptProcessMonitor(sessionId: string, info: ToolProcessInfo): vo
       clearPromptProcessMonitor(sessionId);
       return;
     }
-    if (current.stopped || current.abnormalExit || current.resourceStuck) return;
+    if (current.stopped || current.abnormalExit || current.resourceStuck || current.autoEnded) return;
     if (isProcessAliveImpl(info.pid)) return;
 
     current.abnormalExit = true;
@@ -331,9 +382,10 @@ export function resetState(): void {
   processedMessages.clear();
   lastMsgTimestamps.clear();
   chatPlatformMap.clear();
-  for (const prompt of activePrompts.values()) {
-    if (prompt.processMonitor) clearInterval(prompt.processMonitor);
-  }
+  for (const prompt of activePrompts.values()) {
+    if (prompt.processMonitor) clearInterval(prompt.processMonitor);
+    if (prompt.responseStallMonitor) clearInterval(prompt.responseStallMonitor);
+  }
   activePrompts.clear();
   displayCards.clear();
   sessionModelOverrides.clear();
@@ -958,7 +1010,7 @@ export async function runAgentSession(
   const onResourceStuck = (data: { pid: number; sessionId: string; idleMinutes: number }) => {
     if (data.sessionId !== sessionId) return;
     const prompt = activePrompts.get(sessionId);
-    if (!prompt || prompt.stopped || prompt.abnormalExit || prompt.resourceStuck) return;
+    if (!prompt || prompt.stopped || prompt.abnormalExit || prompt.resourceStuck || prompt.autoEnded) return;
     prompt.resourceStuck = true;
 
     const chatId = pickDisplayChat(sessionId) ?? getLastActiveChat(sessionId) ?? getChatsForSession(sessionId)[0];
@@ -1065,9 +1117,10 @@ export async function runAgentSession(
   // 导致 finalReply 丢失、完成卡片空白。此处主动读取上一轮终端状态完成
   // 卡片终结和回复发送，不依赖 display loop 时序，保证"先发完上一个回答
   // 再开始缓存问题对应的任务"。
-  const prevState = await readStreamState(sessionId);
-  if (prevState && prevState.status !== "running") {
-    const displayChatId = pickDisplayChat(sessionId);
+  const prevState = await readStreamState(sessionId);
+  if (prevState && prevState.status !== "running") {
+    const prevTerminalReply = formatTerminalReply(prevState.status, prevState.finalReply);
+    const displayChatId = pickDisplayChat(sessionId);
     if (displayChatId) {
       const pp = platformForChat(displayChatId);
       const display = displayCards.get(displayChatId);
@@ -1099,45 +1152,49 @@ export async function runAgentSession(
           const finalStatus = turnFinalStatus(prevState.status);
           finalizeTurnCards(sessionId, prevState.turnCount, finalStatus).catch(() => {});
 
-          if (prevState.finalReply && stillOursAfterUpdate && !isFinalReplySentForTurn(prevState)) {
-            await sendFinalReplyTextOnce(pp, displayChatId, sessionId, prevState.turnCount, prevState.finalReply);
-          }
+          if (prevTerminalReply && stillOursAfterUpdate && !isFinalReplySentForTurn(prevState)) {
+            await sendFinalReplyTextOnce(pp, displayChatId, sessionId, prevState.turnCount, prevTerminalReply);
+          }
           pp.setChatAvatar(displayChatId, prevState.tool, "idle").catch(() => {});
         }
-      } else if (pp && prevState.finalReply && !isFinalReplySentForTurn(prevState)) {
+      } else if (pp && prevTerminalReply && !isFinalReplySentForTurn(prevState)) {
         // 无 display 记录但上一轮有 finalReply（极快轮次），至少发送
         const finalStatus = turnFinalStatus(prevState.status);
         finalizeTurnCards(sessionId, prevState.turnCount, finalStatus).catch(() => {});
-        await sendFinalReplyTextOnce(pp, displayChatId, sessionId, prevState.turnCount, prevState.finalReply);
+        await sendFinalReplyTextOnce(pp, displayChatId, sessionId, prevState.turnCount, prevTerminalReply);
       }
       // else: displayCards 无记录且无 finalReply → 无需处理
     }
   }
 
   // 初始化 stream-state.json
-  const initialState = createEmptyStreamState(sessionId, cwd, tool, nextTurnCount);
-  await writeStreamState(initialState);
+  const initialState = createEmptyStreamState(sessionId, cwd, tool, nextTurnCount);
+  const activityTracker = createAgentActivityTracker(initialState.activity?.startedAt ?? Date.now());
+  await writeStreamState(initialState);
 
   // 为新 turn 创建第一张展示卡片，同时注册到 turn-cards 持久化。
   // 统一 display loop 始终运行，卡片创建后下一个 tick 即自动开始更新。
   const displayChatIdForNew = pickDisplayChat(sessionId);
-  if (displayChatIdForNew) {
-    const ppNew = platformForChat(displayChatIdForNew);
-    if (ppNew && ppNew.kind !== "wechat") {
-      const cardId = await createVisibleProgressCard(
+  if (displayChatIdForNew) {
+    const ppNew = platformForChat(displayChatIdForNew);
+    if (ppNew && ppNew.kind !== "wechat") {
+      const initialHeaderTitle = formatAgentActivityTitle(activityTracker.activity);
+      const cardId = await createVisibleProgressCard(
         ppNew,
         displayChatIdForNew,
         sessionId,
-        nextTurnCount,
-        "生成中卡片发送失败，结果将以文本形式发送。",
+        nextTurnCount,
+        "生成中卡片发送失败，结果将以文本形式发送。",
+        initialHeaderTitle,
       );
       if (cardId) {
         displayCards.set(displayChatIdForNew, {
           cardId,
           sequence: 1,
           cardBusy: false,
-          cardCreatedAt: Date.now(),
-          lastSentContent: "",
+          cardCreatedAt: Date.now(),
+          lastSentContent: "",
+          lastSentHeaderTitle: initialHeaderTitle,
           streamErrorNotified: false,
           sessionId,
           turnCount: nextTurnCount,
@@ -1178,8 +1235,71 @@ export async function runAgentSession(
   const toolCallMap = new Map<string, { name: string; input: unknown }>();
   let streamErrored = false;
 
+  const runningPrompt = activePrompts.get(sessionId);
+  if (runningPrompt) {
+    const checkResponseStall = async () => {
+      const current = activePrompts.get(sessionId);
+      if (!current || current !== runningPrompt) {
+        clearPromptResponseStallMonitor(sessionId);
+        return;
+      }
+      if (
+        current.stopped
+        || current.abnormalExit
+        || current.resourceStuck
+        || current.autoEnded
+        || activityTracker.activity.kind !== "responding"
+        || !hasResponseStalled(current.responseProgress, Date.now(), responseStallTimeoutMs)
+      ) {
+        return;
+      }
+
+      const autoEndedAt = Date.now();
+      current.autoEnded = true;
+      current.autoEndedAt = autoEndedAt;
+      clearPromptResponseStallMonitor(sessionId);
+      clearPromptProcessMonitor(sessionId);
+
+      // First publish an atomic terminal state so the card cannot keep claiming the
+      // Agent is running while process cleanup is underway.
+      await writeStreamState({
+        sessionId,
+        status: "auto_ended",
+        accumulatedContent: state.accumulatedContent,
+        finalReply: pickFinalReply(state).trim(),
+        activity: activityTracker.activity,
+        chunkCount: state.chunkCount,
+        turnCount: nextTurnCount,
+        contextTokens: existingInfo?.lastContextTokens ?? 0,
+        updatedAt: autoEndedAt,
+        cwd,
+        tool,
+        autoEndedAt,
+      });
+
+      try {
+        current.closeSession?.();
+      } catch (err) {
+        console.warn(`[${ts()}] [RESPONSE-STALL] closeSession failed for ${sessionId}: ${(err as Error).message}`);
+      }
+      current.controller.abort();
+      await killProcessTree(current.processPid);
+      console.warn(
+        `[${ts()}] [RESPONSE-STALL] Session ${sessionId} auto-ended after 3 minutes without reply character changes`,
+      );
+    };
+
+    const responseStallMonitor = setInterval(() => {
+      void checkResponseStall().catch((err) => {
+        console.warn(`[${ts()}] [RESPONSE-STALL] check failed for ${sessionId}: ${(err as Error).message}`);
+      });
+    }, responseStallCheckIntervalMs);
+    responseStallMonitor.unref?.();
+    runningPrompt.responseStallMonitor = responseStallMonitor;
+  }
+
   try {
-    for await (const unifiedMsg of adapter.prompt(sessionId, userTextWithCapabilities, cwd, controller.signal, {
+    for await (const unifiedMsg of adapter.prompt(sessionId, userTextWithCapabilities, cwd, controller.signal, {
       onProcessStart: (processInfo) => {
         startPromptProcessMonitor(sessionId, processInfo);
         if (processInfo.pid !== undefined) registerProcess(processInfo.pid, sessionId);
@@ -1193,8 +1313,10 @@ export async function runAgentSession(
         if (prompt) prompt.closeSession = closeSession;
       },
     })) {
-      for (const block of unifiedMsg.blocks) {
-        accumulateBlockContent(block, state, toolCallMap);
+      let activityChanged = false;
+      for (const block of unifiedMsg.blocks) {
+        if (updateAgentActivity(activityTracker, block)) activityChanged = true;
+        accumulateBlockContent(block, state, toolCallMap);
 
         if (block.type === "compact_boundary" && block.post_tokens) {
           for (const cid of getChatsForSession(sessionId)) {
@@ -1208,18 +1330,30 @@ export async function runAgentSession(
             lastContextTokens: block.post_tokens,
             running: true,
           });
-        }
-      }
-
-      // 定时写入文件
+        }
+      }
+
+      const prompt = activePrompts.get(sessionId);
+      if (prompt && !prompt.autoEnded) {
+        const totalChars = state.accumulatedContent.length + pickFinalReply(state).length;
+        prompt.responseProgress = observeResponseProgress(
+          prompt.responseProgress,
+          activityTracker.activity.kind === "responding",
+          totalChars,
+          Date.now(),
+        );
+      }
+
+      // 定时写入文件
       const now2 = Date.now();
-      if (now2 - lastFileWrite >= FILE_WRITE_INTERVAL_MS) {
-        lastFileWrite = now2;
-        await writeStreamState({
+      if (activityChanged || now2 - lastFileWrite >= FILE_WRITE_INTERVAL_MS) {
+        lastFileWrite = now2;
+        await writeStreamState({
           sessionId,
           status: "running",
-          accumulatedContent: state.accumulatedContent,
-          finalReply: pickFinalReply(state),
+          accumulatedContent: state.accumulatedContent,
+          finalReply: pickFinalReply(state),
+          activity: activityTracker.activity,
           chunkCount: state.chunkCount,
           turnCount: nextTurnCount,
           contextTokens: existingInfo?.lastContextTokens ?? 0,
@@ -1236,17 +1370,26 @@ export async function runAgentSession(
     // 标记 prompt 结束
     resourceMonitor.off("stuck", onResourceStuck);
     const prompt = activePrompts.get(sessionId);
-    const wasStopped = prompt?.stopped ?? false;
-    const wasAbnormalExit = prompt?.abnormalExit ?? false;
-    const wasResourceStuck = prompt?.resourceStuck ?? false;
-    clearPromptProcessMonitor(sessionId);
-    activePrompts.delete(sessionId);
+    const wasStopped = prompt?.stopped ?? false;
+    const wasAbnormalExit = prompt?.abnormalExit ?? false;
+    const wasResourceStuck = prompt?.resourceStuck ?? false;
+    const wasAutoEnded = prompt?.autoEnded ?? false;
+    const autoEndedAt = prompt?.autoEndedAt;
+    clearPromptResponseStallMonitor(sessionId);
+    clearPromptProcessMonitor(sessionId);
+    activePrompts.delete(sessionId);
 
     // 先写最终状态（done/stopped），确保 display loop 在下一轮消费前
     // 读到新状态并终结旧卡片。否则 setImmediate 在 CHECK 阶段先于
     // writeFile I/O（POLL 阶段）执行，display loop 会误以为旧轮仍在
     // 运行中并更新旧卡片，而不是新建卡片。
-    const finalStatus = (streamErrored || wasAbnormalExit || wasResourceStuck) ? "error" : wasStopped ? "stopped" : "done";
+    const finalStatus = wasAutoEnded
+      ? "auto_ended"
+      : (streamErrored || wasAbnormalExit || wasResourceStuck)
+        ? "error"
+        : wasStopped
+          ? "stopped"
+          : "done";
     const finalReply = pickFinalReply(state).trim();
 
     // stop-stuck-loop 接口可能在 fire-and-forget 中已写入带 final_reply 的
@@ -1267,16 +1410,18 @@ export async function runAgentSession(
     await writeStreamState({
       sessionId,
       status: finalStatus,
-      accumulatedContent: state.accumulatedContent,
-      finalReply: finalReplyToWrite,
+      accumulatedContent: state.accumulatedContent,
+      finalReply: finalReplyToWrite,
+      activity: activityTracker.activity,
       chunkCount: state.chunkCount,
       turnCount: nextTurnCount,
       contextTokens: existingInfo?.lastContextTokens ?? 0,
       updatedAt: Date.now(),
       cwd,
-      tool,
-      ...(preserveStuckAt ? { stuckAt: preserveStuckAt } : {}),
-    });
+      tool,
+      ...(preserveStuckAt ? { stuckAt: preserveStuckAt } : {}),
+      ...(autoEndedAt !== undefined ? { autoEndedAt } : {}),
+    });
 
     // 消费队列中的缓存消息（异步，不阻塞后续清理）
     // 用户 /stop 后应丢弃队列消息，避免用户停止后又自动开始新轮
@@ -1328,7 +1473,37 @@ export async function runAgentSession(
       }
       console.log(`[${ts()}] Session ${sessionId} stopped (content chunks: ${state.chunkCount})`);
       if (tid) logTrace(tid, "SESSION_END", { sessionId, outcome: "stopped", chunks: state.chunkCount });
-    } else if (wasAbnormalExit) {
+    } else if (wasAutoEnded) {
+      for (const cid of getChatsForSession(sessionId)) {
+        const finfo = sessionInfoMap.get(cid);
+        await recordSessionRegistry({
+          chatId: cid,
+          sessionId,
+          tool,
+          turnCount: finfo?.turnCount ?? nextTurnCount,
+          lastContextTokens: finfo?.lastContextTokens ?? nextContextTokens,
+          startTime: finfo?.startTime ?? now,
+          running: false,
+        });
+      }
+      const activeAutoEnded = getLastActiveChat(sessionId) ?? getChatsForSession(sessionId)[0];
+      if (activeAutoEnded) {
+        const terminalState = await readStreamState(sessionId);
+        if (!displayCards.has(activeAutoEnded) && (!terminalState || !isFinalReplySentForTurn(terminalState))) {
+          const pp = platformForChat(activeAutoEnded) ?? platform;
+          await sendFinalReplyTextOnce(
+            pp,
+            activeAutoEnded,
+            sessionId,
+            nextTurnCount,
+            formatAutoEndedReply(finalReplyToWrite),
+          );
+        }
+        platform.setChatAvatar(activeAutoEnded, tool, "idle").catch(() => {});
+      }
+      console.warn(`[${ts()}] Session ${sessionId} auto-ended after stalled response output (content chunks: ${state.chunkCount})`);
+      if (tid) logTrace(tid, "SESSION_END", { sessionId, outcome: "response_stall", chunks: state.chunkCount });
+    } else if (wasAbnormalExit) {
       for (const cid of getChatsForSession(sessionId)) {
         const finfo = sessionInfoMap.get(cid);
         await recordSessionRegistry({
@@ -1445,10 +1620,14 @@ export function startUnifiedDisplayLoop(): void {
               // 还没执行，当前 stream state 可能是 stopSession fire-and-forget
               // 写入的，finalReply 滞后于内存态。跳过发送，等 finally 落盘后
               // 下一次 tick 再处理，避免发送过期内容或与后续发送重复。
-              if (activePrompts.has(sessionId)) continue;
-
-              const tail = "━━━ 回答结束 ━━━";
-              const finalMsg = remaining ? remaining + "\n" + tail : tail;
+              if (activePrompts.has(sessionId)) continue;
+
+              const tail = "━━━ 回答结束 ━━━";
+              const finalMsg = state.status === "auto_ended"
+                ? formatAutoEndedReply(remaining)
+                : remaining
+                  ? remaining + "\n" + tail
+                  : tail;
               if (!isFinalReplySentForTurn(state)) {
                 await sendFinalReplyTextOnce(p, chatId, sessionId, state.turnCount, finalMsg);
               }
@@ -1497,11 +1676,12 @@ export function startUnifiedDisplayLoop(): void {
                 continue;
               }
 
-              let terminalTextDelivered = true;
-              if (state.finalReply) {
-                if (!isFinalReplySentForTurn(state)) {
-                  terminalTextDelivered = await sendFinalReplyTextOnce(p, chatId, sessionId, state.turnCount, state.finalReply);
-                }
+              let terminalTextDelivered = true;
+              const terminalReply = formatTerminalReply(state.status, state.finalReply);
+              if (terminalReply) {
+                if (!isFinalReplySentForTurn(state)) {
+                  terminalTextDelivered = await sendFinalReplyTextOnce(p, chatId, sessionId, state.turnCount, terminalReply);
+                }
               } else if (state.accumulatedContent.trim()) {
                 const short = truncateContent(state.accumulatedContent, 30, 4000);
                 terminalTextDelivered = await p.sendText(chatId, `[生成过程]\n${short}`).then((ok) => ok !== false).catch(() => false);
@@ -1553,14 +1733,16 @@ export function startUnifiedDisplayLoop(): void {
               }
             } else {
               // 非 WeChat: 卡片流程
-              if (display.turnCount !== state.turnCount) {
+              if (display.turnCount !== state.turnCount) {
                 console.log(`[${ts()}] [DISPLAY] turn mismatch for ${chatId}: display.turnCount=${display.turnCount} state.turnCount=${state.turnCount}, resetting`);
                 finalizeTurnCards(sessionId, display.turnCount, "done").catch(() => {});
                 displayCards.delete(chatId);
-                continue;
-              }
-
-              // 卡片轮转
+                continue;
+              }
+
+              const activityHeaderTitle = formatAgentActivityTitle(state.activity, Date.now());
+
+              // 卡片轮转
               if (Date.now() - display.cardCreatedAt > CARD_ROTATE_MS) {
                 display.cardBusy = true;
                 try {
@@ -1568,8 +1750,9 @@ export function startUnifiedDisplayLoop(): void {
                     p,
                     chatId,
                     sessionId,
-                    display.turnCount,
-                    display.streamErrorNotified ? undefined : "生成中卡片发送失败，结果将继续更新在上一张卡片中。",
+                    display.turnCount,
+                    display.streamErrorNotified ? undefined : "生成中卡片发送失败，结果将继续更新在上一张卡片中。",
+                    activityHeaderTitle,
                   );
                   if (!newCardId) {
                     display.streamErrorNotified = true;
@@ -1577,7 +1760,7 @@ export function startUnifiedDisplayLoop(): void {
                   }
                   const oldSeqBase = display.sequence;
                   const oldContent = state.accumulatedContent + state.finalReply;
-                  const oldCard = buildProgressCard(truncateContent(oldContent) || " ", { showStop: false, headerTitle: "生成中（上轮）" });
+                  const oldCard = buildProgressCard(truncateContent(oldContent) || " ", { showStop: false, headerTitle: "上一阶段记录" });
                   await p.cardUpdate(display.cardId, oldCard, oldSeqBase + 1).then(() => {
                     display.sequence = oldSeqBase + 1;
                   }).catch(err => {
@@ -1588,9 +1771,10 @@ export function startUnifiedDisplayLoop(): void {
                   display.sequence = 1;
                   display.cardCreatedAt = Date.now();
                   display.rotationAccLen = state.accumulatedContent.length;
-                  display.rotationFinalReply = state.finalReply;
-                  display.lastSentContent = "";
-                  display.streamErrorNotified = false;
+                  display.rotationFinalReply = state.finalReply;
+                  display.lastSentContent = "";
+                  display.lastSentHeaderTitle = activityHeaderTitle;
+                  display.streamErrorNotified = false;
                 } catch (err) {
                   console.error(`[${ts()}] [CARDIKT] rotation FAIL for ${chatId}: ${(err as Error).message}`);
                 } finally {
@@ -1608,17 +1792,24 @@ export function startUnifiedDisplayLoop(): void {
                   replyDelta = state.finalReply.slice(rotReply.length);
                 } else {
                   replyDelta = state.finalReply;
-                }
-                const delta = (accDelta + replyDelta).trim();
-
-                display.dotCount = (display.dotCount % 9) + 1;
-                let deltaBase = (delta || "");
-                if (isCodeBlockOpen(deltaBase)) deltaBase += "\n```";
-                const displayContent = deltaBase + "\n" + "。" .repeat(display.dotCount);
-                if (displayContent === display.lastSentContent) continue;
-
-                display.lastSentContent = displayContent;
-                const deltaCard = buildProgressCard(truncateContent(displayContent) || "处理中...", { showStop: true, headerTitle: "生成中..." });
+                }
+                const delta = (accDelta + replyDelta).trim();
+
+                display.dotCount = (display.dotCount % 9) + 1;
+                let deltaBase = delta;
+                if (isCodeBlockOpen(deltaBase)) deltaBase += "\n```";
+                const displayContent = deltaBase + "\n" + "。".repeat(display.dotCount);
+                if (
+                  displayContent === display.lastSentContent
+                  && activityHeaderTitle === display.lastSentHeaderTitle
+                ) continue;
+
+                display.lastSentContent = displayContent;
+                display.lastSentHeaderTitle = activityHeaderTitle;
+                const deltaCard = buildProgressCard(truncateContent(displayContent) || "等待 Agent 输出...", {
+                  showStop: true,
+                  headerTitle: activityHeaderTitle,
+                });
                 display.cardBusy = true;
                 const mySeq = display.sequence + 1;
                 try {
@@ -1637,20 +1828,24 @@ export function startUnifiedDisplayLoop(): void {
                   display.cardBusy = false;
                 }
                 continue;
-              }
-
-              display.dotCount = (display.dotCount % 9) + 1;
-              let contentBase = state.accumulatedContent + state.finalReply;
-              if (isCodeBlockOpen(contentBase)) contentBase += "\n```";
-              const fullContent = contentBase + "\n" + "。".repeat(display.dotCount);
-              if (fullContent === display.lastSentContent) continue;
-
-              display.lastSentContent = fullContent;
-              const cardContent = truncateContent(fullContent);
+              }
+
+              display.dotCount = (display.dotCount % 9) + 1;
+              let contentBase = state.accumulatedContent + state.finalReply;
+              if (isCodeBlockOpen(contentBase)) contentBase += "\n```";
+              const fullContent = contentBase + "\n" + "。".repeat(display.dotCount);
+              if (
+                fullContent === display.lastSentContent
+                && activityHeaderTitle === display.lastSentHeaderTitle
+              ) continue;
+
+              display.lastSentContent = fullContent;
+              display.lastSentHeaderTitle = activityHeaderTitle;
+              const cardContent = truncateContent(fullContent) || "等待 Agent 输出...";
               display.cardBusy = true;
               const mySeq = display.sequence + 1;
               try {
-                const card = buildProgressCard(cardContent, { showStop: true, headerTitle: "生成中..." });
+                const card = buildProgressCard(cardContent, { showStop: true, headerTitle: activityHeaderTitle });
                 await p.cardUpdate(display.cardId, card, mySeq);
                 display.sequence = mySeq;
               } catch (err) {
@@ -1710,8 +1905,9 @@ export function stopUnifiedDisplayLoop(): void {
 export function stopSession(sessionId: string): boolean {
   const prompt = activePrompts.get(sessionId);
   if (!prompt) return false;
-  prompt.stopped = true;
-  clearPromptProcessMonitor(sessionId);
+  prompt.stopped = true;
+  clearPromptResponseStallMonitor(sessionId);
+  clearPromptProcessMonitor(sessionId);
   cancelQueuedMessage(sessionId);
   try {
     prompt.closeSession?.();