chatccc 0.2.42 → 0.2.44

package/config.sample.json

@@ -5,6 +5,7 @@
   },
   "port": 18080,
   "gitTimeoutSeconds": 180,
+  "allowInterrupt": false,
   "claude": {
     "enabled": false,
     "defaultAgent": true,

package/demo/ilink_echo_probe.ts

@@ -1,222 +1,222 @@
-/**
- * OpenILink WeChat Echo Probe
- * ===========================
- * Minimal scan-login and text echo demo for the WeChat iLink channel.
- *
- * Usage:
- *   npm run demo:ilink-echo
- *
- * Behavior:
- *   When a user sends text to the logged-in WeChat account, this demo replies
- *   with "收到：" plus the received text.
- */
-
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { createRequire } from "node:module";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-import {
-  Client as OpenIlinkWire,
-  extractText,
-  type GetUpdatesResponse,
-  type WeixinMessage,
-} from "@openilink/openilink-sdk-node";
-
-import { setupFileLogging } from "../src/shared.ts";
-
-interface TerminalQrRenderer {
-  generate(
-    input: string,
-    opts: { small: boolean },
-    callback: (qrcode: string) => void,
-  ): void;
-}
-
-interface EchoProbeSnapshot {
-  token?: string;
-  baseUrl?: string;
-  pollCursor?: string;
-  botId?: string;
-  userId?: string;
-  lastSeenAt?: string;
-}
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const PROJECT_ROOT = join(__dirname, "..");
-const SNAPSHOT_PATH = join(PROJECT_ROOT, "state", "ilink-echo-probe.json");
-const LOG_DIR = join(__dirname, "logs");
-const requireFromDemo = createRequire(import.meta.url);
-const terminalQr = requireFromDemo("qrcode-terminal") as TerminalQrRenderer;
-
-setupFileLogging(LOG_DIR, "ilink-echo-probe");
-
-let acceptingEvents = true;
-
-function ensureParentDir(filePath: string): void {
-  mkdirSync(dirname(filePath), { recursive: true });
-}
-
-function readSnapshot(): EchoProbeSnapshot {
-  if (!existsSync(SNAPSHOT_PATH)) {
-    return {};
-  }
-
-  try {
-    return JSON.parse(readFileSync(SNAPSHOT_PATH, "utf8")) as EchoProbeSnapshot;
-  } catch (error) {
-    console.warn(`Cannot read saved iLink probe state: ${(error as Error).message}`);
-    return {};
-  }
-}
-
-function writeSnapshot(snapshot: EchoProbeSnapshot): void {
-  ensureParentDir(SNAPSHOT_PATH);
-  writeFileSync(SNAPSHOT_PATH, `${JSON.stringify(snapshot, null, 2)}\n`);
-}
-
-function updateSnapshot(patch: Partial<EchoProbeSnapshot>): EchoProbeSnapshot {
-  const next = {
-    ...readSnapshot(),
-    ...patch,
-    lastSeenAt: new Date().toISOString(),
-  };
-  writeSnapshot(next);
-  return next;
-}
-
-function peerKeyOf(message: WeixinMessage): string {
-  return String(message.from_user_id ?? "");
-}
-
-function textOf(message: WeixinMessage): string {
-  return extractText(message).trim();
-}
-
-function printScanMaterial(content: string): void {
-  console.log("\n========== iLink scan content ==========");
-  console.log(content);
-  console.log("========== iLink terminal QR ==========");
-  terminalQr.generate(content, { small: true }, (renderedQr) => {
-    console.log(renderedQr);
-  });
-  console.log("========== end iLink QR ==========\n");
-}
-
-async function prepareProbeWire(saved: EchoProbeSnapshot): Promise<OpenIlinkWire> {
-  const ilinkWire = new OpenIlinkWire("", {
-    base_url: saved.baseUrl,
-  });
-
-  console.log("Starting iLink QR login. The QR is shown on every run.");
-  const loginResult = await ilinkWire.loginWithQr({
-    on_qrcode: (content) => {
-      printScanMaterial(content);
-    },
-    on_scanned: () => {
-      console.log("QR scanned. Confirm login in WeChat.");
-    },
-    on_expired: (attempt, maxAttempts) => {
-      console.log(`QR expired, refreshing (${attempt}/${maxAttempts}).`);
-    },
-  });
-
-  if (!loginResult.connected) {
-    throw new Error(`iLink QR login failed: ${loginResult.message}`);
-  }
-
-  updateSnapshot({
-    token: loginResult.bot_token ?? ilinkWire.token,
-    baseUrl: loginResult.base_url ?? ilinkWire.baseUrl,
-    botId: loginResult.bot_id,
-    userId: loginResult.user_id,
-    pollCursor: "",
-  });
-
-  console.log(`iLink login ready. BotID=${loginResult.bot_id ?? ""}`);
-  return ilinkWire;
-}
-
-async function mirrorIncomingLine(
-  ilinkWire: OpenIlinkWire,
-  message: WeixinMessage,
-): Promise<void> {
-  const peerKey = peerKeyOf(message);
-  if (!peerKey) {
-    console.warn("Skip message without from_user_id.");
-    return;
-  }
-
-  const incomingText = textOf(message);
-  const outgoingText = incomingText ? `收到：${incomingText}` : "收到：[non-text message]";
-  const contextToken = message.context_token;
-
-  if (contextToken) {
-    await ilinkWire.sendText(peerKey, outgoingText, contextToken);
-  } else {
-    await ilinkWire.push(peerKey, outgoingText);
-  }
-
-  console.log(`Echoed to ${peerKey}: ${outgoingText.slice(0, 120)}`);
-}
-
-function rememberPollingCursor(response: GetUpdatesResponse): void {
-  const pollCursor = response.sync_buf ?? response.get_updates_buf;
-  if (!pollCursor) {
-    return;
-  }
-  updateSnapshot({ pollCursor });
-}
-
-function installStopHooks(): void {
-  const stop = (): void => {
-    if (!acceptingEvents) {
-      return;
-    }
-    acceptingEvents = false;
-    console.log("Stopping iLink echo probe...");
-  };
-
-  process.once("SIGINT", stop);
-  process.once("SIGTERM", stop);
-}
-
-async function runProbe(): Promise<void> {
-  installStopHooks();
-
-  const saved = readSnapshot();
-  const ilinkWire = await prepareProbeWire(saved);
-  const latest = readSnapshot();
-
-  console.log("Listening for WeChat messages. Send text to the small account.");
-  console.log(`State file: ${SNAPSHOT_PATH}`);
-  console.log(`Log dir: ${LOG_DIR}`);
-
-  await ilinkWire.monitor(
-    async (message) => {
-      try {
-        await mirrorIncomingLine(ilinkWire, message);
-      } catch (error) {
-        console.error(`Echo failed: ${(error as Error).stack ?? (error as Error).message}`);
-      }
-    },
-    {
-      initial_buf: latest.pollCursor ?? "",
-      on_buf_update: (pollCursor) => updateSnapshot({ pollCursor }),
-      on_response: rememberPollingCursor,
-      on_error: (error) => {
-        console.error(`iLink monitor error: ${error.stack ?? error.message}`);
-      },
-      on_session_expired: () => {
-        console.error("iLink session expired. Restart with --fresh to scan again.");
-        acceptingEvents = false;
-      },
-      should_continue: () => acceptingEvents,
-    },
-  );
-}
-
-runProbe().catch((error: Error) => {
-  console.error(`Fatal iLink echo probe error: ${error.stack ?? error.message}`);
-  process.exitCode = 1;
-});
+/**
+ * OpenILink WeChat Echo Probe
+ * ===========================
+ * Minimal scan-login and text echo demo for the WeChat iLink channel.
+ *
+ * Usage:
+ *   npm run demo:ilink-echo
+ *
+ * Behavior:
+ *   When a user sends text to the logged-in WeChat account, this demo replies
+ *   with "收到：" plus the received text.
+ */
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import {
+  Client as OpenIlinkWire,
+  extractText,
+  type GetUpdatesResponse,
+  type WeixinMessage,
+} from "@openilink/openilink-sdk-node";
+
+import { setupFileLogging } from "../src/shared.ts";
+
+interface TerminalQrRenderer {
+  generate(
+    input: string,
+    opts: { small: boolean },
+    callback: (qrcode: string) => void,
+  ): void;
+}
+
+interface EchoProbeSnapshot {
+  token?: string;
+  baseUrl?: string;
+  pollCursor?: string;
+  botId?: string;
+  userId?: string;
+  lastSeenAt?: string;
+}
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PROJECT_ROOT = join(__dirname, "..");
+const SNAPSHOT_PATH = join(PROJECT_ROOT, "state", "ilink-echo-probe.json");
+const LOG_DIR = join(__dirname, "logs");
+const requireFromDemo = createRequire(import.meta.url);
+const terminalQr = requireFromDemo("qrcode-terminal") as TerminalQrRenderer;
+
+setupFileLogging(LOG_DIR, "ilink-echo-probe");
+
+let acceptingEvents = true;
+
+function ensureParentDir(filePath: string): void {
+  mkdirSync(dirname(filePath), { recursive: true });
+}
+
+function readSnapshot(): EchoProbeSnapshot {
+  if (!existsSync(SNAPSHOT_PATH)) {
+    return {};
+  }
+
+  try {
+    return JSON.parse(readFileSync(SNAPSHOT_PATH, "utf8")) as EchoProbeSnapshot;
+  } catch (error) {
+    console.warn(`Cannot read saved iLink probe state: ${(error as Error).message}`);
+    return {};
+  }
+}
+
+function writeSnapshot(snapshot: EchoProbeSnapshot): void {
+  ensureParentDir(SNAPSHOT_PATH);
+  writeFileSync(SNAPSHOT_PATH, `${JSON.stringify(snapshot, null, 2)}\n`);
+}
+
+function updateSnapshot(patch: Partial<EchoProbeSnapshot>): EchoProbeSnapshot {
+  const next = {
+    ...readSnapshot(),
+    ...patch,
+    lastSeenAt: new Date().toISOString(),
+  };
+  writeSnapshot(next);
+  return next;
+}
+
+function peerKeyOf(message: WeixinMessage): string {
+  return String(message.from_user_id ?? "");
+}
+
+function textOf(message: WeixinMessage): string {
+  return extractText(message).trim();
+}
+
+function printScanMaterial(content: string): void {
+  console.log("\n========== iLink scan content ==========");
+  console.log(content);
+  console.log("========== iLink terminal QR ==========");
+  terminalQr.generate(content, { small: true }, (renderedQr) => {
+    console.log(renderedQr);
+  });
+  console.log("========== end iLink QR ==========\n");
+}
+
+async function prepareProbeWire(saved: EchoProbeSnapshot): Promise<OpenIlinkWire> {
+  const ilinkWire = new OpenIlinkWire("", {
+    base_url: saved.baseUrl,
+  });
+
+  console.log("Starting iLink QR login. The QR is shown on every run.");
+  const loginResult = await ilinkWire.loginWithQr({
+    on_qrcode: (content) => {
+      printScanMaterial(content);
+    },
+    on_scanned: () => {
+      console.log("QR scanned. Confirm login in WeChat.");
+    },
+    on_expired: (attempt, maxAttempts) => {
+      console.log(`QR expired, refreshing (${attempt}/${maxAttempts}).`);
+    },
+  });
+
+  if (!loginResult.connected) {
+    throw new Error(`iLink QR login failed: ${loginResult.message}`);
+  }
+
+  updateSnapshot({
+    token: loginResult.bot_token ?? ilinkWire.token,
+    baseUrl: loginResult.base_url ?? ilinkWire.baseUrl,
+    botId: loginResult.bot_id,
+    userId: loginResult.user_id,
+    pollCursor: "",
+  });
+
+  console.log(`iLink login ready. BotID=${loginResult.bot_id ?? ""}`);
+  return ilinkWire;
+}
+
+async function mirrorIncomingLine(
+  ilinkWire: OpenIlinkWire,
+  message: WeixinMessage,
+): Promise<void> {
+  const peerKey = peerKeyOf(message);
+  if (!peerKey) {
+    console.warn("Skip message without from_user_id.");
+    return;
+  }
+
+  const incomingText = textOf(message);
+  const outgoingText = incomingText ? `收到：${incomingText}` : "收到：[non-text message]";
+  const contextToken = message.context_token;
+
+  if (contextToken) {
+    await ilinkWire.sendText(peerKey, outgoingText, contextToken);
+  } else {
+    await ilinkWire.push(peerKey, outgoingText);
+  }
+
+  console.log(`Echoed to ${peerKey}: ${outgoingText.slice(0, 120)}`);
+}
+
+function rememberPollingCursor(response: GetUpdatesResponse): void {
+  const pollCursor = response.sync_buf ?? response.get_updates_buf;
+  if (!pollCursor) {
+    return;
+  }
+  updateSnapshot({ pollCursor });
+}
+
+function installStopHooks(): void {
+  const stop = (): void => {
+    if (!acceptingEvents) {
+      return;
+    }
+    acceptingEvents = false;
+    console.log("Stopping iLink echo probe...");
+  };
+
+  process.once("SIGINT", stop);
+  process.once("SIGTERM", stop);
+}
+
+async function runProbe(): Promise<void> {
+  installStopHooks();
+
+  const saved = readSnapshot();
+  const ilinkWire = await prepareProbeWire(saved);
+  const latest = readSnapshot();
+
+  console.log("Listening for WeChat messages. Send text to the small account.");
+  console.log(`State file: ${SNAPSHOT_PATH}`);
+  console.log(`Log dir: ${LOG_DIR}`);
+
+  await ilinkWire.monitor(
+    async (message) => {
+      try {
+        await mirrorIncomingLine(ilinkWire, message);
+      } catch (error) {
+        console.error(`Echo failed: ${(error as Error).stack ?? (error as Error).message}`);
+      }
+    },
+    {
+      initial_buf: latest.pollCursor ?? "",
+      on_buf_update: (pollCursor) => updateSnapshot({ pollCursor }),
+      on_response: rememberPollingCursor,
+      on_error: (error) => {
+        console.error(`iLink monitor error: ${error.stack ?? error.message}`);
+      },
+      on_session_expired: () => {
+        console.error("iLink session expired. Restart with --fresh to scan again.");
+        acceptingEvents = false;
+      },
+      should_continue: () => acceptingEvents,
+    },
+  );
+}
+
+runProbe().catch((error: Error) => {
+  console.error(`Fatal iLink echo probe error: ${error.stack ?? error.message}`);
+  process.exitCode = 1;
+});

package/package.json

@@ -1,59 +1,59 @@
-{
-  "name": "chatccc",
-  "version": "0.2.42",
-  "description": "Feishu bot bridge for Claude Code",
-  "license": "Apache-2.0",
-  "type": "module",
-  "main": "./src/index.ts",
-  "bin": {
-    "chatccc": "bin/chatccc.mjs"
-  },
-  "files": [
-    "src/",
-    "bin/",
-    "demo/ilink_echo_probe.ts",
-    "im-skills/",
-    "images/img_readme_*.jpg",
-    "images/img_readme_*.png",
-    "images/avatars/status_*.png",
-    "images/avatars/badges/",
-    "package.json",
-    "README.md",
-    "config.sample.json"
-  ],
-  "scripts": {
-    "dev": "tsx src/index.ts",
-    "chatccc": "tsx src/index.ts",
-    "start": "tsx src/index.ts",
-    "demo:bot-test": "tsx demo/bot_test.ts",
-    "demo:bot-test:local": "tsx demo/bot_test.ts --local",
-    "demo:create-group": "tsx src/index.ts",
-    "demo:create-group:local": "tsx src/index.ts --local",
-    "demo:permission-check": "tsx demo/permission_check.ts",
-    "demo:claude-hi": "tsx demo/claude_say_hi.ts",
-    "demo:codex-hi": "tsx demo/codex_say_hi.ts",
-    "demo:ilink-echo": "tsx demo/ilink_echo_probe.ts",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
-  "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "0.2.133",
-    "@larksuiteoapi/node-sdk": "^1.59.0",
-    "@openilink/openilink-sdk-node": "^0.6.0",
-    "nodemailer": "^8.0.7",
-    "qrcode-terminal": "^0.12.0",
-    "sharp": "^0.34.5",
-    "tsx": "^4.0.0",
-    "ws": "^8.18.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@types/qrcode-terminal": "^0.12.2",
-    "@types/ws": "^8.18.1",
-    "typescript": "^5.0.0",
-    "vitest": "^4.1.5"
-  },
-  "engines": {
-    "node": ">=20"
-  }
-}
+{
+  "name": "chatccc",
+  "version": "0.2.44",
+  "description": "Feishu bot bridge for Claude Code",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./src/index.ts",
+  "bin": {
+    "chatccc": "bin/chatccc.mjs"
+  },
+  "files": [
+    "src/",
+    "bin/",
+    "demo/ilink_echo_probe.ts",
+    "im-skills/",
+    "images/img_readme_*.jpg",
+    "images/img_readme_*.png",
+    "images/avatars/status_*.png",
+    "images/avatars/badges/",
+    "package.json",
+    "README.md",
+    "config.sample.json"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "chatccc": "tsx src/index.ts",
+    "start": "tsx src/index.ts",
+    "demo:bot-test": "tsx demo/bot_test.ts",
+    "demo:bot-test:local": "tsx demo/bot_test.ts --local",
+    "demo:create-group": "tsx src/index.ts",
+    "demo:create-group:local": "tsx src/index.ts --local",
+    "demo:permission-check": "tsx demo/permission_check.ts",
+    "demo:claude-hi": "tsx demo/claude_say_hi.ts",
+    "demo:codex-hi": "tsx demo/codex_say_hi.ts",
+    "demo:ilink-echo": "tsx demo/ilink_echo_probe.ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "0.2.133",
+    "@larksuiteoapi/node-sdk": "^1.59.0",
+    "@openilink/openilink-sdk-node": "^0.6.0",
+    "nodemailer": "^8.0.7",
+    "qrcode-terminal": "^0.12.0",
+    "sharp": "^0.34.5",
+    "tsx": "^4.0.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/qrcode-terminal": "^0.12.2",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.0.0",
+    "vitest": "^4.1.5"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

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/config.ts

@@ -98,6 +98,8 @@ export interface AppConfig {
   feishu: FeishuConfig;
   port: number;
   gitTimeoutSeconds: number;
+  /** 若为 false，AI 生成过程中用户发送消息不会打断，须先点「停止」再发送新消息 */
+  allowInterrupt: boolean;
   claude: ClaudeConfig;
   cursor: CursorConfig;
   codex: CodexConfig;
@@ -287,6 +289,7 @@ function loadConfig(): AppConfig {
     feishu: { appId: "", appSecret: "" },
     port: 18080,
     gitTimeoutSeconds: 180,
+    allowInterrupt: false,
     claude: { enabled: false, defaultAgent: true, model: "", effort: "", apiKey: "", baseUrl: "" },
     cursor: { enabled: false, defaultAgent: false, path: "", model: "claude-opus-4-7-max" },
     codex: { enabled: false, defaultAgent: false, path: "", model: "", effort: "" },
@@ -403,6 +406,7 @@ function loadConfig(): AppConfig {
     },
     port: typeof parsed.port === "number" ? parsed.port : 18080,
     gitTimeoutSeconds: typeof parsed.gitTimeoutSeconds === "number" ? parsed.gitTimeoutSeconds : 180,
+    allowInterrupt: typeof parsed.allowInterrupt === "boolean" ? parsed.allowInterrupt : false,
     claude: {
       enabled: claudeEnabled,
       defaultAgent: defaultTool === "claude",
@@ -476,6 +480,7 @@ export let CLAUDE_BASE_URL = config.claude.baseUrl;
 
 export let GIT_TIMEOUT_SECONDS = config.gitTimeoutSeconds;
 export let GIT_TIMEOUT_MS = GIT_TIMEOUT_SECONDS * 1000;
+export let ALLOW_INTERRUPT = config.allowInterrupt;
 
 /** 探测 cursor-agent 安装路径（优先配置，其次 LocalAppData，最后默认 agent） */
 function detectCursorAgent(): string {
@@ -540,6 +545,7 @@ export function applyLoadedConfig(next: AppConfig): void {
   CLAUDE_BASE_URL = next.claude.baseUrl;
   GIT_TIMEOUT_SECONDS = next.gitTimeoutSeconds;
   GIT_TIMEOUT_MS = GIT_TIMEOUT_SECONDS * 1000;
+  ALLOW_INTERRUPT = next.allowInterrupt;
   CURSOR_AGENT_COMMAND = detectCursorAgent();
   CURSOR_AGENT_ARGS = resolveCursorAgentArgs();
 }

package/src/index.ts

@@ -41,6 +41,7 @@ import {
   CLAUDE_EFFORT,
   CLAUDE_MODEL,
   GIT_TIMEOUT_MS,
+  ALLOW_INTERRUPT,
   reloadConfigFromDisk,
   anthropicConfigDisplay,
   LOCAL_RELAY_URL,
@@ -574,6 +575,7 @@ async function handleCommand(text: string, chatId: string, openId: string, msgTi
         const running = chatSessionMap.get(chatId);
         const isActive = running && !running.stopped;
         const statusText = [
+          `**群名:** ${status?.chatName || "—"}`,
           `**Session ID:** \`${status?.sessionId ?? sessionId}\``,
           `**工具:** ${toolLabel}`,
           `**状态:** ${isActive ? "🟢 运行中" : "⚪ 空闲"}`,
@@ -606,7 +608,8 @@ async function handleCommand(text: string, chatId: string, openId: string, msgTi
         logTrace(tid, "BRANCH", { cmd: "/sessions" });
         const allSessions = await getAllSessionsStatus();
         const now = Date.now();
-        const cardData = allSessions.map(s => ({
+        const others = allSessions.filter(s => s.chatId !== chatId);
+        const cardData = others.map(s => ({
           sessionId: s.sessionId,
           chatName: s.chatName,
           active: s.active,
@@ -617,8 +620,8 @@ async function handleCommand(text: string, chatId: string, openId: string, msgTi
         }));
         const card = buildSessionsCard(cardData);
         const ok = await sendRawCard(freshToken, chatId, card);
-        console.log(`[${ts()}] [SESSIONS] card sent, ok=${ok}, count=${allSessions.length}`);
-        logTrace(tid, "DONE", { outcome: "sessions", ok, count: allSessions.length });
+        console.log(`[${ts()}] [SESSIONS] card sent, ok=${ok}, count=${others.length}`);
+        logTrace(tid, "DONE", { outcome: "sessions", ok, count: others.length });
         return;
       }
 
@@ -656,9 +659,7 @@ async function handleCommand(text: string, chatId: string, openId: string, msgTi
         }
 
         const descPrefix = sessionPrefixForTool(descriptionTool);
-        const newName = isUntitledSessionChatName(chatInfo.name)
-          ? sessionChatName("新会话", cwd)
-          : chatInfo.name;
+        const newName = sessionChatName("新会话", cwd);
         await updateChatInfo(freshToken, chatId, newName, `${descPrefix} ${newSessionId}`);
         console.log(`[${ts()}] [FORGET] Group updated: name="${newName}" desc="${descPrefix} ${newSessionId}"`);
 
@@ -702,17 +703,22 @@ async function handleCommand(text: string, chatId: string, openId: string, msgTi
         const index = parseInt(sessionMatch[1], 10) - 1;
         logTrace(tid, "BRANCH", { cmd: "/session", index: index + 1 });
         const allSessions = await getAllSessionsStatus();
-        if (allSessions.length === 0) {
+        // 与 buildSessionsCard 保持一致的排序：Claude Code → Cursor → Codex，组内保持 updatedAt 降序
+        const claudeOrdered = allSessions.filter(s => s.tool !== "cursor" && s.tool !== "codex");
+        const cursorOrdered = allSessions.filter(s => s.tool === "cursor");
+        const codexOrdered = allSessions.filter(s => s.tool === "codex");
+        const ordered = [...claudeOrdered, ...cursorOrdered, ...codexOrdered].filter(s => s.chatId !== chatId);
+        if (ordered.length === 0) {
           await sendCardReply(freshToken, chatId, "/session", "暂无历史会话。", "yellow");
           logTrace(tid, "DONE", { outcome: "session_no_sessions" });
           return;
         }
-        if (index < 0 || index >= allSessions.length) {
-          await sendCardReply(freshToken, chatId, "/session", `序号超出范围，当前共 ${allSessions.length} 个会话。`, "yellow");
-          logTrace(tid, "DONE", { outcome: "session_out_of_range", index: index + 1, total: allSessions.length });
+        if (index < 0 || index >= ordered.length) {
+          await sendCardReply(freshToken, chatId, "/session", `序号超出范围，当前共 ${ordered.length} 个会话。`, "yellow");
+          logTrace(tid, "DONE", { outcome: "session_out_of_range", index: index + 1, total: ordered.length });
           return;
         }
-        const target = allSessions[index];
+        const target = ordered[index];
 
         const existing2 = chatSessionMap.get(chatId);
         if (existing2) {
@@ -736,10 +742,9 @@ async function handleCommand(text: string, chatId: string, openId: string, msgTi
         }
 
         const descPrefix2 = sessionPrefixForTool(target.tool);
-        const newName2 = isUntitledSessionChatName(chatInfo.name)
-          ? sessionChatName("新会话", cwd2)
-          : chatInfo.name;
+        const newName2 = target.chatName || sessionChatName("新会话", cwd2);
         await updateChatInfo(freshToken, chatId, newName2, `${descPrefix2} ${target.sessionId}`);
+        console.log(`[${ts()}] [SESSION] Switched to session ${target.sessionId} (#${index + 1}), name="${newName2}"`);
 
         sessionInfoMap.set(chatId, {
           sessionId: target.sessionId,
@@ -769,7 +774,6 @@ async function handleCommand(text: string, chatId: string, openId: string, msgTi
           "green"
         );
 
-        console.log(`[${ts()}] [SESSION] Switched to session ${target.sessionId} (#${index + 1})`);
         logTrace(tid, "DONE", { outcome: "session_switch", sessionId: target.sessionId, index: index + 1, cwd: cwd2 });
         return;
       }
@@ -835,6 +839,18 @@ async function handleCommand(text: string, chatId: string, openId: string, msgTi
           console.log(`[${ts()}] [SKIP] Older message (${msgTimestamp} <= ${existing.msgTimestamp}), ignoring`);
           return;
         }
+
+        if (!ALLOW_INTERRUPT) {
+          logTrace(tid, "BLOCKED", { outcome: "interrupt_disabled", sessionId });
+          console.log(`[${ts()}] [BLOCKED] allowInterrupt=false, ignoring message during generation. Hint sent to user.`);
+          await sendCardReply(
+            freshToken, chatId, "生成中",
+            "AI 正在生成回复中，Agent 不会遗忘当前进度，停止后仍可从断点继续。\n请先点击卡片上的「停止」按钮，再发送新消息。",
+            "yellow"
+          );
+          return;
+        }
+
         existing.stopped = true;
         if (existing.spinnerTimer) { clearInterval(existing.spinnerTimer); existing.spinnerTimer = null; }
         existing.close();

package/src/session.ts

@@ -739,6 +739,7 @@ export const UNKNOWN_MODEL_PLACEHOLDER = "—";
 
 export interface SessionStatus {
   sessionId: string;
+  chatName: string;
   running: boolean;
   turnCount: number;
   lastContextTokens: number;
@@ -785,8 +786,12 @@ export async function getSessionStatus(chatId: string): Promise<SessionStatus |
   const active = chatSessionMap.get(chatId);
   const { model, effort } = await resolveModelEffort(info.tool, info.sessionId);
 
+  const registry = await loadSessionRegistry();
+  const chatName = registry[chatId]?.chatName ?? "";
+
   return {
     sessionId: info.sessionId,
+    chatName,
     running: active !== undefined && !active.stopped,
     turnCount: info.turnCount,
     lastContextTokens: info.lastContextTokens,

package/src/shared.ts

@@ -1,17 +1,17 @@
 import { execSync } from "node:child_process";
-import {
-  appendFileSync,
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  unlinkSync,
-  writeFileSync,
-} from "node:fs";
-import { createServer } from "node:http";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import { inspect } from "node:util";
-import { WebSocketServer, WebSocket } from "ws";
+import {
+  appendFileSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  unlinkSync,
+  writeFileSync,
+} from "node:fs";
+import { createServer } from "node:http";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { inspect } from "node:util";
+import { WebSocketServer, WebSocket } from "ws";
 
 import { printServiceDidNotStart } from "./exit-banner.ts";
 
@@ -355,56 +355,56 @@ export function installCrashLogging(opts: CrashHandlersOptions = {}): InstallCra
 // 文件日志：同时输出到控制台和日志文件
 // ---------------------------------------------------------------------------
 
-export function setupFileLogging(logDir: string, prefix: string): { logPath: string; flush: () => void } {
-  mkdirSync(logDir, { recursive: true });
-  const ts = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
-  const logPath = join(logDir, `${prefix}-${ts}.log`);
-  writeFileSync(logPath, "", { flag: "a", encoding: "utf8" });
-  const origConsoleLog = console.log.bind(console);
-  const origConsoleError = console.error.bind(console);
-  const formatArg = (arg: unknown): string => {
-    if (typeof arg === "string") return arg;
-    if (arg instanceof Error) return arg.stack ?? arg.message;
-    return inspect(arg, { depth: 6, breakLength: Infinity, maxArrayLength: 200 });
-  };
-  const writeLine = (level: string, args: unknown[]) => {
-    try {
-      const line = args.map(formatArg).join(" ");
-      appendFileSync(logPath, `[${new Date().toISOString()}] [${level}] ${line}\n`, "utf8");
-    } catch (err) {
-      try {
-        appendStartupTrace("fileLog write failed", { level, error: err instanceof Error ? err.message : String(err) });
-      } catch {
-        // 日志系统自身不能影响主流程
-      }
-    }
-  };
-  console.log = (...args: unknown[]) => {
-    writeLine("LOG", args);
-    try {
-      origConsoleLog(...args);
-    } catch {
-      // 控制台输出失败也不能拖垮服务
-    }
-  };
-  console.error = (...args: unknown[]) => {
-    writeLine("ERR", args);
-    try {
-      origConsoleError(...args);
-    } catch {
-      // 控制台输出失败也不能拖垮服务
-    }
-  };
-  const flush = () => {
-    try {
-      appendFileSync(logPath, "", "utf8");
-    } catch (err) {
-      appendStartupTrace("fileLog flush failed", { error: err instanceof Error ? err.message : String(err) });
-    }
-  };
-  origConsoleLog(`Log file: ${logPath}`);
-  return { logPath, flush };
-}
+export function setupFileLogging(logDir: string, prefix: string): { logPath: string; flush: () => void } {
+  mkdirSync(logDir, { recursive: true });
+  const ts = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
+  const logPath = join(logDir, `${prefix}-${ts}.log`);
+  writeFileSync(logPath, "", { flag: "a", encoding: "utf8" });
+  const origConsoleLog = console.log.bind(console);
+  const origConsoleError = console.error.bind(console);
+  const formatArg = (arg: unknown): string => {
+    if (typeof arg === "string") return arg;
+    if (arg instanceof Error) return arg.stack ?? arg.message;
+    return inspect(arg, { depth: 6, breakLength: Infinity, maxArrayLength: 200 });
+  };
+  const writeLine = (level: string, args: unknown[]) => {
+    try {
+      const line = args.map(formatArg).join(" ");
+      appendFileSync(logPath, `[${new Date().toISOString()}] [${level}] ${line}\n`, "utf8");
+    } catch (err) {
+      try {
+        appendStartupTrace("fileLog write failed", { level, error: err instanceof Error ? err.message : String(err) });
+      } catch {
+        // 日志系统自身不能影响主流程
+      }
+    }
+  };
+  console.log = (...args: unknown[]) => {
+    writeLine("LOG", args);
+    try {
+      origConsoleLog(...args);
+    } catch {
+      // 控制台输出失败也不能拖垮服务
+    }
+  };
+  console.error = (...args: unknown[]) => {
+    writeLine("ERR", args);
+    try {
+      origConsoleError(...args);
+    } catch {
+      // 控制台输出失败也不能拖垮服务
+    }
+  };
+  const flush = () => {
+    try {
+      appendFileSync(logPath, "", "utf8");
+    } catch (err) {
+      appendStartupTrace("fileLog flush failed", { error: err instanceof Error ? err.message : String(err) });
+    }
+  };
+  origConsoleLog(`Log file: ${logPath}`);
+  return { logPath, flush };
+}
 
 // ---------------------------------------------------------------------------
 // 本地 WebSocket 中继服务器（同一端口、多客户端广播）