deepseeker-code 1.0.47 → 1.0.49

package/README.md

@@ -139,6 +139,8 @@ DeepSeeker-Code 支持三种配置来源，优先级 **环境变量 > config.jso
 | `DEEP_SEEK_REASONING_EFFORT` | 推理强度，仅 `high` / `max` | `high` |
 | `DEEP_SEEK_THINKING` | 深度思考开关，设 `0` 关闭 | 开 |
 | `DEEP_SEEK_STREAM_IDLE_TIMEOUT_MS` | 流式 idle 超时（ms） | `120000` |
+| `DEEP_SEEK_VISION` | 视觉多模态开关，设 `1`/`true` 开启（开启后聊天支持贴图附件） | 关 |
+| `DEEP_SEEK_IMAGE_TOKENS` | 单张图片折算 token 数（下限 100） | `1500` |
 
 #### 产品行为
 
@@ -148,6 +150,7 @@ DeepSeeker-Code 支持三种配置来源，优先级 **环境变量 > config.jso
 | `DEEP_SEEK_PARALLEL_SAFE_TOOLS` | 设 `0` 关闭同轮只读工具并发（默认开） | 开（并发） |
 | `DEEP_SEEK_WORKFLOW_CONCURRENCY` | run_workflow 子 agent 并发上限 | `4` |
 | `DEEP_SEEK_WORKFLOW_MAX_STEPS` | run_workflow 单次步数上限 | `8` |
+| `RUN_COMMAND_AUTO_BG_MS` | run_command 前台超时自动转后台阈值（ms）；到期进程收编进后台注册表返回 task_id，不杀进程 | `120000` |
 | `SEARCH_PROVIDER` | 搜索后端 `tavily` / `bing` / `ddg` | 自动（有 Tavily key 用 Tavily，否则 Bing） |
 | `TAVILY_API_KEY` | Tavily 搜索密钥 | — |
 | `WEB_FETCH_ALLOW_PRIVATE` | 设 `1` 放行 web_fetch 访问内网/回环（云元数据端点仍硬拦） | 关（SSRF 安全） |

package/dist/cli.mjs

