lark-remote 0.4.4 → 0.5.0

package/dist/connector/index.d.ts

@@ -73,7 +73,7 @@ export interface InboundMediaPayload {
 }
 /**
  * 媒体消息到达的轻量描述（未下载）：供上层先做 owner/配置闸门，
- * 通过后再调 downloadInboundMedia —— 下载发生在认证之后（P1 review 修复）。
+ * 通过后再调 downloadInboundMedia —— 下载发生在认证之后（修复）。
  */
 /** SDK 给出的可下载资源种类（`resources[].type`）。 */
 export type InboundResourceKind = 'image' | 'file' | 'audio' | 'video' | 'sticker';
@@ -107,8 +107,6 @@ type CardActionHandler = (action: CardActionEvent) => void | CardActionResponse
  * 卡片 patch 的重试上限。含义：1 次原始尝试 + 最多 PATCH_MAX_RETRIES 次重试。
  */
 export declare const PATCH_MAX_RETRIES = 3;
-/** 重试退避基数（ms）；第 n 次重试前等待 n × 基数，给对端恢复的时间。 */
-export declare const PATCH_RETRY_BASE_DELAY_MS = 150;
 export declare class FeishuConnector {
     /** 飞书 channel 实例（public：测试直接访问/注入 mock，替代 as unknown as）。 */
     channel: LarkChannel;
@@ -182,14 +180,14 @@ export declare class FeishuConnector {
      */
     private checkUploadable;
     /**
-     * sendFile/sendImage 共用骨架：token → 上传（流在任何失败路径销毁，P2-18）
+     * sendFile/sendImage 共用骨架：token → 上传（流在任何失败路径销毁）
      * → 发送媒体消息。上传端点 / form 字段 / 响应 key / msg_type 的差异由调用方
      * 以 uploadUrl + buildForm + keyField + msgType 表达；timeout、noKeepAliveAgent
      * （Bun keep-alive 修复）与错误包装在此单源。label 是对外错误前缀与日志
      * 标签（'sendFile' | 'sendImage'）。
      */
     private uploadAndSendMedia;
-    /** 单次「上传 + 发媒体消息」；文件流在此拥有，任何失败路径都销毁（P2-18）。 */
+    /** 单次「上传 + 发媒体消息」；文件流在此拥有，任何失败路径都销毁。 */
     private uploadWithToken;
     /**
      * Upload a file to Feishu and send it to the specified chat.
@@ -203,13 +201,13 @@ export declare class FeishuConnector {
      */
     sendImage(chatId: string, filePath: string): Promise<string>;
     /**
-     * Cached tenant_access_token for sendFile (P2-18). The token is valid ~2h;
+     * Cached tenant_access_token for sendFile. The token is valid ~2h;
      * fetching it on every file send wastes a round-trip and an unguarded fetch
      * could return data.code != 0 with an undefined token. Cache with expiry and
      * validate the response code.
      *
      * 缓存的两条失效路径：到期（下面 expire）与被服务端判 token 无效
-     * （invalidateTenantToken，见 §B13）。
+     * （invalidateTenantToken）。
      */
     private cachedToken;
     private cachedTokenExpireAt;

package/dist/connector/index.js

@@ -7,7 +7,7 @@ import { sleep } from '../common/sleep.js';
 import { isTransientTransportError } from '../error-classification.js';
 import axios from 'axios';
 import fs from 'node:fs';
-import { silentlyUnlink } from '../common/fs.js';
+import { bestEffortUnlink } from '../common/fs.js';
 import { displayName } from '../platform/path.js';
 import https from 'node:https';
 import os from 'node:os';
@@ -111,7 +111,7 @@ function withTimeout(promise, ms, label, onLateSettle) {
     });
 }
 /**
- * 判断 send 失败是否值得重试一次（§9.5 限流重试口径，§P1-3 修正）。
+ * 判断 send 失败是否值得重试一次（§9.5 限流重试口径）。
  *
  * @larksuite/channel@0.7.1 的 classifyError 把飞书业务码 99991400/99991401
  * （频率控制）归类为 `code='permission_denied'`（SDK 源码实证），并保留原始
@@ -145,7 +145,7 @@ function shouldRetrySendError(err) {
  */
 export const PATCH_MAX_RETRIES = 3;
 /** 重试退避基数（ms）；第 n 次重试前等待 n × 基数，给对端恢复的时间。 */
