lark-remote 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.2] - 2026-09-12
+
+### 修复
+
+- **Windows `!` 命令修复**：解析 `bash` 时跳过 `system32` / `SysWOW64` 下的 WSL 启动器（那不是 Git Bash），并从 PATH 中的 `Git\cmd` 目录反推 `Git\bin\bash.exe` / `Git\usr\bin\bash.exe`；修复 `!` 命令被整条丢进 WSL 执行后因旧版 Node 解析不了新语法而报 `SyntaxError` 的问题
+- **`lark-remote update` 不再被运行中的实例阻塞**：裸子命令 `update` / `version` / `help` 现在与 `--update` / `--version` / `--help` 等价；此前裸 `update` 会被当作位置参数落进守护进程路径去抢单例锁，被运行中的实例以 "already running" 挡下
+
+### 变更
+
+- **移除 `/reconnect` 命令**：路由分发、`/help` 按钮、Bridge 与 FeishuConnector 的重连实现及文档一并删除；重连需求已由 `/restart` 覆盖
+- **消息合并提示**：飞书把极短间隔连发的多条消息合并成一条时，首行命令之后若还有以 `/` 开头的整行，会在执行第一条命令的同时提示被忽略的原始内容，不再静默丢弃
+- **旧 Node 运行时友好化**：`dist/cli.js` 作为入口保持极旧 Node 可解析（避免 `??` / `?.` 语法），版本检查在加载应用模块图前由 preflight 处理；Node < 18 时给出明确的人话报错而非解析错误
+
 ## [0.2.1] - 2026-09-11
 
 ### 新增

package/README.en.md

@@ -117,7 +117,6 @@ Your original message also gets an emoji reaction: `Typing` while the run is in
 | `/status` | `/s` | Current directory, session, model, process status |
 | `/stop` | `/t` | Kill the current agent process (SIGKILL) |
 | `/ps` | - | Whether a process is running |
-| `/reconnect` | - | Reconnect to Feishu |
 | `/restart` | - | In-place bridge self-restart (new process takes over with the same config) |
 | `/config get\|set` | `/c` | View/change runtime config (agent-aware card) |
 | `/order save\|list\|edit` | `/o` | Save, list, or edit frequently used prompts |

package/README.md

