@unlinearity/cli-wechat-bridge 1.1.1 → 1.1.3

package/dist/daemon/wechat-daemon.js

@@ -13,7 +13,7 @@ import { readBridgeLockFile, } from "../bridge/bridge-state.js";
 import { getProcessRecordByPid, isWechatDaemonCommandLine, killProcessTreeSync, listWechatDaemonProcesses, reapOrphanedOpencodeProcesses, reapPeerBridgeProcesses, } from "../bridge/bridge-process-reaper.js";
 import { buildOneTimeCode, buildWechatInboundPrompt, formatApprovalMessage, formatDuration, formatMirroredUserInputMessage, formatPendingApprovalReminder, formatPendingUserInputReminder, formatSessionSwitchMessage, formatTaskFailedMessage, formatUserInputRequestMessage, MESSAGE_START_GRACE_MS, nowIso, OutputBatcher, parsePendingUserInputAnswerCommand, parseWechatControlCommand, truncatePreview, } from "../bridge/bridge-utils.js";
 import { formatUserFacingBridgeFatalError, formatUserFacingInboundError, formatWechatContextTokenStaleLogEntry, formatWechatSendFailureLogEntry, isRetryableWechatSendError, shouldForwardBridgeEventToWechat, } from "../bridge/wechat-bridge.js";
-import { BRIDGE_LOCK_FILE, BRIDGE_LOG_FILE, ensureChannelDataDir, migrateLegacyChannelFiles, } from "../wechat/channel-config.js";
+import { BRIDGE_LOCK_FILE, BRIDGE_LOG_FILE, appendBoundedLog, ensureChannelDataDir, migrateLegacyChannelFiles, } from "../wechat/channel-config.js";
 import { ensureWechatCredentials } from "../wechat/setup.js";
 import { formatBindCommandUsage, formatBindingsListMessage, isBindCommandPrefix, listBindings, loadEmojiBindings, parseEmojiBindingsCommand, removeBinding, resolveEmojiCommand, setBinding, } from "./emoji-bindings.js";
 import { classifyWechatTransportError, DEFAULT_LONG_POLL_TIMEOUT_MS, describeWechatTransportError, isWechatContextTokenStaleError, WeChatTransport, } from "../wechat/wechat-transport.js";
@@ -36,7 +36,7 @@ const DAEMON_TAKEOVER_FORCE_STOP_TIMEOUT_MS = 3_000;
 const DAEMON_TAKEOVER_STOP_POLL_MS = 250;
 const VISIBLE_CLIENT_CONNECT_TIMEOUT_MS = 15_000;
 const VISIBLE_CLIENT_CONNECT_POLL_MS = 250;
-const DAEMON_ADAPTERS = ["codex", "claude", "opencode"];
+const DAEMON_ADAPTERS = ["codex", "claude", "opencode", "pi"];
 function log(message) {
     process.stderr.write(`[wechat-daemon] ${message}\n`);
 }
