@unlinearity/cli-wechat-bridge 1.1.5 → 1.2.0

package/dist/i18n/index.js

@@ -1,3 +1,9 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { messages as zhMessages } from "./messages-zh.js";
 import { messages as enMessages } from "./messages-en.js";
 const catalogs = {

package/dist/i18n/messages-en.js

@@ -1,3 +1,9 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 export const messages = {
     // === Bridge welcome & control ===
     "bridge.welcome": "WeChat Bridge ready ({adapter}).\nCWD: {cwd}",
@@ -11,7 +17,7 @@ export const messages = {
     "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, /pi, /stop, /confirm, /deny, /status\n{bindings}\n\nManage: /bind [emoji] cmd, /unbind [emoji], /bindings",
+    "daemon.welcome": "WeChat Daemon ready.\nCWD: {cwd}\nActive: {adapter}\n\nCommands: /claude, /codex, /opencode, /pi, /stop, /confirm, /deny, /status, /model, /plan, /all <prompt>\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.",
@@ -25,7 +31,7 @@ export const messages = {
     // === Hook health check ===
     "hook.healthCheck.warning": "[Warning] No hook events received from Claude after 15s.\nThe hook system may not be working — Claude output will not reach WeChat.",
     "hook.healthCheck.logHint": "\nCheck: {logPath}",
-    "hook.healthCheck.fixes": "\nCommon fixes:\n- Ensure Node.js >= 22.6.0: node --version\n- Reinstall: npm install -g cli-wechat-bridge@latest\n- Check firewall: allow localhost TCP connections",
+    "hook.healthCheck.fixes": "\nCommon fixes:\n- Ensure Node.js >= 22.13.0: node --version\n- Reinstall: npm install -g cli-wechat-bridge@latest\n- Check firewall: allow localhost TCP connections",
     // === PTY fallback ===
     "pty.fallback.warning": "[Warning] PTY unavailable — using fallback mode (TERM=dumb).\nCore features (messaging, approvals, session management) work normally; terminal rendering (colors, progress bars) may be degraded.\nFix: Linux install build-essential python3 | Windows run npm rebuild node-pty | macOS run xcode-select --install\nRun --doctor for detailed environment info.\n",
     // === Spawn diagnostic ===
@@ -36,7 +42,7 @@ export const messages = {
     "spawn.diagnostic.linuxBuildTools": "- Linux requires build tools for node-pty: sudo apt install build-essential python3\n- Then reinstall: npm install -g cli-wechat-bridge@latest",
     "spawn.diagnostic.notFound": "- The command \"{target}\" was not found on PATH.\n- Verify it is installed and accessible from your terminal.",
     "spawn.diagnostic.generic": "- Reinstall: npm install -g cli-wechat-bridge@latest",
-    "spawn.diagnostic.nodeVersion": "- Ensure Node.js >= 22.6.0: node --version",
+    "spawn.diagnostic.nodeVersion": "- Ensure Node.js >= 22.13.0: node --version",
     "spawn.diagnostic.winFull": "- Ensure Windows 10 build 18309+ (run 'winver' to check)\n- Install Visual C++ Redistributable: https://aka.ms/vs/17/release/vc_redist.x64.exe\n- Run: npm rebuild node-pty\n- Try running as Administrator",
     // === Emoji bindings ===
     "binding.usage": "Invalid format.\nUsage: /bind [emoji] command\nExample: /bind 🚀 deploy --prod",
@@ -59,6 +65,7 @@ export const messages = {
     "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.label.wecomConnectivity": "WeCom 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.",
@@ -82,6 +89,7 @@ export const messages = {
     "doctor.dataDirMissing": "(will be created on first run)",
     "doctor.credentialsFound": "found",
     "doctor.credentialsMissing": "not found (run wechat-setup first)",
+    "doctor.credentialsMissingWecom": "not found (run wecom-setup first)",
     "doctor.mode.bridge": "standalone bridge",
     "doctor.mode.generic": "generic",
     "doctor.notSpecified": "(not specified)",

package/dist/i18n/messages-zh.js

@@ -1,3 +1,9 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 export const messages = {
     // === 桥接欢迎 & 控制 ===
     "bridge.welcome": "微信桥接就绪 ({adapter})。\n工作目录: {cwd}",
@@ -11,7 +17,7 @@ export const messages = {
     "bridge.fatalError": "桥接错误: {message}",
     "bridge.backlogIgnored": "已忽略 {count} 条桥接启动前的积压消息（不会自动处理）。\n如果你是在桥接启动后才发送的消息却看到此提示，说明本机系统时钟可能不准（偏差超过 {graceSeconds} 秒），请校准时间后重启桥接。",
     // === Daemon 欢迎 & 控制 ===
-    "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.welcome": "微信 Daemon 就绪。\n工作目录: {cwd}\n当前: {adapter}\n\n命令: /claude, /codex, /opencode, /pi, /stop, /confirm, /deny, /status, /model, /plan, /all <prompt>\n{bindings}\n\n管理: /bind [表情] 命令, /unbind [表情], /bindings",
     "daemon.noActiveAdapter": "未选择活跃终端。发送 /codex、/claude、/opencode 或 /pi 启动一个。",
     "daemon.switchResult.new": "已启动新的可见 CLI。",
     "daemon.switchResult.reused": "已复用现有的可见 CLI。",
@@ -25,7 +31,7 @@ export const messages = {
     // === Hook 健康检查 ===
     "hook.healthCheck.warning": "[警告] 15 秒内未收到 Claude hook 事件。\nhook 系统可能未正常工作 — Claude 的输出将无法到达微信。",
     "hook.healthCheck.logHint": "\n查看日志: {logPath}",
-    "hook.healthCheck.fixes": "\n常见修复方法:\n- 确保 Node.js >= 22.6.0: node --version\n- 重新安装: npm install -g cli-wechat-bridge@latest\n- 检查防火墙: 允许 localhost TCP 连接",
+    "hook.healthCheck.fixes": "\n常见修复方法:\n- 确保 Node.js >= 22.13.0: node --version\n- 重新安装: npm install -g cli-wechat-bridge@latest\n- 检查防火墙: 允许 localhost TCP 连接",
     // === PTY 回退 ===
     "pty.fallback.warning": "[警告] PTY 不可用 — 已切换到回退模式（TERM=dumb）。\n核心功能（消息收发、审批、会话管理）正常工作；终端渲染（颜色、进度条）可能受限。\n修复方法: Linux 安装 build-essential python3 | Windows 运行 npm rebuild node-pty | macOS 运行 xcode-select --install\n运行 --doctor 查看详细环境信息。\n",
     // === 启动诊断 ===
@@ -36,7 +42,7 @@ export const messages = {
     "spawn.diagnostic.linuxBuildTools": "- Linux 需要编译工具来构建 node-pty: sudo apt install build-essential python3\n- 然后重新安装: npm install -g cli-wechat-bridge@latest",
     "spawn.diagnostic.notFound": "- 命令 \"{target}\" 未在 PATH 中找到。\n- 请确认已安装并可从终端访问。",
     "spawn.diagnostic.generic": "- 重新安装: npm install -g cli-wechat-bridge@latest",
-    "spawn.diagnostic.nodeVersion": "- 确保 Node.js >= 22.6.0: node --version",
+    "spawn.diagnostic.nodeVersion": "- 确保 Node.js >= 22.13.0: node --version",
     "spawn.diagnostic.winFull": "- 确保 Windows 10 build 18309+（运行 winver 查看）\n- 安装 Visual C++ Redistributable: https://aka.ms/vs/17/release/vc_redist.x64.exe\n- 运行: npm rebuild node-pty\n- 尝试以管理员身份运行",
     // === Emoji 绑定 ===
     "binding.usage": "格式错误。\n用法: /bind [表情] 命令\n示例: /bind 🚀 deploy --prod",
@@ -59,6 +65,7 @@ export const messages = {
     "doctor.label.codePage": "控制台代码页",
     "doctor.codePage.nonAsciiWarning": "{codePage}（非 UTF-8，且数据目录路径含非 ASCII 字符；旧版本的 hook 脚本在此环境下会乱码失效，请升级到最新版本）",
     "doctor.label.connectivity": "微信服务可达性",
+    "doctor.label.wecomConnectivity": "企业微信服务可达性",
     "doctor.connectivity.ok": "可达 ({baseUrl})",
     "doctor.connectivity.unreachable": "无法访问 {baseUrl}（检查网络与防火墙）",
     "doctor.connectivity.proxyHint": "无法访问 {baseUrl}。检测到代理 {proxy}，但 Node fetch 默认不使用代理环境变量；若必须经代理出网，请设置 NODE_USE_ENV_PROXY=1 后重试。",
@@ -82,6 +89,7 @@ export const messages = {
     "doctor.dataDirMissing": "(首次运行会创建)",
     "doctor.credentialsFound": "已找到",
     "doctor.credentialsMissing": "未找到 (先运行 wechat-setup)",
+    "doctor.credentialsMissingWecom": "未找到 (先运行 wecom-setup)",
     "doctor.mode.bridge": "独立桥接",
     "doctor.mode.generic": "通用",
     "doctor.notSpecified": "(未指定)",

package/dist/runtime/create-runtime-host.js

@@ -1,3 +1,9 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { createBridgeAdapter } from "../bridge/bridge-adapters.js";
 import { CodexPtyAdapter } from "../bridge/bridge-adapters.codex.js";
 import { LegacyAdapterRuntime } from "./legacy-adapter-runtime.js";

package/dist/runtime/legacy-adapter-runtime.js

@@ -25,6 +25,21 @@ export class LegacyAdapterRuntime {
         }
         await this.adapter.createSession();
     }
+    async listModels() {
+        if (!this.adapter.listModels)
+            throw new Error("Model listing is not supported by this companion.");
+        return this.adapter.listModels();
+    }
+    async selectModel(modelId) {
+        if (!this.adapter.selectModel)
+            throw new Error("Model selection is not supported by this companion.");
+        return this.adapter.selectModel(modelId);
+    }
+    async setPlanMode(enabled) {
+        if (!this.adapter.setPlanMode)
+            throw new Error("Plan mode is not supported by this companion.");
+        return this.adapter.setPlanMode(enabled);
+    }
     async interrupt() {
         return await this.adapter.interrupt();
     }

package/dist/runtime/runtime-types.js

@@ -3,3 +3,6 @@ export const CODEX_REMOTE_AUTH_TOKEN_ENV = "WECHAT_BRIDGE_CODEX_REMOTE_AUTH_TOKE
 export function hasLocalClientEndpointProvider(runtime) {
     return typeof runtime.getLocalClientEndpoint === "function";
 }
+export function hasVisibleClientSessionPreparer(runtime) {
+    return typeof runtime.prepareVisibleClientSession === "function";
+}

package/dist/utils/atomic-file.js

@@ -1,3 +1,9 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import fs from "node:fs";
 import { ensureChannelDataDir } from "../wechat/channel-config.js";
 /**

package/dist/utils/doctor.js

@@ -1,3 +1,9 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import { execFileSync } from "node:child_process";
 import fs from "node:fs";
 import net from "node:net";
@@ -74,11 +80,11 @@ function defaultGetWindowsCodePage() {
         return null;
     }
 }
-async function defaultFetchServerDate() {
+async function defaultFetchServerDate(baseUrl = DEFAULT_BASE_URL) {
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), SERVER_DATE_TIMEOUT_MS);
     try {
-        const res = await fetch(DEFAULT_BASE_URL, {
+        const res = await fetch(baseUrl, {
             method: "GET",
             signal: controller.signal,
         });
@@ -179,6 +185,7 @@ function isBridgeAdapterKind(value) {
 export function parseDoctorCliArgs(argv, mode = "generic", fallbackCwd = process.cwd()) {
     let cwd = fallbackCwd;
     let adapter;
+    let channelId = "wechat";
     for (let i = 0; i < argv.length; i += 1) {
         const arg = argv[i];
         const next = argv[i + 1];
@@ -195,11 +202,17 @@ export function parseDoctorCliArgs(argv, mode = "generic", fallbackCwd = process
             i += 1;
             continue;
         }
+        if (arg === "--channel" && (next === "wechat" || next === "wecom")) {
+            channelId = next;
+            i += 1;
+            continue;
+        }
     }
     return {
         mode,
         cwd: path.resolve(cwd),
         adapter,
+        ...(channelId === "wecom" ? { channelId } : {}),
     };
 }
 function statusTag(status) {
@@ -582,10 +595,15 @@ export async function buildDoctorReport(options = {}, rawDeps = {}) {
         }
     }
     const proxyUrl = pickProxyEnvValue(deps.env);
-    const serverDate = await deps.fetchServerDate();
+    const connectivityUrl = doctorOptions.channelId === "wecom"
+        ? "https://open.work.weixin.qq.com"
+        : DEFAULT_BASE_URL;
+    const serverDate = await deps.fetchServerDate(connectivityUrl);
     if (serverDate) {
-        lines.push(row(STATE_OK, msg("label.connectivity"), msg("connectivity.ok", {
-            baseUrl: DEFAULT_BASE_URL,
+        lines.push(row(STATE_OK, msg(doctorOptions.channelId === "wecom"
+            ? "label.wecomConnectivity"
+            : "label.connectivity"), msg("connectivity.ok", {
+            baseUrl: connectivityUrl,
         })));
         const skewMs = deps.now() - serverDate.getTime();
         const skewSeconds = Math.round(Math.abs(skewMs) / 1000);
@@ -595,9 +613,11 @@ export async function buildDoctorReport(options = {}, rawDeps = {}) {
             : 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 })));
+        lines.push(row(STATE_WARN, msg(doctorOptions.channelId === "wecom"
+            ? "label.wecomConnectivity"
+            : "label.connectivity"), proxyUrl && deps.env.NODE_USE_ENV_PROXY !== "1"
+            ? msg("connectivity.proxyHint", { baseUrl: connectivityUrl, proxy: proxyUrl })
+            : msg("connectivity.unreachable", { baseUrl: connectivityUrl })));
     }
     try {
         await deps.loadNodePty();
@@ -612,9 +632,15 @@ export async function buildDoctorReport(options = {}, rawDeps = {}) {
     const dataDir = deps.resolveDataDir();
     const dataDirExists = deps.exists(dataDir);
     lines.push(row(dataDirExists ? STATE_OK : STATE_FAIL, msg("label.dataDir"), dataDirExists ? dataDir : `${dataDir} ${msg("dataDirMissing")}`));
-    const credFile = path.join(dataDir, "account.json");
+    const credFile = doctorOptions.channelId === "wecom"
+        ? path.join(dataDir, "wecom", "account.json")
+        : path.join(dataDir, "account.json");
     const credExists = deps.exists(credFile);
-    lines.push(row(credExists ? STATE_OK : STATE_FAIL, msg("label.credentials"), credExists ? msg("credentialsFound") : msg("credentialsMissing")));
+    lines.push(row(credExists ? STATE_OK : STATE_FAIL, msg("label.credentials"), credExists
+        ? msg("credentialsFound")
+        : msg(doctorOptions.channelId === "wecom"
+            ? "credentialsMissingWecom"
+            : "credentialsMissing")));
     section(lines, msg("section.runtime"));
     lines.push(fieldRow(msg("label.mode"), formatMode(doctorOptions.mode)));
     lines.push(fieldRow(msg("label.cwd"), doctorOptions.cwd));

package/dist/utils/version-checker.js

@@ -1,3 +1,9 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import fs from "node:fs";
 import path from "node:path";
 import { CHANNEL_DATA_DIR, ensureChannelDataDir } from "../wechat/channel-config.js";
@@ -179,16 +185,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
 `;
 }

package/dist/wechat/channel-config.js

@@ -1,3 +1,9 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 import crypto from "node:crypto";
 import fs from "node:fs";
 import os from "node:os";

package/dist/wechat/setup.js

@@ -1,4 +1,10 @@
 #!/usr/bin/env bun
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 /**
  * CLI WeChat Bridge setup.
  *
@@ -11,6 +17,7 @@ import fs from "node:fs";
 import readline from "node:readline";
 import { BOT_TYPE, CONTEXT_CACHE_FILE, CREDENTIALS_FILE, DEFAULT_BASE_URL, ensureChannelDataDir, migrateLegacyChannelFiles, SYNC_BUF_FILE, } from "./channel-config.js";
 import { isWechatSyncSessionTimeout } from "./wechat-transport.js";
+import { isDirectModuleRun } from "../core/direct-run.js";
 const CHANNEL_VERSION = "0.3.0";
 export function loadExistingCredentials() {
     try {
@@ -130,18 +137,74 @@ async function askYesNo(prompt) {
         rl.close();
     }
 }
-async function printQRCode(qrContent, write) {
+// eslint-disable-next-line no-control-regex
+const ANSI_SGR_RE = /\u001b\[[0-9;]*m/g;
+function resolveLoginTerminal() {
+    const columns = process.stdout.columns;
+    return {
+        platform: process.platform,
+        isTTY: process.stdout.isTTY === true,
+        columns: typeof columns === "number" && Number.isFinite(columns) && columns > 0
+            ? columns
+            : undefined,
+    };
+}
+export function getQRCodeVisibleWidth(qr) {
+    return Math.max(0, ...qr
+        .replace(/\r/g, "")
+        .split("\n")
+        .map((line) => Array.from(line.replace(ANSI_SGR_RE, "")).length));
+}
+export function selectQRCodePresentation(params) {
+    if (!params.isTTY ||
+        typeof params.columns !== "number" ||
+        !Number.isFinite(params.columns) ||
+        params.columns <= 0 ||
+        params.renderedWidth + 1 > params.columns) {
+        return "url_only";
+    }
+    return "qr_with_url";
+}
+export function formatQRCodeLoginInstruction(presentation) {
+    return presentation === "qr_with_url"
+        ? "Scan the QR code above with WeChat, then confirm the login on your phone. If scanning fails, open the browser URL above.\n"
+        : "The QR code was not rendered in this terminal. Open the browser URL above, then confirm the login in WeChat.\n";
+}
+async function generateQRCode(qrContent, options) {
+    const qrterm = await import("qrcode-terminal");
+    return await new Promise((resolve, reject) => {
+        try {
+            qrterm.default.generate(qrContent, options, resolve);
+        }
+        catch (error) {
+            reject(error);
+        }
+    });
+}
+export async function printQRCode(qrContent, write, terminal = resolveLoginTerminal(), qrMode = "small", qrGenerator = generateQRCode) {
+    if (!terminal.isTTY) {
+        return "url_only";
+    }
     try {
-        const qrterm = await import("qrcode-terminal");
-        await new Promise((resolve) => {
-            qrterm.default.generate(qrContent, { small: true }, (qr) => {
-                write(`${qr}\n`);
-                resolve();
-            });
+        const qr = await qrGenerator(qrContent, {
+            small: qrMode === "small",
         });
+        const presentation = selectQRCodePresentation({
+            isTTY: terminal.isTTY,
+            columns: terminal.columns,
+            renderedWidth: getQRCodeVisibleWidth(qr),
+        });
+        if (presentation === "qr_with_url") {
+            write(`${qr}\n`);
+        }
+        write(presentation === "qr_with_url"
+            ? `If scanning fails, open this short-lived WeChat login URL in a browser. Do not share it:\n${qrContent}\n\n`
+            : `Open this short-lived WeChat login URL in a browser. Do not share it:\n${qrContent}\n\n`);
+        return presentation;
     }
     catch {
-        write(`Open this QR code URL in a browser: ${qrContent}\n\n`);
+        write(`The QR code could not be rendered. Open this short-lived WeChat login URL in a browser. Do not share it:\n${qrContent}\n\n`);
+        return "url_only";
     }
 }
 function saveCredentials(account) {
@@ -174,16 +237,54 @@ function printPostLoginHelp(log) {
     log("");
     log("Run wechat-setup again any time you need to refresh the login.");
 }
+export function parseWechatSetupCliArgs(argv) {
+    let qrMode = "small";
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg === "--help" || arg === "-h") {
+            return { help: true, qrMode };
+        }
+        if (arg === "--qr-mode") {
+            const value = argv[index + 1];
+            if (value !== "small" && value !== "normal") {
+                throw new Error("--qr-mode requires small or normal.");
+            }
+            qrMode = value;
+            index += 1;
+            continue;
+        }
+        if (arg === "--qr-mode=small" || arg === "--qr-mode=normal") {
+            qrMode = arg.endsWith("=small") ? "small" : "normal";
+            continue;
+        }
+        throw new Error(`Unknown wechat-setup option: ${arg}`);
+    }
+    return { help: false, qrMode };
+}
+export function formatWechatSetupUsage() {
+    return [
+        "Usage: wechat-setup [--qr-mode <small|normal>]",
+        "",
+        "Log in to WeChat and save bridge credentials.",
+        "QR mode defaults to small; use --qr-mode normal when the terminal renders small QR blocks incorrectly.",
+        "",
+    ].join("\n");
+}
 export async function runWechatLogin(options = {}) {
     const baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
     const log = options.log ?? ((message) => console.log(message));
     const write = options.write ?? ((message) => process.stdout.write(message));
     const timeoutMs = options.timeoutMs ?? 480_000;
     const pollIntervalMs = options.pollIntervalMs ?? 1_000;
+    const terminal = options.terminal ?? resolveLoginTerminal();
+    const qrMode = options.qrMode ?? "small";
+    if (!terminal.isTTY) {
+        throw new Error("WeChat login requires an interactive terminal. Run wechat-setup directly in PowerShell, Command Prompt, or a terminal window.");
+    }
     log("Fetching WeChat login QR code...\n");
     const qrResp = await fetchQRCode(baseUrl);
-    await printQRCode(qrResp.qrcode_img_content, write);
-    log("Scan the QR code above with WeChat, then confirm the login on your phone.\n");
+    const presentation = await printQRCode(qrResp.qrcode_img_content, write, terminal, qrMode);
+    log(formatQRCodeLoginInstruction(presentation));
     const deadline = Date.now() + timeoutMs;
     let scannedPrinted = false;
     while (Date.now() < deadline) {
@@ -252,7 +353,12 @@ export async function ensureWechatCredentials(options = {}) {
     const login = options.login ?? (() => runWechatLogin(options));
     return login();
 }
-async function main() {
+async function main(argv = process.argv.slice(2)) {
+    const cliOptions = parseWechatSetupCliArgs(argv);
+    if (cliOptions.help) {
+        console.log(formatWechatSetupUsage());
+        return;
+    }
     migrateLegacyChannelFiles((message) => console.log(message));
     const existing = loadExistingCredentials();
     if (existing) {
@@ -266,10 +372,10 @@ async function main() {
             return;
         }
     }
-    await runWechatLogin({ requireUserId: true });
+    await runWechatLogin({ requireUserId: true, qrMode: cliOptions.qrMode });
     printPostLoginHelp((message) => console.log(message));
 }
-const isDirectRun = Boolean(import.meta.main);
+const isDirectRun = isDirectModuleRun(import.meta.url, process.argv, import.meta.main);
 if (isDirectRun) {
     main().catch((err) => {
         const message = err instanceof Error ? err.message : String(err);

package/dist/wechat/wechat-channel.js

@@ -1,4 +1,10 @@
 #!/usr/bin/env bun
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (c) 2026 UNLINEARITY <unlinearity@gmail.com>
+// Source: https://github.com/UNLINEARITY/CLI-WeChat-Bridge
+// This file is part of CLI-WeChat-Bridge. Modifications and derivative works
+// must be released under AGPL-3.0-or-later with full source code; see
+// LICENSE.txt. Network services built on it must offer source to users.
 /**
  * WeChat MCP server.
  *