lark-remote 0.5.6 → 0.5.7

package/dist/card/tool-render.js

@@ -10,7 +10,21 @@
  * like `✅ **Bash** — pwd` so collapsed panels stay informative.
  */
 import { truncate } from '../common/truncate.js';
+import { asRecord, summarizeToolInput } from '../common/tool-summary.js';
+import { truncateMiddleToDisplayWidth } from '../common/text-width.js';
+// 这两个宽度工具原本住在这里；resume 卡片也要用，已下沉到 common。
+export { displayWidth, truncateMiddleToDisplayWidth, truncateToDisplayWidth, } from '../common/text-width.js';
 const HEADER_SUMMARY_MAX = 80;
+/**
+ * 面板标题的显示宽度上限（半角单位，CJK/emoji 记 2）。
+ *
+ * 手机（~390px 内容宽）上折叠面板的标题只有**一行**可用：减去图标与内边距约
+ * 320px，按 ~7.5px/半角算 ≈ 42 个半角宽度（iPhone SE 更窄，超出时按 `·`/空格
+ * 折行仍可读，但不能整段换行）。超过就折行，断点常常落在 URL 或命令
+ * 中间（2026-10-19 截图反馈）。完整参数在展开后的正文里，标题只负责"哪个工具、
+ * 动了什么"，并带上 `HH:mm` 时间戳（一起计入预算）。
+ */
+export const HEADER_DISPLAY_MAX = 42;
 const BODY_FIELD_MAX = 600;
 const OUTPUT_MAX = 1200;
 /**
@@ -27,11 +41,11 @@ const BODY_TOTAL_MAX = 2500;
  *   `✅ **Read** — /repo/a.ts`
  *   `❌ **Grep** — pattern in path`
  */