@@ -45,7 +45,7 @@ function logError(message) {
 }
 function appendDaemonLog(message) {
     ensureChannelDataDir();
-    fs.appendFileSync(BRIDGE_LOG_FILE, `[${new Date().toISOString()}] daemon: ${message}\n`, "utf8");
+    appendBoundedLog(BRIDGE_LOG_FILE, `[${new Date().toISOString()}] daemon: ${message}\n`);
 }
 function computePollRetryDelayMs(consecutiveFailures) {
     const normalizedFailures = Math.max(1, consecutiveFailures);
@@ -56,7 +56,7 @@ function computeWechatSendRetryDelayMs(attempt) {
     return WECHAT_SEND_RETRY_BASE_MS * attempt;
 }
 function isDaemonAdapterKind(value) {
-    return value === "codex" || value === "claude" || value === "opencode";
+    return value === "codex" || value === "claude" || value === "opencode" || value === "pi";
 }
 function isSameWorkspaceCwd(left, right) {
     const normalizedLeft = path.resolve(left);
@@ -84,10 +84,10 @@ export function parseDaemonCliArgs(argv) {
         const next = argv[i + 1];
         if (arg === "--help" || arg === "-h") {
             process.stdout.write([
-                "Usage: wechat-daemon [--cwd <path>] [--adapter <codex|claude|opencode>] [--profile <name-or-path>] [--no-open]",
+                "Usage: wechat-daemon [--cwd <path>] [--adapter <codex|claude|opencode|pi>] [--profile <name-or-path>] [--no-open]",
                 "",
-                "Keeps one WeChat connection alive and switches between Codex, Claude Code, and OpenCode from WeChat.",
-                "Send /codex, /claude, or /opencode in WeChat to switch the active terminal.",
+                "Keeps one WeChat connection alive and switches between Codex, Claude Code, OpenCode, and Pi from WeChat.",
+                "Send /codex, /claude, /opencode, or /pi in WeChat to switch the active terminal.",
                 "",
             ].join("\n"));
             process.exit(0);
@@ -133,12 +133,26 @@ export function parseDaemonSwitchCommand(text) {
             return "claude";
         case "/opencode":
             return "opencode";
+        case "/pi":
+            return "pi";
         default:
             return null;
     }
 }
+export function parseDaemonSwitchDirective(text) {
+    const match = text
+        .trim()
+        .match(/^\/(codex|claude|opencode|pi)(?:\s+([\s\S]+))?$/i);
+    if (!match) {
+        return null;
+    }
+    return {
+        adapter: match[1].toLowerCase(),
+        remainder: match[2]?.trim() ?? "",
+    };
+}
 export function defaultDaemonSessionStartMode(adapter) {
-    return adapter === "claude" || adapter === "opencode" ? "new" : "restore";
+    return adapter === "codex" ? "restore" : "new";
 }
 export function resolveDaemonSessionStartMode(params) {
     if (params.reuseExistingVisible && params.visibleConnected) {
@@ -340,6 +354,12 @@ function isVisibleClientAlive(cwd, adapter) {
     clearLocalCompanionOccupancy(cwd, endpoint.instanceId, { adapter });
     return false;
 }
+export function shouldRestartDeadCodexVisibleRuntime(params) {
+    return (params.adapter === "codex" &&
+        !params.slotCreated &&
+        params.hadVisibleClient &&
+        !params.visibleConnected);
+}
 function cleanupVisibleClientLauncher(launch) {
     if (!launch.pid || !isPidAlive(launch.pid)) {
         return false;
@@ -370,6 +390,24 @@ export async function waitForVisibleClientConnection(params, deps = {}) {
         await sleepFn(Math.min(pollMs, remainingMs));
     }
 }
+export async function waitForCodexVisibleThread(params, deps = {}) {
+    const timeoutMs = params.timeoutMs ?? VISIBLE_CLIENT_CONNECT_TIMEOUT_MS;
+    const pollMs = params.pollMs ?? VISIBLE_CLIENT_CONNECT_POLL_MS;
+    const sleepFn = deps.sleep ?? sleep;
+    const now = deps.now ?? (() => Date.now());
+    const deadline = now() + timeoutMs;
+    while (true) {
+        const threadId = params.getThreadId();
+        if (threadId) {
+            return threadId;
+        }
+        const remainingMs = deadline - now();
+        if (remainingMs <= 0) {
+            return null;
+        }
+        await sleepFn(Math.min(pollMs, remainingMs));
+    }
+}
 function formatInboundMessagePreview(message) {
     if (message.text.trim()) {
         return message.text;
@@ -384,7 +422,7 @@ function formatInboundMessagePreview(message) {
 function formatNoActiveAdapterMessage() {
     return [
         "No active terminal is selected.",
-        "Send /codex, /claude, or /opencode to choose one.",
+        "Send /codex, /claude, /opencode, or /pi to choose one.",
     ].join("\n");
 }
 export function formatDaemonSwitchResultDetail(result) {
@@ -392,6 +430,9 @@ export function formatDaemonSwitchResultDetail(result) {
         const previous = result.previousActiveAdapter
             ? ` Active terminal remains ${result.previousActiveAdapter}.`
             : " No terminal is active yet.";
+        if (result.visibleConnected && result.visibleReady === false) {
+            return `The visible Codex CLI connected, but its active thread is not ready yet.${previous} Check ${BRIDGE_LOG_FILE}.`;
+        }
         if (result.openedVisible) {
             return result.created
                 ? `Started the bridge slot and tried to open the visible CLI, but it has not connected yet.${previous} Check ${BRIDGE_LOG_FILE}.`
@@ -444,6 +485,7 @@ class WechatDaemon {
     slots = new Map();
     startedAt = new Date().toISOString();
     bridgeStartedAtMs = Date.now();
+    backlogNoticeSent = false;
     activeAdapter = null;
     takenOverAdapter;
     textSendChain = Promise.resolve();
@@ -542,7 +584,7 @@ class WechatDaemon {
         let consecutivePollFailures = 0;
         log("WeChat daemon is ready.");
         log(`Working directory: ${this.cwd}`);
-        log("Switch from WeChat with /codex, /claude, or /opencode.");
+        log("Switch from WeChat with /codex, /claude, /opencode, or /pi.");
         appendDaemonLog(`started: cwd=${this.cwd}`);
         const activeSlot = this.getActiveSlot();
         const welcomeText = t("daemon.welcome", {
@@ -582,6 +624,13 @@ class WechatDaemon {
             }
             if (pollResult.ignoredBacklogCount > 0) {
                 appendDaemonLog(`ignored_startup_backlog: count=${pollResult.ignoredBacklogCount}`);
+                if (!this.backlogNoticeSent) {
+                    this.backlogNoticeSent = true;
+                    await this.queueWechatMessage(this.authorizedUserId, t("bridge.backlogIgnored", {
+                        count: pollResult.ignoredBacklogCount,
+                        graceSeconds: Math.round(MESSAGE_START_GRACE_MS / 1000),
+                    }), "notice");
+                }
             }
             for (const message of pollResult.messages) {
                 try {
@@ -689,7 +738,24 @@ class WechatDaemon {
             created = true;
         }
         let openedVisible = false;
+        const visibleEndpointBeforeProbe = readLocalCompanionEndpoint(this.cwd, {
+            adapter,
+        });
+        const hadVisibleClient = Boolean(visibleEndpointBeforeProbe?.companionPid ||
+            visibleEndpointBeforeProbe?.companionConnectedAt ||
+            visibleEndpointBeforeProbe?.sharedThreadId ||
+            visibleEndpointBeforeProbe?.sharedSessionId);
         let visibleConnected = isVisibleClientAlive(this.cwd, adapter);
+        if (shouldRestartDeadCodexVisibleRuntime({
+            adapter,
+            slotCreated: created,
+            hadVisibleClient,
+            visibleConnected,
+        })) {
+            await this.startFreshSlotSession(slot);
+            appendDaemonLog(`dead_visible_codex_runtime_restarted: cwd=${this.cwd}`);
+        }
+        const sharedSessionBeforeVisible = getSharedSessionIdFromAdapterState(slot.runtime.getState());
         const sessionStartMode = resolveDaemonSessionStartMode({
             adapter,
             explicitSessionStartMode: options.sessionStartMode,
@@ -701,7 +767,7 @@ class WechatDaemon {
         if (!created &&
             options.reuseExistingVisible === false &&
             sessionStartMode === "new" &&
-            (adapter === "claude" || adapter === "opencode") &&
+            (adapter === "claude" || adapter === "opencode" || adapter === "pi") &&
             visibleConnected) {
             await this.startFreshSlotSession(slot);
             appendDaemonLog(`fresh_session_started: adapter=${adapter} source=start_command`);
@@ -732,16 +798,36 @@ class WechatDaemon {
                 appendDaemonLog(`visible_client_connect_timeout: adapter=${adapter} cwd=${this.cwd} timeout_ms=${VISIBLE_CLIENT_CONNECT_TIMEOUT_MS} cleaned_launcher=${cleanedLauncher}`);
             }
         }
-        const activated = options.openVisible === false || visibleConnected;
+        let visibleReady = visibleConnected;
+        if (adapter === "codex" && visibleConnected && !sharedSessionBeforeVisible) {
+            const visibleThreadId = await waitForCodexVisibleThread({
+                getThreadId: () => {
+                    const state = slot.runtime.getState();
+                    if (state.lastThreadSwitchSource !== "local") {
+                        return undefined;
+                    }
+                    return state.sharedThreadId ?? state.sharedSessionId;
+                },
+            });
+            visibleReady = Boolean(visibleThreadId);
+            if (visibleThreadId) {
+                appendDaemonLog(`visible_codex_thread_ready: thread=${visibleThreadId} cwd=${this.cwd}`);
+            }
+            else {
+                appendDaemonLog(`visible_codex_thread_timeout: cwd=${this.cwd} timeout_ms=${VISIBLE_CLIENT_CONNECT_TIMEOUT_MS}`);
+            }
+        }
+        const activated = options.openVisible === false || (visibleConnected && visibleReady);
         if (activated) {
             this.activeAdapter = adapter;
         }
-        appendDaemonLog(`switch_adapter: adapter=${adapter} created=${created} opened_visible=${openedVisible} visible_connected=${visibleConnected} activated=${activated} previous_active=${previousActiveAdapter ?? "(none)"} session_start_mode=${sessionStartMode}`);
+        appendDaemonLog(`switch_adapter: adapter=${adapter} created=${created} opened_visible=${openedVisible} visible_connected=${visibleConnected} visible_ready=${visibleReady} activated=${activated} previous_active=${previousActiveAdapter ?? "(none)"} session_start_mode=${sessionStartMode}`);
         return {
             activeAdapter: adapter,
             created,
             openedVisible,
             visibleConnected,
+            visibleReady,
             activated,
             previousActiveAdapter,
         };
@@ -784,12 +870,12 @@ class WechatDaemon {
         slot.pendingConfirmations = [];
         slot.pendingUserInput = null;
         slot.activeTask = null;
-        if (slot.adapter === "claude") {
+        if (slot.adapter === "codex" || slot.adapter === "claude") {
             await slot.runtime.reset();
         }
-        else if (slot.adapter === "opencode") {
+        else if (slot.adapter === "opencode" || slot.adapter === "pi") {
             if (!slot.runtime.createSession) {
-                throw new Error("/new is not available in opencode mode.");
+                throw new Error(`/new is not available in ${slot.adapter} mode.`);
             }
             await slot.runtime.createSession();
         }
@@ -967,18 +1053,24 @@ class WechatDaemon {
                 message = { ...message, text: rewritten };
             }
         }
-        const switchAdapter = parseDaemonSwitchCommand(message.text);
-        if (switchAdapter) {
-            const result = await this.ensureSlot(switchAdapter, {
+        const switchDirective = parseDaemonSwitchDirective(message.text);
+        if (switchDirective) {
+            const result = await this.ensureSlot(switchDirective.adapter, {
                 openVisible: true,
                 reuseExistingVisible: true,
             });
             const detail = formatDaemonSwitchResultDetail(result);
-            const heading = result.activated
-                ? `Active terminal: ${switchAdapter}.`
-                : `Could not activate terminal: ${switchAdapter}.`;
-            await this.queueWechatMessage(message.senderId, `${heading}\n${detail}`);
-            return;
+            if (!result.activated) {
+                await this.queueWechatMessage(message.senderId, `Could not activate terminal: ${switchDirective.adapter}.\n${detail}`);
+                return;
+            }
+            if (switchDirective.remainder) {
+                message = { ...message, text: switchDirective.remainder };
+            }
+            else {
+                await this.queueWechatMessage(message.senderId, `Active terminal: ${switchDirective.adapter}.\n${detail}`);
+                return;
+            }
         }
         if (message.text.trim().toLowerCase() === "/daemon-stop") {
             await this.queueWechatMessage(message.senderId, "Stopping wechat-daemon...");
@@ -996,7 +1088,7 @@ class WechatDaemon {
             await this.queueWechatMessage(message.senderId, formatBindCommandUsage());
             return;
         }
-        const slot = this.getActiveSlot();
+        let slot = this.getActiveSlot();
         if (!slot) {
             await this.queueWechatMessage(message.senderId, formatNoActiveAdapterMessage());
             return;
@@ -1018,6 +1110,15 @@ class WechatDaemon {
             await this.queueWechatMessage(message.senderId, prefixDaemonAdapterMessage(slot.adapter, formatPendingUserInputReminder(slot.pendingUserInput)));
             return;
         }
+        const visibleResult = await this.ensureSlot(slot.adapter, {
+            openVisible: true,
+            reuseExistingVisible: true,
+        });
+        if (!visibleResult.activated) {
+            await this.queueWechatMessage(message.senderId, prefixDaemonAdapterMessage(slot.adapter, formatDaemonSwitchResultDetail(visibleResult)));
+            return;
+        }
+        slot = this.getActiveSlot() ?? slot;
         const adapterState = slot.runtime.getState();
         if (adapterState.status === "busy" || adapterState.status === "awaiting_approval") {
             await this.queueWechatMessage(message.senderId, prefixDaemonAdapterMessage(slot.adapter, `${slot.adapter} is still working. Wait for the current reply or use /stop.`));

package/dist/i18n/messages-en.js

@@ -9,9 +9,10 @@ export const messages = {
     "bridge.status.busy": "{adapter} is still working on the previous request. Wait for it to finish or send /interrupt.",
     "bridge.newSession.done": "New session started.",
     "bridge.fatalError": "Bridge error: {message}",
+    "bridge.backlogIgnored": "Ignored {count} backlog message(s) sent before the bridge started (they will not be processed).\nIf you actually sent them after the bridge started, your system clock is likely skewed by more than {graceSeconds}s — sync the clock and restart the bridge.",
     // === Daemon welcome & control ===
-    "daemon.welcome": "WeChat Daemon ready.\nCWD: {cwd}\nActive: {adapter}\n\nCommands: /claude, /codex, /opencode, /stop, /confirm, /deny, /status\n{bindings}\n\nManage: /bind [emoji] cmd, /unbind [emoji], /bindings",
-    "daemon.noActiveAdapter": "No active terminal is selected. Send /codex, /claude, or /opencode to start one.",
+    "daemon.welcome": "WeChat Daemon ready.\nCWD: {cwd}\nActive: {adapter}\n\nCommands: /claude, /codex, /opencode, /pi, /stop, /confirm, /deny, /status\n{bindings}\n\nManage: /bind [emoji] cmd, /unbind [emoji], /bindings",
+    "daemon.noActiveAdapter": "No active terminal is selected. Send /codex, /claude, /opencode, or /pi to start one.",
     "daemon.switchResult.new": "Started a new visible CLI.",
     "daemon.switchResult.reused": "Reused the existing visible CLI.",
     // === Approval ===
@@ -55,6 +56,15 @@ export const messages = {
     "doctor.label.node": "Node.js",
     "doctor.label.platform": "Platform",
     "doctor.label.winBuild": "Windows build",
+    "doctor.label.codePage": "Console code page",
+    "doctor.codePage.nonAsciiWarning": "{codePage} (not UTF-8 and the data directory path contains non-ASCII characters; hook scripts from older versions break in this environment — upgrade to the latest release)",
+    "doctor.label.connectivity": "WeChat connectivity",
+    "doctor.connectivity.ok": "reachable ({baseUrl})",
+    "doctor.connectivity.unreachable": "cannot reach {baseUrl} (check network and firewall)",
+    "doctor.connectivity.proxyHint": "cannot reach {baseUrl}. Proxy {proxy} detected, but Node fetch ignores proxy environment variables by default; if your network requires the proxy, set NODE_USE_ENV_PROXY=1 and retry.",
+    "doctor.label.clock": "System clock",
+    "doctor.clock.ok": "~{skewSeconds}s skew vs server time",
+    "doctor.clock.skewWarning": "~{skewSeconds}s skew vs server time (large skew makes the bridge treat fresh messages as pre-start backlog — sync the system clock)",
     "doctor.label.nodePty": "node-pty",
     "doctor.label.shell": "shell",
     "doctor.label.dataDir": "Data dir",

package/dist/i18n/messages-zh.js

@@ -9,9 +9,10 @@ export const messages = {
     "bridge.status.busy": "{adapter} 仍在处理上一个请求。请等待完成或发送 /interrupt。",
     "bridge.newSession.done": "已开始新会话。",
     "bridge.fatalError": "桥接错误: {message}",
+    "bridge.backlogIgnored": "已忽略 {count} 条桥接启动前的积压消息（不会自动处理）。\n如果你是在桥接启动后才发送的消息却看到此提示，说明本机系统时钟可能不准（偏差超过 {graceSeconds} 秒），请校准时间后重启桥接。",
     // === Daemon 欢迎 & 控制 ===
-    "daemon.welcome": "微信 Daemon 就绪。\n工作目录: {cwd}\n当前: {adapter}\n\n命令: /claude, /codex, /opencode, /stop, /confirm, /deny, /status\n{bindings}\n\n管理: /bind [表情] 命令, /unbind [表情], /bindings",
-    "daemon.noActiveAdapter": "未选择活跃终端。发送 /codex、/claude 或 /opencode 启动一个。",
+    "daemon.welcome": "微信 Daemon 就绪。\n工作目录: {cwd}\n当前: {adapter}\n\n命令: /claude, /codex, /opencode, /pi, /stop, /confirm, /deny, /status\n{bindings}\n\n管理: /bind [表情] 命令, /unbind [表情], /bindings",
+    "daemon.noActiveAdapter": "未选择活跃终端。发送 /codex、/claude、/opencode 或 /pi 启动一个。",
     "daemon.switchResult.new": "已启动新的可见 CLI。",
     "daemon.switchResult.reused": "已复用现有的可见 CLI。",
     // === 审批 ===
@@ -55,6 +56,15 @@ export const messages = {
     "doctor.label.node": "Node.js",
     "doctor.label.platform": "平台",
     "doctor.label.winBuild": "Windows build",
+    "doctor.label.codePage": "控制台代码页",
+    "doctor.codePage.nonAsciiWarning": "{codePage}（非 UTF-8，且数据目录路径含非 ASCII 字符；旧版本的 hook 脚本在此环境下会乱码失效，请升级到最新版本）",
+    "doctor.label.connectivity": "微信服务可达性",
+    "doctor.connectivity.ok": "可达 ({baseUrl})",
+    "doctor.connectivity.unreachable": "无法访问 {baseUrl}（检查网络与防火墙）",
+    "doctor.connectivity.proxyHint": "无法访问 {baseUrl}。检测到代理 {proxy}，但 Node fetch 默认不使用代理环境变量；若必须经代理出网，请设置 NODE_USE_ENV_PROXY=1 后重试。",
+    "doctor.label.clock": "系统时钟",
+    "doctor.clock.ok": "与服务器时间偏差约 {skewSeconds}s",
+    "doctor.clock.skewWarning": "与服务器时间偏差约 {skewSeconds}s（偏差过大会导致桥接启动后的消息被当作积压忽略，请校准系统时间）",
     "doctor.label.nodePty": "node-pty",
     "doctor.label.shell": "shell",
     "doctor.label.dataDir": "数据目录",

package/dist/utils/doctor.js

@@ -7,12 +7,14 @@ import { normalizeBridgeLockPayload, shouldAutoReclaimBridgeLock, } from "../bri
 import { readLocalCompanionEndpoint as readWorkspaceEndpoint, } from "../companion/local-companion-link.js";
 import { isDaemonEndpointAlive, } from "../daemon/daemon-link.js";
 import { t } from "../i18n/index.js";
-import { resolveChannelDataDir } from "../wechat/channel-config.js";
+import { DEFAULT_BASE_URL, resolveChannelDataDir } from "../wechat/channel-config.js";
 const STATE_OK = "[ok]";
 const STATE_WARN = "[warn]";
 const STATE_FAIL = "[fail]";
 const RUNTIME_ENDPOINT_TIMEOUT_MS = 500;
 const DAEMON_ENDPOINT_TIMEOUT_MS = 500;
+const SERVER_DATE_TIMEOUT_MS = 3_000;
+const CLOCK_SKEW_WARN_MS = 30_000;
 function msg(key, params) {
     return t(`doctor.${key}`, params);
 }
@@ -58,6 +60,53 @@ function getPlatformPtyFix(platform) {
             return "npm rebuild node-pty";
     }
 }
+function defaultGetWindowsCodePage() {
+    try {
+        const output = execFileSync("cmd.exe", ["/d", "/c", "chcp"], {
+            stdio: ["ignore", "pipe", "ignore"],
+            encoding: "utf8",
+            windowsHide: true,
+        });
+        const match = /(\d+)\s*\.?\s*$/.exec(output.trim());
+        return match ? Number(match[1]) : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function defaultFetchServerDate() {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), SERVER_DATE_TIMEOUT_MS);
+    try {
+        const res = await fetch(DEFAULT_BASE_URL, {
+            method: "GET",
+            signal: controller.signal,
+        });
+        const dateHeader = res.headers.get("date");
+        if (!dateHeader) {
+            return null;
+        }
+        const parsed = new Date(dateHeader);
+        return Number.isFinite(parsed.getTime()) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function containsNonAscii(value) {
+    return Array.from(value).some((character) => character.charCodeAt(0) > 0x7f);
+}
+function pickProxyEnvValue(env) {
+    return (env.HTTPS_PROXY ??
+        env.https_proxy ??
+        env.HTTP_PROXY ??
+        env.http_proxy ??
+        env.ALL_PROXY ??
+        env.all_proxy)?.trim() || undefined;
+}
 function defaultIsProcessAlive(pid) {
     if (!Number.isInteger(pid) || pid <= 0) {
         return false;
@@ -100,6 +149,10 @@ function resolveDeps(deps = {}) {
         arch: deps.arch ?? process.arch,
         nodeVersion: deps.nodeVersion ?? process.version,
         osRelease: deps.osRelease ?? os.release,
+        env: deps.env ?? process.env,
+        now: deps.now ?? Date.now,
+        getWindowsCodePage: deps.getWindowsCodePage ?? defaultGetWindowsCodePage,
+        fetchServerDate: deps.fetchServerDate ?? defaultFetchServerDate,
         findExecutable: deps.findExecutable ?? findExecutable,
         loadNodePty: deps.loadNodePty ??
             (async () => {
@@ -121,6 +174,7 @@ function isBridgeAdapterKind(value) {
     return (value === "codex" ||
         value === "claude" ||
         value === "opencode" ||
+        value === "pi" ||
         value === "shell");
 }
 export function parseDoctorCliArgs(argv, mode = "generic", fallbackCwd = process.cwd()) {
@@ -349,7 +403,7 @@ function chooseEndpointAdapters(options, lock) {
         return [lock.adapter];
     }
     return options.mode === "daemon"
-        ? ["codex", "claude", "opencode"]
+        ? ["codex", "claude", "opencode", "pi"]
         : ["codex"];
 }
 function chooseCliChecks(options) {
@@ -361,6 +415,8 @@ function chooseCliChecks(options) {
                 return [{ name: "claude", label: "Claude CLI", optional: false }];
             case "opencode":
                 return [{ name: "opencode", label: "OpenCode", optional: false }];
+            case "pi":
+                return [{ name: "pi", label: "Pi", optional: false }];
             case "shell":
                 return [];
             default:
@@ -371,6 +427,7 @@ function chooseCliChecks(options) {
         { name: "codex", label: "Codex CLI", optional: true },
         { name: "claude", label: "Claude CLI", optional: true },
         { name: "opencode", label: "OpenCode", optional: true },
+        { name: "pi", label: "Pi", optional: true },
     ];
 }
 function appendCliLines(lines, options, deps) {
@@ -503,6 +560,32 @@ export async function buildDoctorReport(options = {}, rawDeps = {}) {
         const build = parseInt(release.split(".").pop() ?? "0", 10);
         const ok = build >= 18309;
         lines.push(row(ok ? STATE_OK : STATE_FAIL, msg("label.winBuild"), ok ? String(build) : `${build} ${msg("winBuildConpty")}`));
+        const codePage = deps.getWindowsCodePage();
+        if (codePage !== null) {
+            const dataDirHasNonAscii = containsNonAscii(deps.resolveDataDir());
+            const risky = codePage !== 65001 && dataDirHasNonAscii;
+            lines.push(row(risky ? STATE_WARN : STATE_OK, msg("label.codePage"), risky
+                ? msg("codePage.nonAsciiWarning", { codePage })
+                : String(codePage)));
+        }
+    }
+    const proxyUrl = pickProxyEnvValue(deps.env);
+    const serverDate = await deps.fetchServerDate();
+    if (serverDate) {
+        lines.push(row(STATE_OK, msg("label.connectivity"), msg("connectivity.ok", {
+            baseUrl: DEFAULT_BASE_URL,
+        })));
+        const skewMs = deps.now() - serverDate.getTime();
+        const skewSeconds = Math.round(Math.abs(skewMs) / 1000);
+        const clockOk = Math.abs(skewMs) <= CLOCK_SKEW_WARN_MS;
+        lines.push(row(clockOk ? STATE_OK : STATE_WARN, msg("label.clock"), clockOk
+            ? msg("clock.ok", { skewSeconds })
+            : msg("clock.skewWarning", { skewSeconds })));
+    }
+    else {
+        lines.push(row(STATE_WARN, msg("label.connectivity"), proxyUrl && deps.env.NODE_USE_ENV_PROXY !== "1"
+            ? msg("connectivity.proxyHint", { baseUrl: DEFAULT_BASE_URL, proxy: proxyUrl })
+            : msg("connectivity.unreachable", { baseUrl: DEFAULT_BASE_URL })));
     }
     try {
         await deps.loadNodePty();

package/dist/utils/version-checker.js

@@ -1,48 +1,70 @@
 import fs from "node:fs";
 import path from "node:path";
-import { execSync } from "node:child_process";
 import { CHANNEL_DATA_DIR, ensureChannelDataDir } from "../wechat/channel-config.js";
 const UPDATE_CHECK_FILE = path.join(CHANNEL_DATA_DIR, "update-check.json");
 const CACHE_DURATION_MS = 24 * 60 * 60 * 1000; // 24小时
-/**
- * 使用 git 命令获取远程仓库最新版本号
- */
-export async function fetchLatestVersion() {
+// npm registry 是权威更新源——它是用户实际安装的渠道;GitHub tags 作为回退,
+// 以便在 registry 暂时不可达或包尚未发布时仍能给出最新版本。
+const NPM_PACKAGE_NAME = "cli-wechat-bridge";
+const DEFAULT_NPM_REGISTRY_URL = `https://registry.npmjs.org/${NPM_PACKAGE_NAME}/latest`;
+const DEFAULT_GITHUB_TAGS_URL = "https://api.github.com/repos/UNLINEARITY/CLI-WeChat-Bridge/tags?per_page=20";
+const FETCH_TIMEOUT_MS = 10_000;
+function resolveFetchDeps(options) {
+    return {
+        fetch: options.fetchImpl ?? globalThis.fetch,
+        npmRegistryUrl: options.npmRegistryUrl ?? DEFAULT_NPM_REGISTRY_URL,
+        githubTagsUrl: options.githubTagsUrl ?? DEFAULT_GITHUB_TAGS_URL,
+        timeoutMs: options.timeoutMs ?? FETCH_TIMEOUT_MS,
+    };
+}
+async function fetchJsonWithTimeout(url, deps) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), deps.timeoutMs);
     try {
-        // 尝试使用 git ls-remote 获取所有 tags
-        const tagsOutput = execSync('git ls-remote --tags origin', {
-            cwd: path.resolve(import.meta.dirname, "..", ".."),
-            encoding: 'utf-8',
-            stdio: ['ignore', 'pipe', 'ignore']
+        const res = await deps.fetch(url, {
+            method: "GET",
+            signal: controller.signal,
+            headers: { Accept: "application/json" },
         });
-        if (!tagsOutput) {
-            return null;
-        }
-        // 解析 tags，找到版本号格式（如 0.1.0, 0.2.0 等）
-        const versionTags = tagsOutput
-            .split('\n')
-            .filter(line => {
-            // 匹配 refs/tags/0.5.0 格式（不是 v0.5.0）
-            return line.includes('refs/tags/') &&
-                !line.includes('^{}') &&
-                /^\w+\s+refs\/tags\/\d+\.\d+\.\d+$/.test(line);
-        })
-            .map(line => {
-            const match = line.match(/refs\/tags\/(\d+\.\d+\.\d+)$/);
-            return match ? match[1] : null;
-        })
-            .filter((v) => v !== null);
-        if (versionTags.length === 0) {
+        if (!res.ok) {
             return null;
         }
-        // 按版本号排序，返回最新的
-        versionTags.sort((a, b) => compareVersions(b, a));
-        return versionTags[0] ?? null;
+        return await res.json();
     }
-    catch (error) {
-        // 如果 git 命令失败，静默返回 null
+    catch {
+        // 网络/超时/解析失败一律视为该源不可用,交由调用方回退。
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function fetchVersionFromNpm(deps) {
+    const data = await fetchJsonWithTimeout(deps.npmRegistryUrl, deps);
+    if (!data || typeof data !== "object") {
         return null;
     }
+    const version = data.version;
+    return typeof version === "string" ? parseVersion(version) : null;
+}
+async function fetchVersionFromGithub(deps) {
+    const data = await fetchJsonWithTimeout(deps.githubTagsUrl, deps);
+    if (!Array.isArray(data)) {
+        return null;
+    }
+    const versions = data
+        .map((tag) => parseVersion(tag.name))
+        .filter((v) => v !== null)
+        .sort((a, b) => compareVersions(b, a));
+    return versions[0] ?? null;
+}
+/**
+ * 从 npm registry 获取最新版本号(回退到 GitHub tags)。
+ * 通过 HTTPS 请求而非本地 git 命令,因此对全局安装的命令(wechat-check-update)同样可用。
+ */
+export async function fetchLatestVersion(options = {}) {
+    const deps = resolveFetchDeps(options);
+    return (await fetchVersionFromNpm(deps)) ?? (await fetchVersionFromGithub(deps));
 }
 /**
  * 从本地 package.json 读取当前版本
@@ -85,6 +107,17 @@ function writeUpdateCache(cache) {
         // 静默失败，不影响正常使用
     }
 }
+const VERSION_PATTERN = /(\d+\.\d+\.\d+)/;
+/**
+ * 从任意字符串中提取版本号,兼容带 "v" 前缀的 tag(如 "v1.1.1")。
+ */
+export function parseVersion(raw) {
+    if (typeof raw !== "string") {
+        return null;
+    }
+    const match = VERSION_PATTERN.exec(raw.trim());
+    return match ? (match[1] ?? null) : null;
+}
 /**
  * 比较两个版本号
  * @returns 返回值 > 0 表示 version1 更新，< 0 表示 version2 更新，= 0 表示相等
@@ -146,16 +179,16 @@ export async function checkForUpdate(forceCheck = false) {
  */
 export function formatUpdateMessage(versionInfo) {
     const { current, latest } = versionInfo;
-    return `
-[Update Available] Version ${latest} is available (current: ${current})
-
-Update instructions:
-   cd CLI-WeChat-Bridge
-   git pull
-   bun install
-   npm install -g .
-
-For more information:
-   https://github.com/UNLINEARITY/CLI-WeChat-Bridge/releases
+    return `
+[Update Available] Version ${latest} is available (current: ${current})
+
+Update instructions:
+   cd CLI-WeChat-Bridge
+   git pull
+   bun install
+   npm install -g .
+
+For more information:
+   https://github.com/UNLINEARITY/CLI-WeChat-Bridge/releases
 `;
 }