-export const PATCH_RETRY_BASE_DELAY_MS = 150;
+const PATCH_RETRY_BASE_DELAY_MS = 150;
 /** 记日志用的错误摘要（不打印 axios 巨型循环对象）。 */
 function formatErrorForLog(err) {
     if (err instanceof Error) {
@@ -271,6 +271,19 @@ export class FeishuConnector {
                     ttl: DEDUP_TTL_MS,
                     maxEntries: 1000,
                 },
+                // 关掉 SDK 的入站去抖合批（`ChatPipeline` + `mergeBatch`），delayMs=0 让每条
+                // 消息单独成批、保留自己的 messageId（`enabled` 仍为 true，per-chat 串行与
+                // 卡片动作同通道不受影响）。
+                //
+                // 背景：SDK 默认 600ms 内把同一会话的多条消息合并成一条，`mergeBatch` 只保留
+                // **最后一条**的 `messageId` 却把多条消息的 `resources` 求并集。飞书客户端
+                // "一次选多图/多文件"会背靠背秒发成多条独立消息，被合并后下载侧拿同一个
+                // `messageId` 下所有 `fileKey`，除最后一条外全部报错 234003（HTTP 400）：
+                // 表现为"多图只有 1 张保存成功，其余下载失败"。合批本应由本项目自己的
+                // 700ms 装配器（`InboundTurnAssembler`）负责，SDK 这层是叠加的第二次合批。
+                batch: {
+                    text: { delayMs: 0 },
+                },
             },
         });
         // 卡片 patch 的统一出口（观测 + 重试）：
