lark-remote 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -5,6 +5,29 @@ 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
+
+### 新增
+
+- **Windows 正式支持**：原生 Windows 支持已在真机完成验证，README / getting-started 的平台前置条件从「macOS / Linux，暂不支持 Windows」更新为 macOS / Linux / Windows 10+
+
+### 变更
+
+- **安全文档措辞更新**：README 安全警告与 `SECURITY.md` 反映 Claude 审批模式——`permissionMode` 可配置（默认 `bypassPermissions`，配置为其他值即启用飞书卡片交互式审批），不再表述为「固定 bypassPermissions」；审批卡片描述从 Codex 专属改为 Claude / Codex / Kimi 通用
+
 ## [0.2.0] - 2026-09-11
 
 ### 新增
@@ -62,7 +85,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### 变更
 
 - kimi ACP 能力声明：`fs` 保持关闭（走本地磁盘兜底，避免未实现的 `fs/*` RPC 报 `METHOD_NOT_FOUND`），`terminal` 打开
-- 文档清理：移除设计文档中对内部文档名（`lessons-redlines`）与本地仓库路径（`/Users/.../lark-remote`）的引用
 
 ## [0.1.10] - 2026-08-22
 
@@ -212,7 +234,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `displayTitle`/`summary` 跳过 task-notification 注入
 - 修复 `scanClaudeSessions` 对迁移到其他目录的会话的遗漏（S2）
 - 修复 probe 生命周期、工厂回退、卡片回调等评审发现的问题（F1-F8）
-- 清理引用已删除文档（lessons-redlines、resume-card-budget-failure-analysis）导致的失效链接
 
 ### 变更
 
@@ -221,7 +242,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 移除 `pnpm-lock.yaml`，统一使用 `bun.lock` 管理依赖
 - 新增 husky lint-staged pre-commit / pre-push 钩子（提交前 lint + typecheck）
 - 启用 npm provenance（构建产物可溯源）
-- 移除 watchdog 相关用户文档及 `open-source-playbook` 等临时文档
 
 ### 测试
 
@@ -300,3 +320,4 @@ Initial release.
 [0.1.6]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.6
 [0.1.7]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.7
 [0.1.8]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.8
+[0.2.1]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.2.1

package/README.en.md

@@ -16,20 +16,20 @@ Designed for a single-user, peer-to-peer private chat. The agent's system prompt
 
 ## ⚠️ Security Warning (read first)
 
-This tool turns Feishu messages directly into local agent executions. Claude runs with **full permissions** by default (fixed `bypassPermissions`); Codex uses the **app-server approval mode** (default `approvalPolicy=on-request` — command execution requires your confirmation on the Feishu card, sandbox defaults to `workspace-write`), which is relatively safe; other agents run with their CLI defaults. Agents can still read and write the local directories you specify. You MUST:
+This tool turns Feishu messages directly into local agent executions. **Out of the box, agents run without approval prompts**: Claude defaults to `bypassPermissions` (no approval card), but that permission mode is **configurable** — set it to anything other than `bypassPermissions` (`default` / `acceptEdits` / `auto` / `dontAsk` / `plan`) to enable interactive approval, where high-risk actions wait for your confirmation on the Feishu card. Codex uses the **app-server approval mode** (default `approvalPolicy=on-request` — command execution requires your confirmation on the Feishu card, sandbox defaults to `workspace-write`); Kimi defaults to `manual` (per-action approval); other agents run with their CLI defaults. **In any mode**, agents can read and write the local directories you specify. You MUST:
 
 - **Use it only in your own private (p2p) chat.** Never add the bot to any group chat; never let anyone else talk to it.
 - Restrict the app's visibility to **yourself only** in the Feishu Open Platform.
 - Don't run it on a machine holding data you can't afford to lose; prefer a dedicated user / machine / container.
 - Keep credentials such as `appSecret` in your local `config.yaml` only — **never commit them anywhere**.
 
-In Codex approval mode, an approval card arrives before any command runs — approve or reject it right in Feishu:
+In approval mode (Claude, Codex, Kimi), an approval card arrives before a command runs — approve or reject it right in Feishu:
 
-![Codex command approval card example](docs/images/approval-card.png)
+![Command approval card example](docs/images/approval-card.png)
 
 ## Prerequisites
 
