chatccc 0.2.39 → 0.2.41

package/demo/ilink_echo_probe.ts

@@ -0,0 +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;
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatccc",
-  "version": "0.2.39",
+  "version": "0.2.41",
   "description": "Feishu bot bridge for Claude Code",
   "license": "Apache-2.0",
   "type": "module",
@@ -11,6 +11,7 @@
   "files": [
     "src/",
     "bin/",
+    "demo/ilink_echo_probe.ts",
     "im-skills/",
     "images/img_readme_*.jpg",
     "images/img_readme_*.png",
@@ -31,19 +32,23 @@
     "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"

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

@@ -1,6 +1,9 @@
-import { describe, it, expect, vi } from "vitest";
-
-import { buildCrashLoggingHandlers, installCrashLogging } 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", () => {
@@ -141,7 +144,7 @@ describe("buildCrashLoggingHandlers", () => {
   });
 });
 
-describe("installCrashLogging", () => {
+describe("installCrashLogging", () => {
   it("注册所有相关事件监听器", () => {
     const before = {
       uncaught: process.listenerCount("uncaughtException"),
@@ -206,5 +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 });
+    }
+  });
+});

package/src/shared.ts

@@ -1,17 +1,17 @@
 import { execSync } from "node:child_process";
-import {
-  appendFileSync,
-  createWriteStream,
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  unlinkSync,
-  writeFileSync,
-} from "node:fs";
-import { createServer } from "node:http";
-import { homedir } from "node:os";
-import { join } from "node:path";
-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,33 +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`);
-  const logStream = createWriteStream(logPath, { flags: "a" });
-  const origConsoleLog = console.log.bind(console);
-  const origConsoleError = console.error.bind(console);
-  let pending = false;
-  const writeLine = (level: string, args: unknown[]) => {
-    const line = args.map((a) => (typeof a === "string" ? a : JSON.stringify(a))).join(" ");
-    pending = true;
-    logStream.write(`[${new Date().toISOString()}] [${level}] ${line}\n`, () => { pending = false; });
-  };
-  console.log = (...args: unknown[]) => {
-    writeLine("LOG", args);
-    origConsoleLog(...args);
-  };
-  console.error = (...args: unknown[]) => {
-    writeLine("ERR", args);
-    origConsoleError(...args);
-  };
-  const flush = () => {
-    if (pending) logStream.end();
-  };
-  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 中继服务器（同一端口、多客户端广播）