lark-remote 0.5.10 → 0.5.13

package/CHANGELOG.md

@@ -5,6 +5,55 @@ 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.5.13] - 2026-10-26
+
+### 修复
+
+- **长回合的最终回答不再被进度内容挤掉**：工具输出、思考、通知此前与最终回答共用同一份卡片预算，回合越长越容易把回答截断甚至整段挤没。现在最终回答独立保存，不受进度文本窗口和工具块上限淘汰；终态渲染先排状态、审批与操作控件，再放完整回答，剩余空间才从新到旧回填进度内容。协议带 `final_answer` 标记的（Codex app-server）直接采用，没有标记的 agent 在收尾时把最后一条非空 assistant 文本提升为最终回答，Claude、opencode、Kimi、Pi、DSH 共用同一套保护
+- **回答放不下时随后补发完整文本**：单张卡片连「最终回答 + 必要控件」都装不下时，原卡提示「最终回答较长，完整内容已随后发送」，完整回答按 UTF-8 字节边界拆成多条纯文本消息补发（优先落在换行处，单条上限 20000 字节），拼接后与原文逐字一致，不再静默截断；补发失败会在原卡给出「完整回答补发失败」的可见回执
+
+### 维护
+
+- **入口与路由/桥接层拆分为独立模块**：消息入站装配、命令实现（`ls` / `order` / `resume` / `ws`）、分页与路径校验、审批转发、用量聚合、会话回写、DSH 多路复用流各自成模块，`src/index.ts`、`src/bridge/index.ts`、`src/router/index.ts` 只保留编排职责；同时为拆分中暴露的状态竞争（中断与自然结束并发写同一张卡的终态、审批重投递、bash 卡片收尾）补上回归用例。无行为变化
+
+## [0.5.12] - 2026-10-24
+
+### 修复
+
+- **Bash 工具结果不再偶发丢失**：kimi 的终端子进程退出后，runner 会等 stdout 尾部 flush（最多 200ms）再推 Bash 输出；但 `terminal/wait_for_exit` 此前在 flush 之前就返回，服务端拿到响应后立即 release 并结束回合，回合结果可能先于延迟推送的 tool_result 到达，卡片上的 Bash 面板变成空输出。现在 wait_for_exit 在 tool_result 入队后才返回，保证输出先于回合结束送达
+
+### 维护
+
+- **测试同步原语收紧**：pid 文件改为等完整内容再读（避免读到空串后把 0 当 PID 轮询进程组）；kimi 压缩完成用例改由 mock server 在收到 prompt 后延迟落记录，消除并行负载下的假红。无行为变化
+
+## [0.5.11] - 2026-10-24
+
+### 修复
+
+- **审批卡在超长或超量输入下不再整卡消失**：审批理由、题面、选项、文件变更等 agent 产出的文本此前没有上限，一条超长理由（实测 3 万字符）或 8 题 × 5 选项就能把卡片顶出字节/元素预算，被飞书整卡拒收——审批彻底不可见，回合只能挂到超时。现在自由文本按字节截断、题数/选项/变更条目按渲染上限折叠，最底层兜底卡改用紧凑审批区：审批按钮在任何降级档都保留
+- **停止 bash 任务后卡片稳定显示「已手动终止」**：停止路径与自然收尾会并发写同一张卡的终态，后写者胜出；现在首个终态胜出，不再被随后的「执行失败」覆盖
+- **内容审核截断后的自动续跑接回本轮会话**：续跑此前用入队时的会话快照，新会话第一条消息被截断时会落到一个全新的空会话，本轮上下文全部丢失；现在按卡片状态 → 运行中会话 → 起点快照三级取本轮实际使用的会话
+- **DSH 停止后残留的排队 prompt 不再被下一个回合隐形执行**：服务端 cancel 不会清空 inbox，被停的 prompt 可能仍留在里面等下一个无人订阅的 turn 认领（耗 token、改工作区、卡片不可见）。现在 cancel 确认关闭后补一次撤回探测，确认不在或撤回成功才清在途标记；退出路径的 cancel 走同一收尾
+- **DSH 断线重连后的历史缺口会回填**：重连快照按消息截取，断连期间积压超过 200 条消息时快照首条会越过上次游标，中间的运行事件此前对本次订阅永久缺失。现在用 `session/page` 的游标向前翻页补齐（最多 20×200 条）；尾部是用户消息时事件探测返回 `unknown`，不再误报「已停止」
+- **pi 会话切换后旧连接不再误杀新回合**：`/new`、`/resume` 切换会替换连接，旧连接迟到的关闭/事件此前会被推进新回合的共享队列，导致新消息未发出即丢失或新回合空转「成功」。现在连接回调带轮次代际锚点，非当前轮的迟到回调直接丢弃
+- **上下文占用统计包含末轮输出**：统一口径改为「输入 + 输出 + 缓存读 + 缓存写」，与文档和压缩水位一致；长收尾回合不再系统性低估数千到数万 token
+- **会话列表不再把 subagent 子会话当成父会话**：codex 按 id 读取与列表/active 同口径过滤子线程；kimi 的工作目录判定改用同路径比较，大小写或尾分隔符差异不再让会话从列表消失
+- **配置 YAML 语法错误不再静默退出**：与配置校验失败同路径在终端输出原因并退出，而不是零输出地无声退出
+- **工作区兜底与路径竞态收紧**：没有当前目录时取「最近使用」的工作区而不是最早保存的别名；`/cd`、`ls.switch`、`/ws use` 的目录检查补 TOCTOU 防护，路径在检查与使用之间被删时给出明确回复而不是静默失败
+- **只有 chatId 的旧绑定记录可以重新认领**：这类记录此前会让所有消息被静默拒绝且永远无法重新绑定，现在视为未绑定，任意首条私聊可重新认领
+- **卡片动作不再被在途媒体下载卡住**：会话变更类卡片动作执行前的入站冲刷改为 2 秒有界等待，大文件下载在途时点「新会话」不再让整个聊天停摆到下载超时；clone 引导期间到达的附件直接忽略，不再落盘或与引导话术冲突
+- **`job.kill` 等纯远程操作立即执行**：终态卡上的「停止后台任务」不再排进串行队列等当前 run 结束
+- **显式清空的模型配置重启后不再被旧选择填回**：`/config` 里清空模型/服务商等于回到默认，残留的旧选择不会再把它填回去
+- **其他可靠性修复**：实例锁改为先写完整临时文件再原子链接，消除并发启动时的空文件窗口；pi 大上下文压缩不再受 60 秒请求超时影响；kimi 非终态的空工具结果不再把运行中的工具提前标成完成；DSH 会话读取遇到单条畸形事件只跳过该条，不再整张恢复卡变空；JSONL 流按字节边界解码，中文/emoji 被 chunk 切开时不再出现乱码
+
+### 安全
+
+- **退出时取消 DSH 回合的凭据临时文件不再可预测**：此前把短时 cookie 写到 `<tmpdir>/lark-remote-exit-cancel-<pid>.hdr`，同机其他用户可预建软链把凭据引到自己可读的文件。现在写入仅本人可进入的随机 0700 临时目录、文件 0600，正常结束与异常路径都会清理
+
+### 变更
+
+- **架构文档同步**：last-session 允许 cwd 缺失、两处终端直写豁免、标题显示宽度常量、DSH follow 快照与事件落盘顺序，中英两侧一致
+
 ## [0.5.10] - 2026-10-24
 
 ### 修复