@@ -423,6 +423,12 @@ var init_config = __esm({
       /** 后台工具（isSync:false）兜底超时（ms）：超时强制收尾释放互斥锁，防 generator 卡死导致锁永久泄漏。
        *  abort 仍是主取消通道，此值仅作最后防线；默认 30min 远超合理后台任务时长，正常任务不受影响。 */
       MAX_BACKGROUND_TOOL_MS: 30 * 60 * 1e3,
+      /** ★ run_command 运行时看门狗（自动转后台阈值 ms）：前台流式超过此时长仍未退出 → 进程自动收编进
+       *  后台任务注册表并返回 task_id（get_background_output / stop_background_task 接管），不再阻塞主循环、
+       *  也不杀进程。与内部空闲看门狗（RUN_COMMAND_IDLE_TIMEOUT_MS，默认 60s）共用降级路径。
+       *  env RUN_COMMAND_AUTO_BG_MS 覆盖。勿把 IDLE 调到高于 DEEP_SEEK_STREAM_IDLE_TIMEOUT_MS
+       *  （空闲分支到期会产出降级消息喂流，不会饿死 collectToolResult 的 idle 熔断）。 */
+      runCommandAutoBgMs: Number(process.env.RUN_COMMAND_AUTO_BG_MS) || 12e4,
       userWorkspaceDir: (() => {
         let cwd = process.cwd().replace(/\\/g, "/");
         if (/^[a-z]:/i.test(cwd)) {
@@ -506,6 +512,7 @@ var init_config = __esm({
       parallelSafeTools: "DEEP_SEEK_PARALLEL_SAFE_TOOLS",
       workflowConcurrency: "DEEP_SEEK_WORKFLOW_CONCURRENCY",
       workflowMaxSteps: "DEEP_SEEK_WORKFLOW_MAX_STEPS",
+      runCommandAutoBgMs: "RUN_COMMAND_AUTO_BG_MS",
       planEnforcement: "DEEP_SEEK_PLAN_ENFORCEMENT",
       mcpExposeMode: "DEEP_SEEK_MCP_EXPOSE_MODE",
       transcriptEvents: "DEEP_SEEK_TRANSCRIPT_EVENTS",
@@ -659,7 +666,7 @@ ${body}`;
       const oldBody = next?.index !== void 0 ? after.slice(0, next.index) : after;
       if (oldBody === `
 ${body}`) return;
-      console.warn(`\u26A0\uFE0F ${fence} \u5DF2\u9501\u5B9A\uFF08\u4F1A\u8BDD\u5185\u4E0D\u53D8\u4EE5\u4FDD\u524D\u7F00\u7F13\u5B58\uFF09\uFF0C\u5185\u5BB9\u53D8\u5316\u5C06\u4E8E\u4E0B\u4E2A\u65B0\u4F1A\u8BDD\u751F\u6548\u3002`);
+      console.warn(`\u26A0\uFE0F ${fence} \u5DF2\u9501\u5B9A\uFF08run \u5185\u4E0D\u53D8\u4EE5\u4FDD\u524D\u7F00\u7F13\u5B58\uFF09\uFF0C\u5185\u5BB9\u53D8\u5316\u5C06\u4E8E\u4E0B\u8F6E\u91CD\u5EFA message[0] \u65F6\u751F\u6548\u3002`);
     };
     decodeProcessOutput = (buf) => {
       const utf8 = buf.toString("utf8");
@@ -973,11 +980,96 @@ var init_deepseek = __esm({
   }
 });
 
+// ../core/src/session/contentParts.ts
+var MAX_IMAGE_BYTES, msgText, imageUrlsOf, hasImagePart, isVisionEnabled, estimateImageTokens, toWireUserContent, replaceImageParts, collapseToText, degradeImagesForAux;
+var init_contentParts = __esm({
+  "../core/src/session/contentParts.ts"() {
+    "use strict";
+    MAX_IMAGE_BYTES = 8 * 1024 * 1024;
+    msgText = (content) => {
+      if (typeof content === "string") return content;
+      if (Array.isArray(content)) {
+        return content.filter((p) => typeof p?.text === "string").map((p) => p.text).join(" ");
+      }
+      return "";
+    };
+    imageUrlsOf = (content) => {
+      if (!Array.isArray(content)) return [];
+      return content.filter((p) => p?.type === "image_url" && typeof p?.image_url?.url === "string").map((p) => p.image_url.url);
+    };
+    hasImagePart = (content) => imageUrlsOf(content).length > 0;
+    isVisionEnabled = () => {
+      const v = process.env.DEEP_SEEK_VISION;
+      return v === "1" || v === "true";
+    };
+    estimateImageTokens = () => {
+      const n = Number(process.env.DEEP_SEEK_IMAGE_TOKENS);
+      return Number.isFinite(n) && n >= 100 ? Math.floor(n) : 1500;
+    };
+    toWireUserContent = (text, attachments) => {
+      if (!Array.isArray(attachments) || attachments.length === 0) return text;
+      const accepted = [];
+      const skipped = [];
+      for (const a of attachments) {
+        const name = typeof a?.name === "string" && a.name.trim() ? a.name : "image";
+        const b64 = typeof a?.base64 === "string" ? a.base64 : "";
+        if (!b64) {
+          skipped.push(`\u{1F5BC} \u56FE\u7247 ${name} \u5DF2\u5FFD\u7565\uFF1A\u7A7A\u6570\u636E`);
+          continue;
+        }
+        if (!/^image\//.test(a?.mime || "")) {
+          skipped.push(`\u{1F5BC} \u56FE\u7247 ${name} \u5DF2\u5FFD\u7565\uFF1A\u975E\u56FE\u7247\u7C7B\u578B`);
+          continue;
+        }
+        if (b64.length * 3 / 4 > MAX_IMAGE_BYTES) {
+          skipped.push(`\u{1F5BC} \u56FE\u7247 ${name} \u5DF2\u5FFD\u7565\uFF1A\u8D85\u8FC7 ${Math.round(MAX_IMAGE_BYTES / 1024 / 1024)}MB \u4E0A\u9650`);
+          continue;
+        }
+        accepted.push({ name, url: `data:${a.mime};base64,${b64}` });
+      }
+      const labels = accepted.map((p) => `\u{1F5BC} [\u56FE\u7247: ${p.name}]`);
+      const footer = [...skipped, ...labels];
+      const finalText = footer.length ? `${text}
+
+${footer.join("\n")}` : text;
+      if (accepted.length === 0) return finalText;
+      const parts = [
+        { type: "text", text: finalText },
+        ...accepted.map((p) => ({ type: "image_url", image_url: { url: p.url } }))
+      ];
+      return parts;
+    };
+    replaceImageParts = (m, note) => {
+      if (!m || !Array.isArray(m.content)) return m;
+      let touched = false;
+      const parts = m.content.map((p) => {
+        if (p?.type === "image_url") {
+          touched = true;
+          return { type: "text", text: note };
+        }
+        return p;
+      });
+      if (!touched) return m;
+      return { ...m, content: parts };
+    };
+    collapseToText = (m, imageNote) => {
+      if (!m || !Array.isArray(m.content)) return m;
+      const text = msgText(m.content);
+      if (imageNote && hasImagePart(m.content)) {
+        return { ...m, content: text ? `${text} ${imageNote}` : imageNote };
+      }
+      return { ...m, content: text };
+    };
+    degradeImagesForAux = (m) => collapseToText(m, "[\u56FE\u7247\u5DF2\u5F52\u6863]");
+  }
+});
+
 // ../core/src/llm/providers/replay/index.ts
 var createReplayProvider;
 var init_replay = __esm({
   "../core/src/llm/providers/replay/index.ts"() {
     "use strict";
+    init_contentParts();
     createReplayProvider = (script) => {
       const turns = Array.isArray(script.turns) ? script.turns : [];
       let cursor = 0;
@@ -1095,6 +1187,7 @@ var isCjkCodePoint, estimateTextTokens, estimateTokens, cleanMsg, groupUnits, sp
 var init_contextCore = __esm({
   "../core/src/session/contextCore.ts"() {
     "use strict";
+    init_contentParts();
     isCjkCodePoint = (c) => c >= 19968 && c <= 40959 || // CJK 统一表意文字（基本区）
     c >= 13312 && c <= 19903 || // CJK 扩展 A
     c >= 12352 && c <= 12543 || // 日文假名（平假名 + 片假名）
@@ -1117,8 +1210,14 @@ var init_contextCore = __esm({
     estimateTokens = (messagesArr) => {
       return messagesArr.reduce((total, m) => {
         let pureText = "";
+        let imageCount = 0;
         if (m.content) {
-          pureText += typeof m.content === "string" ? m.content : JSON.stringify(m.content);
+          if (typeof m.content === "string") {
+            pureText += m.content;
+          } else if (Array.isArray(m.content)) {
+            pureText += msgText(m.content);
+            imageCount += imageUrlsOf(m.content).length;
+          }
         }
         if (m.tool_calls && Array.isArray(m.tool_calls)) {
           for (const call of m.tool_calls) {
@@ -1134,7 +1233,7 @@ var init_contextCore = __esm({
           }
         }
         const isStructured = m.role === "tool" || Array.isArray(m.tool_calls) && m.tool_calls.length > 0;
-        const tokens = estimateTextTokens(pureText, isStructured ? 4 : 4.8) + 4;
+        const tokens = estimateTextTokens(pureText, isStructured ? 4 : 4.8) + imageCount * estimateImageTokens() + 4;
         return total + (isNaN(tokens) ? 0 : tokens);
       }, 0);
     };
@@ -1242,6 +1341,7 @@ var init_store = __esm({
     "use strict";
     init_config();
     init_common();
+    init_contentParts();
     getSessionsDirPath = (mainSessionId) => {
       assertSafeSessionId(mainSessionId);
       const fileName = getFileName(mainSessionId);
@@ -1406,8 +1506,8 @@ var init_store = __esm({
             }
             if (typeof msg?.dscEvent === "string") continue;
             messageCount++;
-            if (!preview && msg?.role === "user" && typeof msg.content === "string") {
-              const t = msg.content.replace(/\s+/g, " ").trim();
+            if (!preview && msg?.role === "user" && msg.content != null) {
+              const t = (msgText(msg.content) || "\uFF08\u8BE5\u6761\u6D88\u606F\u5E26\u56FE\u7247\u9644\u4EF6\uFF09").replace(/\s+/g, " ").trim();
               if (t.includes("\uFFFD")) {
                 const cleaned = t.replace(/\uFFFD+/g, "").trim();
                 preview = cleaned ? `\uFF08\u542B\u4E71\u7801\u7247\u6BB5\uFF09${cleaned}` : "\uFF08\u8BE5\u6761\u6D88\u606F\u5185\u5BB9\u4E3A\u4E71\u7801\uFF0C\u65E0\u6CD5\u6B63\u5E38\u663E\u793A\uFF09";
@@ -1838,6 +1938,7 @@ var init_truncate = __esm({
     init_config();
     init_model();
     init_contextCore();
+    init_contentParts();
     init_store();
     init_transcript();
     init_hooks();
@@ -1904,7 +2005,8 @@ ${tail}`;
     };
     compactBatch = async (batch, signal) => {
       const resp = await chatWithModelWithSummary(
-        [...batch, { role: "user", content: '\u7528\u4E00\u884C\u8BDD\u6982\u62EC\u4EE5\u4E0A\u5BF9\u8BDD\u4E0E\u5DE5\u5177\u8C03\u7528\uFF1A\u4EFB\u52A1\u76EE\u6807\u3001\u5173\u952E\u51B3\u7B56\u3001\u52A8\u8FC7\u7684\u6587\u4EF6\u3001\u5F53\u524D\u8FDB\u5EA6\u3002\u5FC5\u987B\u539F\u6837\u4FDD\u7559\u5173\u952E\u5B9E\u4F53\u540D\uFF08\u6587\u4EF6\u8DEF\u5F84\u3001\u51FD\u6570/\u7C7B\u540D\u3001\u62A5\u9519\u5173\u952E\u8BCD\uFF09\u4EE5\u4FBF\u540E\u7EED\u68C0\u7D22\u3002\u5BF9\u8BB0\u4E0D\u51C6\u7684\u7EC6\u8282\u4E0D\u8981\u81C6\u6D4B\uFF0C\u6807\u6CE8"(\u7EC6\u8282\u5DF2\u5F52\u6863)"\u5373\u53EF\u3002\u4E0D\u8981\u8C03\u7528\u5DE5\u5177\u3002' }],
+        // ★ 辅助模型是 text-only：送前把 image part 降级为占位符——base64 绝不能进摘要批（烧钱且无意义）
+        [...batch.map(degradeImagesForAux), { role: "user", content: '\u7528\u4E00\u884C\u8BDD\u6982\u62EC\u4EE5\u4E0A\u5BF9\u8BDD\u4E0E\u5DE5\u5177\u8C03\u7528\uFF1A\u4EFB\u52A1\u76EE\u6807\u3001\u5173\u952E\u51B3\u7B56\u3001\u52A8\u8FC7\u7684\u6587\u4EF6\u3001\u5F53\u524D\u8FDB\u5EA6\u3002\u5FC5\u987B\u539F\u6837\u4FDD\u7559\u5173\u952E\u5B9E\u4F53\u540D\uFF08\u6587\u4EF6\u8DEF\u5F84\u3001\u51FD\u6570/\u7C7B\u540D\u3001\u62A5\u9519\u5173\u952E\u8BCD\uFF09\u4EE5\u4FBF\u540E\u7EED\u68C0\u7D22\u3002\u5BF9\u8BB0\u4E0D\u51C6\u7684\u7EC6\u8282\u4E0D\u8981\u81C6\u6D4B\uFF0C\u6807\u6CE8"(\u7EC6\u8282\u5DF2\u5F52\u6863)"\u5373\u53EF\u3002\u4E0D\u8981\u8C03\u7528\u5DE5\u5177\u3002' }],
         [],
         { signal }
       );
@@ -1915,7 +2017,7 @@ ${tail}`;
     extractArchiveEntities = (batch) => {
       let text = "";
       for (const m of batch) {
-        if (m.content) text += ` ${typeof m.content === "string" ? m.content : JSON.stringify(m.content)}`;
+        if (m.content) text += ` ${msgText(m.content)}`;
         const calls = m.tool_calls;
         if (Array.isArray(calls)) for (const c of calls) text += ` ${c?.function?.name ?? ""} ${c?.function?.arguments ?? ""}`;
       }
@@ -2702,7 +2804,7 @@ async function killBackgroundTasksUnder(dirPath) {
   }
   return killed;
 }
-var _winShellCache, resolveWinShell, MAX_BUFFER_CHARS, registry, backgroundTools, killAllBackgroundTasks;
+var _winShellCache, resolveWinShell, MAX_BUFFER_CHARS, registry, createBgTask, attachTaskLifecycle, adoptRunningProcess, backgroundTools, killAllBackgroundTasks;
 var init_background = __esm({
   "../core/src/tool/registry/background.ts"() {
     "use strict";
@@ -2743,12 +2845,110 @@ var init_background = __esm({
     };
     MAX_BUFFER_CHARS = 1e5;
     registry = /* @__PURE__ */ new Map();
+    createBgTask = (proc, command, cwd, sessionId) => {
+      const task = {
+        taskId: createUUID(),
+        command,
+        cwd,
+        sessionId: sessionId ?? "",
+        proc,
+        startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        status: "running",
+        exitCode: null,
+        outputBuffer: ""
+      };
+      registry.set(task.taskId, task);
+      return task;
+    };
+    attachTaskLifecycle = (task, proc, opts = {}) => {
+      return new Promise((resolve) => {
+        let finished = false;
+        const finish = (apply) => {
+          if (finished) return;
+          finished = true;
+          apply();
+          setTimeout(() => registry.delete(task.taskId), 6e4);
+          opts.signal?.removeEventListener("abort", onAbort);
+          try {
+            proc?.stdout?.removeAllListeners?.();
+          } catch {
+          }
+          try {
+            proc?.stderr?.removeAllListeners?.();
+          } catch {
+          }
+          try {
+            proc?.removeAllListeners?.();
+          } catch {
+          }
+          resolve();
+        };
+        const onAbort = () => {
+          killTree(proc).finally(() => {
+            finish(() => {
+              if (task.status === "running") task.status = "killed";
+              task.exitCode = task.exitCode ?? -1;
+              appendOutput(task, `
+[\u7528\u6237\u4E2D\u6B62\uFF0C\u8FDB\u7A0B\u6811\u5DF2\u7EC8\u6B62]`);
+            });
+          });
+        };
+        opts.signal?.addEventListener("abort", onAbort, { once: true });
+        proc.on("close", (code) => {
+          finish(() => {
+            if (opts.codec) {
+              try {
+                appendOutput(task, opts.codec.flush());
+              } catch {
+              }
+            }
+            task.status = task.status === "killed" ? "killed" : "exited";
+            task.exitCode ??= code ?? 0;
+            appendOutput(task, `
+[\u8FDB\u7A0B\u7ED3\u675F exit=${code}]`);
+          });
+        });
+        proc.on("error", (e) => {
+          finish(() => {
+            if (task.status === "running") task.status = "exited";
+            task.exitCode = task.exitCode ?? -1;
+            appendOutput(task, `
+[spawn error: ${e.message}]`);
+          });
+        });
+      });
+    };
+    adoptRunningProcess = (proc, meta, seedOutput, codec) => {
+      const task = createBgTask(proc, meta.command, meta.cwd, meta.sessionId);
+      if (seedOutput) appendOutput(task, seedOutput);
+      try {
+        proc?.stdout?.removeAllListeners?.("data");
+      } catch {
+      }
+      try {
+        proc?.stderr?.removeAllListeners?.("data");
+      } catch {
+      }
+      try {
+        proc?.removeAllListeners?.("close");
+      } catch {
+      }
+      try {
+        proc?.removeAllListeners?.("error");
+      } catch {
+      }
+      const onData = (d) => appendOutput(task, codec.decode(d));
+      proc.stdout?.on("data", onData);
+      proc.stderr?.on("data", onData);
+      void attachTaskLifecycle(task, proc, { signal: meta.signal, codec });
+      return task.taskId;
+    };
     backgroundTools = [
       {
         type: "function",
         function: {
           name: "run_in_background",
-          description: "\u5728\u540E\u53F0\u542F\u52A8\u4E00\u4E2A\u957F\u8FDE\u63A5/\u5E38\u9A7B shell \u547D\u4EE4\uFF08\u5982 dev server\u3001watch\u3001tail -f\uFF09\uFF0C\u7ACB\u5373\u8FD4\u56DE task_id\uFF0C\u4E0D\u963B\u585E\u540E\u7EED\u63A8\u7406\u3002\u5E38\u7528\u4E8E\u5148\u8D77\u670D\u52A1\u518D\u7EE7\u7EED\u5E72\u522B\u7684\u6D3B\u3002\u7528 get_background_output \u67E5\u65E5\u5FD7\u4E0E\u72B6\u6001\uFF0Cstop_background_task \u7EC8\u6B62\u3002",
+          description: "\u5728\u540E\u53F0\u542F\u52A8\u4E00\u4E2A\u957F\u65F6 shell \u547D\u4EE4\u5E76\u7ACB\u5373\u8FD4\u56DE task_id\uFF0C\u4E0D\u963B\u585E\u540E\u7EED\u63A8\u7406\u3002\u9002\u7528\u4E24\u7C7B\u573A\u666F\uFF1A\u2460 \u957F\u8FDE\u63A5/\u5E38\u9A7B\u8FDB\u7A0B\uFF08dev server\u3001watch\u3001tail -f\uFF09\u2014\u2014\u5148\u8D77\u670D\u52A1\u518D\u7EE7\u7EED\u5E72\u522B\u7684\u6D3B\uFF1B\u2461 \u9884\u8BA1\u8FD0\u884C\u6570\u5206\u949F\u4EE5\u4E0A\u3001\u65E0\u9700\u5B9E\u65F6\u76EF\u770B\u7684\u6709\u9650\u957F\u4EFB\u52A1\uFF08\u5168\u91CF\u6D4B\u8BD5 / \u5927\u6784\u5EFA / \u5927\u4F53\u79EF\u5B89\u88C5\u2014\u2014\u8DD1\u5B8C\u7528 get_background_output \u5E26 wait_seconds \u7B49\u7ED3\u679C\uFF0C\u4E0D\u8981\u7528\u524D\u53F0 run_command \u5E72\u7B49\uFF09\u3002\u7528 get_background_output \u67E5\u65E5\u5FD7\u4E0E\u72B6\u6001\uFF0Cstop_background_task \u7EC8\u6B62\u3002",
           parameters: {
             type: "object",
             properties: {
@@ -2798,75 +2998,25 @@ var init_background = __esm({
               yield `\u274C [\u540E\u53F0\u542F\u52A8\u5931\u8D25]\uFF1A${e.message}`;
               return;
             }
-            const taskId = createUUID();
-            const task = {
-              taskId,
-              command: args.command,
-              cwd,
-              sessionId: ctx?.sessionId ?? "",
-              proc,
-              startedAt: (/* @__PURE__ */ new Date()).toISOString(),
-              status: "running",
-              exitCode: null,
-              outputBuffer: ""
+            const codec = {
+              decode: decodeChunk,
+              // flush：close 时收尾两个 stream 解码器的尾字节（GBK/UTF-8 残留，不 flush 丢最后一个字符）
+              flush: () => {
+                let s = "";
+                if (decoder) s += decoder.decode();
+                s += pendingUtf8.decode();
+                return s;
+              }
             };
-            registry.set(taskId, task);
-            proc.stdout?.on("data", (d) => appendOutput(task, decodeChunk(d)));
-            proc.stderr?.on("data", (d) => appendOutput(task, decodeChunk(d)));
+            const task = createBgTask(proc, args.command, cwd, ctx?.sessionId);
+            const taskId = task.taskId;
+            proc.stdout?.on("data", (d) => appendOutput(task, codec.decode(d)));
+            proc.stderr?.on("data", (d) => appendOutput(task, codec.decode(d)));
             yield `\u2705 [\u540E\u53F0\u4EFB\u52A1\u5DF2\u542F\u52A8]
 task_id: ${taskId}
 \u547D\u4EE4: ${args.command}
 \u7528 get_background_output(task_id="${taskId}") \u67E5\u65E5\u5FD7\uFF0Cstop_background_task(task_id="${taskId}") \u7EC8\u6B62\u3002`;
-            await new Promise((resolve) => {
-              let finished = false;
-              const finish = (apply) => {
-                if (finished) return;
-                finished = true;
-                apply();
-                setTimeout(() => registry.delete(taskId), 6e4);
-                ctx?.abortSignal?.removeEventListener("abort", onAbort);
-                try {
-                  proc?.stdout?.removeAllListeners?.();
-                } catch {
-                }
-                try {
-                  proc?.stderr?.removeAllListeners?.();
-                } catch {
-                }
-                try {
-                  proc?.removeAllListeners?.();
-                } catch {
-                }
-                resolve();
-              };
-              const onAbort = () => {
-                killTree(proc).finally(() => {
-                  finish(() => {
-                    if (task.status === "running") task.status = "killed";
-                    task.exitCode = task.exitCode ?? -1;
-                    appendOutput(task, `
-[\u7528\u6237\u4E2D\u6B62\uFF0C\u8FDB\u7A0B\u6811\u5DF2\u7EC8\u6B62]`);
-                  });
-                });
-              };
-              ctx?.abortSignal?.addEventListener("abort", onAbort, { once: true });
-              proc.on("close", (code) => {
-                finish(() => {
-                  task.status = task.status === "killed" ? "killed" : "exited";
-                  task.exitCode ??= code ?? 0;
-                  appendOutput(task, `
-[\u8FDB\u7A0B\u7ED3\u675F exit=${code}]`);
-                });
-              });
-              proc.on("error", (e) => {
-                finish(() => {
-                  if (task.status === "running") task.status = "exited";
-                  task.exitCode = task.exitCode ?? -1;
-                  appendOutput(task, `
-[spawn error: ${e.message}]`);
-                });
-              });
-            });
+            await attachTaskLifecycle(task, proc, { signal: ctx?.abortSignal, codec });
           }
         }
       },
@@ -2878,7 +3028,7 @@ task_id: ${taskId}
           parameters: {
             type: "object",
             properties: {
-              task_id: { type: "string", description: "run_in_background \u8FD4\u56DE\u7684 task_id" },
+              task_id: { type: "string", description: "\u540E\u53F0\u4EFB\u52A1\u7684 task_id\uFF08run_in_background \u8FD4\u56DE\uFF0C\u6216 run_command \u8D85\u65F6\u81EA\u52A8\u8F6C\u540E\u53F0\u8FD4\u56DE\uFF09" },
               tail_lines: { type: "number", description: "\u53EA\u8FD4\u56DE\u6700\u540E N \u884C\u65E5\u5FD7\uFF08\u9ED8\u8BA4 50\uFF0C\u907F\u514D\u4E00\u6B21\u704C\u5165\u8FC7\u591A\uFF09" },
               wait_seconds: { type: "number", description: "\u963B\u585E\u7B49\u5F85\u4EFB\u52A1\u9000\u51FA\uFF08\u6216\u5230\u8FBE\u6B64\u65F6\u957F\uFF09\u540E\u518D\u8FD4\u56DE\uFF0C\u4E0A\u9650 120 \u79D2\uFF1B\u4EFB\u52A1\u5DF2\u5728\u8DD1\u4E14\u9700\u8981\u7B49\u7ED3\u679C\u65F6\u4F7F\u7528\uFF0C\u4E0D\u9700\u8981\u7B49\u5C31\u7701\u7565" }
             },
@@ -2919,7 +3069,7 @@ task_id: ${taskId}
           parameters: {
             type: "object",
             properties: {
-              task_id: { type: "string", description: "run_in_background \u8FD4\u56DE\u7684 task_id" }
+              task_id: { type: "string", description: "\u540E\u53F0\u4EFB\u52A1\u7684 task_id\uFF08run_in_background \u8FD4\u56DE\uFF0C\u6216 run_command \u8D85\u65F6\u81EA\u52A8\u8F6C\u540E\u53F0\u8FD4\u56DE\uFF09" }
             },
             required: ["task_id"]
           },
@@ -4918,7 +5068,7 @@ var init_workflow = __esm({
 // ../core/src/tool/tsHost.ts
 import fsSync3 from "fs";
 import path15 from "path";
-var _ts, _tsTried, getTs, buildDefaultOptions, findTsConfigBounded, resolveTsConfig, createProjectHost, lsCache, getLanguageService, realpathNative, posToLineCol, lineColToPos;
+var _ts, _tsTried, getTs, buildDefaultOptions, findTsConfigBounded, resolveTsConfig, createProjectHost, lsCache, getLanguageService, realpathNative, posToLineCol, SUPPORTED_SOURCE_EXTS, checkSupportedSourceExt, lineColToPos;
 var init_tsHost = __esm({
   "../core/src/tool/tsHost.ts"() {
     "use strict";
@@ -5064,6 +5214,12 @@ var init_tsHost = __esm({
       const { line, character } = ts.getLineAndCharacterOfPosition(sf, pos);
       return { line: line + 1, column: character + 1 };
     };
+    SUPPORTED_SOURCE_EXTS = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]);
+    checkSupportedSourceExt = (displayPath) => {
+      const ext = path15.extname(displayPath).toLowerCase();
+      if (SUPPORTED_SOURCE_EXTS.has(ext)) return null;
+      return `\u274C [\u6587\u4EF6\u7C7B\u578B\u4E0D\u652F\u6301]\uFF1A[${displayPath}] \u7684\u6269\u5C55\u540D ${ext || "(\u65E0)"} \u4E0D\u5728 TS \u5F15\u64CE\u652F\u6301\u8303\u56F4\uFF08\u4EC5 .ts/.tsx/.js/.jsx/.mjs/.cjs\uFF09\u3002\u8BF7\u6539\u7528 read_file/grep \u67E5\u770B\u5185\u5BB9\uFF1B\u7F16\u8BD1/\u7C7B\u578B\u7C7B\u9A8C\u8BC1\u7528 run_command \u8DD1\u5BF9\u5E94\u8BED\u8A00\u5DE5\u5177\u94FE\uFF08\u5982 mvn compile / tsc --noEmit\uFF09\u3002`;
+    };
     lineColToPos = (ts, sf, line1, col1) => ts.getPositionOfLineAndCharacter(sf, Math.max(0, line1 - 1), Math.max(0, col1 - 1));
   }
 });
@@ -5666,7 +5822,7 @@ ${summaries.join("\n")}`;
         type: "function",
         function: {
           name: "view_symbol_outline",
-          description: "\u901A\u8FC7\u62BD\u8C61\u8BED\u6CD5\u6811(AST)\u5FEB\u901F\u63D0\u53D6\u6307\u5B9A\u6587\u4EF6\u4E2D\u7684\u7B26\u53F7\u5927\u7EB2\uFF08\u7C7B\u3001\u63A5\u53E3\u3001\u51FD\u6570\u540D\u3001\u5BFC\u51FA\u9879\u3001\u5165\u53C2\u7B7E\u540D\u7B49\uFF09\u3002\u9002\u5408\u5728\u4E0D\u8BFB\u53D6\u51E0\u5343\u884C\u5177\u4F53\u4EE3\u7801\u7684\u524D\u63D0\u4E0B\uFF0C\u5B8F\u89C2\u4E86\u89E3\u6587\u4EF6\u67B6\u6784\u3002",
+          description: "\u901A\u8FC7\u62BD\u8C61\u8BED\u6CD5\u6811(AST)\u5FEB\u901F\u63D0\u53D6\u6307\u5B9A TS/JS \u6E90\u6587\u4EF6\u4E2D\u7684\u7B26\u53F7\u5927\u7EB2\uFF08\u7C7B\u3001\u63A5\u53E3\u3001\u51FD\u6570\u540D\u3001\u5BFC\u51FA\u9879\u3001\u5165\u53C2\u7B7E\u540D\u7B49\uFF09\u3002\u9002\u5408\u5728\u4E0D\u8BFB\u53D6\u51E0\u5343\u884C\u5177\u4F53\u4EE3\u7801\u7684\u524D\u63D0\u4E0B\uFF0C\u5B8F\u89C2\u4E86\u89E3\u6587\u4EF6\u67B6\u6784\u3002\u4EC5\u652F\u6301 .ts/.tsx/.js/.jsx/.mjs/.cjs\uFF1B\u5176\u4ED6\u7C7B\u578B\u6587\u4EF6\uFF08.java/.vue/.py \u7B49\uFF09\u76F4\u63A5\u62D2\u7EDD\uFF0C\u8BF7\u6539\u7528 read_file\u3002",
           parameters: {
             type: "object",
             properties: {
@@ -5682,6 +5838,8 @@ ${summaries.join("\n")}`;
               const absPath = resolveReadablePath(args.path);
               const readBlock = await assertReadable(absPath, args.path);
               if (readBlock) return readBlock;
+              const extBlock = checkSupportedSourceExt(args.path);
+              if (extBlock) return extBlock;
               const statForSize = await fs12.stat(absPath);
               if (statForSize.size > 1024 * 1024) {
                 return `\u26A0\uFE0F [\u6587\u4EF6\u8FC7\u5927]\uFF1A[${args.path}] \u7EA6 ${Math.round(statForSize.size / 1024)}KB\uFF0C\u8D85\u8FC7\u7B26\u53F7\u5927\u7EB2\u5206\u6790\u7684 1MB \u4E0A\u9650\uFF08\u9632\u5168\u91CF readFile + AST \u9A7B\u7559\u5403\u5185\u5B58\uFF09\u3002\u8BF7\u6539\u7528 read_file \u5206\u7247\u67E5\u770B\uFF0C\u6216\u7F29\u5C0F\u76EE\u6807\u6587\u4EF6\u3002`;
@@ -5970,6 +6128,7 @@ var init_command = __esm({
     init_type();
     init_guard();
     init_background();
+    init_config();
     EXIT_SENTINEL = (code) => `
 \u27E6DSC_EXIT:${code}\u27E7`;
     EXIT_SENTINEL_RE = /⟦DSC_EXIT:(-?\d+)⟧/g;
@@ -5979,7 +6138,7 @@ var init_command = __esm({
         type: "function",
         function: {
           name: "run_command",
-          description: "\u5728\u5DE5\u4F5C\u533A\u6267\u884C shell \u547D\u4EE4\uFF08\u8DD1\u6D4B\u8BD5 / \u6784\u5EFA / git \u7B49\uFF09\uFF0C\u6D41\u5F0F\u8FD4\u56DE stdout/stderr \u5E76\u9644\u5E26\u9000\u51FA\u7801\u3002\u5C5E\u4E8E\u9AD8\u5371\u64CD\u4F5C\uFF0C\u6BCF\u6B21\u6267\u884C\u90FD\u9700\u8981\u7528\u6237\u5BA1\u6279\u3002",
+          description: "\u5728\u5DE5\u4F5C\u533A\u6267\u884C shell \u547D\u4EE4\uFF08\u77ED\u5E73\u5FEB\u7684\u6D4B\u8BD5 / \u6784\u5EFA / git \u7B49\uFF09\uFF0C\u6D41\u5F0F\u8FD4\u56DE stdout/stderr \u5E76\u9644\u5E26\u9000\u51FA\u7801\u3002\u5C5E\u4E8E\u9AD8\u5371\u64CD\u4F5C\uFF0C\u6BCF\u6B21\u6267\u884C\u90FD\u9700\u8981\u7528\u6237\u5BA1\u6279\u3002\u9884\u8BA1\u8FD0\u884C\u6570\u5206\u949F\u4EE5\u4E0A\u7684\u957F\u4EFB\u52A1\uFF08\u5168\u91CF\u6D4B\u8BD5 / \u5927\u6784\u5EFA / \u5927\u4F53\u79EF\u5B89\u88C5\uFF09\u8BF7\u6539\u7528 run_in_background \u540E\u53F0\u6267\u884C\uFF1B\u82E5\u672C\u5DE5\u5177\u6267\u884C\u8FC7\u4E45\u4ECD\u672A\u7ED3\u675F\uFF0C\u7CFB\u7EDF\u4F1A\u81EA\u52A8\u628A\u8FDB\u7A0B\u8F6C\u5165\u540E\u53F0\u5E76\u8FD4\u56DE task_id\uFF08\u7528 get_background_output \u67E5\u7ED3\u679C\u3001stop_background_task \u7EC8\u6B62\uFF09\u3002",
           parameters: {
             type: "object",
             properties: {
@@ -6024,6 +6183,10 @@ ${tail}`,
             const cwd = args.cwd ? resolveSafePath(args.cwd) : getActiveWorkspaceRoot();
             const maxChars = RUN_COMMAND_MAX_CHARS;
             let totalYieldedChars = 0;
+            let fullOutput = "";
+            let degraded = false;
+            let degradeDue = false;
+            let degradeReason = null;
             const isWin = process.platform === "win32";
             if (ctx?.abortSignal?.aborted) {
               yield `\u274C [\u5DF2\u4E2D\u6B62]\uFF1A\u547D\u4EE4 [${args.command}] \u672A\u6267\u884C\uFF08\u7528\u6237\u5DF2\u4E2D\u65AD\uFF09\u3002`;
@@ -6078,6 +6241,15 @@ ${tail}`,
               }
               return (decoder ?? pendingUtf8).decode(buf, { stream: true });
             };
+            const codec = {
+              decode: decodeChunk,
+              flush: () => {
+                let s = "";
+                if (decoder) s += decoder.decode();
+                s += pendingUtf8.decode();
+                return s;
+              }
+            };
             proc.stdout?.on("data", (d) => {
               queue.push(decodeChunk(d));
               notifyNewData();
@@ -6104,11 +6276,22 @@ ${tail}`,
               void killTree(proc);
             };
             ctx?.abortSignal?.addEventListener("abort", onAbort);
+            const IDLE_TIMEOUT_MS = Number(process.env.RUN_COMMAND_IDLE_TIMEOUT_MS) || 6e4;
+            const autoBgMs = Math.max(1, appConfig.runCommandAutoBgMs);
+            const runtimeTimer = setTimeout(() => {
+              degradeDue = true;
+              notifyNewData();
+            }, autoBgMs);
+            runtimeTimer.unref?.();
             let overLimit = false;
             try {
-              while ((!settled || queue.length > 0) && !overLimit) {
+              while ((!settled || queue.length > 0) && !overLimit && !degraded) {
+                if (degradeDue && !settled) {
+                  degraded = true;
+                  degradeReason = "runtime";
+                  break;
+                }
                 if (queue.length === 0) {
-                  const IDLE_TIMEOUT_MS = 6e4;
                   let timedOut = false;
                   await new Promise((r) => {
                     resolveWaiter = r;
@@ -6117,20 +6300,26 @@ ${tail}`,
                       r();
                     }, IDLE_TIMEOUT_MS);
                   });
+                  if (degradeDue && !settled) {
+                    degraded = true;
+                    degradeReason = "runtime";
+                    break;
+                  }
                   if (timedOut && !settled && queue.length === 0) {
-                    yield `
-
-\u23F1\uFE0F [\u770B\u95E8\u72D7]\uFF1A\u547D\u4EE4\u8FDE\u7EED ${IDLE_TIMEOUT_MS / 1e3}s \u65E0\u8F93\u51FA\u4E14\u672A\u9000\u51FA\uFF0C\u5224\u5B9A\u4E3A\u5E38\u9A7B\u8FDB\u7A0B\uFF08\u5982 dev server / tail -f\uFF09\u3002\u5DF2\u4E3B\u52A8\u7EC8\u6B62\u4EE5\u91CA\u653E\u4E3B\u5FAA\u73AF\u2014\u2014\u5E38\u9A7B\u547D\u4EE4\u8BF7\u6539\u7528 run_in_background\u3002
-`;
-                    onAbort();
-                    settled = true;
-                    overLimit = true;
+                    degraded = true;
+                    degradeReason = "idle";
                     break;
                   }
                 }
                 while (queue.length > 0) {
+                  if (degradeDue && !settled) {
+                    degraded = true;
+                    degradeReason = "runtime";
+                    break;
+                  }
                   const chunk = queue.shift();
                   totalYieldedChars += chunk.length;
+                  fullOutput += chunk;
                   if (totalYieldedChars > maxChars) {
                     yield `
 
@@ -6144,14 +6333,30 @@ ${tail}`,
                   yield chunk;
                 }
               }
-              if (overLimit) {
+              if (degraded) {
+                const taskId = adoptRunningProcess(
+                  proc,
+                  { command: args.command, cwd, sessionId: ctx?.sessionId, signal: ctx?.abortSignal },
+                  fullOutput + queue.join(""),
+                  codec
+                );
+                const why = degradeReason === "idle" ? `\u8FDE\u7EED ${Math.round(IDLE_TIMEOUT_MS / 1e3)}s \u65E0\u8F93\u51FA\u4E14\u672A\u9000\u51FA` : `\u5DF2\u6301\u7EED\u8FD0\u884C\u8D85\u8FC7 ${Math.round(autoBgMs / 1e3)}s`;
+                yield `
+
+\u23F3 [\u81EA\u52A8\u8F6C\u540E\u53F0]\uFF1A\u547D\u4EE4 [${args.command}] ${why}\uFF0C\u5DF2\u81EA\u52A8\u8F6C\u4E3A\u540E\u53F0\u4EFB\u52A1\uFF08\u524D\u53F0\u6D41\u5F0F\u7ED3\u675F\uFF0C\u672A\u6D88\u8D39\u7684\u5269\u4F59\u8F93\u51FA\u5DF2\u5E76\u5165\u540E\u53F0\u7F13\u51B2\uFF09\u3002
+task_id: ${taskId}
+\u26A0\uFE0F \u8FDB\u7A0B\u4ECD\u5728\u8FD0\u884C\uFF0C\u9000\u51FA\u7801\u672A\u77E5\uFF08\u4E0D\u5224\u5B9A\u6210\u529F/\u5931\u8D25\uFF09\u2014\u2014\u7528 get_background_output(task_id="${taskId}", wait_seconds=\u2026) \u7B49\u5F85/\u67E5\u770B\u7ED3\u679C\uFF1B\u82E5\u786E\u8BA4\u65E0\u9700\u7EE7\u7EED\uFF0C\u7528 stop_background_task(task_id="${taskId}") \u7EC8\u6B62\u3002
+`;
+              } else if (overLimit) {
                 yield EXIT_SENTINEL(-1);
               } else if (exitCode !== null) {
                 yield EXIT_SENTINEL(exitCode);
               }
             } finally {
               if (idleTimer) clearTimeout(idleTimer);
+              clearTimeout(runtimeTimer);
               ctx?.abortSignal?.removeEventListener("abort", onAbort);
+              if (!settled && !degraded) void killTree(proc);
             }
           }
         }
@@ -7177,6 +7382,8 @@ var init_typescript = __esm({
     precheck = async (displayPath, absPath) => {
       const readBlock = await assertReadable(absPath, displayPath);
       if (readBlock) return readBlock;
+      const extBlock = checkSupportedSourceExt(displayPath);
+      if (extBlock) return extBlock;
       const stat = await fs16.stat(absPath);
       if (stat.size > MAX_FILE_BYTES) {
         return `\u26A0\uFE0F [\u6587\u4EF6\u8FC7\u5927]\uFF1A[${displayPath}] \u7EA6 ${Math.round(stat.size / 1024)}KB\uFF0C\u8D85\u8FC7 ${MAX_FILE_BYTES / 1024}KB \u4E0A\u9650\uFF08\u9632\u5168\u91CF type-check \u5403\u5185\u5B58\uFF09\u3002`;
@@ -7239,7 +7446,7 @@ ${body}${tail}` };
         type: "function",
         function: {
           name: "get_diagnostics",
-          description: "\u5BF9\u4E00\u4E2A\u6216\u591A\u4E2A TS/JS \u6587\u4EF6\u53D6 TypeScript \u8BED\u6CD5 + \u8BED\u4E49\u8BCA\u65AD\uFF08\u7C7B\u578B\u9519\u8BEF\u3001\u672A\u7528\u53D8\u91CF\u3001\u4E0D\u53EF\u8FBE\u4EE3\u7801\u7B49\uFF09\uFF0C\u8F93\u51FA\u5E26\u884C\u53F7/\u5217/\u4E25\u91CD\u5EA6/TS \u9519\u8BEF\u7801\uFF0C\u683C\u5F0F\u5BF9\u9F50 tsc\u3002\u7528\u4E8E\u7CBE\u51C6\u5B9A\u4F4D\u7F16\u8BD1/\u7C7B\u578B\u95EE\u9898\uFF0C\u66FF\u4EE3\u624B\u52A8\u8DD1 tsc \u518D\u89E3\u6790\u8F93\u51FA\u3002\u2605 \u6539\u5B8C\u591A\u4E2A\u6587\u4EF6\u540E\u9A8C\u8BC1\uFF1A\u4F20 paths \u6570\u7EC4\u4E00\u6B21\u8BCA\u65AD\u5168\u90E8\uFF08\u6700\u591A 20 \u4E2A\uFF09\uFF0C\u52FF\u9010\u6587\u4EF6\u591A\u6B21\u8C03\u7528\u3002\u652F\u6301 .ts/.tsx/.js/.jsx/.mjs/.cjs\uFF1B.vue SFC \u4E0D\u652F\u6301\uFF08\u9700 vue-tsc\uFF09\u3002\u9879\u76EE\u7EA7\u5168\u91CF\u8BCA\u65AD\u8BF7\u7528 run_command \u8DD1 `tsc --noEmit`\u3002\u4F9D\u8D56 typescript \u6A21\u5757\uFF08VSCode \u6269\u5C55\u5185\u53EF\u7528\uFF1B\u7F3A\u5931\u5219\u672C\u5DE5\u5177\u81EA\u52A8\u9690\u85CF\uFF09\u3002",
+          description: "\u5BF9\u4E00\u4E2A\u6216\u591A\u4E2A TS/JS \u6587\u4EF6\u53D6 TypeScript \u8BED\u6CD5 + \u8BED\u4E49\u8BCA\u65AD\uFF08\u7C7B\u578B\u9519\u8BEF\u3001\u672A\u7528\u53D8\u91CF\u3001\u4E0D\u53EF\u8FBE\u4EE3\u7801\u7B49\uFF09\uFF0C\u8F93\u51FA\u5E26\u884C\u53F7/\u5217/\u4E25\u91CD\u5EA6/TS \u9519\u8BEF\u7801\uFF0C\u683C\u5F0F\u5BF9\u9F50 tsc\u3002\u7528\u4E8E\u7CBE\u51C6\u5B9A\u4F4D\u7F16\u8BD1/\u7C7B\u578B\u95EE\u9898\uFF0C\u66FF\u4EE3\u624B\u52A8\u8DD1 tsc \u518D\u89E3\u6790\u8F93\u51FA\u3002\u2605 \u6539\u5B8C\u591A\u4E2A\u6587\u4EF6\u540E\u9A8C\u8BC1\uFF1A\u4F20 paths \u6570\u7EC4\u4E00\u6B21\u8BCA\u65AD\u5168\u90E8\uFF08\u6700\u591A 20 \u4E2A\uFF09\uFF0C\u52FF\u9010\u6587\u4EF6\u591A\u6B21\u8C03\u7528\u3002\u652F\u6301 .ts/.tsx/.js/.jsx/.mjs/.cjs\uFF1B.vue SFC \u4E0D\u652F\u6301\uFF08\u9700 vue-tsc\uFF09\uFF0C\u5176\u4F59\u6269\u5C55\u540D\uFF08.java/.py/.go \u7B49\uFF09\u76F4\u63A5\u62D2\u7EDD\u3001\u52FF\u4F20\u5165\u3002\u9879\u76EE\u7EA7\u5168\u91CF\u8BCA\u65AD\u8BF7\u7528 run_command \u8DD1 `tsc --noEmit`\u3002\u4F9D\u8D56 typescript \u6A21\u5757\uFF08VSCode \u6269\u5C55\u5185\u53EF\u7528\uFF1B\u7F3A\u5931\u5219\u672C\u5DE5\u5177\u81EA\u52A8\u9690\u85CF\uFF09\u3002",
           parameters: {
             type: "object",
             properties: {
@@ -7294,7 +7501,7 @@ ${sections.join("\n\n")}`;
         type: "function",
         function: {
           name: "goto_definition",
-          description: "\u8DF3\u8F6C\u5230\u6307\u5B9A TS/JS \u6587\u4EF6\u67D0\u884C\u67D0\u5217\u7B26\u53F7\u7684\u5B9A\u4E49\u4F4D\u7F6E\uFF0C\u8FD4\u56DE rel/path:line:col\uFF08\u53EF\u591A\u5904\uFF09\u3002\u7528\u4E8E\u8DE8\u6587\u4EF6\u8FFD\u8E2A\u51FD\u6570/\u7C7B\u578B/\u53D8\u91CF\u7684\u6765\u6E90\uFF0C\u66FF\u4EE3 grep \u731C\u6D4B\u3002\u652F\u6301 .ts/.tsx/.js/.jsx/.mjs/.cjs\uFF1B.vue SFC \u4E0D\u652F\u6301\u3002\u843D\u70B9\u5728 node_modules \u6216 .d.ts \u65F6\u6807\u6CE8 (declaration/library)\u3002\u884C/\u5217\u4E3A 1-based\uFF08\u4E0E\u7F16\u8F91\u5668\u4E00\u81F4\uFF09\u3002\u4F9D\u8D56 typescript \u6A21\u5757\uFF08VSCode \u6269\u5C55\u5185\u53EF\u7528\uFF1B\u7F3A\u5931\u5219\u672C\u5DE5\u5177\u81EA\u52A8\u9690\u85CF\uFF09\u3002",
+          description: "\u8DF3\u8F6C\u5230\u6307\u5B9A TS/JS \u6587\u4EF6\u67D0\u884C\u67D0\u5217\u7B26\u53F7\u7684\u5B9A\u4E49\u4F4D\u7F6E\uFF0C\u8FD4\u56DE rel/path:line:col\uFF08\u53EF\u591A\u5904\uFF09\u3002\u7528\u4E8E\u8DE8\u6587\u4EF6\u8FFD\u8E2A\u51FD\u6570/\u7C7B\u578B/\u53D8\u91CF\u7684\u6765\u6E90\uFF0C\u66FF\u4EE3 grep \u731C\u6D4B\u3002\u652F\u6301 .ts/.tsx/.js/.jsx/.mjs/.cjs\uFF1B.vue SFC \u4E0D\u652F\u6301\uFF0C\u5176\u4F59\u6269\u5C55\u540D\uFF08.java/.py/.go \u7B49\uFF09\u76F4\u63A5\u62D2\u7EDD\u3001\u52FF\u4F20\u5165\u3002\u843D\u70B9\u5728 node_modules \u6216 .d.ts \u65F6\u6807\u6CE8 (declaration/library)\u3002\u884C/\u5217\u4E3A 1-based\uFF08\u4E0E\u7F16\u8F91\u5668\u4E00\u81F4\uFF09\u3002\u4F9D\u8D56 typescript \u6A21\u5757\uFF08VSCode \u6269\u5C55\u5185\u53EF\u7528\uFF1B\u7F3A\u5931\u5219\u672C\u5DE5\u5177\u81EA\u52A8\u9690\u85CF\uFF09\u3002",
           parameters: {
             type: "object",
             properties: {
@@ -10033,6 +10240,7 @@ var init_streamInference = __esm({
     init_truncate();
     init_transcript();
     init_contextCore();
+    init_contentParts();
     streamInference = async function* (ctx) {
       const {
         message,
@@ -10060,7 +10268,8 @@ var init_streamInference = __esm({
           eventType: "llm.request",
           metadata: { depth, decisionSource: userDecisionSource, ok: true, durationMs: performance.now() - startTime, round },
           usage: { prompt_tokens: estimateTokens(inferenceMessages) },
-          payload: { input: message[message.length - 1].content }
+          payload: { input: msgText(message[message.length - 1].content) }
+          // ★ 多模态：trace 只记文本视图
         });
         console.log(`\u{1F504} \u4EE3\u7406\u63A8\u7406\u7B2C ${round} \u8F6E\uFF08\u6D41\u5F0F\uFF09...`);
         let contentBuf = "";
@@ -10192,7 +10401,8 @@ var init_streamInference = __esm({
             prompt_cache_hit_tokens: lastUsage?.cached_tokens,
             prompt_cache_miss_tokens: (lastUsage?.prompt_tokens || 0) - (lastUsage?.cached_tokens || 0)
           },
-          payload: { input: message[message.length - 1].content }
+          payload: { input: msgText(message[message.length - 1].content) }
+          // ★ 多模态：trace 只记文本视图
         });
         console.log(`[DSC-DIAG] streamInference round ${round} \u5B8C\u6210: content=${contentBuf.length}chars reasoning=${reasoningBuf.length}chars toolCalls=${toolCallsBuf.size}`);
         return { kind: "completed", assistantMessage, usage: lastUsage };
@@ -10205,7 +10415,8 @@ var init_streamInference = __esm({
           sessionId,
           eventType: "llm.error",
           metadata: { depth, decisionSource: llmDecisionSource, ok: false, durationMs: performance.now() - startTime, attempt: round },
-          payload: { input: message[message.length - 1].content, output: err.message }
+          payload: { input: msgText(message[message.length - 1].content), output: err.message }
+          // ★ 多模态：文本视图
         });
         console.log(`[DSC-DIAG] streamInference round ${round} \u2550\u2550\u2550 ERROR: ${err.message}`);
         return { kind: "error", error: err };
@@ -10420,7 +10631,7 @@ async function* runAgent(message, options) {
   const firstPrompt = (() => {
     if (depth !== 0) return "";
     const m = message.find((x) => x?.role === "user");
-    return typeof m?.content === "string" ? m.content : "";
+    return msgText(m?.content);
   })();
   const nudges = createNudgeScheduler({ firstPrompt, planMode: !!options.planMode, noEarlyFinal: !!options.noEarlyFinal });
   const userDecisionSource = depth > 0 ? "spawn_agent" : "user";
@@ -10548,7 +10759,7 @@ async function* runAgent(message, options) {
       const assistantMessage = infResult.assistantMessage;
       message.push(assistantMessage);
       await appendMessage({ ...assistantMessage, sessionId });
-      if (assistantMessage.content) {
+      if (typeof assistantMessage.content === "string" && assistantMessage.content) {
         lastContent = assistantMessage.content;
       }
       if (!assistantMessage.tool_calls || assistantMessage.tool_calls.length === 0) {
@@ -10641,6 +10852,7 @@ var init_runAgent = __esm({
     init_inbox();
     init_common();
     init_contextCore();
+    init_contentParts();
     init_store();
     init_truncate();
     init_hooks();
@@ -10733,11 +10945,12 @@ var init_recovery = __esm({
 });
 
 // ../core/src/session/content.ts
-var decayOldToolResults, buildContextMessages;
+var decayOldToolResults, NO_VISION_IMAGE_NOTE, enforceVisionGate, buildContextMessages;
 var init_content = __esm({
   "../core/src/session/content.ts"() {
     "use strict";
     init_contextCore();
+    init_contentParts();
     init_transcript();
     init_store();
     init_config();
@@ -10747,15 +10960,20 @@ var init_content = __esm({
       const cutoffUnitIdx = Math.max(0, units.length - appConfig.KEEP_RECENT_UNITS);
       if (cutoffUnitIdx === 0) return msgs;
       const decayIds = /* @__PURE__ */ new Set();
+      let hasOldImage = false;
       for (let u = 0; u < cutoffUnitIdx; u++) {
         for (const m of units[u]) {
           const mm = m;
           if (mm.role === "tool" && typeof mm.tool_call_id === "string") decayIds.add(mm.tool_call_id);
+          if (hasImagePart(m.content)) hasOldImage = true;
         }
       }
-      if (decayIds.size === 0) return msgs;
+      if (decayIds.size === 0 && !hasOldImage) return msgs;
       const keep = appConfig.BOUNDARY_TOOL_KEEP_CHARS;
+      const oldRefs = /* @__PURE__ */ new Set();
+      for (let u = 0; u < cutoffUnitIdx; u++) for (const m of units[u]) oldRefs.add(m);
       return msgs.map((m) => {
+        if (!oldRefs.has(m)) return m;
         const mm = m;
         if (mm.role === "tool" && decayIds.has(mm.tool_call_id) && typeof mm.content === "string" && mm.content.length > keep) {
           const head = mm.content.slice(0, keep);
@@ -10763,9 +10981,11 @@ var init_content = __esm({
 
 [\u2026 \u8BE5\u5386\u53F2\u5DE5\u5177\u8F93\u51FA\u5DF2\u6298\u53E0\uFF08\u5171 ${mm.content.length} \u5B57\u7B26\uFF09\uFF0C\u5982\u9700\u7EC6\u8282\u8BF7\u91CD\u65B0\u8C03\u7528\u5DE5\u5177 \u2026]` };
         }
-        return m;
+        return replaceImageParts(mm, "[\u5386\u53F2\u56FE\u7247\u5DF2\u6298\u53E0\uFF1A\u539F\u56FE\u4ECD\u5728\u4F1A\u8BDD\u5F52\u6863\u4E2D\uFF0C\u5982\u9700\u518D\u6B21\u67E5\u770B\u8BF7\u91CD\u65B0\u63D0\u4F9B\u8BE5\u56FE\u7247]");
       });
     };
+    NO_VISION_IMAGE_NOTE = "[\u56FE\u7247\u672A\u9001\u8FBE\uFF1A\u5F53\u524D\u672A\u5F00\u542F\u89C6\u89C9\u80FD\u529B\uFF08DEEP_SEEK_VISION\uFF09\uFF0C\u6A21\u578B\u770B\u4E0D\u5230\u8BE5\u56FE\uFF1B\u539F\u56FE\u4FDD\u7559\u5728\u4F1A\u8BDD\u5F52\u6863\u4E2D\uFF0C\u5982\u9700\u5206\u6790\u8BF7\u8BA9\u7528\u6237\u91CD\u65B0\u63D0\u4F9B]";
+    enforceVisionGate = (msgs) => isVisionEnabled() ? msgs : msgs.map((m) => collapseToText(m, NO_VISION_IMAGE_NOTE));
     buildContextMessages = async (sessionId, currentUserMsg, systemPrompt) => {
       const lines = await readTranscriptLines(sessionId);
       const store = await getRollingState(sessionId);
@@ -10785,12 +11005,12 @@ var init_content = __esm({
       const messageAll = all.slice(archivedMessageCount);
       if (messageAll.length === 0) {
         result.push(currentUserMsg);
-        return result;
+        return enforceVisionGate(result);
       }
       const repair = repairOrphanToolCalls(messageAll, recovery.interruption.kind === "crashed");
       result.push(...decayOldToolResults(repair.msgs));
       result.push(currentUserMsg);
-      return result;
+      return enforceVisionGate(result);
     };
   }
 });
@@ -11164,9 +11384,12 @@ var init_loader4 = __esm({
     };
     parseStdoutDecision = (stdout) => {
       const s = (stdout ?? "").trim();
-      if (!s || !s.startsWith("{")) return void 0;
+      if (!s) return void 0;
+      const match = s.match(/\{[\s\S]*\}$/);
+      if (!match) return void 0;
+      const jsonStr = match[0];
       try {
-        const parsed = JSON.parse(s);
+        const parsed = JSON.parse(jsonStr);
         if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return void 0;
         const out = {};
         if (parsed.deny === true) {
@@ -12254,6 +12477,7 @@ var init_chatProcessing = __esm({
     init_store();
     init_transcript();
     init_content();
+    init_contentParts();
     init_trace();
     init_webHost();
     init_registry();
@@ -12309,10 +12533,16 @@ ${lines.join("\n")}
 \u6CE8\u610F\uFF1A\u9879\u76EE\u7EA7\u914D\u7F6E\uFF08.deepseeker-code/\uFF09\u4EC5\u5728\u9ED8\u8BA4\u6839 ${path41.basename(activeReal) || activeReal} \u751F\u6548\u3002`;
       }
       let replyText = "";
+      let userContent = inbound.content;
+      if (Array.isArray(inbound.attachments) && inbound.attachments.length > 0) {
+        userContent = isVisionEnabled() ? toWireUserContent(inbound.content, inbound.attachments) : `${inbound.content}
+
+\u{1F5BC} \u6536\u5230\u56FE\u7247\u9644\u4EF6\uFF08${inbound.attachments.map((a) => a?.name || "image").join("\u3001")}\uFF09\uFF1A\u5F53\u524D\u6A21\u578B\u672A\u5F00\u542F\u89C6\u89C9\u80FD\u529B\uFF08DEEP_SEEK_VISION\uFF09\uFF0C\u5DF2\u5FFD\u7565\u56FE\u7247\u5185\u5BB9\u3002`;
+      }
       try {
         const fullMessages = await buildContextMessages(
           sessionId,
-          { role: "user", content: inbound.content },
+          { role: "user", content: userContent },
           sysPrompt
         );
         await emitTrace({
@@ -12325,7 +12555,7 @@ ${lines.join("\n")}
         });
         void sweepStaleAtomicTmp().catch(() => {
         });
-        await appendMessage({ sessionId, role: "user", content: inbound.content });
+        await appendMessage({ sessionId, role: "user", content: userContent });
         let streamedAnyText = false;
         const onUIEvent = opts?.onUIEvent ?? ((evt) => sseWrite?.(evt));
         const requestApproval2 = opts?.requestApproval ?? createWebRequestApproval((evt) => sseWrite?.(evt), abortSignal);
@@ -12399,6 +12629,7 @@ var init_fork = __esm({
   "../core/src/session/fork.ts"() {
     "use strict";
     init_common();
+    init_contentParts();
     init_transcript();
     init_store();
     listForkAnchors = (lines) => {
@@ -12408,7 +12639,7 @@ var init_fork = __esm({
         if (isEventLine(l)) continue;
         const row = l;
         if (row?.role === "user") {
-          lastUser = typeof row.content === "string" ? row.content : "";
+          lastUser = msgText(row.content) || (hasImagePart(row.content) ? "\u{1F5BC} [\u56FE\u7247\u6D88\u606F]" : "");
         } else if (row?.role === "assistant") {
           const content = typeof row.content === "string" ? row.content : "";
           const names = Array.isArray(row.tool_calls) ? row.tool_calls.map((tc) => tc?.function?.name ?? "").filter(Boolean).join(", ") : "";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "deepseeker-code",
-    "version": "1.0.47",
+    "version": "1.0.49",
     "description": "DeepSeeker-Code 终端客户端（React Ink，in-process 直驱 runAgent）",
     "homepage": "https://github.com/xknk/deepSeekCode#readme",
     "repository": {