claude-codex-wechat 0.1.19 → 0.1.20

package/dist/server/cli.js

@@ -2,9 +2,9 @@
 import { createRequire as __cjsCreateRequire } from 'node:module'; const require = __cjsCreateRequire(import.meta.url);
 
 // src/cli.ts
-import { existsSync as existsSync10, readFileSync as readFileSync8 } from "node:fs";
-import { dirname as dirname12, join as join12 } from "node:path";
-import { fileURLToPath } from "node:url";
+import { existsSync as existsSync10, readFileSync as readFileSync9 } from "node:fs";
+import { dirname as dirname13, join as join13 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/daemon/bootstrap.ts
 import { networkInterfaces } from "node:os";
@@ -81,9 +81,24 @@ function normalizeBridgeConfig(raw, env, path) {
     wechat: normalizeWechatConfig(record.wechat, env),
     bridge: normalizeBridgeDefaultsConfig(record.bridge),
     tunnel: normalizeTunnelConfig(record.tunnel),
+    update: normalizeUpdateStatusConfig(record.update),
     providers: normalizeProvidersConfig(record.providers, env)
   };
 }
+function normalizeUpdateStatusConfig(raw) {
+  const record = raw && typeof raw === "object" ? raw : {};
+  const currentVersion = typeof record.currentVersion === "string" && record.currentVersion ? record.currentVersion : void 0;
+  const latestVersion = typeof record.latestVersion === "string" && record.latestVersion ? record.latestVersion : void 0;
+  const lastCheckedAt = typeof record.lastCheckedAt === "number" && Number.isFinite(record.lastCheckedAt) ? record.lastCheckedAt : void 0;
+  const updateAvailable = record.updateAvailable === true;
+  if (!currentVersion && !latestVersion && lastCheckedAt === void 0 && !updateAvailable) return void 0;
+  return {
+    ...currentVersion ? { currentVersion } : {},
+    ...latestVersion ? { latestVersion } : {},
+    updateAvailable,
+    ...lastCheckedAt !== void 0 ? { lastCheckedAt } : {}
+  };
+}
 function normalizeProvidersConfig(raw, env) {
   const record = raw && typeof raw === "object" ? raw : {};
   const claude = normalizeProviderCommand(record.claude, env.BRIDGE_CLAUDE_COMMAND);
@@ -164,6 +179,21 @@ async function deleteConfigFile(configPath) {
     throw error;
   }
 }
