claude-codex-wechat 0.1.53 → 0.1.54

package/README.md

@@ -41,15 +41,15 @@ claude-codex-wechat restart
 
 安装完，三步就能跑通：
 
+**1. 启动**（首次会自动注册成系统后台服务，并自动配好接入公网中转，无需手动配置）
+
 ```bash
-# 1. 启动（首次会自动注册成系统后台服务，并自动配好接入公网中转，无需手动配置）
 claude-codex-wechat start
+```
 
-# 2. 打开管理页，用微信扫码登录完成绑定
-#    浏览器访问 http://127.0.0.1:8787
+**2. 绑定微信** — 浏览器打开 <http://127.0.0.1:8787>，用微信扫码登录。
 
-# 3. 绑定成功后，直接在微信里给机器人发消息即可
-```
+**3. 开始用** — 绑定成功后，直接在微信里给机器人发消息即可。
 
 搞定。之后不管电脑锁屏还是你人在外面，只要开发机开着，就能用微信指挥它。
 

package/dist/server/cli.js

@@ -2760,6 +2760,8 @@ var WeixinOutboundGate = class _WeixinOutboundGate {
   hintedReplies = /* @__PURE__ */ new Map();
   /** The message held back on the final quota slot, pending proof of a follow-up. */
   pendingLast = /* @__PURE__ */ new Map();
+  /** 配额归零导致消息入队、且尚未告知用户的会话。 */
+  quotaExhaustedNotified = /* @__PURE__ */ new Set();
   static HINT_REPLY_TTL_MS = 2 * 60 * 60 * 1e3;
   hasPending(chatId) {
     return this.options.store.hasPendingOutbound(chatId);
@@ -2781,16 +2783,19 @@ var WeixinOutboundGate = class _WeixinOutboundGate {
       this.pendingLast.delete(chatId);
       await this.options.send(chatId, appendHintIfText(buffered));
       this.hintedReplies.set(chatId, Date.now());
-      store.enqueueOutbound(chatId, message);
+      store.enqueueOutbound(chatId, stamp(message));
       return;
     }
     if (store.hasPendingOutbound(chatId)) {
-      store.enqueueOutbound(chatId, message);
+      store.enqueueOutbound(chatId, stamp(message));
       return;
     }
     const quota = store.getQuota(chatId);
     if (quota.expired || quota.remaining <= 0) {
-      store.enqueueOutbound(chatId, message);
+      if (!this.quotaExhaustedNotified.has(chatId)) {
+        this.quotaExhaustedNotified.add(chatId);
+      }
+      store.enqueueOutbound(chatId, stamp(message));
       return;
     }
     if (quota.remaining === 1) {
@@ -2810,6 +2815,24 @@ var WeixinOutboundGate = class _WeixinOutboundGate {
     this.pendingLast.delete(chatId);
     await this.options.send(chatId, buffered);
   }
+  /**
+   * 取出「配额耗尽导致回复被排队」的一次性提示文案，没有则返回 null。
+   * 取走即清除，保证同一次耗尽只提示一次，不会每条排队消息都刷屏。
+   */
+  takeQuotaExhaustedNotice(chatId) {
+    if (!this.quotaExhaustedNotified.delete(chatId)) return null;
+    return "\u26A0\uFE0F \u672C\u8F6E\u56DE\u590D\u5DF2\u8D85\u51FA\u5FAE\u4FE1 24 \u5C0F\u65F6\u63A8\u9001\u989D\u5EA6\uFF0C\u5269\u4F59\u5185\u5BB9\u5DF2\u6682\u5B58\u3002\u56DE\u590D\u4EFB\u610F\u6D88\u606F\u5373\u53EF\u7EE7\u7EED\u63A5\u6536\u3002";
+  }
+  /**
+   * 丢弃该会话全部待发消息（含缓冲在最后一格配额上的那条）。
+   * 会话被替换时调用，避免旧会话的回复稍后串进新会话。
+   */
+  async discardPending(chatId) {
+    this.pendingLast.delete(chatId);
+    this.hintedReplies.delete(chatId);
+    this.quotaExhaustedNotified.delete(chatId);
+    this.options.store.clearOutbound(chatId);
+  }
   async drain(chatId) {
     const { store } = this.options;
     while (store.hasPendingOutbound(chatId)) {
@@ -2817,6 +2840,10 @@ var WeixinOutboundGate = class _WeixinOutboundGate {
       if (quota.expired || quota.remaining <= 0) break;
       const pending = store.peekOutbound(chatId);
       const next = pending[0];
+      if (isStale(next)) {
+        store.shiftOutbound(chatId);
+        continue;
+      }
       const isLastSlot = quota.remaining === 1;
       const hasMore = pending.length > 1;
       if (isLastSlot && hasMore) {
@@ -2836,6 +2863,13 @@ function appendHintIfText(item) {
   if (MEDIA_KINDS.has(item.kind)) return item;
   return { ...item, text: item.text + CONTINUATION_HINT };
 }
+function isStale(item, now = Date.now()) {
+  if (typeof item.enqueuedAt !== "number") return false;
+  return now - item.enqueuedAt >= PUSH_WINDOW_MS;
+}
+function stamp(item) {
+  return item.enqueuedAt === void 0 ? { ...item, enqueuedAt: Date.now() } : item;
+}
 
 // src/providers/claude-code/claudeStreamingRunner.ts
 import { spawn as spawn3 } from "node:child_process";
@@ -3680,6 +3714,21 @@ function readTurnId(value) {
   if (typeof record.turnId === "string" && record.turnId) return record.turnId;
   return void 0;
 }
+function readTurnAgentMessages(value) {
+  if (!value || typeof value !== "object") return [];
+  const turn = value.turn;
+  if (!turn || typeof turn !== "object") return [];
+  const items = turn.items;
+  if (!Array.isArray(items)) return [];
+  const texts = [];
+  for (const item of items) {
+    if (!item || typeof item !== "object") continue;
+    const record = item;
+    if (record.type !== "agentMessage") continue;
+    if (typeof record.text === "string" && record.text.trim()) texts.push(record.text);
+  }
+  return texts;
+}
 function readTurnError(value) {
   if (!value || typeof value !== "object") return void 0;
   const record = value;
@@ -3734,6 +3783,7 @@ var CodexInteractiveRunner = class {
     session.activeMessage = void 0;
     session.activeTurnId = void 0;
     session.turnClosed = false;
+    session.emittedTextThisTurn = false;
     session.turnCompletedPromise = new Promise((resolve2) => {
       session.turnCompletedResolver = resolve2;
     });
@@ -3880,6 +3930,7 @@ var CodexInteractiveRunner = class {
     });
     client.onNotification("turn/completed", (params) => {
       this.flushActiveMessage(session);
+      this.recoverTurnMessages(session, params);
       const turnError = readTurnError(params);
       if (turnError) this.enqueueEvent(session, { type: "error", error: turnError });
       session.turnClosed = true;
@@ -3920,6 +3971,18 @@ var CodexInteractiveRunner = class {
     this.enqueueEvent(session, { type: "text_delta", text: session.activeMessage.text });
     this.enqueueEvent(session, { type: "message_done" });
     session.activeMessage = void 0;
+    session.emittedTextThisTurn = true;
+  }
+  // 瞬时（非流式）回合里 app-server 可能完全不发 item/agentMessage/delta，
+  // 助手文本只出现在 turn/completed 的 items 中。此时若不兜底，回复会静默丢失。
+  // 只在本轮一条文本都没发出时才补发——宁可少发，也不要重复刷屏、白耗微信配额。
+  recoverTurnMessages(session, params) {
+    if (session.emittedTextThisTurn) return;
+    for (const text of readTurnAgentMessages(params)) {
+      this.enqueueEvent(session, { type: "text_delta", text });
+      this.enqueueEvent(session, { type: "message_done" });
+      session.emittedTextThisTurn = true;
+    }
   }
   enqueueEvent(session, event) {
     session.pendingEvents.push(event);
@@ -4363,7 +4426,19 @@ var MessageRouter = class _MessageRouter {
     }
   }
   async handleMessage(message) {
-    return this.withSessionChangeNotification(() => this.handleMessageInner(message));
+    try {
+      return await this.withSessionChangeNotification(() => this.handleMessageInner(message));
+    } catch (error) {
+      const detail = error instanceof Error ? error.message : String(error);
+      console.error("[bridge] handleMessage failed:", message.chatId, error);
+      await this.sendToChat({
+        chatId: message.chatId,
+        kind: "status",
+        text: `\u26A0\uFE0F \u6865\u63A5\u5C42\u5185\u90E8\u9519\u8BEF\uFF1A${detail}
+\u53EF\u91CD\u53D1\u6D88\u606F\u91CD\u8BD5\uFF1B\u82E5\u6301\u7EED\u5931\u8D25\uFF0C\u8BF7\u68C0\u67E5 provider \u662F\u5426\u53EF\u7528\uFF08claude-codex-wechat doctor\uFF09\u3002`
+      }).catch(() => void 0);
+      return { status: "accepted" };
+    }
   }
   async handleMessageInner(message) {
     let user = this.options.resolveUser(message);
@@ -4569,6 +4644,7 @@ var MessageRouter = class _MessageRouter {
     });
     const isLive = () => this.activeGenerations.get(message.chatId)?.genId === genId && (this.latestMutatingSeq.get(message.chatId) ?? 0) <= seq;
     let bufferedText = "";
+    let deliveredSomething = false;
     const typingMinIntervalMs = this.options.typingKeepaliveMs ?? 5e3;
     let lastTypingAt = Date.now();
     await this.options.channel.setTyping?.(message.chatId, true);
@@ -4593,6 +4669,7 @@ var MessageRouter = class _MessageRouter {
         if (event.type === "message_done" && bufferedText.trim()) {
           await this.sendToChat({ chatId: message.chatId, kind: "text", text: bufferedText });
           bufferedText = "";
+          deliveredSomething = true;
         }
         if (event.type === "choice_prompt" && event.labels.length > 0) {
           this.pendingChoices.set(message.chatId, { sessionId: session.id, labels: event.labels, multiSelect: event.multiSelect });
@@ -4622,11 +4699,20 @@ var MessageRouter = class _MessageRouter {
             kind: "status",
             text: errorText
           });
+          deliveredSomething = true;
         }
       }
       if (isLive() && bufferedText.trim()) {
         await this.sendToChat({ chatId: message.chatId, kind: "text", text: bufferedText });
         bufferedText = "";
+        deliveredSomething = true;
+      }
+      if (isLive() && !deliveredSomething) {
+        await this.sendToChat({
+          chatId: message.chatId,
+          kind: "status",
+          text: "\u26A0\uFE0F \u672C\u8F6E\u6CA1\u6709\u8FD4\u56DE\u4EFB\u4F55\u5185\u5BB9\uFF08provider \u5DF2\u7ED3\u675F\u4F46\u672A\u4EA7\u51FA\u56DE\u590D\uFF09\u3002\u53EF\u91CD\u53D1\u6D88\u606F\u91CD\u8BD5\u3002"
+        });
       }
       if (isLive()) {
         const finalBinding = this.conversation.getCurrent();
@@ -4643,6 +4729,10 @@ var MessageRouter = class _MessageRouter {
       const stillMine = this.activeGenerations.get(message.chatId)?.genId === genId;
       if (stillMine) this.activeGenerations.delete(message.chatId);
       await Promise.resolve(this.options.outboundGate?.finalize?.(message.chatId)).catch(() => void 0);
+      const quotaNotice = this.options.outboundGate?.takeQuotaExhaustedNotice?.(message.chatId);
+      if (quotaNotice) {
+        await this.sendToChat({ chatId: message.chatId, kind: "status", text: quotaNotice }).catch(() => void 0);
+      }
       if (stillMine) await this.options.channel.setTyping?.(message.chatId, false);
     }
   }
@@ -4718,6 +4808,7 @@ var MessageRouter = class _MessageRouter {
         providerId,
         cwd
       });
+      await Promise.resolve(this.options.outboundGate?.discardPending?.(chatId)).catch(() => void 0);
       await this.sendToChat({
         chatId,
         kind: "status",
@@ -5713,7 +5804,20 @@ function createUpdateChecker(opts) {
 }
 
 // src/daemon/bootstrap.ts
+var crashLoggingInstalled = false;
+function installCrashLogging() {
+  if (crashLoggingInstalled) return;
+  crashLoggingInstalled = true;
+  process.on("unhandledRejection", (reason) => {
+    console.error("[bridge] unhandled rejection:", reason);
+  });
+  process.on("uncaughtException", (error) => {
+    console.error("[bridge] uncaught exception, exiting:", error);
+    process.exit(1);
+  });
+}
 async function startDaemon(options) {
+  installCrashLogging();
   const port = options.port ?? Number(process.env.BRIDGE_PORT ?? 8787);
   const host = options.host ?? "0.0.0.0";
   const configPath = options.configPath ?? process.env.BRIDGE_CONFIG ?? defaultConfigPath();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-codex-wechat",
-  "version": "0.1.53",
+  "version": "0.1.54",
   "private": false,
   "type": "module",
   "packageManager": "pnpm@11.5.0",