@@ -524,8 +573,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### 修复
 
 - `displayTitle`/`summary` 跳过 task-notification 注入
-- 修复 `scanClaudeSessions` 对迁移到其他目录的会话的遗漏（S2）
-- 修复 probe 生命周期、工厂回退、卡片回调等评审发现的问题（F1-F8）
+- 修复 `scanClaudeSessions` 对迁移到其他目录的会话的遗漏
+- 修复 probe 生命周期、工厂回退、卡片回调等问题
 
 ### 变更
 

package/README.en.md

@@ -14,19 +14,6 @@ Designed for a single-user, peer-to-peer private chat. The agent's system prompt
 
 > **New here? Start with [docs/en/getting-started.md](docs/en/getting-started.md).**
 
-## ⚠️ Security Warning (read first)
-
-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; note that since kimi 0.40, `yolo` means Ask-When-Needed rather than allow-everything — use `auto` for fully unattended, no-approval execution); 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 approval mode (Claude, Codex, Kimi), an approval card arrives before a command runs — approve or reject it right in Feishu:
-
-![Command approval card example](docs/images/approval-card.png)
-
 ## Prerequisites
 
 - OS: macOS / Linux / Windows 10+ (native Windows support is verified on real hardware, with behavior matching macOS/Linux)
@@ -70,7 +57,7 @@ defaultAgent: claude
 claude:
   model: claude-opus-4-8
   effort: medium            # low | medium | high | xhigh | max
