chatccc 0.2.41 → 0.2.43

package/src/__tests__/cards.test.ts

@@ -311,7 +311,7 @@ describe("buildSessionsCard", () => {
 
   it("returns valid JSON with session listing", () => {
     const card = buildSessionsCard([
-      { sessionId: "abc123", active: true, turnCount: 5, elapsedSeconds: 120, model: "Claude Opus 4.7", tool: "claude" },
+      { sessionId: "abc123", chatName: "test-group", active: true, turnCount: 5, elapsedSeconds: 120, model: "Claude Opus 4.7", tool: "claude" },
     ]);
     const parsed = JSON.parse(card);
     expect(parsed.elements[0].text.content).toContain("共 **1** 个会话");
@@ -322,7 +322,7 @@ describe("buildSessionsCard", () => {
 
   it("shows idle status for inactive sessions", () => {
     const card = buildSessionsCard([
-      { sessionId: "xyz", active: false, turnCount: 0, elapsedSeconds: null, model: "Claude Sonnet 4.6", tool: "claude" },
+      { sessionId: "xyz", chatName: "", active: false, turnCount: 0, elapsedSeconds: null, model: "Claude Sonnet 4.6", tool: "claude" },
     ]);
     const parsed = JSON.parse(card);
     expect(parsed.elements[0].text.content).toContain("⚪ 空闲");
@@ -330,7 +330,7 @@ describe("buildSessionsCard", () => {
 
   it("shows elapsed time for active sessions", () => {
     const card = buildSessionsCard([
-      { sessionId: "active123", active: true, turnCount: 3, elapsedSeconds: 95, model: "Claude Opus 4.7", tool: "claude" },
+      { sessionId: "active123", chatName: "", active: true, turnCount: 3, elapsedSeconds: 95, model: "Claude Opus 4.7", tool: "claude" },
     ]);
     const parsed = JSON.parse(card);
     expect(parsed.elements[0].text.content).toContain("1分35秒");
@@ -338,8 +338,8 @@ describe("buildSessionsCard", () => {
 
   it("separates Claude Code and Cursor sessions", () => {
     const card = buildSessionsCard([
-      { sessionId: "c1", active: false, turnCount: 1, elapsedSeconds: null, model: "(留空)", tool: "claude" },
-      { sessionId: "c2", active: false, turnCount: 2, elapsedSeconds: null, model: "claude-opus-4-7-max", tool: "cursor" },
+      { sessionId: "c1", chatName: "", active: false, turnCount: 1, elapsedSeconds: null, model: "(留空)", tool: "claude" },
+      { sessionId: "c2", chatName: "", active: false, turnCount: 2, elapsedSeconds: null, model: "claude-opus-4-7-max", tool: "cursor" },
     ]);
     const parsed = JSON.parse(card);
     const content: string = parsed.elements[0].text.content;
@@ -349,7 +349,7 @@ describe("buildSessionsCard", () => {
 
   it("omits Cursor section when no Cursor sessions", () => {
     const card = buildSessionsCard([
-      { sessionId: "c1", active: false, turnCount: 1, elapsedSeconds: null, model: "(留空)", tool: "claude" },
+      { sessionId: "c1", chatName: "", active: false, turnCount: 1, elapsedSeconds: null, model: "(留空)", tool: "claude" },
     ]);
     const parsed = JSON.parse(card);
     const content: string = parsed.elements[0].text.content;
@@ -357,6 +357,22 @@ describe("buildSessionsCard", () => {
     expect(content).not.toContain("Cursor 会话");
   });
 
+  it("displays chatName when provided", () => {
+    const card = buildSessionsCard([
+      { sessionId: "abc123", chatName: "帮我写代码-src", active: false, turnCount: 2, elapsedSeconds: null, model: "Claude Opus 4.7", tool: "claude" },
+    ]);
+    const parsed = JSON.parse(card);
+    expect(parsed.elements[0].text.content).toContain("帮我写代码-src");
+  });
+
+  it("includes /session help text in non-empty card", () => {
+    const card = buildSessionsCard([
+      { sessionId: "abc123", chatName: "", active: false, turnCount: 2, elapsedSeconds: null, model: "Claude Opus 4.7", tool: "claude" },
+    ]);
+    const parsed = JSON.parse(card);
+    expect(parsed.elements[2].text.content).toContain("/session 数字");
+  });
+
   it("includes close button", () => {
     const card = buildSessionsCard([]);
     const parsed = JSON.parse(card);

package/src/__tests__/crash-logging.test.ts

@@ -1,9 +1,9 @@
-import { mkdtemp, readFile, rm } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { describe, it, expect, vi } from "vitest";
-
-import { buildCrashLoggingHandlers, installCrashLogging, setupFileLogging } from "../shared.ts";
+import { mkdtemp, readFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { describe, it, expect, vi } from "vitest";
+
+import { buildCrashLoggingHandlers, installCrashLogging, setupFileLogging } from "../shared.ts";
 
 describe("buildCrashLoggingHandlers", () => {
   it("uncaughtException: 写诊断、刷新日志、调用 onFatal", () => {
@@ -144,7 +144,7 @@ describe("buildCrashLoggingHandlers", () => {
   });
 });
 
-describe("installCrashLogging", () => {
+describe("installCrashLogging", () => {
   it("注册所有相关事件监听器", () => {
     const before = {
       uncaught: process.listenerCount("uncaughtException"),
@@ -209,58 +209,58 @@ describe("installCrashLogging", () => {
     } finally {
       cleanup();
     }
-  });
-});
-
-describe("setupFileLogging", () => {
-  it("flush 后继续写日志不会触发 write after end，且日志已落盘", async () => {
-    const originalLog = console.log;
-    const originalError = console.error;
-    console.log = vi.fn() as never;
-    console.error = vi.fn() as never;
-    const dir = await mkdtemp(join(tmpdir(), "chatccc-log-"));
-
-    try {
-      const fileLog = setupFileLogging(dir, "index");
-
-      console.log("before flush");
-      fileLog.flush();
-
-      expect(() => console.error("after flush")).not.toThrow();
-      fileLog.flush();
-
-      const content = await readFile(fileLog.logPath, "utf8");
-      expect(content).toContain("[LOG] before flush");
-      expect(content).toContain("[ERR] after flush");
-    } finally {
-      console.log = originalLog;
-      console.error = originalError;
-      await rm(dir, { recursive: true, force: true });
-    }
-  });
-
-  it("日志参数无法 JSON 序列化时也不会让 console 调用抛错", async () => {
-    const originalLog = console.log;
-    const originalError = console.error;
-    console.log = vi.fn() as never;
-    console.error = vi.fn() as never;
-    const dir = await mkdtemp(join(tmpdir(), "chatccc-log-"));
-
-    try {
-      const fileLog = setupFileLogging(dir, "index");
-      const circular: Record<string, unknown> = { name: "root" };
-      circular.self = circular;
-
-      expect(() => console.log("circular", circular)).not.toThrow();
-      fileLog.flush();
-
-      const content = await readFile(fileLog.logPath, "utf8");
-      expect(content).toContain("[LOG] circular");
-      expect(content).toContain("self");
-    } finally {
-      console.log = originalLog;
-      console.error = originalError;
-      await rm(dir, { recursive: true, force: true });
-    }
-  });
-});
+  });
+});
+
+describe("setupFileLogging", () => {
+  it("flush 后继续写日志不会触发 write after end，且日志已落盘", async () => {
+    const originalLog = console.log;
+    const originalError = console.error;
+    console.log = vi.fn() as never;
+    console.error = vi.fn() as never;
+    const dir = await mkdtemp(join(tmpdir(), "chatccc-log-"));
+
+    try {
+      const fileLog = setupFileLogging(dir, "index");
+
+      console.log("before flush");
+      fileLog.flush();
+
+      expect(() => console.error("after flush")).not.toThrow();
+      fileLog.flush();
+
+      const content = await readFile(fileLog.logPath, "utf8");
+      expect(content).toContain("[LOG] before flush");
+      expect(content).toContain("[ERR] after flush");
+    } finally {
+      console.log = originalLog;
+      console.error = originalError;
+      await rm(dir, { recursive: true, force: true });
+    }
+  });
+
+  it("日志参数无法 JSON 序列化时也不会让 console 调用抛错", async () => {
+    const originalLog = console.log;
+    const originalError = console.error;
+    console.log = vi.fn() as never;
+    console.error = vi.fn() as never;
+    const dir = await mkdtemp(join(tmpdir(), "chatccc-log-"));
+
+    try {
+      const fileLog = setupFileLogging(dir, "index");
+      const circular: Record<string, unknown> = { name: "root" };
+      circular.self = circular;
+
+      expect(() => console.log("circular", circular)).not.toThrow();
+      fileLog.flush();
+
+      const content = await readFile(fileLog.logPath, "utf8");
+      expect(content).toContain("[LOG] circular");
+      expect(content).toContain("self");
+    } finally {
+      console.log = originalLog;
+      console.error = originalError;
+      await rm(dir, { recursive: true, force: true });
+    }
+  });
+});

package/src/__tests__/session.test.ts

@@ -1,4 +1,7 @@
 import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
 import {
   chatSessionMap,
   sessionInfoMap,
@@ -7,9 +10,12 @@ import {
   resetState,
   getSessionStatus,
   getAllSessionsStatus,
+  recordSessionRegistry,
   accumulateBlockContent,
   pickFinalReply,
   UNKNOWN_MODEL_PLACEHOLDER,
+  _setSessionRegistryFileForTest,
+  _resetSessionRegistryFileForTest,
   _setAdapterForToolForTest,
   _clearAdapterCacheForTest,
 } from "../session.ts";
@@ -196,39 +202,146 @@ describe("getSessionStatus", () => {
 });
 
 describe("getAllSessionsStatus", () => {
-  beforeEach(() => {
+  let registryFile = "";
+
+  beforeEach(async () => {
     chatSessionMap.clear();
     sessionInfoMap.clear();
+    const dir = await mkdtemp(join(tmpdir(), "chatccc-session-registry-"));
+    registryFile = join(dir, "session-registry.json");
+    _setSessionRegistryFileForTest(registryFile);
   });
 
-  afterEach(() => {
+  afterEach(async () => {
     _clearAdapterCacheForTest();
+    _resetSessionRegistryFileForTest();
+    if (registryFile) {
+      await rm(dirname(registryFile), { recursive: true, force: true });
+    }
   });
 
   it("returns empty array when no sessions", async () => {
     await expect(getAllSessionsStatus()).resolves.toEqual([]);
   });
 
-  it("returns statuses for all recorded sessions", async () => {
+  it("does not read memory-only sessions", async () => {
     mockSessionInfo("chat1", { sessionId: "s1" });
     mockSessionInfo("chat2", { sessionId: "s2" });
     mockActiveSession("chat1");
+
+    const result = await getAllSessionsStatus();
+    expect(result).toEqual([]);
+  });
+
+  it("returns statuses from disk registry", async () => {
+    await recordSessionRegistry({
+      chatId: "chat1",
+      sessionId: "s1",
+      tool: "claude",
+      chatName: "test-chat-1",
+      turnCount: 2,
+      startTime: 1000,
+      updatedAt: 2000,
+      running: true,
+    });
+    await recordSessionRegistry({
+      chatId: "chat2",
+      sessionId: "s2",
+      tool: "claude",
+      chatName: "test-chat-2",
+      turnCount: 0,
+      startTime: 900,
+      updatedAt: 1900,
+      running: false,
+    });
+
     const result = await getAllSessionsStatus();
     expect(result).toHaveLength(2);
+    expect(result[0].chatId).toBe("chat1");
+    expect(result[0].active).toBe(true);
+    expect(result[0].turnCount).toBe(2);
+    expect(result[0].chatName).toBe("test-chat-1");
+    expect(result[1].chatId).toBe("chat2");
+    expect(result[1].active).toBe(false);
+    expect(result[1].chatName).toBe("test-chat-2");
+  });
+
+  it("returns recent disk sessions by updatedAt desc, limited to 20", async () => {
+    for (let i = 0; i < 25; i++) {
+      await recordSessionRegistry({
+        chatId: `chat-${i}`,
+        sessionId: `sid-${i}`,
+        tool: "claude",
+        startTime: i,
+        updatedAt: 1000 + i,
+      });
+    }
+
+    const result = await getAllSessionsStatus();
+    expect(result).toHaveLength(20);
+    expect(result[0].chatId).toBe("chat-24");
+    expect(result[19].chatId).toBe("chat-5");
+    expect(result.some((r) => r.chatId === "chat-4")).toBe(false);
+  });
+
+  it("marks disk-running sessions as active without checking chatSessionMap", async () => {
+    await recordSessionRegistry({
+      chatId: "chat1",
+      sessionId: "s1",
+      tool: "claude",
+      running: true,
+      updatedAt: 1000,
+    });
+
+    const result = await getAllSessionsStatus();
     expect(result.find(r => r.chatId === "chat1")!.active).toBe(true);
-    expect(result.find(r => r.chatId === "chat2")!.active).toBe(false);
   });
 
-  it("marks stopped sessions as not active", async () => {
-    mockSessionInfo("chat1");
-    mockActiveSession("chat1", { stopped: true });
+  it("persists chatName across updates and defaults to empty string when not set", async () => {
+    await recordSessionRegistry({
+      chatId: "chat-a",
+      sessionId: "sa",
+      tool: "claude",
+      chatName: "My Chat",
+      updatedAt: 100,
+    });
+    // Update without chatName — should keep existing
+    await recordSessionRegistry({
+      chatId: "chat-a",
+      sessionId: "sa",
+      tool: "claude",
+      updatedAt: 200,
+    });
+    const result = await getAllSessionsStatus();
+    expect(result.find(r => r.chatId === "chat-a")!.chatName).toBe("My Chat");
+  });
+
+  it("chatName defaults to empty string for sessions without it", async () => {
+    await recordSessionRegistry({
+      chatId: "chat-b",
+      sessionId: "sb",
+      tool: "claude",
+      updatedAt: 100,
+    });
     const result = await getAllSessionsStatus();
-    expect(result[0].active).toBe(false);
+    expect(result.find(r => r.chatId === "chat-b")!.chatName).toBe("");
   });
 
   it("混合 claude + cursor 会话：各自取自己来源的 model/effort", async () => {
-    mockSessionInfo("chat-c", { sessionId: "sid-c", tool: "claude" });
-    mockSessionInfo("chat-x", { sessionId: "sid-x", tool: "cursor" });
+    await recordSessionRegistry({
+      chatId: "chat-c",
+      sessionId: "sid-c",
+      tool: "claude",
+      chatName: "claude-chat",
+      updatedAt: 100,
+    });
+    await recordSessionRegistry({
+      chatId: "chat-x",
+      sessionId: "sid-x",
+      tool: "cursor",
+      chatName: "cursor-chat",
+      updatedAt: 200,
+    });
     _setAdapterForToolForTest(
       "cursor",
       mockAdapter((sid) =>
@@ -473,4 +586,4 @@ describe("pickFinalReply", () => {
       }),
     ).toBe("");
   });
-});
+});

package/src/cards.ts

@@ -254,6 +254,7 @@ export function buildCdCard(
 // 所有会话列表卡片（Claude Code 优先，然后 Cursor）
 export function buildSessionsCard(sessions: Array<{
   sessionId: string;
+  chatName: string;
   active: boolean;
   turnCount: number;
   elapsedSeconds: number | null;
@@ -274,7 +275,7 @@ export function buildSessionsCard(sessions: Array<{
       config: { wide_screen_mode: true },
       header: { template: "blue", title: { content: "所有会话", tag: "plain_text" } },
       elements: [
-        { tag: "div", text: { tag: "lark_md", content: `当前没有会话记录。\n\n使用 **/new**（默认 ${defaultToolLabel}）、**/new claude**、**/new cursor** 或 **/new codex** 创建新会话。` } },
+        { tag: "div", text: { tag: "lark_md", content: `当前没有会话记录。\n\n使用 **/new**（默认 ${defaultToolLabel}）、**/new claude**、**/new cursor** 或 **/new codex** 创建新会话。\n创建后可在任意会话群内发送 **/sessions** 查看列表，用 **/session 数字** 切换会话。` } },
         { tag: "hr" },
         { tag: "action", actions: [{ tag: "button", text: { tag: "plain_text", content: "收起" }, type: "default", value: { action: "close" } }] },
       ],
@@ -291,7 +292,8 @@ export function buildSessionsCard(sessions: Array<{
       extra = ` | 本轮: ${mins}分${secs}秒`;
     }
     const toolLabel = s.tool === "cursor" ? "Cursor" : s.tool === "codex" ? "Codex" : "Claude Code";
-    return `**${i + 1}.** \`${shortId}\` ${status} | 工具: ${toolLabel} | 轮数: ${s.turnCount} | ${s.model}${extra}`;
+    const namePart = s.chatName ? `**${s.chatName}** ` : "";
+    return `**${i + 1}.** ${namePart}\`${shortId}\` ${status} | 工具: ${toolLabel} | 轮数: ${s.turnCount} | ${s.model}${extra}`;
   };
 
   const lines: string[] = [`共 **${sessions.length}** 个会话:`, ""];
@@ -326,7 +328,7 @@ export function buildSessionsCard(sessions: Array<{
     elements: [
       { tag: "div", text: { tag: "lark_md", content: lines.join("\n") } },
       { tag: "hr" },
-      { tag: "div", text: { tag: "lark_md", content: "在会话群内发送 **/forget** 可重置当前会话（创建新 Session，保留工作目录和群聊）。" } },
+      { tag: "div", text: { tag: "lark_md", content: "在会话群内发送 **/forget** 可重置当前会话（创建新 Session，保留工作目录和群聊）。\n发送 **/session 数字**（如 `/session 1`）可将当前群聊切换到列表中对应编号的会话。" } },
       { tag: "hr" },
       {
         tag: "action",