-export function toolHeaderText(tool) {
+export function toolHeaderText(tool, suffix = '') {
     const icon = tool.status === 'ok' ? '✅' : tool.status === 'error' ? '❌' : '⏳';
     // use the cached parsed record when available (avoids per-render parse).
     const input = tool.parsedInput !== undefined ? tool.parsedInput : tool.input;
-    const summary = summarizeInput(tool.name, input);
+    const summary = summarizeToolInput(tool.name, input);
     // 信息保真 ACP kind 映射后 name 与原始 title 不同时，title 以
     // ` — {summary}` 追加在标题末尾（截断沿用 HEADER_SUMMARY_MAX）。
     // 用 truncate（suffix 为空）而非裸 slice：裸 slice 按 UTF-16 码元切，
@@ -44,9 +58,14 @@ export function toolHeaderText(tool) {
     // `✅ **Bash** — ls` instead of `✅ **Bash** — ls — ls`.
     const parts = [summary, blockSummary].filter(Boolean);
     const uniqueParts = parts.filter((part, i) => parts.indexOf(part) === i);
-    return uniqueParts.length > 0
+    const title = uniqueParts.length > 0
         ? `${icon} **${tool.name}** — ${uniqueParts.join(' — ')}`
         : `${icon} **${tool.name}**`;
+    // 折叠面板的标题必须能在一行内放下（手机窄屏）：超宽就按显示宽度截断，
+    // 完整值仍在展开后的正文里。`suffix`（时间戳）一起计入预算，否则"标题压到
+    // 60 宽 + 18 宽时间戳"在手机上照样折行。
+    // 中间省略：路径/URL 的结尾（文件名）比开头更有信息量。
+    return truncateMiddleToDisplayWidth(`${title}${suffix}`, HEADER_DISPLAY_MAX);
 }
 /**
  * Structured body markdown for a tool call. Renders input fields by tool name
@@ -56,13 +75,14 @@ export function toolHeaderText(tool) {
  * for unknown tools: `default` returns '' and unknown tools only surface their
  * args through the panel header's `summarizeInput` fallback.
  */
-export function toolBodyMd(tool) {
+export function toolBodyMd(tool, opts = {}) {
     const parts = [];
     const inputMd = renderInput(tool);
     if (inputMd)
         parts.push(inputMd);
     if (tool.output) {
-        const truncated = truncate(tool.output, OUTPUT_MAX);
+        const outputMax = Math.min(opts.outputMax ?? OUTPUT_MAX, OUTPUT_MAX);
+        const truncated = truncate(tool.output, outputMax);
         if (tool.status === 'error') {
             parts.push(`**Error**\n\`\`\`\n${truncated}\n\`\`\``);
         }
@@ -79,51 +99,6 @@ export function toolBodyMd(tool) {
     // 同上：走 truncate 保证切点不落在代理对中间（末尾 '…' 由 truncate 附加以对齐预算）。
     return `${truncate(body, BODY_TOTAL_MAX)}\n\n_（body 已截断，完整内容查日志）_`;
 }
-function summarizeInput(name, input) {
-    const rec = asRecord(input);
-    if (!rec)
-        return '';
-    const pick = (key, max = HEADER_SUMMARY_MAX) => {
-        const v = rec[key];
-        if (typeof v !== 'string')
-            return '';
-        const oneLine = v.replace(/\s+/g, ' ').trim();
-        return oneLine.length > max ? `${oneLine.slice(0, max)}…` : oneLine;
-    };
-    switch (name) {
-        case 'Bash':
-        case 'bash':
-            return pick('command');
-        case 'Read':
-        case 'Edit':
-        case 'Write':
-        case 'NotebookEdit':
-        case 'read':
-        case 'edit':
-        case 'write':
-            return pick('file_path') || pick('path');
-        case 'Grep':
-        case 'grep': {
-            const pat = pick('pattern', 40);
-            const p = pick('path', 30);
-            return p ? `${pat} in ${p}` : pat;
-        }
-        case 'Glob':
-        case 'find':
-            return pick('pattern');
-        case 'ls':
-            return pick('path');
-        case 'WebFetch':
-            return pick('url');
-        case 'WebSearch':
-            return pick('query', 60);
-        case 'Agent':
-        case 'Task':
-            return pick('description') || pick('subagent_type');
-        default:
-            return pick('command') || pick('file_path') || pick('path') || pick('query');
-    }
-}
 // --- Named render bodies (shared by tool-name cases and toolHint branches) ---
 function renderBashInput(str) {
     const cmd = str('command');
@@ -155,6 +130,15 @@ function renderWebFetchInput(str) {
 function renderWebSearchInput(str) {
     return str('query') ? `**Query** \`${truncate(str('query'), BODY_FIELD_MAX)}\`` : '';
 }
+/** DSH `web_search` 的批量查询参数（`queries: string[]`）。 */
+function renderWebQueriesInput(queries) {
+    if (!Array.isArray(queries))
+        return '';
+    const items = queries.filter((q) => typeof q === 'string' && q.trim().length > 0);
+    if (items.length === 0)
+        return '';
+    return `**Query** \`${truncate(items.join('` / `'), BODY_FIELD_MAX)}\``;
+}
 function renderInput(tool) {
     // use the cached parsed record when available (avoids per-render parse).
     const input = tool.parsedInput !== undefined ? tool.parsedInput : tool.input;
@@ -180,6 +164,7 @@ function renderInput(tool) {
     switch (tool.name) {
         case 'Bash':
         case 'bash':
+        case 'pwsh':
             return renderBashInput(str);
         case 'Read':
         case 'Edit':
@@ -188,37 +173,26 @@ function renderInput(tool) {
         case 'read':
         case 'edit':
         case 'write':
+        case 'read_image':
             return renderFileInput(str);
         case 'Grep':
         case 'grep':
             return renderGrepInput(str);
         case 'Glob':
+        case 'glob':
         case 'find':
             return renderGlobInput(str);
         case 'ls':
             return renderLsInput(str);
         case 'WebFetch':
+        case 'web_fetch':
             return renderWebFetchInput(str);
         case 'WebSearch':
             return renderWebSearchInput(str);
+        case 'web_search':
+            return renderWebQueriesInput(rec.queries) || renderWebSearchInput(str);
         default:
             return '';
     }
 }
-function asRecord(input) {
-    if (!input)
-        return null;
-    if (typeof input === 'object')
-        return input;
-    if (typeof input === 'string') {
-        try {
-            const p = JSON.parse(input);
-            return p && typeof p === 'object' ? p : null;
-        }
-        catch {
-            return null;
-        }
-    }
-    return null;
-}
 //# sourceMappingURL=tool-render.js.map

package/dist/common/text-width.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 文本的**显示宽度**工具（半角 1 / 全角与 emoji 2）。
+ *
+ * 为什么单列一个模块：卡片标题、状态行、resume 卡片标题都要按"手机上能放几行"
+ * 来收敛，而卡片层（`src/card/`）与会话读取层（`src/session/`）都要用——放在
+ * 任何一侧都会让另一侧反向依赖。
+ */
+/**
+ * 按**显示宽度**截断（半角 1 / 全角与 emoji 2）。
+ *
+ * markdown 的 `**` 与 emoji 都要按视觉宽度算：只按字符数截断时，一行 34 个
+ * CJK 就是 34 个字宽，手机上必然折行。
+ */
+export declare function truncateToDisplayWidth(text: string, maxUnits: number): string;
+/** 字符串的显示宽度（半角 1 / 全角与 emoji 2）。 */
+export declare function displayWidth(text: string): number;
+/**
+ * 中间省略截断：保留开头与结尾，只在中间打 `…`。
+ *
+ * 标题里的路径/URL 必须保留**结尾**才有信息量（`~/code/notes-app/.../notes/
+ * 2026-10-19-vision-remaining.md` 里真正有用的是文件名），尾部省略会把文件名
+ * 整个切掉；纯尾部截断只适合"开头即结论"的句子（命令）。
+ */
+export declare function truncateMiddleToDisplayWidth(text: string, maxUnits: number): string;

package/dist/common/text-width.js

@@ -0,0 +1,93 @@
+/**
+ * 文本的**显示宽度**工具（半角 1 / 全角与 emoji 2）。
+ *
+ * 为什么单列一个模块：卡片标题、状态行、resume 卡片标题都要按"手机上能放几行"
+ * 来收敛，而卡片层（`src/card/`）与会话读取层（`src/session/`）都要用——放在
+ * 任何一侧都会让另一侧反向依赖。
+ */
+/**
+ * 按**显示宽度**截断（半角 1 / 全角与 emoji 2）。
+ *
+ * markdown 的 `**` 与 emoji 都要按视觉宽度算：只按字符数截断时，一行 34 个
+ * CJK 就是 34 个字宽，手机上必然折行。
+ */
+export function truncateToDisplayWidth(text, maxUnits) {
+    if (displayWidth(text) <= maxUnits)
+        return text;
+    let used = 0;
+    let out = '';
+    for (const ch of text) {
+        const w = charWidth(ch);
+        // 预留 1 个单位给省略号
+        if (used + w > maxUnits - 1)
+            break;
+        out += ch;
+        used += w;
+    }
+    return `${out}…`;
+}
+/** 字符串的显示宽度（半角 1 / 全角与 emoji 2）。 */
+export function displayWidth(text) {
+    let total = 0;
+    for (const ch of text)
+        total += charWidth(ch);
+    return total;
+}
+function charWidth(ch) {
+    const code = ch.codePointAt(0) ?? 0;
+    // CJK 统一表意文字、假名、全角标点、常见 emoji 都按两个半角算。
+    if (code >= 0x1100 && (code <= 0x115f || code === 0x2329 || code === 0x232a))
+        return 2;
+    if (code >= 0x2e80 && code <= 0xa4cf)
+        return 2;
+    if (code >= 0xac00 && code <= 0xd7a3)
+        return 2;
+    if (code >= 0xf900 && code <= 0xfaff)
+        return 2;
+    if (code >= 0xfe30 && code <= 0xfe6f)
+        return 2;
+    if (code >= 0xff00 && code <= 0xff60)
+        return 2;
+    if (code >= 0xffe0 && code <= 0xffe6)
+        return 2;
+    if (code >= 0x1f300 && code <= 0x1faff)
+        return 2;
+    if (code >= 0x2600 && code <= 0x27bf)
+        return 2;
+    return 1;
+}
+/**
+ * 中间省略截断：保留开头与结尾，只在中间打 `…`。
+ *
+ * 标题里的路径/URL 必须保留**结尾**才有信息量（`~/code/notes-app/.../notes/
+ * 2026-10-19-vision-remaining.md` 里真正有用的是文件名），尾部省略会把文件名
+ * 整个切掉；纯尾部截断只适合"开头即结论"的句子（命令）。
+ */
+export function truncateMiddleToDisplayWidth(text, maxUnits) {
+    if (displayWidth(text) <= maxUnits)
+        return text;
+    const budget = Math.max(1, maxUnits - 1); // 给省略号留 1 个单位
+    const headBudget = Math.ceil(budget / 2);
+    const tailBudget = budget - headBudget;
+    let head = '';
+    let used = 0;
+    for (const ch of text) {
+        const w = charWidth(ch);
+        if (used + w > headBudget)
+            break;
+        head += ch;
+        used += w;
+    }
+    let tail = '';
+    used = 0;
+    const chars = [...text];
+    for (let i = chars.length - 1; i >= 0; i--) {
+        const w = charWidth(chars[i]);
+        if (used + w > tailBudget)
+            break;
+        tail = chars[i] + tail;
+        used += w;
+    }
+    return `${head}…${tail}`;
+}
+//# sourceMappingURL=text-width.js.map

package/dist/common/tool-summary.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 工具调用参数 → 一行人话摘要（`bash — npm test`、`read — src/a.ts`）。
+ *
+ * 为什么要抽到 common：run 卡的面板标题（`src/card/tool-render.ts`）和
+ * resume 卡的「🔧 工具调用」标题（`src/session/<agent>/sessions.ts`）都要同一套口径；
+ * 各写一份必然漂移（同一个 `glob` 在一处显示 pattern、另一处显示目录）。
+ *
+ * 只做"取哪个字段"，不做 agent 分支：工具名与参数名的对应表就是这张 switch。
+ */
+export declare function asRecord(input: unknown): Record<string, unknown> | null;
+export declare function summarizeToolInput(name: string, input: unknown): string;

package/dist/common/tool-summary.js

@@ -0,0 +1,153 @@
+/**
+ * 工具调用参数 → 一行人话摘要（`bash — npm test`、`read — src/a.ts`）。
+ *
+ * 为什么要抽到 common：run 卡的面板标题（`src/card/tool-render.ts`）和
+ * resume 卡的「🔧 工具调用」标题（`src/session/<agent>/sessions.ts`）都要同一套口径；
+ * 各写一份必然漂移（同一个 `glob` 在一处显示 pattern、另一处显示目录）。
+ *
+ * 只做"取哪个字段"，不做 agent 分支：工具名与参数名的对应表就是这张 switch。
+ */
+import { truncate } from './truncate.js';
+const HEADER_SUMMARY_MAX = 80;
+export function asRecord(input) {
+    if (!input)
+        return null;
+    if (typeof input === 'object')
+        return input;
+    if (typeof input === 'string') {
+        try {
+            const p = JSON.parse(input);
+            return p && typeof p === 'object' ? p : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+export function summarizeToolInput(name, input) {
+    const rec = asRecord(input);
+    if (!rec)
+        return '';
+    const pick = (key, max = HEADER_SUMMARY_MAX) => {
+        const v = rec[key];
+        if (typeof v !== 'string')
+            return '';
+        const oneLine = v.replace(/\s+/g, ' ').trim();
+        return oneLine.length > max ? `${oneLine.slice(0, max)}…` : oneLine;
+    };
+    /** First non-empty of several keys（DSH 同名工具跨版本改过参数名）。 */
+    const pickAny = (keys, max = HEADER_SUMMARY_MAX) => {
+        for (const key of keys) {
+            const v = pick(key, max);
+            if (v)
+                return v;
+        }
+        return '';
+    };
+    /** 数组参数的第一个字符串项（DSH web_search 的 queries、present 的 files）。 */
+    const pickFirst = (key, max = HEADER_SUMMARY_MAX) => {
+        const v = rec[key];
+        if (typeof v === 'string')
+            return pick(key, max);
+        if (!Array.isArray(v))
+            return '';
+        for (const item of v) {
+            if (typeof item === 'string' && item.trim()) {
+                const oneLine = item.replace(/\s+/g, ' ').trim();
+                return oneLine.length > max ? `${oneLine.slice(0, max)}…` : oneLine;
+            }
+            if (item && typeof item === 'object') {
+                const path = item.path;
+                if (typeof path === 'string' && path.trim())
+                    return path;
+            }
+        }
+        return '';
+    };
+    switch (name) {
+        case 'Bash':
+        case 'bash':
+        case 'pwsh':
+            return pick('command');
+        case 'Read':
+        case 'Edit':
+        case 'Write':
+        case 'NotebookEdit':
+        case 'read':
+        case 'edit':
+        case 'write':
+        case 'read_image':
+            return pick('file_path') || pick('path');
+        case 'Grep':
+        case 'grep': {
+            const pat = pick('pattern', 40);
+            const p = pick('path', 30);
+            return p ? `${pat} in ${p}` : pat;
+        }
+        case 'Glob':
+        case 'glob':
+        case 'find':
+            return pick('pattern');
+        case 'ls':
+            return pick('path');
+        case 'WebFetch':
+        case 'web_fetch':
+            return pick('url');
+        case 'WebSearch':
+        case 'web_search':
+            return pickFirst('queries', 60) || pick('query', 60);
+        case 'Agent':
+        case 'Task':
+        case 'subagent':
+        case 'workflow':
+            return pick('description') || pick('subagent_type');
+        case 'todo_write':
+            return summarizeTodos(rec);
+        case 'job_output':
+        case 'job_kill':
+            return pick('job_id');
+        case 'job_list':
+            return '（列出任务）';
+        case 'present':
+            return pickFirst('files');
+        case 'skill':
+            return pick('name');
+        case 'run_code':
+            return pick('description') || pick('language');
+        case 'terminal_send':
+            return pick('text');
+        case 'ask_user_question': {
+            const questions = rec.questions;
+            return Array.isArray(questions) ? `${questions.length} 个问题` : '';
+        }
+        case 'send_message':
+        case 'interrupt_agent':
+            return pick('description') || pick('agent_id');
+        default:
+            return pickAny(['command', 'file_path', 'path', 'query', 'url']);
+    }
+}
+/** todo_write 摘要：完成进度 + 当前 in_progress 项主题。 */
+function summarizeTodos(rec) {
+    const todos = rec.todos;
+    if (!Array.isArray(todos))
+        return '';
+    let done = 0;
+    let active = '';
+    for (const item of todos) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const todo = item;
+        if (todo.status === 'completed')
+            done += 1;
+        if (!active && todo.status === 'in_progress' && typeof todo.content === 'string') {
+            active = todo.content.replace(/\s+/g, ' ').trim();
+        }
+    }
+    const progress = `${done}/${todos.length}`;
+    if (!active)
+        return `已完成 ${progress}`;
+    return truncate(`已完成 ${progress} · ${active}`, HEADER_SUMMARY_MAX, { suffix: '…' });
+}
+//# sourceMappingURL=tool-summary.js.map

package/dist/config/index.d.ts

@@ -28,7 +28,7 @@ export declare const DEFAULT_TURN_IDLE_TIMEOUT_MINUTES: 30;
  * 单文件上限默认 100MB：50MB 对视频偏小（2026-09-15 事故就是 mp4 被丢弃）。
  * 注意飞书侧 `type=file` 超过 100MB 必须用 Range 分片下载，而 SDK 的
  * `downloadResourceToFile` 不分片（必报 234037），所以 100 是实际可用上限
- * （inbound-message-matrix.md §4.4）。
+ * （inbound-message-matrix.md §4 第 4 条）。
  */
 export declare const DEFAULT_INBOUND_MEDIA_DIR_NAME = ".lark-remote-temp";
 export declare const DEFAULT_INBOUND_MEDIA_MAX_SIZE_MB = 100;

package/dist/config/index.js

@@ -56,7 +56,7 @@ export const DEFAULT_TURN_IDLE_TIMEOUT_MINUTES = DEFAULTS.TURN_IDLE_TIMEOUT_MINU
  * 单文件上限默认 100MB：50MB 对视频偏小（2026-09-15 事故就是 mp4 被丢弃）。
  * 注意飞书侧 `type=file` 超过 100MB 必须用 Range 分片下载，而 SDK 的
  * `downloadResourceToFile` 不分片（必报 234037），所以 100 是实际可用上限
- * （inbound-message-matrix.md §4.4）。
+ * （inbound-message-matrix.md §4 第 4 条）。
  */
 export const DEFAULT_INBOUND_MEDIA_DIR_NAME = '.lark-remote-temp';
 export const DEFAULT_INBOUND_MEDIA_MAX_SIZE_MB = 100;

package/dist/connector/index.js

@@ -424,7 +424,7 @@ export class FeishuConnector {
                         kind: res.kind,
                         fileName: res.fileName,
                         // 飞书侧 >100MB 必须 Range 分片（SDK 不分片），到上限就是下不动：
-                        // 提示写清楚，避免用户以为"再放大上限就能存"（matrix §4.4/§2 #11）。
+                        // 提示写清楚，避免用户以为"再放大上限就能存"（inbound-message-matrix.md §4 第 4 条）。
                         reason: `超过 ${limitMb}MB 大小限制` +
                             (limitMb >= 100 ? '（飞书 >100MB 的文件需分片下载，暂不支持）' : ''),
                     });

package/dist/index.js

@@ -11,6 +11,8 @@ import { SessionReaderRegistry, SessionStore } from './session/index.js';
 import { ClaudeSessionReader, CodexSessionReader, OpencodeSessionReader, PiSessionReader, KimiSessionReader, DshSessionReader, } from './session/index.js';
 import { CommandRouter, isImmediateAction, DIRECT_RETURN_CMDS, SESSION_MUTATING_ACTION_CMDS, COMPACT_ACTION_CMDS, } from './router/index.js';
 import { DshDaemon } from './runner/dsh/daemon.js';
+import { DshClient } from './runner/dsh/client.js';
+import { DshInflightStore, dshInflightPath, reconcileInflightDshRuns, } from './runner/dsh/inflight.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';
@@ -29,7 +31,7 @@ import { WorkspaceStore } from './workspace/index.js';
 import { InboundTurnAssembler } from './inbound/turn-assembler.js';
 import { InboundAuthorizer } from './inbound/authorize.js';
 import { stripPlaceholders } from './inbound/placeholder.js';
-import { buildSessionHistoryCard } from './router/card-helpers.js';
+import { buildSessionHistoryCard, pickResumeCardEvents } from './router/card-helpers.js';
 import { newSessionButton, resumeCompactButton, agentDisplayName } from './card/card-shared.js';
 import path from 'node:path';
 import fs from 'node:fs';
@@ -43,16 +45,18 @@ function isStopCommand(text) {
     return t === '/stop' || t === '/t';
 }
 /** Send auto-resume card for a restored session */
-async function sendAutoResumeCard(connector, contact, cwd, session, state, compactSupported = false) {
+async function sendAutoResumeCard(connector, contact, cwd, session, state, compactSupported = false, stillRunning = false) {
     if (!contact.userId)
         return;
     const recipient = contact.chatId ?? contact.userId;
     if (!recipient)
         return;
-    // Limit history events to prevent card size exceeded error (11310)
+    // Limit history events to prevent card size exceeded error (11310).
+    // 窗口按"最后 N 条"截，但强制保住最后一条用户消息与最后一条 assistant 正文，
+    // 否则工具往返会把它俩一起挤出卡（2026-10-19 恢复卡只剩 5 个 bash 面板）。
     const MAX_HISTORY_EVENTS = 5;
-    const eventsToShow = state.events.slice(-MAX_HISTORY_EVENTS);
-    const hiddenCount = state.events.length - MAX_HISTORY_EVENTS;
+    const eventsToShow = pickResumeCardEvents(state.events, MAX_HISTORY_EVENTS);
+    const hiddenCount = state.events.length - eventsToShow.length;
     // Action buttons: Compact (runCompact-capable runner) + new session.
     const agentKind = state.agentKind ?? 'claude';
     const actionButtons = [];
@@ -73,6 +77,7 @@ async function sendAutoResumeCard(connector, contact, cwd, session, state, compa
         headerText: `📂 \`${cwd}\`\n已恢复最近会话: **${session.sessionId}**`,
         title: `🔁 自动恢复会话 · ${agentDisplayName(agentKind)}`,
         hiddenCount,
+        stillRunning,
         actions: actionButtons,
     });
     await connector.sendWithRetry(recipient, { card });
@@ -300,6 +305,9 @@ function initializeRunner(config, configDir, cliArgs) {
             provider: dshConf?.provider,
             model: dshConf?.model,
             reasoningEffort: dshConf?.reasoningEffort,
+            // Durable markers for turns that outlive this process; reconciled on the
+            // next startup (see reconcileInflightDshRuns).
+            inflightPath: dshInflightPath(configDir),
         });
     });
     sessionReaderRegistry.register('dsh', dshSessionReader);
@@ -834,6 +842,33 @@ async function main() {
             })();
         }
     }
+    // 上次进程可能死在 DSH turn 中途：清掉残留的待执行 prompt，并对仍在跑的
+    // turn 提示 owner（不自动 cancel——它可能是 Web UI 的 turn）。清理不依赖是否
+    // 已绑定；没有收件人时只是不发提示。
+    const dshConf = getAgentConfig(config, 'dsh');
+    if (dshConf) {
+        const contact = startupContactStore.getContact();
+        const recipient = contact?.chatId ?? contact?.userId;
+        void reconcileInflightDshRuns({
+            store: new DshInflightStore(dshInflightPath(configDir)),
+            client: new DshClient(dshConf.host ?? 'http://127.0.0.1:3080', {
+                dshHome: dshConf.dshHome,
+                token: dshConf.token,
+                credentialsFile: dshConf.credentialsFile,
+                // Host may be down: bound the probe instead of waiting the default 60s.
+                requestTimeoutMs: 3_000,
+            }),
+            ...(recipient
+                ? {
+                    notify: async (text) => {
+                        await connector.sendWithRetry(recipient, { text });
+                    },
+                }
+                : {}),
+        }).catch((err) => {
+            logger.warn(`[startup] dsh inflight reconcile failed: ${err.message}`);
+        });
+    }
     // Auto-restore: resume the persisted sessionId if available
     const restoredContact = startupContactStore.getContact();
     if (restoredContact?.userId) {
@@ -845,6 +880,26 @@ async function main() {
                 const startupReader = sessionReaderRegistry.get(config.defaultAgent);
                 sessionStore.setSessionIdAndCwd(restoredContact.userId, config.defaultAgent, sessionIdToResume, restoredCwd);
                 const content = startupReader.readSessionContent(sessionIdToResume, restoredCwd);
+                // 该会话可能仍有在途 turn（上一个实例退出/崩溃后留在常驻 host 里）。
+                // 不取消、不接管，但必须在卡上说明，否则用户会把它当"卡住了"。
+                //
+                // 只有 DSH reader 的 isSessionActive() 是服务端的 running 事实。其他
+                // reader 的同名方法只表示"最近一段时间有写入"，拿它当 turn 在跑会在
+                // 每次自动恢复时误报。
+                const stillRunning = config.defaultAgent === 'dsh'
+                    ? (() => {
+                        try {
+                            return startupReader.isSessionActive(sessionIdToResume, restoredCwd);
+                        }
+                        catch (err) {
+                            getLogger().warn(`[startup] isSessionActive failed: ${err.message}`);
+                            return false;
+                        }
+                    })()
+                    : false;
+                if (stillRunning) {
+                    getLogger().warn(`[startup] session ${sessionIdToResume} still has a running turn; auto-resume card is a snapshot`);
+                }
                 // 完整透传 usage（含 inputTokens/outputTokens/totalTokens），
                 // 让 formatUsageStats 走真实值路径，与终态卡片//resume 卡片口径一致。
                 const usage = content.usage;
@@ -862,7 +917,7 @@ async function main() {
                         agentKind: config.defaultAgent,
                     }, 
                     // Compact 能力探测与 bridge 侧一致（runner 有 runCompact 才渲染）。
-                    bridge.hasRunCompact(restoredCwd, config.defaultAgent));
+                    bridge.hasRunCompact(restoredCwd, config.defaultAgent), stillRunning);
                 }
                 catch (err) {
                     getLogger().warn('[startup] sendAutoResumeCard failed:', err);

package/dist/platform/command.js

@@ -5,7 +5,7 @@
  * 自更新安装源检测 update/install.ts）。**执行**统一走 platform/spawn.ts 的
  * cross-spawn 包装（PATHEXT 解析 + .cmd 经 cmd.exe 受控执行），本模块不再
  * 解析 .cmd/.bat 垫片内容——垫片格式是 npm/pnpm 的上游实现细节（历史变过、
- * pnpm 生成形态不同），手写解析器等于耦合该细节（v2 §4.2）。
+ * pnpm 生成形态不同），手写解析器等于耦合该细节。
  *
  * posix：PATH 目录顺序 + X_OK（现状语义迁移）。
  * win32：PATH 目录顺序 × PATHEXT(.exe/.cmd/.bat) 解析，.cmd 命中即报告垫片

package/dist/platform/shell.d.ts

@@ -8,7 +8,7 @@
  *   由调用方转成明确错误卡（提示需要 Git Bash）。
  *
  * kimi ACP 的 terminal/create 固定 `bash -c`，因此 Git Bash 不是 `!` 的专属
- * 需求，而是 kimi agent 在 Windows 上可用的前置条件（§4.4）。
+ * 需求，而是 kimi agent 在 Windows 上可用的前置条件。
  */
 import type { ChildProcess, SpawnOptions } from 'node:child_process';
 import { type ResolveOptions, type LaunchSpec } from './command.js';
@@ -31,7 +31,7 @@ export interface ShellBackend {
      * - posix：原样透传（与迁移前 `spawnProcess(command, args, ...)` 逐字一致）；
      * - win32：首 token 是 shell（bash/sh/zsh/dash）时按 Git Bash 解析，缺失则抛
      *   {@link ShellUnavailableError}——kimi agent 在 Windows 上可用的前置条件
-     *   （§4.4）。其余命令交给 cross-spawn 做 PATH/PATHEXT 解析，不做命令翻译。
+     *   。其余命令交给 cross-spawn 做 PATH/PATHEXT 解析，不做命令翻译。
      */
     spawnArgv(file: string, args: readonly string[], opts?: {
         cwd?: string;

package/dist/platform/spawn.d.ts

@@ -35,7 +35,7 @@ export declare function mergeProcessEnv(base?: NodeJS.ProcessEnv, overrides?: No
  */
 export declare function useDetachedProcessGroup(platform?: NodeJS.Platform): boolean;
 /**
- * win32 command-not-found 行嗅探（§4.4）：命中即视为「命令缺失」失败而非
+ * win32 command-not-found 行嗅探：命中即视为「命令缺失」失败而非
  * 普通非零退出。platform 注入使其在任意宿主可测。
  */
 export declare function isWindowsCommandNotFoundLine(line: string, platform?: NodeJS.Platform): boolean;