chatccc 0.2.203 → 0.2.205

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";
@@ -82,18 +87,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);
@@ -1115,29 +1121,33 @@ export async function runAgentSession(
   }
 
   // 初始化 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,
@@ -1179,7 +1189,7 @@ export async function runAgentSession(
   let streamErrored = false;
 
   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 +1203,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)) {
@@ -1213,13 +1225,14 @@ export async function runAgentSession(
 
       // 定时写入文件
       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,
@@ -1267,8 +1280,9 @@ 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,
@@ -1553,14 +1567,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 +1584,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 +1594,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 +1605,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 +1626,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 +1662,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) {

package/src/startup-lifecycle.ts

@@ -0,0 +1,96 @@
+import { spawn, type ChildProcess } from "node:child_process";
+
+/**
+ * ChatCCC 自己拉起替代进程时使用的内部标记。
+ *
+ * 不能用“是否已有配置”判断是否打开控制台：首次配置和日常直接启动都应该
+ * 打开，而 `/restart`、`/update` 和 Web UI 重启都不应该打扰用户。环境变量
+ * 会自然穿过 cmd/bash/npx 这几层启动器，因此也适用于 Windows 与 Linux。
+ */
+export const INTERNAL_RESTART_ENV_VAR = "CHATCCC_INTERNAL_RESTART";
+
+type Environment = Record<string, string | undefined>;
+
+export function createInternalRestartEnv(
+  inherited: Environment = process.env,
+): NodeJS.ProcessEnv {
+  return {
+    ...inherited,
+    [INTERNAL_RESTART_ENV_VAR]: "1",
+  };
+}
+
+/** 用户直接启动时打开；ChatCCC 内部重启产生的替代进程不打开。 */
+interface AutoOpenWebUiOptions {
+  env?: Environment;
+  openOnStart?: boolean;
+}
+
+export function shouldAutoOpenWebUi(options: AutoOpenWebUiOptions = {}): boolean {
+  const env = options.env ?? process.env;
+  return options.openOnStart !== false && env[INTERNAL_RESTART_ENV_VAR] !== "1";
+}
+
+/** Web UI 始终使用 localhost，并跟随实际配置端口。 */
+export function buildWebUiUrl(port: number): string {
+  return `http://localhost:${port}/`;
+}
+
+interface OpenBrowserDeps {
+  platform?: NodeJS.Platform;
+  env?: Environment;
+  spawnImpl?: typeof spawn;
+  onError?: (message: string) => void;
+  onInfo?: (message: string) => void;
+}
+
+/**
+ * 调用操作系统默认浏览器打开 Web UI，与 Chrome CDP 守护功能完全独立。
+ * 返回值仅表示打开请求是否成功发起；浏览器是否复用标签页由系统浏览器决定。
+ */
+export function openWebUiInDefaultBrowser(
+  port: number,
+  deps: OpenBrowserDeps = {},
+): boolean {
+  const url = buildWebUiUrl(port);
+  const platform = deps.platform ?? process.platform;
+  const env = deps.env ?? process.env;
+  const spawnImpl = deps.spawnImpl ?? spawn;
+  const onError = deps.onError ?? ((message: string) => console.error(message));
+  const onInfo = deps.onInfo ?? ((message: string) => console.log(message));
+
+  // Linux 服务器通常没有图形会话。此时调用 xdg-open 只会制造噪音；
+  // 直接给出可复制的 SSH 隧道命令，让用户从自己的电脑访问本地 Web UI。
+  if (platform === "linux" && !env.DISPLAY && !env.WAYLAND_DISPLAY) {
+    onInfo(
+      `[WEB-UI] 未检测到 Linux 图形桌面，跳过自动打开浏览器。` +
+      `可在本机执行 ssh -L ${port}:127.0.0.1:${port} <user>@<server>，` +
+      `然后访问 ${url}`,
+    );
+    return false;
+  }
+
+  try {
+    let child: ChildProcess;
+    if (platform === "win32") {
+      // `start` 会把第一个带引号的参数当窗口标题，空字符串是必要占位符。
+      child = spawnImpl("cmd.exe", ["/c", "start", "", url], {
+        detached: true,
+        stdio: "ignore",
+        windowsHide: true,
+      });
+    } else if (platform === "darwin") {
+      child = spawnImpl("open", [url], { detached: true, stdio: "ignore" });
+    } else {
+      child = spawnImpl("xdg-open", [url], { detached: true, stdio: "ignore" });
+    }
+    child.on("error", (err) => {
+      onError(`[WEB-UI] 自动打开浏览器失败: ${err.message}`);
+    });
+    child.unref();
+    return true;
+  } catch (err) {
+    onError(`[WEB-UI] 自动打开浏览器失败: ${(err as Error).message}`);
+    return false;
+  }
+}

package/src/stream-state.ts

@@ -1,7 +1,9 @@
 import { readFile, writeFile, mkdir, rename, unlink } from "node:fs/promises";
 import { dirname, join } from "node:path";
 
-import { USER_DATA_DIR, ts } from "./config.ts";
+import { USER_DATA_DIR, ts } from "./config.ts";
+import { createAgentActivityTracker } from "./agent-activity.ts";
+import type { AgentActivity } from "./agent-activity.ts";
 
 // ---------------------------------------------------------------------------
 // stream-state.json — 每个 session 的流式输出持久化文件
@@ -16,7 +18,9 @@ export interface StreamState {
   /** 本轮会话中 LLM 输出的全部文本内容（所有 text block 的累加）。
    *  命名含 "final" 但实为"全部累积文本"，并非仅"最终一段回复"。
    *  参见 session.ts 的 AccumulatorState 注释。 */
-  finalReply: string;
+  finalReply: string;
+  /** Current user-visible work phase for running progress cards. */
+  activity?: AgentActivity;
   /** The turn whose terminal text reply has already been delivered to IM. */
   finalReplySentTurn?: number;
   finalReplySentAt?: number;
@@ -122,16 +126,18 @@ export async function markFinalReplySent(sessionId: string, turnCount: number, s
   await writeStreamState(state);
 }
 
-export function createEmptyStreamState(sessionId: string, cwd: string, tool: string, turnCount: number): StreamState {
-  return {
+export function createEmptyStreamState(sessionId: string, cwd: string, tool: string, turnCount: number): StreamState {
+  const now = Date.now();
+  return {
     sessionId,
     status: "running",
-    accumulatedContent: "",
-    finalReply: "",
+    accumulatedContent: "",
+    finalReply: "",
+    activity: createAgentActivityTracker(now).activity,
     chunkCount: 0,
     turnCount,
     contextTokens: 0,
-    updatedAt: Date.now(),
+    updatedAt: now,
     cwd,
     tool,
   };