@@ -117,7 +117,6 @@ bridge 启动后不在终端输出，运行日志写入 `~/.lark-remote/logs/YYY
 | `/status` | `/s` | 当前目录、session、模型、进程状态 |
 | `/stop` | `/t` | 终止当前 agent 进程（SIGKILL） |
 | `/ps` | - | 是否有进程在跑 |
-| `/reconnect` | - | 重连飞书 |
 | `/restart` | - | 原地自重启 bridge（新进程同 config 接管） |
 | `/config get\|set` | `/c` | 查改运行时配置（agent-aware 卡片） |
 | `/order save\|list\|edit\|alias` | `/o` | 收藏常用指令；`/order edit` 修改指令文本（保留别名/使用统计）；`/order alias` 注册快捷别名（输入 `$name` 展开） |

package/dist/bridge/index.d.ts

@@ -10,9 +10,8 @@ import type { InboundMediaPayload } from '../connector/index.js';
 /**
  * Seam (§7): the channel capabilities the bridge needs. `sendWithRetry` is
  * the minimum a Feishu channel must offer for the bridge to push messages
- * through it; `reconnect` lets `/reconnect` be served through the bridge
- * without the router holding a separate connector reference. Declared here
- * so tests can satisfy it structurally without `as unknown as` casts.
+ * through it. Declared here so tests can satisfy it structurally without
+ * `as unknown as` casts.
  */
 interface BridgeChannel extends RunCardChannel {
     sendWithRetry(chatId: string, input: {
@@ -24,7 +23,6 @@ interface BridgeChannel extends RunCardChannel {
     }, opts?: {
         replyTo?: string;
     }): Promise<string>;
-    reconnect(): Promise<void>;
     sendFile(chatId: string, filePath: string): Promise<string>;
     addReaction(messageId: string, emoji: string): Promise<void>;
     removeReactionByEmoji(messageId: string, emoji: string): Promise<void>;
@@ -326,8 +324,6 @@ export declare class Bridge {
     flushMediaNotifications(userId: string, chatId: string): void;
     /** 冲刷全部待合批提示（/exit、/restart 干净退出前调用）。 */
     flushAllMediaNotifications(): Promise<void>;
-    /** Reconnect the underlying Feishu channel. */
-    reconnect(): Promise<void>;
     /**
      * Resolve the working directory for a user.
      * First checks sessionStore (set by /cd), then falls back to first workspace.

package/dist/bridge/index.js

@@ -683,10 +683,6 @@ export class Bridge {
     async flushAllMediaNotifications() {
         await this.mediaHandler.flushAllPending();
     }
-    /** Reconnect the underlying Feishu channel. */
-    async reconnect() {
-        await this.connector.reconnect();
-    }
     /**
      * Resolve the working directory for a user.
      * First checks sessionStore (set by /cd), then falls back to first workspace.

package/dist/cli.d.ts

@@ -1,5 +1,17 @@
 #!/usr/bin/env node
 type RuntimeChoice = 'bun' | 'node';
+/**
+ * 纯信息类命令 + Node 版本守卫。
+ *
+ * 必须在 import 应用模块图之前执行。dist/cli.js 自身刻意不使用 ES2020+ 语法
+ * （?? / ?. / ??=），这样它在 node 12 上也 **能被解析**；而 dist/index.js 是
+ * ES2022，node<14 一加载就是 `SyntaxError: Unexpected token '?'`，堆栈全部落在
+ * Node 内部、完全看不出是版本问题（实测：WSL 里的 lark-remote 报的就是这个）。
+ *
+ * @returns 已处理完时返回退出码（0/1），调用方应立即 `process.exit(code)`；
+ *          返回 null 表示不是信息类命令、运行时也够新，继续正常启动。
+ */
+export declare function handlePreflight(args: string[], nodeVersion?: string): number | null;
 interface BunProbe {
     error: boolean;
     status: number | null;

package/dist/cli.js

@@ -3,8 +3,44 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { spawn, spawnSync } from 'node:child_process';
 import { fileURLToPath, pathToFileURL } from 'node:url';
+import { printHelp, printVersion } from './config/dir.js';
 const entryUrl = new URL('./index.js', import.meta.url);
 const entry = fileURLToPath(entryUrl);
+/**
+ * 最低支持的 Node 主版本。package.json engines 写的是 >=20，这里放宽一档到
+ * 18 —— 守卫的目的是把「node 太老」变成一句人话，而不是把边界再收紧一次。
+ */
+const MIN_NODE_MAJOR = 18;
+/**
+ * 纯信息类命令 + Node 版本守卫。
+ *
+ * 必须在 import 应用模块图之前执行。dist/cli.js 自身刻意不使用 ES2020+ 语法
+ * （?? / ?. / ??=），这样它在 node 12 上也 **能被解析**；而 dist/index.js 是
+ * ES2022，node<14 一加载就是 `SyntaxError: Unexpected token '?'`，堆栈全部落在
+ * Node 内部、完全看不出是版本问题（实测：WSL 里的 lark-remote 报的就是这个）。
+ *
+ * @returns 已处理完时返回退出码（0/1），调用方应立即 `process.exit(code)`；
+ *          返回 null 表示不是信息类命令、运行时也够新，继续正常启动。
+ */
+export function handlePreflight(args, nodeVersion = process.versions.node) {
+    for (const arg of args) {
+        if (arg === '-v' || arg === '--version' || arg === 'version') {
+            printVersion();
+            return 0;
+        }
+        if (arg === '-h' || arg === '--help' || arg === 'help') {
+            printHelp();
+            return 0;
+        }
+    }
+    const major = parseInt(String(nodeVersion).split('.')[0], 10);
+    if (!Number.isNaN(major) && major > 0 && major < MIN_NODE_MAJOR) {
+        console.error(`lark-remote 需要 Node >= ${MIN_NODE_MAJOR}（当前 ${nodeVersion}）。\n` +
+            '请升级 Node 后重试；若你在 WSL 里执行，注意 WSL 发行版的 node 与 Windows 侧的 node 是两套。');
+        return 1;
+    }
+    return null;
+}
 /** Prefer bun unless we are already under bun or bun is not usable. */
 export function decideRuntime(isBun, probe) {
     if (!isBun && !probe.error && probe.status === 0)
@@ -52,7 +88,8 @@ export async function bootstrap(deps) {
             }
         }
         else {
-            exit(code ?? 1);
+            // 不用 `??`：cli.js 是入口，必须在 node<14 上也能被解析（见 handlePreflight）。
+            exit(typeof code === 'number' ? code : 1);
         }
     });
 }
@@ -69,10 +106,17 @@ function isDirectEntry() {
     return candidates.some((p) => pathToFileURL(p).href === import.meta.url);
 }
 function main() {
+    const args = process.argv.slice(2);
+    // 信息类命令 / 过旧运行时：在探测 bun、import 应用模块图之前先处理掉。
+    const preflight = handlePreflight(args);
+    if (preflight !== null) {
+        process.exit(preflight);
+    }
+    const isBunFlag = process.isBun;
     const deps = {
         entry,
-        args: process.argv.slice(2),
-        isBun: process.isBun ?? false,
+        args,
+        isBun: isBunFlag === true,
         probe: probeBun(),
         importEntry: () => import(entryUrl.href),
         spawnBun: (e, a) => spawn('bun', [e, ...a], { stdio: 'inherit', windowsHide: true }),

package/dist/config/dir.js

@@ -28,10 +28,10 @@ export function parseCliArgs(args = process.argv.slice(2)) {
     const result = {};
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
-        if (arg === '-h' || arg === '--help') {
+        if (arg === '-h' || arg === '--help' || arg === 'help') {
             result.help = true;
         }
-        else if (arg === '-v' || arg === '--version') {
+        else if (arg === '-v' || arg === '--version' || arg === 'version') {
             result.version = true;
         }
         else if (arg === '--config-dir' && i + 1 < args.length) {
@@ -52,7 +52,10 @@ export function parseCliArgs(args = process.argv.slice(2)) {
         else if (arg === '--dev') {
             result.dev = true;
         }
-        else if (arg === '--update') {
+        else if (arg === '--update' || arg === 'update') {
+            // 裸子命令等价形式：`lark-remote update` 与 `--update` 同义。
+            // 不识别时它会落到守护进程路径去抢单例锁，被正在运行的实例挡下
+            // （"already running"），而 update 根本不是守护类命令。
             result.update = true;
         }
     }
@@ -62,7 +65,9 @@ export function parseCliArgs(args = process.argv.slice(2)) {
 export function getVersion() {
     const pkgPath = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', '..', 'package.json');
     const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
-    return pkg.version ?? '0.0.0';
+    // 不用 `??`：本模块会被 dist/cli.js 静态引入，而 cli.js 必须在很旧的 Node
+    // （实测 WSL v12）上也 **能解析** —— node<14 不认识 ??，会直接 SyntaxError。
+    return typeof pkg.version === 'string' ? pkg.version : '0.0.0';
 }
 /** Print version to stdout. */
 export function printVersion() {
@@ -74,7 +79,12 @@ export function printHelp() {
         'lark-remote — 飞书私聊 ↔ 本地 Coding Agent CLI 桥接',
         '',
         'Usage:',
-        '  lark-remote [options]',
+        '  lark-remote [command] [options]',
+        '',
+        'Commands:',
+        '  update                 等同 --update：升级到最新版本后退出（不被运行中的实例阻塞）',
+        '  version                等同 --version',
+        '  help                   等同 --help',
         '',
         'Options:',
         '  --config-dir <path>   自定义配置目录（默认 ~/.lark-remote，可用于同机多实例）',

package/dist/connector/index.d.ts

@@ -114,7 +114,6 @@ export declare class FeishuConnector {
     }): Promise<InboundMediaPayload>;
     connect(): Promise<void>;
     disconnect(): Promise<void>;
-    reconnect(): Promise<void>;
     /**
      * Send a message with automatic rate-limit retry (§9.5).
      * Encounters rate_limited / feishuCode 99991400|99991401（SDK 归类为

package/dist/connector/index.js

@@ -288,12 +288,6 @@ export class FeishuConnector {
             this.isConnected = false;
         }
     }
-    async reconnect() {
-        // disconnect() swallows its own errors internally, so no try/catch needed
-        // here — it always resolves.
-        await this.disconnect();
-        await this.connect();
-    }
     /**
      * Send a message with automatic rate-limit retry (§9.5).
      * Encounters rate_limited / feishuCode 99991400|99991401（SDK 归类为

package/dist/platform/command.d.ts

@@ -1,5 +1,7 @@
 import type { LaunchSpec } from './types.js';
 export type { LaunchSpec } from './types.js';
+/** 判断一个已命中的 bash.exe 是否只是 WSL 启动器（而非 Git Bash）。 */
+export declare function isWslBashLauncher(file: string): boolean;
 export interface ResolveOptions {
     platform?: NodeJS.Platform;
     /** PATH 环境变量注入（测试用）；默认 process.env.PATH */

package/dist/platform/command.js

@@ -18,6 +18,33 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { currentPlatform, isWin32 } from './select.js';
 const DEFAULT_PATHEXT = ['.exe', '.bat', '.cmd'];
+/**
+ * win32 的「假 bash」：`%SystemRoot%\system32\bash.exe`（SysWOW64 同理）不是
+ * Git Bash，而是 WSL 启动器（wsl.exe 的 bash 别名）。PATH 里 system32 通常
+ * 排在 Git\cmd 之前，按目录顺序命中它会把整条 `!` 命令丢进 WSL 发行版执行：
+ * 工作目录变成 /mnt/d/...、node 变成 WSL 里装的那个版本。实测本机 WSL node
+ * 为 v12，加载 dist/index.js 的 ES2022 语法（?? / ?.）直接
+ * `SyntaxError: Unexpected token '?'`，`!lark-remote -v` 因此失败。
+ *
+ * 因此解析 `bash` 时必须跳过它，继续在 PATH 中找真正的 Git Bash。
+ *
+ * 判定只看两层目录名（`<...>\system32\bash.exe`）：Git Bash 装在
+ * `<Git>\bin` / `<Git>\usr\bin`，不会叫 system32；反过来把真正的 Git Bash
+ * 装在名为 system32 的目录里也可以忽略。
+ */
+const WSL_BASH_PARENT_DIRS = ['system32', 'syswow64'];
+/** 判断一个已命中的 bash.exe 是否只是 WSL 启动器（而非 Git Bash）。 */
+export function isWslBashLauncher(file) {
+    const normalized = file.replaceAll('/', '\\').toLowerCase();
+    if (path.win32.basename(normalized) !== 'bash.exe')
+        return false;
+    return WSL_BASH_PARENT_DIRS.includes(path.win32.basename(path.win32.dirname(normalized)));
+}
+/** 查询目标是 bash（`bash` 或显式 `bash.exe`）时才走上面的特例。 */
+function isBashQuery(name) {
+    const lower = name.toLowerCase();
+    return lower === 'bash' || lower === 'bash.exe';
+}
 /**
  * 缓存 TTL：probe 层（runner/probe.ts）5 分钟，本层更短——bridge 运行期间
  * 用户新装/卸载 agent（典型场景：按 /config 不可用提示去安装）后，最迟
@@ -56,17 +83,42 @@ function existsWin32(file) {
         return posixForm;
     return null;
 }
+/**
+ * Git for Windows 只把 `Git\cmd` 放进 PATH（里面没有 bash.exe），真正的
+ * bash 在 `Git\bin\bash.exe` / `Git\usr\bin\bash.exe`。PATH 里只暴露 cmd
+ * 目录时，从 cmd 反推安装根再找 bash。
+ */
+function resolveBashFromGitCmdDir(pathEnv) {
+    for (const dir of listPathDirs(pathEnv, 'win32')) {
+        if (path.win32.basename(dir).toLowerCase() !== 'cmd')
+            continue;
+        const root = path.win32.dirname(dir);
+        for (const rel of ['bin\\bash.exe', 'usr\\bin\\bash.exe']) {
+            const found = existsWin32(path.win32.join(root, rel));
+            if (found)
+                return { kind: 'direct', file: found };
+        }
+    }
+    return null;
+}
 function resolveWin32(name, pathEnv, pathExt) {
     const hasExtension = /\.[A-Za-z0-9]+$/.test(name);
+    const bashQuery = isBashQuery(name);
     for (const dir of listPathDirs(pathEnv, 'win32')) {
         const candidates = hasExtension ? [name] : pathExt.map((ext) => name + ext);
         for (const candidate of candidates) {
             const found = existsWin32(path.win32.join(dir, candidate));
+            if (!found)
+                continue;
+            // WSL 启动器不是 Git Bash：跳过，继续找后面的 PATH 目录
+            if (bashQuery && isWslBashLauncher(found))
+                continue;
             // .cmd/.bat 垫片命中即报告垫片路径本身；执行语义由 cross-spawn 负责
-            if (found)
-                return { kind: 'direct', file: found };
+            return { kind: 'direct', file: found };
         }
     }
+    if (bashQuery)
+        return resolveBashFromGitCmdDir(pathEnv);
     return null;
 }
 function resolvePosix(name, pathEnv) {

package/dist/router/index.d.ts

@@ -548,7 +548,6 @@ export declare class CommandRouter {
      * Paginates with ACTIVE_PAGE_SIZE (default 20) items per page.
      */
     private buildActiveCardFromMemory;
-    private cmdReconnect;
     private cmdConfig;
     /**
      * DSH /config 卡片构建前异步预取模型/预设目录（§4.2 动态清单）。

package/dist/router/index.js

@@ -49,6 +49,25 @@ function pageSlice(items, offset, pageSize) {
     };
 }
 const ACTIVE_PAGE_SIZE = 20;
+/**
+ * 飞书会把极短间隔连发的多条消息合并成一条换行分隔的消息：用户侧看是两条消息，
+ * 本端收到的却是 `/a\n/b`。命令执行是「一条消息一条」，首行之外的内容不会作为
+ * 独立命令执行。命中时返回首行之外的原始内容（即被忽略的部分），未命中返回 null。
+ * 绝对路径参数（如 `/cd /tmp`）与命令同处首行，不会误判。
+ */
+function findMergedCommandTail(message) {
+    const lines = message.split('\n');
+    if (lines.length < 2)
+        return null;
+    const tail = lines.slice(1).join('\n').trim();
+    if (!tail)
+        return null;
+    const hasSlashLine = lines.slice(1).some((line) => {
+        const trimmed = line.trim();
+        return trimmed.length > 1 && trimmed.startsWith('/') && !trimmed.startsWith('/ ');
+    });
+    return hasSlashLine ? tail : null;
+}
 /** 人类可读字节数（B/KB/MB/GB）；/ls 列表与单文件卡共用。 */
 function formatBytes(bytes) {
     if (bytes < 1024)
@@ -1929,6 +1948,16 @@ export class CommandRouter {
         const parts = message.slice(1).split(/\s+/);
         const cmd = parts[0]?.toLowerCase();
         const args = parts.slice(1);
+        // 飞书会把短间隔连发的消息合并成一条换行分隔的消息（见 findMergedCommandTail）。
+        // 先提示被忽略的内容，再照常执行第一条命令，避免第二条被静默丢弃。
+        const mergedTail = findMergedCommandTail(message);
+        if (mergedTail) {
+            await this.bridge.sendResult({
+                text: `⚠️ 已忽略：${mergedTail}\n` +
+                    '一条消息只能执行一条命令\n' +
+                    '如果发得太快，也可能被飞书合并成一条消息',
+            }, ctx);
+        }
         switch (cmd) {
             case 'help':
             case 'h':
@@ -1963,8 +1992,6 @@ export class CommandRouter {
                 return this.cmdResume(args, ctx);
             case 'active':
                 return this.cmdActive(args, ctx);
-            case 'reconnect':
-                return await this.cmdReconnect();
             case 'config':
             case 'c':
                 return await this.cmdConfig(args, ctx);
@@ -1995,7 +2022,6 @@ export class CommandRouter {
             { cmd: 'restart', label: '/restart', desc: '重启 bridge（新进程，config 不变）' },
             { cmd: 'update', label: '/update /u', desc: '检查并升级到最新版本' },
             { cmd: 'status', label: '/status /s', desc: '显示当前状态' },
-            { cmd: 'reconnect', label: '/reconnect', desc: '重连飞书' },
         ].sort((a, b) => a.label.length - b.label.length || a.cmd.localeCompare(b.cmd));
         // 文本组（需带参数，不宜用按钮；以纯文本行展示）
         const textCommands = [
@@ -2024,9 +2050,9 @@ export class CommandRouter {
         // 跨行不对齐（按钮列右边界参差）。改用 weighted 后，每行 column_set
         // 总宽相同（同级 body.elements），weight 比例一致，列宽跨行恒等。
         // 2026-07-05 手机排版修复：weight 1:3 → 2:3。1:3 时按钮列只占 25%，
-        // 手机窄屏（~330px 可用）下约 82px，容不下 `/reconnect`（10 字符 ≈ 100px），
+        // 手机窄屏（~330px 可用）下约 82px，容不下 `/config /c`（10 字符 ≈ 100px），
         // 按钮文字被截断成 "..."。改 2:3 后按钮列占 40% ≈ 132px，足够显示
-        // 最长的 /reconnect，文本列仍占 60% 足以放下描述。
+        // 最长的 /config /c，文本列仍占 60% 足以放下描述。
         for (const c of buttonCommands) {
             bodyElements.push({
                 tag: 'column_set',
@@ -3470,15 +3496,6 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
         };
         return { card };
     }
-    async cmdReconnect() {
-        try {
-            await this.bridge.reconnect();
-            return { text: '已重连飞书' };
-        }
-        catch {
-            return { text: '重连失败，请检查网络和配置' };
-        }
-    }
     async cmdConfig(args, ctx) {
         // Ensure probe cache is populated before building the card.
         await probeAllAgents();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lark-remote",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Feishu (Lark) private-chat bridge to local coding agents — Claude Code / Codex / opencode / pi / kimi, with live-streaming CardKit 2.0 cards",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",