-  permissionMode: bypassPermissions  # Claude official --permission-mode: default | acceptEdits | auto | bypassPermissions | manual | dontAsk | plan (switchable via /config card; anything other than bypassPermissions enables approval)
+  permissionMode: auto  # Claude official --permission-mode: default | acceptEdits | auto | bypassPermissions | manual | dontAsk | plan (switchable via /config card; auto is the default: low-risk actions run, high-risk actions ask)
   stopGraceMs: 5000
 
 logging:

package/README.md

@@ -14,19 +14,6 @@
 
 > **第一次接触本项目？先看 [docs/zh/getting-started.md](docs/zh/getting-started.md)。**
 
-## ⚠️ 安全警告（必读）
-
-本工具会把飞书消息直接转为本地 agent 执行。**开箱默认是不弹审批的**：Claude 默认以 `bypassPermissions` 运行（无审批卡），但该权限模式**可配置**——把它改成 `bypassPermissions` 以外的值（`default` / `acceptEdits` / `auto` / `dontAsk` / `plan`）即启用交互式审批，高风险操作会在飞书卡片上等你确认；Codex 采用 **app-server 审批模式**（默认 `approvalPolicy=on-request`，执行命令需在飞书卡片上确认，沙箱默认 `workspace-write`）；Kimi 默认 `manual`（逐条审批；注意 kimi 0.40+ 起 `yolo` 已改为「必要时询问」而非全部放行，要完全不弹审批需选 `auto`）；其他 agent 以各自 CLI 的默认权限运行。**无论哪种模式**，agent 都能读写你指定的本地目录，请务必：
-
-- **仅限你自己的私聊（p2p）使用**。不要把机器人拉进任何群聊，不要让任何其他人能与它对话。
-- 在飞书开放平台把应用可见范围限制到**只有你自己**。
-- 运行本工具的机器上不要存放与损失承受力不符的数据；建议在独立用户/机器/容器里运行。
-- `appSecret` 等凭据只在本地 `config.yaml`，**不要提交到任何仓库**。
-
-审批模式下（Claude、Codex、Kimi），执行命令前会收到审批卡片，可直接在飞书里允许或拒绝：
-
-![命令审批卡片示例](docs/images/approval-card.png)
-
 ## 前置条件
 
 - 操作系统：macOS / Linux / Windows 10+（原生 Windows 支持已完成真机验证，行为与 macOS/Linux 对齐）
@@ -70,7 +57,7 @@ defaultAgent: claude
 claude:
   model: claude-opus-4-8
   effort: medium            # low | medium | high | xhigh | max
-  permissionMode: bypassPermissions  # Claude 官方 --permission-mode：default | acceptEdits | auto | bypassPermissions | manual | dontAsk | plan（`/config` 卡片可切换；非 bypassPermissions 会启用审批）
+  permissionMode: auto  # Claude 官方 --permission-mode：default | acceptEdits | auto | bypassPermissions | manual | dontAsk | plan（`/config` 卡片可切换；auto 为默认：低风险放行、高风险审批）
   stopGraceMs: 5000
 
 logging:

package/dist/binder.js