-- OS: macOS / Linux. **Windows is not supported yet** (relies on POSIX behaviors such as Unix signals, bash, and file locks)
+- OS: macOS / Linux / Windows 10+ (native Windows support is verified on real hardware, with behavior matching macOS/Linux)
 - Node.js 20+ ([Bun](https://bun.sh/) for development)
 - A Feishu custom app (either way): scan-to-create (a QR code pops up in the terminal on first launch; scan it with the Feishu app to create the app and write credentials automatically); or create one manually in the Open Platform — enable bot capability, subscribe to `im.message.receive_v1` and `card.action.trigger` via **long connection** (WebSocket, no public address needed), with at least the `im:message` scope.
 - Claude Code CLI installed locally and logged in once in a terminal (`claude` → browser OAuth). Same idea for other agents (codex / opencode / pi / kimi): install the corresponding CLI first. DSH connects to a local DSH Web Host via HTTP+WebSocket (no local subprocess), default address `http://127.0.0.1:3080`.
@@ -70,7 +70,7 @@ defaultAgent: claude
 claude:
   model: claude-opus-4-8
   effort: medium            # low | medium | high | xhigh | max
-  # permissionMode is hardcoded to bypassPermissions (inside the runner)
+  permissionMode: bypassPermissions  # Claude official --permission-mode: default | acceptEdits | auto | bypassPermissions | manual | dontAsk | plan (switchable via /config card; anything other than bypassPermissions enables approval)
   stopGraceMs: 5000
 
 logging:
@@ -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

@@ -16,20 +16,20 @@
 
 ## ⚠️ 安全警告（必读）
 
-本工具会把飞书消息直接转为本地 agent 执行。Claude 默认以**完全权限**运行（固定 `bypassPermissions`）；Codex 采用 **app-server 审批模式**（默认 `approvalPolicy=on-request`，执行命令需在飞书卡片上确认，沙箱默认 `workspace-write`），相对安全；其他 agent 以各自 CLI 的默认权限运行。agent 仍可读写你指定的本地目录，请务必：
+本工具会把飞书消息直接转为本地 agent 执行。**开箱默认是不弹审批的**：Claude 默认以 `bypassPermissions` 运行（无审批卡），但该权限模式**可配置**——把它改成 `bypassPermissions` 以外的值（`default` / `acceptEdits` / `auto` / `dontAsk` / `plan`）即启用交互式审批，高风险操作会在飞书卡片上等你确认；Codex 采用 **app-server 审批模式**（默认 `approvalPolicy=on-request`，执行命令需在飞书卡片上确认，沙箱默认 `workspace-write`）；Kimi 默认 `manual`（逐条审批）；其他 agent 以各自 CLI 的默认权限运行。**无论哪种模式**，agent 都能读写你指定的本地目录，请务必：
 
 - **仅限你自己的私聊（p2p）使用**。不要把机器人拉进任何群聊，不要让任何其他人能与它对话。
 - 在飞书开放平台把应用可见范围限制到**只有你自己**。
 - 运行本工具的机器上不要存放与损失承受力不符的数据；建议在独立用户/机器/容器里运行。
 - `appSecret` 等凭据只在本地 `config.yaml`，**不要提交到任何仓库**。
 
-Codex 审批模式下，执行命令前会收到审批卡片，可直接在飞书里允许或拒绝：
+审批模式下（Claude、Codex、Kimi），执行命令前会收到审批卡片，可直接在飞书里允许或拒绝：
 
-![Codex 命令审批卡片示例](docs/images/approval-card.png)
+![命令审批卡片示例](docs/images/approval-card.png)
 
 ## 前置条件
 
-- 操作系统：macOS / Linux。**暂不支持 Windows**（原生 Windows 支持在建设中：平台 seam 已落地，待真机验证后发布）
+- 操作系统：macOS / Linux / Windows 10+（原生 Windows 支持已完成真机验证，行为与 macOS/Linux 对齐）
 - Node.js 20+（开发时用 [Bun](https://bun.sh/)）
 - 飞书自建应用（二选一）：扫码创建（首次启动终端弹二维码，飞书 App 扫码即自动创建并写入凭据）；或手动在开放平台建应用——开启机器人能力，订阅 `im.message.receive_v1` 和 `card.action.trigger`，订阅方式选「长连接」（WebSocket，无需公网地址），权限至少 `im:message`。
 - Claude Code CLI：本地安装并在终端完成一次登录（`claude` → 浏览器 OAuth）。使用其他 agent（codex / opencode / pi / kimi）同理，先装好对应 CLI；DSH 需本地 DSH Web Host 在跑（默认 `http://127.0.0.1:3080`），lark-remote 通过 HTTP+WebSocket 直连、不 spawn 本地子进程。
@@ -70,7 +70,7 @@ defaultAgent: claude
 claude:
   model: claude-opus-4-8
   effort: medium            # low | medium | high | xhigh | max
-  # permissionMode 硬编码为 bypassPermissions（runner 内部）
+  permissionMode: bypassPermissions  # Claude 官方 --permission-mode：default | acceptEdits | auto | bypassPermissions | manual | dontAsk | plan（`/config` 卡片可切换；非 bypassPermissions 会启用审批）
   stopGraceMs: 5000
 
 logging:
@@ -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.
@@ -699,7 +695,7 @@ export class Bridge {
             const workspaces = this.workspaceStore.list();
             if (workspaces.length > 0) {
                 // NOTE: fallback uses insertion order, not sort preference — by design
-                // (workspace-sorting.md §9: cwd fallback stays insertion-order for now)
+                // (cwd fallback stays insertion-order for now)
                 cwd = workspaces[0].path;
                 getLogger().info(`[bridge] resolveCwd fallback cwd=${cwd} (first saved 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

@@ -130,7 +130,6 @@ export class FeishuConnector {
         // 返回时，lark SDK 正常 resolve、@larksuite/channel 的 patchCard 丢弃返回值，
         // 导致终态卡 patch 被业务层拒绝时全链路无日志无兜底。这里只观测不改行为——
         // 不 throw、不重试，返回值原样透传。
-        // 详见 .adversarial-tdd/prompt-patchcard-business-code-observability.md
         // Guard: unit-test mocks may omit rawClient; skip probe installation in that case.
         const messageService = tryGetPatchService(this.channel);
         if (messageService?.patch) {
@@ -289,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/index.js

@@ -438,7 +438,7 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
             const workspaces = workspaceStore.list();
             if (workspaces.length > 0) {
                 // NOTE: fallback uses insertion order, not sort preference — by design
-                // (workspace-sorting.md §9: cwd fallback stays insertion-order for now)
+                // (cwd fallback stays insertion-order for now)
                 workspace = workspaces[0].path;
             }
         }

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)
@@ -1029,7 +1048,7 @@ export class CommandRouter {
         }
         const resolvedTarget = path.resolve(targetPath);
         // 与 ls.browse 对齐：目标只要存在且是目录即可切换（不再做子树/父级限制）。
-        // 安全边界由 binder owner 认证兜底，见 docs/architecture/design.md §9.7 更新说明。
+        // 安全边界由 binder owner 认证兜底，见 docs/zh/architecture/design.md §9.7 更新说明。
         if (!fs.existsSync(resolvedTarget) || !fs.statSync(resolvedTarget).isDirectory()) {
             await this.bridge.sendResult({ text: `路径无效: ${resolvedTarget}` }, ctx);
             return;
@@ -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/dist/session/claude/sessions.js

@@ -114,7 +114,7 @@ export function listClaudeSessions(cwd, opts = {}) {
     const limit = opts.limit;
     const projectsDir = opts.projectsDir ?? defaultProjectsDir();
     const index = ensureSessionIndex(projectsDir);
-    // 首次调用延迟全量建索引；之后 5s 按需节流增量刷新（session-index-manual 拍板 3）。
+    // 首次调用延迟全量建索引；之后 5s 按需节流增量刷新（拍板 3）。
     index.refresh();
     // 统一 parser 的完整 cwd 集合 → A→B→C 任意中间 cwd 都可列出（核心 bug 修复）。
     // readdir 失败时索引保留旧快照（首次失败则为空），与旧扫描的 readdir 兜底等价。

package/dist/session/dsh/sessions.js

@@ -24,7 +24,7 @@ import { truncateUtf8, TOOL_RESULT_MAX_BYTES } from '../../common/truncate.js';
  * CC-05: history 拉取上限。DSH session.history 的 maxMessages 同时限制返回条数，
  * 若用它同时充当展示截断，>50 事件的会话累计 usage 会少算。这里拉取一个足够大的
  * 上限保证 usage 累加覆盖整个会话；展示仍由 capEvents(opts?.maxEvents ?? 50) 截断。
- * （若 DSH 支持分页 cursor 可改成分页，当前用有界大拉取，见 review-fix-plan-cc.md）
+ * （若 DSH 支持分页 cursor 可改成分页，当前用有界大拉取）
  */
 const DSH_HISTORY_FETCH_LIMIT = 10_000;
 /** Synchronous unary POST via curl (the reader interface is synchronous). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lark-remote",
-  "version": "0.2.0",
+  "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",