@@ -305,7 +318,7 @@ export class FeishuConnector {
             // SDK 只为 image/file/audio/video/media/sticker 五类产出非空 resources，
             // 枚举 msg_type 必然漏（2026-09-15 事故：mp4 被当文本转发给 agent）。
             // 一条消息可以**同时**产出资源事件与文本事件（post 既有文字又有图），
-            // 由 B3 的装配器合并成同一个 turn。
+            // 由的装配器合并成同一个 turn。
             const hasResources = msg.resources.length > 0;
             if (hasResources) {
                 // 只上报「媒体到达」，不在此下载：owner/配置闸门在 index.ts 里先执行，
@@ -403,9 +416,9 @@ export class FeishuConnector {
         for (const res of msg.resources) {
             const tmpPath = path.join(os.tmpdir(), `lark-remote-inbound-${randomUUID()}`);
             try {
-                const { contentType, bytesWritten } = await withTimeout(this.channel.downloadResourceToFile(msg.messageId, res.fileKey, res.type, tmpPath), timeoutMs, `downloadResource fileKey=${res.fileKey}`, () => silentlyUnlink(tmpPath));
+                const { contentType, bytesWritten } = await withTimeout(this.channel.downloadResourceToFile(msg.messageId, res.fileKey, res.type, tmpPath), timeoutMs, `downloadResource fileKey=${res.fileKey}`, () => bestEffortUnlink(tmpPath));
                 if (bytesWritten > maxBytes) {
-                    silentlyUnlink(tmpPath);
+                    bestEffortUnlink(tmpPath);
                     const limitMb = maxBytes / (1024 * 1024);
                     failures.push({
                         kind: res.kind,
@@ -429,7 +442,7 @@ export class FeishuConnector {
             catch (err) {
                 // 超时不在这里删文件：上面已把清理挂到底层传输的 settle 上。
                 if (!(err instanceof ResourceTimeoutError))
-                    silentlyUnlink(tmpPath);
+                    bestEffortUnlink(tmpPath);
                 getLogger().warn(`[feishu] downloadResource failed fileKey=${res.fileKey} type=${res.type}:`, err.message);
                 failures.push({
                     kind: res.kind,
@@ -489,7 +502,7 @@ export class FeishuConnector {
                     return result.messageId;
                 }
                 catch (retryErr) {
-                    // P2-17: throw the RETRY error, not the outer `err`. Previously
+                    // throw the RETRY error, not the outer `err`. Previously
                     // `throw err` here re-threw the first (rate-limit) failure, hiding
                     // the real reason the retry attempt failed (e.g. auth invalid).
                     getLogger().warn('[feishu] retry after rate limit still failed');
@@ -595,7 +608,7 @@ export class FeishuConnector {
         }
     }
     /**
-     * sendFile/sendImage 共用骨架：token → 上传（流在任何失败路径销毁，P2-18）
+     * sendFile/sendImage 共用骨架：token → 上传（流在任何失败路径销毁）
      * → 发送媒体消息。上传端点 / form 字段 / 响应 key / msg_type 的差异由调用方
      * 以 uploadUrl + buildForm + keyField + msgType 表达；timeout、noKeepAliveAgent
      * （Bun keep-alive 修复）与错误包装在此单源。label 是对外错误前缀与日志
@@ -627,13 +640,13 @@ export class FeishuConnector {
             throw new Error(`${label} failed: ${errorInfo}`, { cause: err });
         }
     }
-    /** 单次「上传 + 发媒体消息」；文件流在此拥有，任何失败路径都销毁（P2-18）。 */
+    /** 单次「上传 + 发媒体消息」；文件流在此拥有，任何失败路径都销毁。 */
     async uploadWithToken(accessToken, chatId, filePath, uploadUrl, buildForm, keyField, msgType) {
         let fileStream = null;
         try {
             fileStream = fs.createReadStream(filePath);
             const form = buildForm(fileStream);
-            // P2-18: timeout 120s（大文件慢链路）；httpsAgent: noKeepAliveAgent 防止
+            // timeout 120s（大文件慢链路）；httpsAgent: noKeepAliveAgent 防止
             // Bun 复用已被服务端 RST 的 keep-alive socket（ECONNRESET after ~30s）。
             const uploadResp = await axios.post(uploadUrl, form, {
                 headers: {
@@ -647,7 +660,7 @@ export class FeishuConnector {
                 throw new FeishuBusinessError(`Upload failed: ${uploadResp.data.msg}`, uploadResp.data.code);
             }
             const mediaKey = uploadResp.data.data[keyField];
-            // P2-18: timeout 30s；noKeepAlive 同上。
+            // timeout 30s；noKeepAlive 同上。
             const sendResp = await axios.post('https://open.feishu.cn/open-apis/im/v1/messages', {
                 receive_id: chatId,
                 msg_type: msgType,
@@ -667,7 +680,7 @@ export class FeishuConnector {
             return sendResp.data.data.message_id;
         }
         catch (err) {
-            // P2-18: destroy the read stream on failure so the fd is released.
+            // destroy the read stream on failure so the fd is released.
             if (fileStream) {
                 try {
                     fileStream.destroy();
@@ -708,13 +721,13 @@ export class FeishuConnector {
         }, 'image_key', 'image');
     }
     /**
-     * Cached tenant_access_token for sendFile (P2-18). The token is valid ~2h;
+     * Cached tenant_access_token for sendFile. The token is valid ~2h;
      * fetching it on every file send wastes a round-trip and an unguarded fetch
      * could return data.code != 0 with an undefined token. Cache with expiry and
      * validate the response code.
      *
      * 缓存的两条失效路径：到期（下面 expire）与被服务端判 token 无效
-     * （invalidateTenantToken，见 §B13）。
+     * （invalidateTenantToken）。
      */
     cachedToken = null;
     cachedTokenExpireAt = 0;
@@ -736,7 +749,7 @@ export class FeishuConnector {
         this.cachedTokenExpireAt = 0;
     }
     async fetchTenantAccessToken() {
-        // P2-18: timeout 30s on the token request.
+        // timeout 30s on the token request.
         // httpsAgent: noKeepAlive — same Bun keep-alive fix as upload above.
         const tokenResp = await axios.post('https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal', {
             app_id: this.appId,

package/dist/inbound/event.d.ts

@@ -1,7 +1,7 @@
 /**
  * 装配器事件（设计依据见 `docs/zh/architecture/inbound-unified-input-design.md`）。
  *
- * 设计文档早期的媒体事件形态是「下载完成后的 attachments/failures」。实际链路里
+ * 早期的媒体事件形态是「下载完成后的 attachments/failures」。实际链路里
  * 下载是异步的（`index.ts` 先过 owner/enabled 闸门再下载），若等下载完成才投递事件，
  * 「先图后文」在慢下载下会先提交一个只含文本的 turn（正是要修的症状）。因此媒体事件
  * 携带一个 **outcome promise**：装配器立刻知道「本 turn 还有 in-flight 下载」，

package/dist/inbound/event.js

@@ -1,7 +1,7 @@
 /**
  * 装配器事件（设计依据见 `docs/zh/architecture/inbound-unified-input-design.md`）。
  *
- * 设计文档早期的媒体事件形态是「下载完成后的 attachments/failures」。实际链路里
+ * 早期的媒体事件形态是「下载完成后的 attachments/failures」。实际链路里
  * 下载是异步的（`index.ts` 先过 owner/enabled 闸门再下载），若等下载完成才投递事件，
  * 「先图后文」在慢下载下会先提交一个只含文本的 turn（正是要修的症状）。因此媒体事件
  * 携带一个 **outcome promise**：装配器立刻知道「本 turn 还有 in-flight 下载」，

package/dist/inbound/placeholder.d.ts

@@ -1,7 +1,7 @@
 /**
  * 入站消息结构占位符识别与剥离（纯函数，无 IO，便于表驱动测试）。
  *
- * 背景（P0 事故 2026-09-15）：`@larksuite/channel` 把非文本消息渲染成结构占位符，
+ * 背景（事故 2026-09-15）：`@larksuite/channel` 把非文本消息渲染成结构占位符，
  * 富文本（`post`）里的图片是 `![image](img_v3_…)` —— 首字符恰好是 `!`，于是被
  * `src/router/index.ts` 的裸前缀判定当成 bash 命令执行了整段消息。
  *
@@ -12,7 +12,7 @@
  * 取舍（有意为之）：剥离对所有消息生效，所以用户在**纯文本**消息里手打
  * `![image](…)` / `<file key="…"/>` 这类字面量也会被当成占位符剥掉。代价是极少数
  * 「讨论本工具自身语法」的消息会丢片段；换来的是任何入口都不可能把占位符当命令
- * （P0 事故正是 `![image](img_v3_…)` 的首字符 `!` 命中 bash 判定）。
+ * （事故正是 `![image](img_v3_…)` 的首字符 `!` 命中 bash 判定）。
  */
 export type PlaceholderKind = 'image' | 'file' | 'video' | 'audio' | 'sticker' | 'share' | 'location' | 'folder' | 'vote' | 'todo' | 'meeting' | 'calendar' | 'hongbao' | 'forwarded' | 'unsupported' | 'unknown';
 export interface StripResult {

package/dist/inbound/placeholder.js

@@ -1,7 +1,7 @@
 /**
  * 入站消息结构占位符识别与剥离（纯函数，无 IO，便于表驱动测试）。
  *
- * 背景（P0 事故 2026-09-15）：`@larksuite/channel` 把非文本消息渲染成结构占位符，
+ * 背景（事故 2026-09-15）：`@larksuite/channel` 把非文本消息渲染成结构占位符，
  * 富文本（`post`）里的图片是 `![image](img_v3_…)` —— 首字符恰好是 `!`，于是被
  * `src/router/index.ts` 的裸前缀判定当成 bash 命令执行了整段消息。
  *
@@ -12,7 +12,7 @@
  * 取舍（有意为之）：剥离对所有消息生效，所以用户在**纯文本**消息里手打
  * `![image](…)` / `<file key="…"/>` 这类字面量也会被当成占位符剥掉。代价是极少数
  * 「讨论本工具自身语法」的消息会丢片段；换来的是任何入口都不可能把占位符当命令
- * （P0 事故正是 `![image](img_v3_…)` 的首字符 `!` 命中 bash 判定）。
+ * （事故正是 `![image](img_v3_…)` 的首字符 `!` 命中 bash 判定）。
  */
 /**
  * 可下载资源类占位符：这些占位符对应的资源会由媒体通道下载落盘，

package/dist/inbound/receipt.d.ts

@@ -1,5 +1,5 @@
 /**
- * 入站回执文案（设计依据见 `docs/zh/architecture/inbound-unified-input-design.md`）。
+ * 入站回执文案（`inbound-unified-input-design.md` §5.7）。
  *
  * 两类回执合并成一条：
  * 1. 无文本纯附件（决策 2）：不自动起 turn，只回已保存路径 + 引导语；
@@ -10,8 +10,6 @@
  */
 import type { PlaceholderKind } from './placeholder.js';
 import type { RejectedItem } from './turn.js';
-/** 单条回执最多列出的文件数；超出折叠为 "… 等 N 个文件"（沿用旧提示口径）。 */
-export declare const MAX_PATHS_IN_RECEIPT = 10;
 /** 「不支持」回执句式（§5.7 表：不支持类型统一「暂不支持 X」）。 */
 export declare function unsupportedReason(kind: PlaceholderKind): string;
 export interface ReceiptInput {

package/dist/inbound/receipt.js

@@ -1,5 +1,5 @@
 /**
- * 入站回执文案（设计依据见 `docs/zh/architecture/inbound-unified-input-design.md`）。
+ * 入站回执文案（`inbound-unified-input-design.md` §5.7）。
  *
  * 两类回执合并成一条：
  * 1. 无文本纯附件（决策 2）：不自动起 turn，只回已保存路径 + 引导语；
@@ -10,7 +10,7 @@
  */
 import path from 'node:path';
 /** 单条回执最多列出的文件数；超出折叠为 "… 等 N 个文件"（沿用旧提示口径）。 */
-export const MAX_PATHS_IN_RECEIPT = 10;
+const MAX_PATHS_IN_RECEIPT = 10;
 /** 占位符种类 → 面向人的名称。 */
 const PLACEHOLDER_LABELS = {
     image: '图片',

package/dist/inbound/turn-assembler.d.ts

@@ -1,7 +1,7 @@
 /**
  * InboundTurnAssembler：统一静默期窗口 + 合并 + 下载等待 + commit。
  *
- * 设计依据：`docs/zh/architecture/inbound-unified-input-design.md` §4/§5.2。
+ * 设计依据：`docs/zh/architecture/inbound-unified-input-design.md` §4、§5.2。
  *
  * 规则：
  * - 任何事件到达 → **重置** 700ms 定时器（按 `userId:chatId` 分桶），保证图/文任意顺序等价；
@@ -13,8 +13,6 @@
  */
 import type { InboundEvent } from './event.js';
 import { type CommitReason, type InboundTurn } from './turn.js';
-/** 统一静默期窗口（ms）——决策 1：不做「纯文本零延迟」快路径。 */
-export declare const DEFAULT_TURN_WINDOW_MS = 700;
 export interface AssemblerContext {
     userId: string;
     chatId: string;

package/dist/inbound/turn-assembler.js

@@ -1,7 +1,7 @@
 /**
  * InboundTurnAssembler：统一静默期窗口 + 合并 + 下载等待 + commit。
  *
- * 设计依据：`docs/zh/architecture/inbound-unified-input-design.md` §4/§5.2。
+ * 设计依据：`docs/zh/architecture/inbound-unified-input-design.md` §4、§5.2。
  *
  * 规则：
  * - 任何事件到达 → **重置** 700ms 定时器（按 `userId:chatId` 分桶），保证图/文任意顺序等价；
@@ -17,7 +17,7 @@ import { buildPrompt } from './prompt.js';
 import { buildReceipt, unsupportedReason } from './receipt.js';
 import { bucketKey, } from './turn.js';
 /** 统一静默期窗口（ms）——决策 1：不做「纯文本零延迟」快路径。 */
-export const DEFAULT_TURN_WINDOW_MS = 700;
+const DEFAULT_TURN_WINDOW_MS = 700;
 export class InboundTurnAssembler {
     deps;
     buckets = new Map();

package/dist/index.js

@@ -9,7 +9,7 @@ import { probeAllAgents } from './runner/probe.js';
 import { warmCodexCatalogCache } from './config/codex-config.js';
 import { SessionReaderRegistry, SessionStore } from './session/index.js';
 import { ClaudeSessionReader, CodexSessionReader, OpencodeSessionReader, PiSessionReader, KimiSessionReader, DshSessionReader, } from './session/index.js';
-import { CommandRouter, isImmediateAction, DIRECT_RETURN_CMDS, } from './router/index.js';
+import { CommandRouter, isImmediateAction, DIRECT_RETURN_CMDS, SESSION_MUTATING_ACTION_CMDS, } from './router/index.js';
 import { dispatchOrderExecForQueue } from './router/order-exec-dispatch.js';
 import { buildCardActionFullValue } from './router/card-action-payload.js';
 import { actionFeedbackText } from './router/card-action-feedback.js';
@@ -22,7 +22,7 @@ import { InstanceAlreadyRunningError, InstanceLock } from './instance-lock.js';
 import { spawnReplacementBridge, waitForPreviousInstance } from './restart.js';
 import { currentPlatform } from './platform/select.js';
 import { startSleepBlocker } from './platform/sleep-blocker.js';
-import { checkLatestVersion, isNewer, runInstallLatest, formatUpdateHint } from './update/index.js';
+import { checkLatestVersion, compareVersions, runInstallLatest, formatUpdateHint, } from './update/index.js';
 import { classifyRejection } from './error-classification.js';
 import { WorkspaceStore } from './workspace/index.js';
 import { InboundTurnAssembler } from './inbound/turn-assembler.js';
@@ -31,7 +31,7 @@ import { buildSessionHistoryCard } from './router/card-helpers.js';
 import { newSessionButton, resumeCompactButton, agentDisplayName } from './card/card-shared.js';
 import path from 'node:path';
 import fs from 'node:fs';
-import { silentlyUnlink } from './common/fs.js';
+import { bestEffortUnlink } from './common/fs.js';
 /**
  * /stop 命令别名单源：普通消息的停止分支与 clone 活跃期拦截的排除条件
  * 共用同一判定，防止将来加别名时两处漂移。
@@ -133,10 +133,10 @@ async function setupInstanceLockAndHandlers(instanceLock, logger, configDir) {
 /** Initialize per-workspace runner factory + agent registry. */
 function initializeRunner(config, configDir, cliArgs) {
     const agentRegistry = new AgentRegistry();
-    // W2.10 单点化：runner factory 取最新 config 的唯一入口（P1-15 语义保持，
+    // 单点化：runner factory 取最新 config 的唯一入口（语义保持，
     // container 未接线时回退启动快照）。
     const latest = () => agentRegistry.getConfigContainer()?.current ?? config;
-    // P1-15: Claude factory reads from configContainer (not closure) so runtime
+    // Claude factory reads from configContainer (not closure) so runtime
     // config changes (model, effort, stopGraceMs) take effect after
     // bridge.setConfig() + clearRunners(). Same pattern as codex/pi/kimi.
     agentRegistry.register('claude', (ws) => {
@@ -147,7 +147,7 @@ function initializeRunner(config, configDir, cliArgs) {
             stopGraceMs: claudeConfig.stopGraceMs,
             settings: cliArgs.settings,
             pidDir: configDir,
-            workspace: ws,
+            cwd: ws,
             permissionMode: claudeConfig.permissionMode,
             idleTtlMs: claudeConfig.idleTtlMinutes != null ? claudeConfig.idleTtlMinutes * 60_000 : undefined,
         });
@@ -228,7 +228,7 @@ function initializeRunner(config, configDir, cliArgs) {
                 .split(',')
                 .map((t) => t.trim())
                 .filter(Boolean),
-            workspace: ws,
+            cwd: ws,
             sessionReader: piSessionReader,
         });
     });
@@ -256,7 +256,7 @@ function initializeRunner(config, configDir, cliArgs) {
     // Register DshRunner (HTTP-only DSH Web Host agent) and DshSessionReader.
     const dshSessionReader = new DshSessionReader({
         // hostProvider 每次调用读最新 config：/config 修改 host 后 runner 重建为
-        // 新 host，reader（/resume、用量、完成卡）也跟随新 host（CC-02）。
+        // 新 host，reader（/resume、用量、完成卡）也跟随新 host。
         hostProvider: () => getAgentConfig(latest(), 'dsh')?.host,
     });
     agentRegistry.register('dsh', (_ws) => {
@@ -308,7 +308,7 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
     // 附件路径统一注入 prompt；无文本纯附件只回执（决策 2）。
     const assembler = new InboundTurnAssembler({
         onCommit: (turn, prompt) => {
-            // 入队时刻（T0）快照 workspace + agent/session 绑定，语义与旧路径一致
+            // 入队时刻快照 cwd + agent/session 绑定，语义与旧路径一致
             // （排队期间 /cd、/config 不再导致语义漂移）。
             const messageId = turn.messageIds[turn.messageIds.length - 1] ?? '';
             // turnMessageIds：终态收尾要覆盖本轮每一条消息（逐条挂的 Typing 得逐条撤）
@@ -318,17 +318,17 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
                 messageId,
                 turnMessageIds: turn.messageIds,
             };
-            let workspace = sessionStore.getCwd(turn.userId) ?? '';
-            if (!workspace && workspaceStore) {
+            let cwd = sessionStore.getCwd(turn.userId) ?? '';
+            if (!cwd && workspaceStore) {
                 const workspaces = workspaceStore.list();
                 if (workspaces.length > 0)
-                    workspace = workspaces[0].path;
+                    cwd = workspaces[0].path;
             }
             const binding = bridge.currentBinding(turn.userId);
-            bridge.enqueue(workspace, async () => {
+            bridge.enqueue(cwd, async () => {
                 // allowCommandPrefix: false —— prompt 已剥离占位符，绝不再做命令分发。
                 await router.handle(prompt, ctx, {
-                    cwdOverride: workspace,
+                    cwdOverride: cwd,
                     binding,
                     allowCommandPrefix: false,
                 });
@@ -347,7 +347,7 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
         },
     });
     router.setInboundFlusher(() => assembler.flushAll('flush'));
-    // 入站媒体（图片/文件/视频/语音/表情）：先认证后下载（P1 review 修复）。
+    // 入站媒体（图片/文件/视频/语音/表情）：先认证后下载（修复）。
     // connector 只上报"媒体到达"，这里先过 owner + enabled 闸门，通过后才
     // 下载——未认证/关闭配置时不会发生任何网络下载或内存/磁盘占用。
     // 下载是异步的：立刻把在途 promise 交给装配器（`kind: 'media'`），
@@ -358,9 +358,9 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
             return;
         }
         // 读 router.config（活引用）：/config 保存后 setConfigValues 返回新对象，
-        // 启动时捕获的 config 参数会过期（P2 review 修复）。
+        // 启动时捕获的 config 参数会过期（修复）。
         if (!router.config.inboundMedia.enabled) {
-            // 不静默（P3 review）：关闭时给 owner 明确反馈，避免发图后无任何反应。
+            // 不静默：关闭时给 owner 明确反馈，避免发图后无任何反应。
             // 不下载、不落盘，只进 rejected（随 turn 回执一起发出）。
             assembler.ingest({
                 kind: 'rejected',
@@ -386,7 +386,7 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
                 // save() 的正常路径会清理临时文件；这里兜底 save 进入 mkdir
                 // try 之前意外抛错的情况，避免 os.tmpdir 残留。
                 for (const item of payload.media) {
-                    silentlyUnlink(item.tempPath);
+                    bestEffortUnlink(item.tempPath);
                 }
                 throw err;
             }
@@ -402,8 +402,8 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
         });
     });
     connector.setMessageHandler((msg) => {
-        // 绑定/授权闸门：仅 owner 放行；非 owner 静默丢弃；未绑定时首条消息（任意内容）认领
-        const decision = binder.classify(msg.userId, msg.content, msg.chatId);
+        // 绑定/授权闸门：仅 owner 放行；非 owner 静默丢弃；未绑定时首条消息认领
+        const decision = binder.authorize(msg.userId, msg.chatId);
         if (decision.kind === 'rejected')
             return;
         if (decision.kind === 'bind_success') {
@@ -562,11 +562,19 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
             return;
         }
         const isImmediate = isImmediateAction(actionValue.cmd);
-        const workspace = sessionStore.getCwd(userId) ?? '';
+        const cwd = sessionStore.getCwd(userId) ?? '';
         // Build full value object — spread all fields from actionValue, then merge
         // component out-of-band fields (option/formValue/inputValue/options) where
         // present. See card-action-payload.ts for the component-type contract.
         const fullValue = buildCardActionFullValue(actionValue, action);
+        // 定序（2026-10-07）：会话 / cwd / agent 变更类卡片动作（new-session、
+        // resume.use、ls.switch、ws.use、config.save）执行前先冲刷入站装配窗口，
+        // 保证窗口内先到的文本消息在本动作之前 commit（绑定旧 session/cwd/agent）。
+        // 否则 700ms 静默窗内的消息会漂移到动作之后的新状态：例如输入「重新构建」
+        // 后立即点「新会话」，消息会落到新会话。名单以 router 单源为准。
+        if (SESSION_MUTATING_ACTION_CMDS.has(actionValue.cmd)) {
+            await assembler.flush(userId, chatId, 'flush');
+        }
         // queue.input / config.save / approval.respond / approval.toggle /
         // approval.answer 系列返回 CardActionResponse toast 给点击用户即时反馈。
         // 必须直接返回值 -- enqueueImmediate / enqueueConfigAction 是
@@ -577,7 +585,7 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
         // order.aliasInput / order.aliasRemove / order.textInput 也返回 toast+card，
         // 需直返避免被吞（order.textInput 曾漏在列表外，编辑卡停留在编辑界面）。
         // approval.planFeedback 同 answer 系列：附意见的 toast 需直返 + 不落串行队列。
-        // W2.1：直返名单以 router 的 DIRECT_RETURN_CMDS 为单一来源（历史注释：
+        // 直返名单以 router 的 DIRECT_RETURN_CMDS 为单一来源（历史注释：
         // order.textInput 曾漏在列表外、answer 家族曾漏在直返列表外——两份拷贝漂移）。
         if (DIRECT_RETURN_CMDS.has(actionValue.cmd)) {
             return router.handleCardAction(fullValue, { userId, chatId, messageId });
@@ -591,13 +599,13 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
             void dispatchOrderExecForQueue({
                 router,
                 bridge,
-                workspace,
+                cwd,
                 orderId: actionValue.orderId,
                 ctx: { userId, chatId, messageId },
             }).catch((err) => logger.error('[control] order.exec dispatch failed:', err));
             return;
         }
-        // B7：非直返命令到这里已经没有回调响应可回（enqueue* 是 fire-and-forget），
+        // 非直返命令到这里已经没有回调响应可回（enqueue* 是 fire-and-forget），
         // handler 返回的 toast 必须显式转成持久文本，否则失败毫无反馈。
         const forwardActionFeedback = (res) => {
             const text = actionFeedbackText(res);
@@ -608,13 +616,13 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
                 .catch((err) => logger.error('[control] card action feedback failed:', err));
         };
         if (isImmediate) {
-            bridge.enqueueImmediate(workspace, async () => {
+            bridge.enqueueImmediate(cwd, async () => {
                 const res = await router.handleCardAction(fullValue, { userId, chatId, messageId });
                 forwardActionFeedback(res);
             });
         }
         else {
-            bridge.enqueue(workspace, async () => {
+            bridge.enqueue(cwd, async () => {
                 const res = await router.handleCardAction(fullValue, { userId, chatId, messageId });
                 forwardActionFeedback(res);
             }, {
@@ -624,7 +632,7 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
                     messageId,
                     messagePreview: `card action: ${actionValue.cmd}`,
                     // Compact 是单向操作，排队卡不允许编辑（编辑预览无意义）。
-                    editable: actionValue.cmd !== 'codex.compact' && actionValue.cmd !== 'resume.compact',
+                    editable: actionValue.cmd !== 'compact' && actionValue.cmd !== 'resume.compact',
                 },
             });
         }
@@ -651,7 +659,7 @@ async function main() {
         initLogger({ dir: path.join(updateConfigDir, 'logs') });
         try {
             const { current, latest } = await checkLatestVersion();
-            if (!isNewer(current, latest)) {
+            if (compareVersions(current, latest) !== 1) {
                 console.log(`Already up to date: ${current}`);
                 process.exit(0);
             }
@@ -699,9 +707,9 @@ async function main() {
         logger.info('[binder] awaiting first binding (any first private message binds)');
     }
     else {
-        logger.info(`[binder] bound to owner openId=${binder.boundOpenId()}`);
+        logger.info(`[binder] bound to owner userId=${binder.boundUserId()}`);
     }
-    const sessionStore = new SessionStore(path.join(configDir, 'last-session.json'), config.defaultAgent);
+    const sessionStore = new SessionStore(path.join(configDir, 'last-session.json'));
     const workspaceStore = new WorkspaceStore(path.join(configDir, 'workspace.json'));
     const bridge = new Bridge({
         connector,

package/dist/instance-lock.js

@@ -17,7 +17,8 @@
  */
 import fs from 'node:fs';
 import path from 'node:path';
-import { silentlyUnlink } from './common/fs.js';
+import { bestEffortUnlink } from './common/fs.js';
+import { isWin32 } from './platform/select.js';
 import { binaryName, verifyPidIdentityVerdict } from './platform/identity.js';
 export class InstanceAlreadyRunningError extends Error {
     pid;
@@ -29,7 +30,7 @@ export class InstanceAlreadyRunningError extends Error {
     }
 }
 /**
- * Probe whether a pid is alive. P2-20:
+ * Probe whether a pid is alive.
  *  - process.kill(pid, 0) returning normally → alive.
  *  - ESRCH (no such process) → dead.
  *  - EPERM (operation not permitted) → the process EXISTS but is owned by
@@ -86,7 +87,7 @@ export class InstanceLock {
                     throw new InstanceAlreadyRunningError(pid, this.lockPath);
                 }
                 // Stale lock: remove and retry once
-                silentlyUnlink(this.lockPath);
+                bestEffortUnlink(this.lockPath);
                 try {
                     const fd = fs.openSync(this.lockPath, 'wx');
                     fs.writeSync(fd, this.lockContents(process.pid));
@@ -114,7 +115,7 @@ export class InstanceLock {
     release() {
         const { pid } = this.readPidAndName();
         if (pid === process.pid) {
-            silentlyUnlink(this.lockPath);
+            bestEffortUnlink(this.lockPath);
         }
     }
     registerExitHandlers() {
@@ -127,14 +128,14 @@ export class InstanceLock {
             this.release();
             process.exit(143);
         });
-        if (process.platform !== 'win32') {
+        if (!isWin32()) {
             process.on('SIGHUP', () => {
                 this.release();
                 process.exit(129);
             });
         }
         else {
-            // win32 无 SIGHUP；CTRL_BREAK 退出前也要释放锁（§3.5，对照 cli.ts 信号转发）
+            // win32 无 SIGHUP；CTRL_BREAK 退出前也要释放锁（对照 cli.ts 信号转发）
             process.on('SIGBREAK', () => {
                 this.release();
                 process.exit(149);
@@ -160,7 +161,7 @@ export class InstanceLock {
         if (Number.isInteger(pid) && pid > 0 && name)
             return { pid, name };
         // Malformed or missing name — treat as corrupt, unlink and return undefined
-        silentlyUnlink(this.lockPath);
+        bestEffortUnlink(this.lockPath);
         return { pid: undefined, name: undefined };
     }
     /**

package/dist/logger/index.d.ts

@@ -35,7 +35,7 @@ export declare class Logger {
     getCurrentLogFile(): string;
     private ensureFile;
     /**
-     * P2-19①: remove daily subdirectories older than the retention window.
+     * remove daily subdirectories older than the retention window.
      * Best-effort — any error is swallowed (logging must never throw).
      */
     private pruneOldDirs;