@@ -44,7 +44,13 @@ export class OwnerBinder {
      */
     authorize(userId, chatId) {
         const bound = this.store.getContact();
-        if (bound) {
+        // 只有 chatId 没有 userId 的记录（老版本写入/手改文件）视同未绑定：
+        // bound.userId === undefined 时任何真实 openId 都判不等，一切消息被
+        // 静默 rejected 且永远无法重新认领——用户只能靠文档提示删文件。
+        if (bound && bound.userId === undefined) {
+            getLogger().warn('[binder] startup contact has chatId but no userId; treating as unbound (re-claimable)');
+        }
+        else if (bound) {
             if (userId === bound.userId)
                 return { kind: 'owner' };
             this.rejectedTotal++;

package/dist/bridge/approval-coordinator.d.ts

@@ -179,6 +179,7 @@ export declare class ApprovalCoordinator {
     /** 记录问题答案到 tracked.answers（懒初始化 Map）。 */
     private recordAnswer;
     private getPendingQuestion;
+    private getPendingQuestionAt;
     private allQuestionsAnswered;
     /** 推送审批卡视图更新（approval_view_updated 重渲染；失败仅记日志）。 */
     private pushApprovalViewUpdate;

package/dist/bridge/approval-coordinator.js

@@ -178,12 +178,7 @@ export class ApprovalCoordinator {
      *   submitAnswers() 显式提交。
      */
     async toggleAnswer(action, ctx) {
-        const tracked = this.getPendingQuestion(ctx.requestId);
-        const questions = tracked.view.questions;
-        const q = questions[action.questionIndex];
-        if (!q) {
-            throw new Error(`Question ${action.questionIndex} not found in request ${ctx.requestId}`);
-        }
+        const { tracked, question: q } = this.getPendingQuestionAt(ctx.requestId, action.questionIndex);
         const option = q.options.find((o) => o.label === action.option);
         if (!option) {
             throw new Error(`Option "${action.option}" not found in question ${action.questionIndex}`);
@@ -217,12 +212,7 @@ export class ApprovalCoordinator {
      * 提交该问题当前勾选的选项；全部问题答完时通过 responder 提交。
      */
     async submitAnswers(action, ctx) {
-        const tracked = this.getPendingQuestion(ctx.requestId);
-        const questions = tracked.view.questions;
-        const q = questions[action.questionIndex];
-        if (!q) {
-            throw new Error(`Question ${action.questionIndex} not found in request ${ctx.requestId}`);
-        }
+        const { tracked, question: q } = this.getPendingQuestionAt(ctx.requestId, action.questionIndex);
         if (!q.multiSelect) {
             throw new Error('该问题为单选，请直接点击选项');
         }
@@ -240,12 +230,7 @@ export class ApprovalCoordinator {
      * 单选问题的答案。与单选 toggle 同语义：全部问题答完自动提交。
      */
     async answerCustom(action, ctx) {
-        const tracked = this.getPendingQuestion(ctx.requestId);
-        const questions = tracked.view.questions;
-        const q = questions[action.questionIndex];
-        if (!q) {
-            throw new Error(`Question ${action.questionIndex} not found in request ${ctx.requestId}`);
-        }
+        const { tracked, question: q } = this.getPendingQuestionAt(ctx.requestId, action.questionIndex);
         if (q.multiSelect) {
             throw new Error('自定义答案仅支持单选');
         }
@@ -266,12 +251,7 @@ export class ApprovalCoordinator {
      * 后回流视图（卡片回显），同一请求可多次修改（新 nonce 来自新渲染）。
      */
     async answerNote(action, ctx) {
-        const tracked = this.getPendingQuestion(ctx.requestId);
-        const questions = tracked.view.questions;
-        const q = questions[action.questionIndex];
-        if (!q) {
-            throw new Error(`Question ${action.questionIndex} not found in request ${ctx.requestId}`);
-        }
+        const { tracked, question: q } = this.getPendingQuestionAt(ctx.requestId, action.questionIndex);
         const text = action.text.trim();
         if (!text) {
             throw new Error('请输入补充说明');
@@ -443,6 +423,14 @@ export class ApprovalCoordinator {
         }
         return tracked;
     }
+    getPendingQuestionAt(requestId, questionIndex) {
+        const tracked = this.getPendingQuestion(requestId);
+        const question = tracked.view.questions?.[questionIndex];
+        if (!question) {
+            throw new Error(`Question ${questionIndex} not found in request ${requestId}`);
+        }
+        return { tracked, question };
+    }
     allQuestionsAnswered(tracked) {
         const questions = tracked.view.questions ?? [];
         if (questions.length === 0)

package/dist/bridge/index.d.ts

@@ -369,6 +369,12 @@ export declare class Bridge {
     private interruptActiveRun;
     /** Send a result message to the user (§7). Returns true on success, false on failure. */
     sendResult(result: CommandResult, ctx: CommandContext): Promise<boolean>;
+    /**
+     * Deliver a final answer that cannot fit in the run card. Plain text avoids
+     * markdown parser limits and preserves every character; sequence labels make
+     * multi-message delivery unambiguous.
+     */
+    private sendFinalAnswerOverflow;
     /**
      * Update an existing card in place (原地更新) instead of sending a new one.
      *
@@ -567,6 +573,7 @@ export declare class Bridge {
         text: string;
         nonce: string;
     }): Promise<void>;
+    private dispatchQuestionAction;
     /**
      * 记下一次「可压缩 run」：终态卡上的 Compact 按钮点击时据此反查
      * sessionId + agentKind。runId 是按钮自带的唯一键，同 cwd 内唯一。