+function persistUpdateStatusToConfigFile(input) {
+  const currentConfig = readConfigFileSync(input.configPath);
+  const nextConfig = {
+    ...currentConfig,
+    update: {
+      ...input.status.currentVersion ? { currentVersion: input.status.currentVersion } : {},
+      ...input.status.latestVersion ? { latestVersion: input.status.latestVersion } : {},
+      updateAvailable: input.status.updateAvailable,
+      ...input.status.lastCheckedAt !== void 0 ? { lastCheckedAt: input.status.lastCheckedAt } : {}
+    }
+  };
+  mkdirSync(dirname(input.configPath), { recursive: true });
+  writeFileSync(input.configPath, `${JSON.stringify(nextConfig, null, 2)}
+`, "utf8");
+}
 async function persistBridgeDefaultsToConfigFile(input) {
   const currentConfig = await readConfigFile(input.configPath);
   const currentBridge = isRecord(currentConfig.bridge) ? currentConfig.bridge : void 0;
@@ -2319,7 +2349,7 @@ var WeixinOutboundGate = class _WeixinOutboundGate {
 };
 
 // src/providers/claude-code/claudeStreamingRunner.ts
-import { spawn as spawn2 } from "node:child_process";
+import { spawn as spawn3 } from "node:child_process";
 import { randomUUID as randomUUID2 } from "node:crypto";
 
 // src/shared/platform.ts
@@ -2384,14 +2414,129 @@ function statePath(filename) {
   return join8(tmpdir(), filename);
 }
 
+// src/providers/claude-code/assistantContent.ts
+function extractAssistantBlocks(message) {
+  if (!message || typeof message !== "object") return [];
+  const content = message.content;
+  if (!Array.isArray(content)) return [];
+  return content.flatMap((item) => {
+    if (!item || typeof item !== "object") return [];
+    const record = item;
+    if (record.type === "text" && typeof record.text === "string") {
+      return [{ type: "text", text: record.text }];
+    }
+    if (record.type === "tool_use" && record.name === "AskUserQuestion") {
+      const rendered = renderAskUserQuestion(record.input);
+      return rendered ? [{ type: "choice", ...rendered }] : [];
+    }
+    return [];
+  });
+}
+function renderAskUserQuestion(input) {
+  if (!input || typeof input !== "object") return null;
+  const questions = input.questions;
+  if (!Array.isArray(questions) || questions.length === 0) return null;
+  const singleQuestion = questions.length === 1;
+  const blocks = [];
+  let mappedLabels = [];
+  let mappedMultiSelect = false;
+  for (const raw of questions) {
+    if (!raw || typeof raw !== "object") continue;
+    const q = raw;
+    const question = typeof q.question === "string" ? q.question.trim() : "";
+    if (!question) continue;
+    const multiSelect = q.multiSelect === true;
+    const lines = [`\u2753 ${question}`];
+    const labels = [];
+    const options = Array.isArray(q.options) ? q.options : [];
+    for (const rawOption of options) {
+      if (!rawOption || typeof rawOption !== "object") continue;
+      const option = rawOption;
+      const label = typeof option.label === "string" ? option.label.trim() : "";
+      if (!label) continue;
+      const description = typeof option.description === "string" ? option.description.trim() : "";
+      labels.push(label);
+      const bullet = singleQuestion ? `${labels.length}.` : "\u30FB";
+      lines.push(description ? `${bullet} ${label} \u2014\u2014 ${description}` : `${bullet} ${label}`);
+    }
+    if (!singleQuestion) {
+      lines.push("\uFF08\u56DE\u590D\u5BF9\u5E94\u9009\u9879\u7684\u6587\u5B57\u5373\u53EF\uFF09");
+    } else {
+      lines.push(multiSelect ? "\uFF08\u53EF\u591A\u9009\uFF0C\u56DE\u590D\u5E8F\u53F7\u6216\u9009\u9879\u6587\u5B57\uFF0C\u591A\u4E2A\u7528\u9017\u53F7\u5206\u9694\uFF0C\u5982 1,2\uFF09" : "\uFF08\u56DE\u590D\u5E8F\u53F7\u6216\u9009\u9879\u6587\u5B57\u5373\u53EF\uFF0C\u5982 1\uFF09");
+    }
+    blocks.push(lines.join("\n"));
+    if (singleQuestion) {
+      mappedLabels = labels;
+      mappedMultiSelect = multiSelect;
+    }
+  }
+  if (blocks.length === 0) return null;
+  return { text: blocks.join("\n\n"), labels: mappedLabels, multiSelect: mappedMultiSelect };
+}
+function mapChoiceReply(text, labels, multiSelect) {
+  if (labels.length === 0) return null;
+  const normalized = text.trim().replace(/[０-９]/g, (d) => String.fromCharCode(d.charCodeAt(0) - 65296 + 48));
+  if (!normalized) return null;
+  const tokens = normalized.split(/[\s,，、]+/).filter(Boolean);
+  if (tokens.length === 0) return null;
+  if (!multiSelect && tokens.length > 1) return null;
+  const picked = [];
+  for (const token of tokens) {
+    const digits = token.replace(/[.。)）:：]+$/, "");
+    if (!/^\d+$/.test(digits)) return null;
+    const index = Number(digits);
+    if (index < 1 || index > labels.length) return null;
+    const label = labels[index - 1];
+    if (!picked.includes(label)) picked.push(label);
+  }
+  return picked.length > 0 ? picked.join(", ") : null;
+}
+
+// src/providers/claude-code/bridgeSystemPrompt.ts
+var BRIDGE_APPEND_SYSTEM_PROMPT = [
+  "\u4F60\u6B63\u8FD0\u884C\u5728\u4E00\u4E2A\u5FAE\u4FE1\u7EAF\u6587\u672C\u6865\u63A5\u73AF\u5883\u4E2D,\u7528\u6237\u53EA\u80FD\u6536\u53D1\u6587\u672C\u6D88\u606F,\u6CA1\u6709\u4EFB\u4F55\u4EA4\u4E92\u5F0F\u5F39\u7A97\u6216\u6309\u94AE\u3002",
+  "\u5F53\u4F60\u9700\u8981\u7528\u6237\u505A\u9009\u62E9\u65F6,\u8BF7\u76F4\u63A5\u5728\u56DE\u590D\u91CC\u7528\u5E26\u5E8F\u53F7\u7684\u5217\u8868\u5217\u51FA\u9009\u9879(\u4F8B\u5982\u300C1. \u9009\u9879A\u300D\u300C2. \u9009\u9879B\u300D),",
+  "\u5E76\u544A\u8BC9\u7528\u6237\u56DE\u590D\u5E8F\u53F7\u6216\u9009\u9879\u6587\u5B57\u5373\u53EF;\u4E0D\u8981\u8C03\u7528 AskUserQuestion \u5DE5\u5177(\u5B83\u5728\u6B64\u73AF\u5883\u4E2D\u65E0\u6CD5\u4EA4\u4E92)\u3002"
+].join("");
+
+// src/providers/claude-code/claudeCapabilities.ts
+import { spawn as spawn2 } from "node:child_process";
+var cache = /* @__PURE__ */ new Map();
+var probeAppendSystemPromptSupport = (command) => {
+  const cached = cache.get(command);
+  if (cached) return cached;
+  const result = runHelpProbe(command);
+  cache.set(command, result);
+  return result;
+};
+function runHelpProbe(command) {
+  return new Promise((resolve2) => {
+    try {
+      const child = spawn2(command, ["--help"], { stdio: ["ignore", "pipe", "pipe"], shell: useShellForCli() });
+      let output = "";
+      const collect = (data) => {
+        output += String(data);
+      };
+      child.stdout?.on("data", collect);
+      child.stderr?.on("data", collect);
+      child.on("error", () => resolve2(false));
+      child.on("close", () => resolve2(output.includes("--append-system-prompt")));
+    } catch {
+      resolve2(false);
+    }
+  });
+}
+
 // src/providers/claude-code/claudeStreamingRunner.ts
 var ClaudeStreamingRunner = class {
   sessions = /* @__PURE__ */ new Map();
   command;
   spawner;
+  capabilityProbe;
   constructor(input = {}) {
     this.command = input.command ?? "claude";
     this.spawner = input.spawner ?? defaultClaudeStreamSpawner;
+    this.capabilityProbe = input.capabilityProbe ?? probeAppendSystemPromptSupport;
   }
   async startSession(input) {
     const resumeId = input.options?.providerSessionId;
@@ -2412,6 +2557,9 @@ var ClaudeStreamingRunner = class {
   async *sendMessage(input) {
     const session = this.sessions.get(input.bridgeSessionId);
     if (!session) throw new Error(`claude_session_not_found:${input.bridgeSessionId}`);
+    if (session.supportsAppendSystemPrompt === void 0) {
+      session.supportsAppendSystemPrompt = await this.capabilityProbe(this.command);
+    }
     const handle = this.ensureHandle(session);
     session.pendingFollowUps = 0;
     handle.write(userEnvelope(input.text));
@@ -2448,8 +2596,11 @@ var ClaudeStreamingRunner = class {
       }
       if (type === "assistant") {
         let emitted = false;
-        for (const text of extractAssistantText(record.message)) {
-          yield { type: "text_delta", text };
+        for (const block of extractAssistantBlocks(record.message)) {
+          yield { type: "text_delta", text: block.text };
+          if (block.type === "choice" && block.labels.length > 0) {
+            yield { type: "choice_prompt", labels: block.labels, multiSelect: block.multiSelect };
+          }
           emitted = true;
         }
         if (emitted) yield { type: "message_done" };
@@ -2510,6 +2661,7 @@ function buildStreamingArgs(session) {
     "--include-partial-messages",
     "--verbose",
     "--dangerously-skip-permissions",
+    ...session.supportsAppendSystemPrompt ? ["--append-system-prompt", BRIDGE_APPEND_SYSTEM_PROMPT] : [],
     "--replay-user-messages"
   ];
   if (session.resumeId) {
@@ -2528,16 +2680,6 @@ function userEnvelope(text) {
   return `${JSON.stringify({ type: "user", message: { role: "user", content: text }, parent_tool_use_id: null })}
 `;
 }
-function extractAssistantText(message) {
-  if (!message || typeof message !== "object") return [];
-  const content = message.content;
-  if (!Array.isArray(content)) return [];
-  return content.flatMap((item) => {
-    if (!item || typeof item !== "object") return [];
-    const record = item;
-    return record.type === "text" && typeof record.text === "string" ? [record.text] : [];
-  });
-}
 function extractError(record) {
   if (typeof record.message === "string") return record.message;
   if (record.error && typeof record.error === "object") {
@@ -2554,7 +2696,7 @@ function parseJsonLine(line) {
   }
 }
 function defaultClaudeStreamSpawner(call) {
-  const child = spawn2(call.command, call.args, { cwd: expandTilde(call.cwd) ?? call.cwd, stdio: ["pipe", "pipe", "pipe"], shell: useShellForCli() });
+  const child = spawn3(call.command, call.args, { cwd: expandTilde(call.cwd) ?? call.cwd, stdio: ["pipe", "pipe", "pipe"], shell: useShellForCli() });
   let stderr = "";
   let buffer = "";
   const queue = [];
@@ -2653,7 +2795,7 @@ var ClaudeCodeProvider = class {
 };
 
 // src/providers/codex/codexAppServerClient.ts
-import { spawn as spawn3 } from "node:child_process";
+import { spawn as spawn4 } from "node:child_process";
 var CodexAppServerClient = class {
   child;
   pending = /* @__PURE__ */ new Map();
@@ -2664,7 +2806,7 @@ var CodexAppServerClient = class {
   buffer = "";
   constructor(input) {
     const command = input.command ?? "codex";
-    this.child = spawn3(command, ["app-server", "--listen", "stdio://"], {
+    this.child = spawn4(command, ["app-server", "--listen", "stdio://"], {
       cwd: input.cwd,
       stdio: ["pipe", "pipe", "pipe"],
       shell: useShellForCli()
@@ -3071,10 +3213,10 @@ function createDefaultProviders(input = {}) {
 }
 
 // src/providers/claude-code/claudeDetection.ts
-import { spawn as spawn4 } from "node:child_process";
+import { spawn as spawn5 } from "node:child_process";
 async function defaultCommandRunner(command, args) {
   return await new Promise((resolve2) => {
-    const child = spawn4(command, args, { stdio: ["ignore", "pipe", "pipe"], shell: useShellForCli() });
+    const child = spawn5(command, args, { stdio: ["ignore", "pipe", "pipe"], shell: useShellForCli() });
     let stdout = "";
     let stderr = "";
     child.stdout.on("data", (chunk) => {
@@ -3107,10 +3249,10 @@ ${result.stderr}`) };
 }
 
 // src/providers/codex/codexDetection.ts
-import { spawn as spawn5 } from "node:child_process";
+import { spawn as spawn6 } from "node:child_process";
 async function defaultCodexCommandRunner(command, args) {
   return await new Promise((resolve2) => {
-    const child = spawn5(command, args, { stdio: ["ignore", "pipe", "pipe"], shell: useShellForCli() });
+    const child = spawn6(command, args, { stdio: ["ignore", "pipe", "pipe"], shell: useShellForCli() });
     let stdout = "";
     let stderr = "";
     child.stdout.on("data", (chunk) => {
@@ -3377,6 +3519,10 @@ var MessageRouter = class _MessageRouter {
   opSeq = 0;
   latestMutatingSeq = /* @__PURE__ */ new Map();
   activeGenerations = /* @__PURE__ */ new Map();
+  // 最近一次 AskUserQuestion 的选项，按 chatId 暂存，并记住是哪个 bridge 会话发出的。
+  // 下一条入站消息若是纯序号，用它翻译成选项文字再转发（消费一次即清除）；不是序号、
+  // 或当前会话已变（sessionId 不匹配）则原样透传，避免旧选项串到别的会话。
+  pendingChoices = /* @__PURE__ */ new Map();
   get conversation() {
     return this.options.conversation;
   }
@@ -3452,12 +3598,24 @@ var MessageRouter = class _MessageRouter {
     if ((this.latestMutatingSeq.get(message.chatId) ?? 0) > seq) {
       return { status: "accepted" };
     }
-    if (await this.maybeSteer(message.chatId, command.text)) {
+    const chatText = this.resolveChoiceReply(message.chatId, command.text);
+    if (await this.maybeSteer(message.chatId, chatText)) {
       return { status: "accepted" };
     }
-    await this.runExclusive(() => this.runChatGeneration(message, user, command.text, seq));
+    await this.runExclusive(() => this.runChatGeneration(message, user, chatText, seq));
     return { status: "accepted" };
   }
+  // 消费一次上一轮暂存的 AskUserQuestion 选项：纯序号回复翻译成对应选项文字，
+  // 其它情况原样透传。取用后即清除，避免过期映射误伤后续消息。若暂存所属会话
+  // 与当前会话不一致（用户已 /new、/resume 或切换 provider），也一律不翻译，
+  // 防止旧会话的选项串到新会话。
+  resolveChoiceReply(chatId, text) {
+    const pending = this.pendingChoices.get(chatId);
+    if (!pending) return text;
+    this.pendingChoices.delete(chatId);
+    if (pending.sessionId !== this.conversation.getCurrent()?.id) return text;
+    return mapChoiceReply(text, pending.labels, pending.multiSelect) ?? text;
+  }
   // A chat message arriving while a turn is in flight: if the provider supports
   // native steer (Codex turn/steer), inject it into the running turn instead of
   // queueing a new turn. Otherwise fall back to the serialized lock (queue).
@@ -3584,6 +3742,9 @@ var MessageRouter = class _MessageRouter {
           await this.sendToChat({ chatId: message.chatId, kind: "text", text: bufferedText });
           bufferedText = "";
         }
+        if (event.type === "choice_prompt" && event.labels.length > 0) {
+          this.pendingChoices.set(message.chatId, { sessionId: session.id, labels: event.labels, multiSelect: event.multiSelect });
+        }
         if (event.type === "session_state") {
           const updated = this.conversation.update({
             providerSessionId: event.state.providerSessionId,
@@ -3655,6 +3816,7 @@ var MessageRouter = class _MessageRouter {
       return;
     }
     if (command.kind === "new_session") {
+      this.pendingChoices.delete(chatId);
       await this.preemptActiveGeneration(chatId);
       const providerId = command.providerId ?? this.conversation.getCurrent()?.providerId ?? this.options.defaults?.defaultProvider ?? "claude-code";
       const cwd = command.cwd ?? this.conversation.getCurrent()?.cwd ?? this.options.defaults?.defaultWorkspace ?? defaultWorkspaceDir();
@@ -3720,6 +3882,7 @@ var MessageRouter = class _MessageRouter {
       return;
     }
     if (command.kind === "resume_session") {
+      this.pendingChoices.delete(chatId);
       const ref = command.ref.trim();
       if (!ref) {
         await this.sendToChat({ chatId, kind: "status", text: "\u7528\u6CD5\uFF1A/resume <\u7F16\u53F7>" });
@@ -3983,6 +4146,7 @@ var BridgeEventHub = class {
 };
 
 // src/runtime/relayTunnelProvider.ts
+var WS_OPEN = 1;
 var RelayTunnelProvider = class {
   constructor(options) {
     this.options = options;
@@ -3997,6 +4161,9 @@ var RelayTunnelProvider = class {
   stopped = true;
   reconnectAttempts = 0;
   reconnectTimer = null;
+  // 能力协商结果:仅当服务器在 registered 回包里声明 streaming:true 时才走流式,
+  // 否则退回缓冲(兼容老服务器)。
+  serverSupportsStreaming = false;
   static defaultCreateSocket(url) {
     const socket = new WebSocket(url);
     return {
@@ -4062,7 +4229,10 @@ var RelayTunnelProvider = class {
           type: "register",
           clientVersion: "0.1.0",
           targetBaseUrl: this.options.targetBaseUrl,
-          authToken: this.options.authToken
+          authToken: this.options.authToken,
+          // 声明支持流式转发。新服务器会在 registered 回包里回 streaming:true;
+          // 老服务器忽略此字段,客户端据此自动退回缓冲。
+          supportsStreaming: true
         }));
       });
       socket.on("message", (raw) => {
@@ -4081,6 +4251,7 @@ var RelayTunnelProvider = class {
         }
         if (payload?.type === "registered") {
           this.reconnectAttempts = 0;
+          this.serverSupportsStreaming = payload?.streaming === true;
           const publicUrl = typeof payload?.publicUrl === "string" && payload.publicUrl ? payload.publicUrl : typeof payload?.token === "string" ? `${derivePublicBaseUrl(this.options.serverUrl)}/${payload.token}` : void 0;
           this.status = {
             installed: true,
@@ -4092,7 +4263,10 @@ var RelayTunnelProvider = class {
           return;
         }
         if (payload?.type === "request") {
-          void this.handleRequest(payload);
+          const requestId = typeof payload?.requestId === "string" ? payload.requestId : "unknown";
+          void this.handleRequest(payload).catch((error) => {
+            console.warn(`[relay] \u5904\u7406\u8BF7\u6C42 ${requestId} \u5931\u8D25\uFF1A`, error instanceof Error ? error.message : String(error));
+          });
         }
       });
       socket.on("close", () => {
@@ -4139,22 +4313,91 @@ var RelayTunnelProvider = class {
     }, delay3);
     this.reconnectTimer.unref?.();
   }
-  async handleRequest(payload) {
-    const fetchImpl = this.options.fetchImpl ?? fetch;
-    const response = await fetchImpl(`${this.options.targetBaseUrl}${payload.path}`, {
-      method: payload.method,
-      headers: payload.headers,
-      body: payload.bodyBase64 ? Buffer.from(payload.bodyBase64, "base64") : void 0
-    });
-    const bodyBuffer = Buffer.from(await response.arrayBuffer());
-    this.socket?.send(JSON.stringify({
+  // 只在连接就绪时发送；未就绪（重连中/尚未 OPEN）时静默跳过（属正常态，不记日志、
+  // 不关连接，以免误伤正在进行的重连）。底层 send 真抛错说明 socket 已坏：记一条 warn，
+  // 并主动 close() 让 close 事件驱动重连、由服务端 WS close 清理它那边的挂起请求。
+  safeSend(payload) {
+    const socket = this.socket;
+    if (!socket) return false;
+    if (socket.readyState !== void 0 && socket.readyState !== WS_OPEN) return false;
+    try {
+      socket.send(payload);
+      return true;
+    } catch (error) {
+      console.warn("[relay] \u56DE\u4F20\u53D1\u9001\u5931\u8D25\uFF0C\u56DE\u6536\u8FDE\u63A5\u4EE5\u91CD\u8FDE\uFF1A", error instanceof Error ? error.message : String(error));
+      try {
+        socket.close();
+      } catch {
+      }
+      return false;
+    }
+  }
+  // 尽力给服务端回一个错误响应，让它立即结束这单挂起请求（避免公网调用方干等到 30s 超时）。
+  // 隧道已断时 safeSend 会静默跳过——此时服务端会因 WS close 自行清理，无需在此处理。
+  sendErrorReply(requestId) {
+    this.safeSend(JSON.stringify({
       type: "response",
-      requestId: payload.requestId,
-      status: response.status,
-      headers: Object.fromEntries(response.headers.entries()),
-      bodyBase64: bodyBuffer.toString("base64")
+      requestId,
+      status: 502,
+      headers: { "content-type": "text/plain; charset=utf-8" },
+      bodyBase64: Buffer.from("agent_local_error").toString("base64")
     }));
   }
+  async handleRequest(payload) {
+    const fetchImpl = this.options.fetchImpl ?? fetch;
+    let response;
+    try {
+      response = await fetchImpl(`${this.options.targetBaseUrl}${payload.path}`, {
+        method: payload.method,
+        headers: payload.headers,
+        body: payload.bodyBase64 ? Buffer.from(payload.bodyBase64, "base64") : void 0
+      });
+    } catch (error) {
+      console.warn(`[relay] \u672C\u5730\u8BF7\u6C42 ${payload.requestId} \u5931\u8D25\uFF1A`, error instanceof Error ? error.message : String(error));
+      this.sendErrorReply(payload.requestId);
+      return;
+    }
+    if (this.serverSupportsStreaming) {
+      await this.streamResponse(payload.requestId, response);
+      return;
+    }
+    try {
+      const bodyBuffer = Buffer.from(await response.arrayBuffer());
+      this.safeSend(JSON.stringify({
+        type: "response",
+        requestId: payload.requestId,
+        status: response.status,
+        headers: Object.fromEntries(response.headers.entries()),
+        bodyBase64: bodyBuffer.toString("base64")
+      }));
+    } catch (error) {
+      console.warn(`[relay] \u8BFB\u53D6\u54CD\u5E94\u4F53 ${payload.requestId} \u5931\u8D25\uFF1A`, error instanceof Error ? error.message : String(error));
+      this.sendErrorReply(payload.requestId);
+    }
+  }
+  // 流式回传:把响应拆成 response-start → response-chunk* → response-end 三段边收边发。
+  // 不区分 content-type——服务器按 content-type 决定透传还是收齐重写(html/js/css)。
+  // 对无限流(SSE)这是关键:响应体永不结束,绝不能 await 读完再发。
+  async streamResponse(requestId, response) {
+    const status = response.status;
+    const headers = Object.fromEntries(response.headers.entries());
+    if (!this.safeSend(JSON.stringify({ type: "response-start", requestId, status, headers }))) return;
+    try {
+      const body = response.body;
+      if (body) {
+        for await (const chunk of body) {
+          const ok = this.safeSend(JSON.stringify({
+            type: "response-chunk",
+            requestId,
+            chunkBase64: Buffer.from(chunk).toString("base64")
+          }));
+          if (!ok) return;
+        }
+      }
+    } finally {
+      this.safeSend(JSON.stringify({ type: "response-end", requestId }));
+    }
+  }
 };
 function derivePublicBaseUrl(serverUrl) {
   return serverUrl.replace(/^ws:\/\//, "http://").replace(/^wss:\/\//, "https://").replace(/\/agent\/?$/, "").replace(/\/+$/, "");
@@ -4208,6 +4451,14 @@ var RelayTunnelRouter = class {
 };
 
 // src/daemon/server.ts
+function readUpdateStatusBestEffort(configPath) {
+  if (!configPath) return { ok: false };
+  try {
+    return { ok: true, update: loadBridgeConfig(configPath).update };
+  } catch {
+    return { ok: false };
+  }
+}
 function createDaemonServer(options = {}) {
   const app = Fastify({ logger: true });
   const events = new BridgeEventHub();
@@ -4378,16 +4629,21 @@ function createDaemonServer(options = {}) {
     });
   }
   registerFsBrowseRoutes({ app });
-  app.get("/api/status", async () => ({
-    ok: true,
-    sessions: conversation.getCurrent() ? [conversation.getCurrent()] : [],
-    preferredLocalUrl: (() => {
-      const lan = listLanIpv4Addresses()[0];
-      const port = process.env.BRIDGE_PORT ?? 8787;
-      if (lan) return `http://${lan}:${port}`;
-      return `http://127.0.0.1:${port}`;
-    })()
-  }));
+  app.get("/api/status", async () => {
+    const read = readUpdateStatusBestEffort(configPath);
+    const update = read.ok ? read.update ?? null : persistedConfig.update ?? null;
+    return {
+      ok: true,
+      sessions: conversation.getCurrent() ? [conversation.getCurrent()] : [],
+      update,
+      preferredLocalUrl: (() => {
+        const lan = listLanIpv4Addresses()[0];
+        const port = process.env.BRIDGE_PORT ?? 8787;
+        if (lan) return `http://${lan}:${port}`;
+        return `http://127.0.0.1:${port}`;
+      })()
+    };
+  });
   app.get("/api/providers/status", async () => providers.getStatus());
   app.post("/api/bridge-events", async (request, reply) => {
     reply.raw.writeHead(200, {
@@ -4423,6 +4679,91 @@ function createDaemonServer(options = {}) {
   return { app, conversation, sessions: conversation, events, activeUserStore, tunnelProvider };
 }
 
+// src/daemon/updateChecker.ts
+var DEFAULT_REGISTRY_URL = "https://registry.npmmirror.com/claude-codex-wechat/latest";
+var DEFAULT_INTERVAL_MS = 60 * 60 * 1e3;
+var FETCH_TIMEOUT_MS = 5e3;
+function parseCore(version) {
+  const core = version.trim().replace(/^v/, "").split(/[-+]/, 1)[0];
+  const parts = core.split(".");
+  if (parts.length !== 3) return null;
+  const nums = parts.map((p) => Number(p));
+  if (nums.some((n) => !Number.isInteger(n) || n < 0)) return null;
+  return [nums[0], nums[1], nums[2]];
+}
+function compareSemver(a, b) {
+  const ca = parseCore(a);
+  const cb = parseCore(b);
+  if (!ca || !cb) return null;
+  for (let i = 0; i < 3; i += 1) {
+    if (ca[i] > cb[i]) return 1;
+    if (ca[i] < cb[i]) return -1;
+  }
+  return 0;
+}
+function isNewerVersion(latest, current) {
+  if (/[-]/.test(latest.trim().replace(/^v/, ""))) return false;
+  return compareSemver(latest, current) === 1;
+}
+function createUpdateChecker(opts) {
+  const registryUrl = opts.registryUrl ?? DEFAULT_REGISTRY_URL;
+  const intervalMs = opts.intervalMs ?? DEFAULT_INTERVAL_MS;
+  const fetchImpl = opts.fetchImpl ?? fetch;
+  const persist = opts.persist ?? persistUpdateStatusToConfigFile;
+  const now = opts.now ?? (() => Date.now());
+  let timer = null;
+  async function checkOnce() {
+    try {
+      const response = await fetchImpl(registryUrl, { signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
+      if (!response.ok) return;
+      const data = await response.json();
+      const latest = typeof data?.version === "string" && data.version.trim() ? data.version.trim() : void 0;
+      if (!latest) return;
+      if (compareSemver(latest, opts.currentVersion) === null) return;
+      await Promise.resolve(persist({
+        configPath: opts.configPath,
+        status: {
+          currentVersion: opts.currentVersion,
+          latestVersion: latest,
+          updateAvailable: isNewerVersion(latest, opts.currentVersion),
+          lastCheckedAt: now()
+        }
+      }));
+    } catch {
+    }
+  }
+  return {
+    async start() {
+      await checkOnce();
+      timer = setInterval(() => {
+        void checkOnce();
+      }, intervalMs);
+      timer.unref?.();
+    },
+    stop() {
+      if (timer) {
+        clearInterval(timer);
+        timer = null;
+      }
+    },
+    checkOnce
+  };
+}
+
+// src/shared/version.ts
+import { readFileSync as readFileSync7 } from "node:fs";
+import { dirname as dirname11, join as join10 } from "node:path";
+import { fileURLToPath } from "node:url";
+function readClientVersion() {
+  try {
+    const here2 = dirname11(fileURLToPath(import.meta.url));
+    const pkg = JSON.parse(readFileSync7(join10(here2, "..", "..", "package.json"), "utf8"));
+    return typeof pkg.version === "string" && pkg.version ? pkg.version : "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+
 // src/daemon/bootstrap.ts
 async function startDaemon(options) {
   const port = options.port ?? Number(process.env.BRIDGE_PORT ?? 8787);
@@ -4456,6 +4797,9 @@ async function startDaemon(options) {
   if (config.tunnel?.relay?.serverUrl && config.tunnel?.relay?.authToken) {
     await resolvedTunnelProvider?.start().catch(() => void 0);
   }
+  if (options.enableUpdateCheck) {
+    createUpdateChecker({ currentVersion: readClientVersion(), configPath }).start().catch(() => void 0);
+  }
   console.log("claude-codex-wechat listening:");
   console.log(`  Local:   http://127.0.0.1:${actualPort}`);
   for (const ip of listLanIpv4Addresses()) {
@@ -4478,8 +4822,8 @@ async function resolveProviderCommands(providers) {
 }
 
 // src/daemon/staticFrontend.ts
-import { readFileSync as readFileSync7 } from "node:fs";
-import { join as join10 } from "node:path";
+import { readFileSync as readFileSync8 } from "node:fs";
+import { join as join11 } from "node:path";
 import fastifyStatic from "@fastify/static";
 function attachStaticFrontend(webRoot2) {
   return async (app) => {
@@ -4487,7 +4831,7 @@ function attachStaticFrontend(webRoot2) {
       root: webRoot2,
       wildcard: false
     });
-    const indexHtml = readFileSync7(join10(webRoot2, "index.html"), "utf8");
+    const indexHtml = readFileSync8(join11(webRoot2, "index.html"), "utf8");
     app.setNotFoundHandler((request, reply) => {
       if (request.url.startsWith("/api")) {
         reply.code(404).send({ error: "not_found" });
@@ -4502,17 +4846,17 @@ function attachStaticFrontend(webRoot2) {
 import { existsSync as existsSync9, statSync, openSync, closeSync, watchFile } from "node:fs";
 import { mkdir as mkdir4, readFile as readFile6, rm as rm2, writeFile as writeFile5 } from "node:fs/promises";
 import { homedir as homedir8 } from "node:os";
-import { dirname as dirname11, join as join11 } from "node:path";
+import { dirname as dirname12, join as join12 } from "node:path";
 import { createReadStream } from "node:fs";
-import { execFile, spawn as spawn6 } from "node:child_process";
+import { execFile, spawn as spawn7 } from "node:child_process";
 import { createInterface } from "node:readline";
 import { promisify } from "node:util";
 var execFileAsync = promisify(execFile);
 async function installService(context) {
   if (process.platform === "darwin") {
     const spec = buildLaunchdSpec(context);
-    await mkdir4(dirname11(spec.plistPath), { recursive: true });
-    await mkdir4(dirname11(spec.stdoutPath), { recursive: true });
+    await mkdir4(dirname12(spec.plistPath), { recursive: true });
+    await mkdir4(dirname12(spec.stdoutPath), { recursive: true });
     await writeFile5(spec.plistPath, renderLaunchdPlist(spec), "utf8");
     await runLaunchctl(["unload", spec.plistPath]).catch(() => void 0);
     await runLaunchctl(["load", spec.plistPath]);
@@ -4521,8 +4865,8 @@ async function installService(context) {
   }
   if (process.platform === "linux") {
     const spec = buildSystemdUserSpec(context);
-    await mkdir4(dirname11(spec.unitPath), { recursive: true });
-    await mkdir4(dirname11(spec.stdoutPath), { recursive: true });
+    await mkdir4(dirname12(spec.unitPath), { recursive: true });
+    await mkdir4(dirname12(spec.stdoutPath), { recursive: true });
     await writeFile5(spec.unitPath, renderSystemdUnit(spec), "utf8");
     await runSystemctl(["--user", "daemon-reload"]);
     await runSystemctl(["--user", "enable", "--now", spec.unitName]);
@@ -4687,37 +5031,37 @@ async function readServiceStatus(context) {
   throw new Error("service_status_not_supported_on_this_platform");
 }
 function buildLaunchdSpec(context) {
-  const stateDir = join11(homedir8(), ".claude-codex-wechat");
+  const stateDir = join12(homedir8(), ".claude-codex-wechat");
   return {
     label: "com.claude-codex-wechat",
-    plistPath: join11(homedir8(), "Library", "LaunchAgents", "com.claude-codex-wechat.plist"),
+    plistPath: join12(homedir8(), "Library", "LaunchAgents", "com.claude-codex-wechat.plist"),
     programArgs: [context.nodePath ?? process.execPath, context.cliEntrypointPath, "__daemon"],
     workingDirectory: homedir8(),
-    stdoutPath: join11(stateDir, "logs", "service.stdout.log"),
-    stderrPath: join11(stateDir, "logs", "service.stderr.log"),
+    stdoutPath: join12(stateDir, "logs", "service.stdout.log"),
+    stderrPath: join12(stateDir, "logs", "service.stderr.log"),
     environment: buildServiceEnvironment(context)
   };
 }
 function buildSystemdUserSpec(context) {
-  const stateDir = join11(homedir8(), ".claude-codex-wechat");
+  const stateDir = join12(homedir8(), ".claude-codex-wechat");
   return {
     unitName: "claude-codex-wechat.service",
-    unitPath: join11(homedir8(), ".config", "systemd", "user", "claude-codex-wechat.service"),
+    unitPath: join12(homedir8(), ".config", "systemd", "user", "claude-codex-wechat.service"),
     execStart: [context.nodePath ?? process.execPath, context.cliEntrypointPath, "__daemon"],
     workingDirectory: homedir8(),
-    stdoutPath: join11(stateDir, "logs", "service.stdout.log"),
-    stderrPath: join11(stateDir, "logs", "service.stderr.log"),
+    stdoutPath: join12(stateDir, "logs", "service.stdout.log"),
+    stderrPath: join12(stateDir, "logs", "service.stderr.log"),
     environment: buildServiceEnvironment(context)
   };
 }
 function buildProcessSpec(context) {
-  const stateDir = join11(homedir8(), ".claude-codex-wechat");
+  const stateDir = join12(homedir8(), ".claude-codex-wechat");
   return {
-    pidPath: join11(stateDir, "service.pid"),
+    pidPath: join12(stateDir, "service.pid"),
     command: [context.nodePath ?? process.execPath, context.cliEntrypointPath, "__daemon"],
     workingDirectory: homedir8(),
-    stdoutPath: join11(stateDir, "logs", "service.stdout.log"),
-    stderrPath: join11(stateDir, "logs", "service.stderr.log"),
+    stdoutPath: join12(stateDir, "logs", "service.stdout.log"),
+    stderrPath: join12(stateDir, "logs", "service.stderr.log"),
     environment: buildServiceEnvironment(context)
   };
 }
@@ -4838,7 +5182,7 @@ async function readPidFile(pidPath) {
   }
 }
 async function writePidFile(pidPath, pid) {
-  await mkdir4(dirname11(pidPath), { recursive: true });
+  await mkdir4(dirname12(pidPath), { recursive: true });
   await writeFile5(pidPath, `${pid}
 `, "utf8");
 }
@@ -4853,12 +5197,12 @@ async function killPid(pid) {
   process.kill(pid, "SIGTERM");
 }
 async function spawnDetachedDaemon(spec) {
-  await mkdir4(dirname11(spec.stdoutPath), { recursive: true });
+  await mkdir4(dirname12(spec.stdoutPath), { recursive: true });
   const outFd = openSync(spec.stdoutPath, "a");
   const errFd = openSync(spec.stderrPath, "a");
   try {
     const [command, ...args] = spec.command;
-    const child = spawn6(command, args, {
+    const child = spawn7(command, args, {
       cwd: spec.workingDirectory,
       // Windows 分离进程需继承完整 process.env（SystemRoot/APPDATA/PATHEXT 等），
       // 否则子进程及其拉起的 claude/codex 会异常；spec.environment 仅作 BRIDGE_* 等覆盖层。
@@ -4896,7 +5240,7 @@ ${tail}
 `);
   }
   if (process.platform === "linux" || process.platform === "darwin") {
-    const child = spawn6("tail", ["-f", ...existing], { stdio: ["ignore", "pipe", "inherit"] });
+    const child = spawn7("tail", ["-f", ...existing], { stdio: ["ignore", "pipe", "inherit"] });
     child.stdout.on("data", (chunk) => {
       process.stdout.write(String(chunk));
     });
@@ -4939,8 +5283,8 @@ function fileSizeHint(path) {
 }
 
 // src/cli.ts
-var here = dirname12(fileURLToPath(import.meta.url));
-var webRoot = join12(here, "..", "web");
+var here = dirname13(fileURLToPath2(import.meta.url));
+var webRoot = join13(here, "..", "web");
 async function main() {
   const command = process.argv[2];
   switch (command) {
@@ -5011,6 +5355,7 @@ async function cmdRestart() {
 async function cmdStatus() {
   const status = await readServiceStatus(createServiceContext());
   printServiceStatus("service status", status);
+  printUpdateHint();
 }
 async function cmdLogs() {
   console.log(await readServiceLogs(createServiceContext()));
@@ -5025,7 +5370,8 @@ async function cmdDaemon() {
     return;
   }
   await startDaemon({
-    attachFrontend: attachStaticFrontend(webRoot)
+    attachFrontend: attachStaticFrontend(webRoot),
+    enableUpdateCheck: true
   });
 }
 async function cmdDoctor() {
@@ -5044,6 +5390,23 @@ async function cmdDoctor() {
     report("\u5FAE\u4FE1 token", wechat?.token ? "\u5DF2\u914D\u7F6E" : "\u672A\u914D\u7F6E");
     report("\u5FAE\u4FE1 accountId", wechat?.accountId ? "\u5DF2\u914D\u7F6E" : "\u672A\u914D\u7F6E");
   }
+  printUpdateHint();
+}
+function printUpdateHint() {
+  const configPath = process.env.BRIDGE_CONFIG ?? defaultConfigPath();
+  if (!existsSync10(configPath)) return;
+  let update;
+  try {
+    update = loadBridgeConfig(configPath).update;
+  } catch {
+    return;
+  }
+  if (!update?.updateAvailable) return;
+  const current = update.currentVersion ?? readClientVersion();
+  console.log(`
+\u53D1\u73B0\u65B0\u7248 v${update.latestVersion}\uFF08\u5F53\u524D v${current}\uFF09\u3002\u66F4\u65B0\uFF1A`);
+  console.log("  npm install -g claude-codex-wechat@latest --registry=https://registry.npmmirror.com/");
+  console.log("  claude-codex-wechat restart");
 }
 function cmdPrintConfig() {
   const configPath = process.env.BRIDGE_CONFIG ?? defaultConfigPath();
@@ -5052,7 +5415,7 @@ function cmdPrintConfig() {
     process.exitCode = 1;
     return;
   }
-  console.log(readFileSync8(configPath, "utf8"));
+  console.log(readFileSync9(configPath, "utf8"));
 }
 async function cmdUninstall() {
   const status = await uninstallService(createServiceContext());
@@ -5060,7 +5423,7 @@ async function cmdUninstall() {
 }
 function createServiceContext() {
   return {
-    cliEntrypointPath: fileURLToPath(import.meta.url),
+    cliEntrypointPath: fileURLToPath2(import.meta.url),
     nodePath: process.execPath,
     configPath: process.env.BRIDGE_CONFIG ?? defaultConfigPath(),
     port: Number(process.env.BRIDGE_PORT ?? 8787)