@zythum02/fello-server 0.1.55 → 0.1.57

package/out/server/main.js

@@ -11,7 +11,7 @@ process.treeSitterWasmPath = join(resourcesPath, "tree-sitter-wasm");
 
 // src/backend/backend.ts
 import { readdir as readdir2, rm as rm3, readFile as readFile10 } from "fs/promises";
-import { join as join25 } from "path";
+import { join as join26 } from "path";
 
 // src/backend/storage/index.ts
 import { join as join5 } from "path";
@@ -64,7 +64,8 @@ var DEFAULT_SETTINGS = {
   shortcuts: {},
   proxy: {
     mode: "off"
-  }
+  },
+  peripherals: []
 };
 function settingsPath() {
   return join3(FELLO_DIR, "settings.json");
@@ -252,24 +253,51 @@ function readSettings() {
       model: p.model,
       active: typeof p.active === "boolean" ? p.active : false
     })) : [];
-    const speechToText = Array.isArray(rawObj?.speechToText) ? rawObj.speechToText.filter((value) => isObject(value)).filter((value) => {
-      const provider = value.provider;
-      return typeof value.id === "string" && typeof value.name === "string" && typeof value.apiKey === "string" && (provider === "volcengine" || provider === "dashscope" || provider === "openai" || provider === "iflytek");
-    }).map((value) => ({
+    const speechProviders = (() => {
+      const isSpeechProvider = (value) => {
+        const provider = value.provider;
+        return typeof value.id === "string" && typeof value.name === "string" && typeof value.apiKey === "string" && (provider === "volcengine" || provider === "dashscope" || provider === "openai" || provider === "iflytek");
+      };
+      const parseShared = (value) => ({
+        id: value.id,
+        name: value.name,
+        provider: value.provider,
+        apiKey: value.apiKey,
+        appId: typeof value.appId === "string" ? value.appId : void 0,
+        apiSecret: typeof value.apiSecret === "string" ? value.apiSecret : void 0,
+        baseUrl: typeof value.baseUrl === "string" ? value.baseUrl : void 0,
+        workspaceId: typeof value.workspaceId === "string" ? value.workspaceId : void 0,
+        region: value.region === "cn-beijing" || value.region === "ap-southeast-1" ? value.region : void 0,
+        workspace: typeof value.workspace === "string" ? value.workspace : void 0,
+        language: typeof value.language === "string" ? value.language : void 0
+      });
+      const rows = (input) => Array.isArray(input) ? input.filter((value) => isObject(value)).filter(isSpeechProvider) : [];
+      if (Array.isArray(rawObj?.speechProviders)) {
+        return rows(rawObj.speechProviders).map((value) => ({
+          ...parseShared(value),
+          asrModel: typeof value.asrModel === "string" ? value.asrModel : void 0,
+          asrResourceId: typeof value.asrResourceId === "string" ? value.asrResourceId : void 0,
+          ttsModel: typeof value.ttsModel === "string" ? value.ttsModel : void 0,
+          voice: typeof value.voice === "string" ? value.voice : void 0,
+          asrEnabled: typeof value.asrEnabled === "boolean" ? value.asrEnabled : false,
+          ttsEnabled: typeof value.ttsEnabled === "boolean" ? value.ttsEnabled : false
+        }));
+      }
+      return rows(rawObj?.speechToText).map((value) => ({
+        ...parseShared(value),
+        asrModel: typeof value.model === "string" ? value.model : void 0,
+        asrResourceId: typeof value.resourceId === "string" ? value.resourceId : void 0,
+        ttsModel: void 0,
+        voice: void 0,
+        asrEnabled: typeof value.active === "boolean" ? value.active : false,
+        ttsEnabled: false
+      }));
+    })();
+    const peripherals = Array.isArray(rawObj?.peripherals) ? rawObj.peripherals.filter(
+      (value) => typeof value === "object" && value !== null && !Array.isArray(value)
+    ).filter((value) => typeof value.id === "string").map((value) => ({
       id: value.id,
-      name: value.name,
-      provider: value.provider,
-      apiKey: value.apiKey,
-      appId: typeof value.appId === "string" ? value.appId : void 0,
-      apiSecret: typeof value.apiSecret === "string" ? value.apiSecret : void 0,
-      resourceId: typeof value.resourceId === "string" ? value.resourceId : void 0,
-      model: typeof value.model === "string" ? value.model : void 0,
-      baseUrl: typeof value.baseUrl === "string" ? value.baseUrl : void 0,
-      workspaceId: typeof value.workspaceId === "string" ? value.workspaceId : void 0,
-      region: value.region === "cn-beijing" || value.region === "ap-southeast-1" ? value.region : void 0,
-      workspace: typeof value.workspace === "string" ? value.workspace : void 0,
-      language: typeof value.language === "string" ? value.language : void 0,
-      active: typeof value.active === "boolean" ? value.active : false
+      enabled: typeof value.enabled === "boolean" ? value.enabled : false
     })) : [];
     const editor = (() => {
       const raw2 = rawObj && isObject(rawObj.editor) ? rawObj.editor : null;
@@ -292,7 +320,8 @@ function readSettings() {
       proxy,
       snippets,
       imageGeneration,
-      speechToText
+      speechProviders,
+      peripherals
     };
   } catch {
     return DEFAULT_SETTINGS;
@@ -404,21 +433,28 @@ function getSettings() {
       model: p.model,
       active: p.active
     })),
-    speechToText: (meta.speechToText ?? []).map((p) => ({
+    speechProviders: (meta.speechProviders ?? []).map((p) => ({
       id: p.id,
       name: p.name,
       provider: p.provider,
       apiKey: p.apiKey,
       appId: p.appId,
       apiSecret: p.apiSecret,
-      resourceId: p.resourceId,
-      model: p.model,
       baseUrl: p.baseUrl,
       workspaceId: p.workspaceId,
       region: p.region,
       workspace: p.workspace,
       language: p.language,
-      active: p.active
+      asrModel: p.asrModel,
+      asrResourceId: p.asrResourceId,
+      ttsModel: p.ttsModel,
+      voice: p.voice,
+      asrEnabled: p.asrEnabled,
+      ttsEnabled: p.ttsEnabled
+    })),
+    peripherals: (meta.peripherals ?? []).map((p) => ({
+      id: p.id,
+      enabled: p.enabled
     }))
   };
 }
@@ -589,22 +625,29 @@ function updateSettings(settings) {
       model: p.model,
       active: p.active
     })) : prevMeta.imageGeneration,
-    speechToText: settings.speechToText ? settings.speechToText.map((p) => ({
+    speechProviders: settings.speechProviders ? settings.speechProviders.map((p) => ({
       id: p.id,
       name: p.name,
       provider: p.provider,
       apiKey: p.apiKey,
       appId: p.appId?.trim() || void 0,
       apiSecret: p.apiSecret?.trim() || void 0,
-      resourceId: p.resourceId?.trim() || void 0,
-      model: p.model?.trim() || void 0,
       baseUrl: p.baseUrl?.trim() || void 0,
       workspaceId: p.workspaceId?.trim() || void 0,
       region: p.region,
       workspace: p.workspace?.trim() || void 0,
       language: p.language?.trim() || void 0,
-      active: p.active
-    })) : prevMeta.speechToText
+      asrModel: p.asrModel?.trim() || void 0,
+      asrResourceId: p.asrResourceId?.trim() || void 0,
+      ttsModel: p.ttsModel?.trim() || void 0,
+      voice: p.voice?.trim() || void 0,
+      asrEnabled: p.asrEnabled,
+      ttsEnabled: p.ttsEnabled
+    })) : prevMeta.speechProviders ?? [],
+    peripherals: settings.peripherals ? settings.peripherals.map((p) => ({
+      id: p.id,
+      enabled: p.enabled
+    })) : prevMeta.peripherals ?? []
   };
   writeSettings(meta);
 }
@@ -1086,26 +1129,24 @@ var en_default = {
     promptRefusal: "\u26A0\uFE0F Model refused to respond",
     promptCancelled: "\u26A0\uFE0F Generation was cancelled",
     noActiveSession: "No active session",
-    title: "Title",
-    cwd: "Working Directory",
     projectDir: "Project Directory",
     agent: "Agent",
     features: "Features",
     mcpServers: "MCP Servers",
     project: "Project",
-    sessionInfo: "Session Info",
     sessionList: "Switch Session",
     sessionListDesc: "Please choose from the following sessions:",
     newSessionDesc: "Please choose from the following projects:",
     noSessions: "No sessions available.",
     switchSessionHint: "Reply with a number to switch session",
     switchSessionGuide: "\u{1F4A1} Send !s to switch session",
-    invalidSessionNumber: "Invalid number, please enter a number between {{min}}-{{max}}. Send a command to retry.",
+    invalidMenuNumber: "Invalid number, please enter a number between {{min}}-{{max}}.",
+    unknownCommand: "\u2753 Unknown command. Send ! to see the current session status and command list.",
     switchedToSession: "Switched to \u300C{{label}}\u300D",
     newSession: "New Chat",
     newSessionTitle: "New Session",
     noProjects: "No projects available.",
-    createSessionHint: "Reply with a number to create a new session (send other content to cancel)",
+    createSessionHint: "Reply with a number to create a new session",
     createSessionGuide: "\u{1F4A1} Send !n to create a new session",
     noAgent: "No available agent. Please configure one in settings.",
     createdAndSwitched: "\u2705 Switched to new session in project\u300C{{project}}\u300D",
@@ -1120,7 +1161,32 @@ var en_default = {
     snippetListDesc: "Please choose a quick phrase:",
     noSnippets: "No quick phrases available. Please add some in settings.",
     selectSnippetHint: "Reply with a number to send the quick phrase",
-    snippetSent: "\u2705 Quick phrase\u300C{{title}}\u300Dhas been sent"
+    snippetSent: "\u2705 Quick phrase\u300C{{title}}\u300Dhas been sent",
+    featuresMenu: "Feature Switches",
+    featuresMenuDesc: "Toggle the features below (applied immediately):",
+    mcpMenu: "MCP Server Switches",
+    mcpMenuDesc: "Toggle the MCP servers below (applied immediately):",
+    toggleHint: "Reply with a number to toggle that item; send 0 to exit the menu",
+    featureGuide: "\u{1F4A1} Send !f to toggle features",
+    mcpServerGuide: "\u{1F4A1} Send !c to toggle MCP servers",
+    noToggleItems: "Nothing to toggle here.",
+    toggleCancelled: "Exited, nothing changed.",
+    toggledOn: "\u2705 Enabled",
+    toggledOff: "\u2705 Disabled",
+    toggleSavedRestartFailed: "{{label}}, but restarting the session failed. The change will apply on the next resume.",
+    permissionMenu: "Permission",
+    permissionMenuDesc: "Please choose a permission mode:",
+    permissionAsk: "Ask",
+    permissionAllowAll: "Allow all",
+    switchPermissionHint: "Reply with a number to switch permission mode",
+    permissionGuide: "\u{1F4A1} Send !p to switch permission",
+    permissionSwitched: "\u2705 Switched to {{mode}}",
+    featureSkills: "Skills",
+    featureSearch: "Search",
+    featureImageGeneration: "Image Generation",
+    featureMemory: "Memory",
+    featureAskUser: "Ask Me",
+    featureShareToUser: "Share to User"
   }
 };
 
@@ -1143,26 +1209,24 @@ var zh_CN_default = {
     promptRefusal: "\u26A0\uFE0F \u6A21\u578B\u62D2\u7EDD\u56DE\u7B54",
     promptCancelled: "\u26A0\uFE0F \u751F\u6210\u5DF2\u53D6\u6D88",
     noActiveSession: "\u5F53\u524D\u6CA1\u6709\u6D3B\u8DC3\u7684\u4F1A\u8BDD",
-    title: "\u6807\u9898",
-    cwd: "\u5DE5\u4F5C\u76EE\u5F55",
     projectDir: "\u9879\u76EE\u76EE\u5F55",
     agent: "Agent",
     features: "\u529F\u80FD",
     mcpServers: "MCP \u670D\u52A1\u5668",
     project: "\u9879\u76EE",
-    sessionInfo: "\u5F53\u524D\u4F1A\u8BDD",
     sessionList: "\u5207\u6362\u4F1A\u8BDD",
     sessionListDesc: "\u8BF7\u5728\u4E0B\u5217\u4F1A\u8BDD\u4E2D\u9009\u62E9\uFF1A",
     newSessionDesc: "\u8BF7\u5728\u4E0B\u5217\u9879\u76EE\u4E2D\u9009\u62E9\uFF1A",
     noSessions: "\u5F53\u524D\u6CA1\u6709\u53EF\u7528\u4F1A\u8BDD\u3002",
     switchSessionHint: "\u8BF7\u56DE\u590D\u5E8F\u53F7\u5207\u6362\u4F1A\u8BDD",
     switchSessionGuide: "\u{1F4A1} \u53D1\u9001 !s \u5207\u6362\u4F1A\u8BDD",
-    invalidSessionNumber: "\u65E0\u6548\u5E8F\u53F7\uFF0C\u8BF7\u8F93\u5165 {{min}}-{{max}} \u4E4B\u95F4\u7684\u6570\u5B57\u3002\u8BF7\u53D1\u9001\u6307\u4EE4\u91CD\u65B0\u8BBE\u7F6E\u3002",
+    invalidMenuNumber: "\u65E0\u6548\u5E8F\u53F7\uFF0C\u8BF7\u8F93\u5165 {{min}}-{{max}} \u4E4B\u95F4\u7684\u6570\u5B57\u3002",
+    unknownCommand: "\u2753 \u672A\u77E5\u547D\u4EE4\u3002\u53D1\u9001 ! \u67E5\u770B\u5F53\u524D\u4F1A\u8BDD\u72B6\u6001\u4E0E\u547D\u4EE4\u5217\u8868\u3002",
     switchedToSession: "\u5DF2\u5207\u6362\u5230\u300C{{label}}\u300D",
     newSession: "\u65B0\u4F1A\u8BDD",
     newSessionTitle: "\u65B0\u5EFA\u4F1A\u8BDD",
     noProjects: "\u5F53\u524D\u6CA1\u6709\u53EF\u7528\u9879\u76EE\u3002",
-    createSessionHint: "\u8BF7\u56DE\u590D\u5E8F\u53F7\u521B\u5EFA\u65B0\u4F1A\u8BDD\uFF08\u53D1\u9001\u5176\u4ED6\u5185\u5BB9\u53D6\u6D88\uFF09",
+    createSessionHint: "\u8BF7\u56DE\u590D\u5E8F\u53F7\u521B\u5EFA\u65B0\u4F1A\u8BDD",
     createSessionGuide: "\u{1F4A1} \u53D1\u9001 !n \u65B0\u5EFA\u4F1A\u8BDD",
     noAgent: "\u6CA1\u6709\u53EF\u7528\u7684 Agent\uFF0C\u8BF7\u5148\u5728\u8BBE\u7F6E\u4E2D\u914D\u7F6E\u3002",
     createdAndSwitched: "\u2705 \u5DF2\u5207\u6362\u5230\u9879\u76EE\u300C{{project}}\u300D\u7684\u65B0\u4F1A\u8BDD",
@@ -1177,7 +1241,32 @@ var zh_CN_default = {
     snippetListDesc: "\u8BF7\u5728\u4E0B\u5217\u5FEB\u6377\u77ED\u8BED\u4E2D\u9009\u62E9\uFF1A",
     noSnippets: "\u5F53\u524D\u6CA1\u6709\u5FEB\u6377\u77ED\u8BED\uFF0C\u8BF7\u5148\u5728\u8BBE\u7F6E\u4E2D\u6DFB\u52A0\u3002",
     selectSnippetHint: "\u8BF7\u56DE\u590D\u5E8F\u53F7\u53D1\u9001\u5FEB\u6377\u77ED\u8BED",
-    snippetSent: "\u2705 \u5FEB\u6377\u77ED\u8BED\u300C{{title}}\u300D\u5DF2\u53D1\u9001"
+    snippetSent: "\u2705 \u5FEB\u6377\u77ED\u8BED\u300C{{title}}\u300D\u5DF2\u53D1\u9001",
+    featuresMenu: "\u529F\u80FD\u5F00\u5173",
+    featuresMenuDesc: "\u8BF7\u5728\u4E0B\u5217\u529F\u80FD\u4E2D\u5207\u6362\uFF08\u7ACB\u5373\u751F\u6548\uFF09\uFF1A",
+    mcpMenu: "MCP \u670D\u52A1\u5668\u5F00\u5173",
+    mcpMenuDesc: "\u8BF7\u5728\u4E0B\u5217 MCP \u670D\u52A1\u5668\u4E2D\u5207\u6362\uFF08\u7ACB\u5373\u751F\u6548\uFF09\uFF1A",
+    toggleHint: "\u8BF7\u56DE\u590D\u5E8F\u53F7\u5207\u6362\u8BE5\u9879\uFF0C\u53D1\u9001 0 \u9000\u51FA\u83DC\u5355",
+    featureGuide: "\u{1F4A1} \u53D1\u9001 !f \u5207\u6362\u529F\u80FD",
+    mcpServerGuide: "\u{1F4A1} \u53D1\u9001 !c \u5207\u6362 MCP \u670D\u52A1\u5668",
+    noToggleItems: "\u5F53\u524D\u6CA1\u6709\u53EF\u5207\u6362\u7684\u9879\u3002",
+    toggleCancelled: "\u5DF2\u9000\u51FA\uFF0C\u672A\u505A\u4FEE\u6539\u3002",
+    toggledOn: "\u2705 \u5DF2\u5F00\u542F",
+    toggledOff: "\u2705 \u5DF2\u5173\u95ED",
+    toggleSavedRestartFailed: "{{label}}\uFF0C\u4F46\u4F1A\u8BDD\u91CD\u542F\u5931\u8D25\uFF0C\u6539\u52A8\u5C06\u5728\u4E0B\u6B21\u6062\u590D\u4F1A\u8BDD\u65F6\u751F\u6548\u3002",
+    permissionMenu: "\u6743\u9650",
+    permissionMenuDesc: "\u8BF7\u5728\u4E0B\u5217\u6743\u9650\u6A21\u5F0F\u4E2D\u9009\u62E9\uFF1A",
+    permissionAsk: "\u6BCF\u6B21\u8BE2\u95EE",
+    permissionAllowAll: "\u5168\u90E8\u5141\u8BB8",
+    switchPermissionHint: "\u8BF7\u56DE\u590D\u5E8F\u53F7\u5207\u6362\u6743\u9650\u6A21\u5F0F",
+    permissionGuide: "\u{1F4A1} \u53D1\u9001 !p \u5207\u6362\u6743\u9650",
+    permissionSwitched: "\u2705 \u5DF2\u5207\u6362\u4E3A {{mode}}",
+    featureSkills: "\u6280\u80FD",
+    featureSearch: "\u9879\u76EE\u68C0\u7D22",
+    featureImageGeneration: "\u56FE\u7247\u751F\u6210",
+    featureMemory: "\u8BB0\u5FC6",
+    featureAskUser: "\u5411\u6211\u63D0\u95EE",
+    featureShareToUser: "\u5206\u4EAB\u7ED9\u7528\u6237"
   }
 };
 
@@ -1366,10 +1455,35 @@ import { join as join8 } from "path";
 import { readFile as readFile3, stat as stat2 } from "fs/promises";
 
 // src/backend/serve-file.ts
+import { createReadStream } from "fs";
 import { stat, readFile as readFile2 } from "fs/promises";
 import { resolve, relative, isAbsolute } from "path";
 import * as mimeTypes from "mime-types";
-async function serveFile(filename, cwd) {
+var RANGE_RE = /^bytes=(\d*)-(\d*)$/;
+function parseRange(header, size) {
+  const raw = header?.trim();
+  if (!raw) return null;
+  const match = RANGE_RE.exec(raw);
+  if (!match) return null;
+  const [, startRaw = "", endRaw = ""] = match;
+  if (!startRaw && !endRaw) return null;
+  let start;
+  let end;
+  if (!startRaw) {
+    const suffix = Number(endRaw);
+    if (!Number.isFinite(suffix) || suffix <= 0) return null;
+    start = Math.max(0, size - suffix);
+    end = size - 1;
+  } else {
+    start = Number(startRaw);
+    end = endRaw ? Math.min(Number(endRaw), size - 1) : size - 1;
+  }
+  if (!Number.isFinite(start) || !Number.isFinite(end)) return null;
+  if (start >= size) return "unsatisfiable";
+  if (end < start) return null;
+  return { start, end };
+}
+async function serveFile(filename, cwd, options = {}) {
   const safeCwd = resolve(cwd);
   const fullPath = resolve(safeCwd, filename || "");
   const rel = relative(safeCwd, fullPath);
@@ -1413,13 +1527,38 @@ async function serveFile(filename, cwd) {
       error: `Not a file: ${filename}`
     };
   }
+  const mimeType = mimeTypes.lookup(fullPath) || "application/octet-stream";
+  const size = fileStat.size;
+  const range = size > 0 ? parseRange(options.range, size) : null;
+  if (range === "unsatisfiable") {
+    return {
+      status: 416,
+      body: "",
+      mimeType,
+      headers: { "Accept-Ranges": "bytes", "Content-Range": `bytes */${size}` },
+      error: `Range not satisfiable: ${options.range} (size ${size})`
+    };
+  }
+  if (range) {
+    return {
+      status: 206,
+      stream: createReadStream(fullPath, { start: range.start, end: range.end }),
+      mimeType,
+      headers: {
+        "Accept-Ranges": "bytes",
+        "Content-Length": String(range.end - range.start + 1),
+        "Content-Range": `bytes ${range.start}-${range.end}/${size}`
+      }
+    };
+  }
   try {
     const content = await readFile2(fullPath);
-    const mimeType = mimeTypes.lookup(fullPath) || "application/octet-stream";
     return {
       status: 200,
       body: new Uint8Array(content),
-      mimeType
+      mimeType,
+      // 声明支持 Range：媒体元素据此决定能否拖动进度条
+      headers: { "Accept-Ranges": "bytes", "Content-Length": String(size) }
     };
   } catch (err) {
     return {
@@ -1451,8 +1590,23 @@ function normalizeRemainingRuns(value) {
   if (!Number.isFinite(n) || n < 0) return null;
   return n;
 }
+function normalizeCron(raw) {
+  const type = raw?.type === "once" || raw?.type === "manual" ? raw.type : "cron";
+  return {
+    type,
+    expr: type === "cron" ? raw?.expr ?? "" : void 0,
+    at: type === "once" && typeof raw?.at === "number" ? raw.at : void 0
+  };
+}
 function normalizeSchedule(raw) {
-  return { ...raw, remainingRuns: normalizeRemainingRuns(raw.remainingRuns) };
+  const cron = normalizeCron(raw.cron);
+  const remainingRuns = normalizeRemainingRuns(raw.remainingRuns);
+  return {
+    ...raw,
+    cron,
+    // 单次计划用 remainingRuns 作为「是否已执行」标记；缺失（历史数据）按未执行处理
+    remainingRuns: cron.type === "once" ? remainingRuns ?? 1 : remainingRuns
+  };
 }
 var store = {
   scheduleDir(scheduleId) {
@@ -1506,11 +1660,16 @@ var store = {
       agentId: params.agentId,
       modelId: params.modelId,
       prompt: params.prompt,
-      cron: { type: params.cron.type, expr: params.cron.expr ?? "" },
+      cron: {
+        type: params.cron.type,
+        expr: params.cron.type === "cron" ? params.cron.expr ?? "" : void 0,
+        at: params.cron.type === "once" ? params.cron.at : void 0
+      },
       createdAt: now,
       updatedAt: now,
       lastRunAt: null,
-      remainingRuns: normalizeRemainingRuns(params.remainingRuns),
+      // 单次计划用 remainingRuns 作为「是否已执行」标记：创建时固定为 1（待执行）
+      remainingRuns: params.cron.type === "once" ? 1 : normalizeRemainingRuns(params.remainingRuns),
       features: (params.features ?? []).filter((f) => f !== "ask_user" && f !== "share_to_user"),
       mcpServers: params.mcpServers ?? []
     };
@@ -1632,7 +1791,7 @@ function parseFileRoute(url) {
   }
   return null;
 }
-async function serveRoute(route) {
+async function serveRoute(route, options = {}) {
   switch (route.type) {
     case "project": {
       const project = storageOps.getProject(route.projectId);
@@ -1644,7 +1803,7 @@ async function serveRoute(route) {
           error: "Project Not Found"
         };
       }
-      return serveFile(route.relativePath, project.cwd);
+      return serveFile(route.relativePath, project.cwd, options);
     }
     case "share": {
       const shareDir = storageOps.sessionShareDir(route.sessionId);
@@ -1656,7 +1815,7 @@ async function serveRoute(route) {
           error: "Session Not Found"
         };
       }
-      return serveFile(route.sharePath, shareDir);
+      return serveFile(route.sharePath, shareDir, options);
     }
     case "automation": {
       const task = store.getTask(route.scheduleId, route.taskId);
@@ -1669,7 +1828,7 @@ async function serveRoute(route) {
         };
       }
       const taskDir = store.taskDir(route.scheduleId, route.taskId);
-      return serveFile(route.relativePath, taskDir);
+      return serveFile(route.relativePath, taskDir, options);
     }
   }
 }
@@ -1840,9 +1999,17 @@ function createWebUIModule() {
       {
         const route = parseFileRoute(url);
         if (route) {
-          const result = await serveRoute(route);
-          res.writeHead(result.status, { "Content-Type": result.mimeType });
-          res.end(result.body);
+          const result = await serveRoute(route, { range: req.headers.range });
+          res.writeHead(result.status, {
+            "Content-Type": result.mimeType,
+            ...result.headers
+          });
+          if (result.stream) {
+            result.stream.on("error", () => res.destroy());
+            result.stream.pipe(res);
+          } else {
+            res.end(result.body ?? "");
+          }
           return;
         }
       }
@@ -2016,22 +2183,22 @@ function prune() {
     else records.delete(k);
   }
 }
-function recordSelfWrite(projectId, relativePath, stat5) {
+function recordSelfWrite(projectId, relativePath, stat8) {
   prune();
   const k = keyOf(projectId, relativePath);
   const list = records.get(k) ?? [];
-  list.push({ mtimeMs: stat5.mtimeMs, size: stat5.size, at: Date.now() });
+  list.push({ mtimeMs: stat8.mtimeMs, size: stat8.size, at: Date.now() });
   records.set(k, list);
 }
-function isSelfWrite(projectId, relativePath, stat5) {
+function isSelfWrite(projectId, relativePath, stat8) {
   const k = keyOf(projectId, relativePath);
   const list = records.get(k);
-  if (!list || !stat5) return false;
+  if (!list || !stat8) return false;
   const now = Date.now();
   const alive = list.filter((r) => now - r.at <= TTL_MS);
   if (alive.length > 0) records.set(k, alive);
   else records.delete(k);
-  return alive.some((r) => r.mtimeMs === stat5.mtimeMs && r.size === stat5.size);
+  return alive.some((r) => r.mtimeMs === stat8.mtimeMs && r.size === stat8.size);
 }
 
 // src/backend/watcher.ts
@@ -3774,6 +3941,29 @@ function getFilenameFromUri(uri) {
 }
 
 // src/agents/acp-client-tools.ts
+var SHELL_OUTPUT_BYTE_LIMIT = 30 * 1024;
+var SHELL_OUTPUT_TRUNCATED_NOTICE = "[Shell output: earlier output exceeded the output limit and was dropped, only the tail is shown. Narrow the command (e.g. pipe through head/tail/grep) to see the part you need.]\n";
+function keepTailWithinByteLimit(text, byteLimit) {
+  const encoded = new TextEncoder().encode(text);
+  if (encoded.length <= byteLimit) return { text, trimmed: false };
+  let start = encoded.length - byteLimit;
+  while (start < encoded.length && (encoded[start] & 192) === 128) start += 1;
+  return {
+    text: new TextDecoder().decode(encoded.subarray(start)),
+    trimmed: true
+  };
+}
+function formatShellResultForModel(params) {
+  const notes = [];
+  if (params.timedOut) notes.push("timed out and was killed");
+  const exitCode = params.exitStatus?.exitCode ?? null;
+  if (exitCode != null && exitCode !== 0) notes.push(`exited with code ${exitCode}`);
+  const signal = params.exitStatus?.signal ?? null;
+  if (signal) notes.push(`killed by signal ${signal}`);
+  if (notes.length === 0) return params.output;
+  return `${params.output}
+[command ${notes.join("; ")}]`;
+}
 function createACPClientTools(params) {
   const terminals = /* @__PURE__ */ new Map();
   const tools = {
@@ -4100,13 +4290,16 @@ Prefer dedicated tools first:
 - Grep: search content (equivalent: rg "pattern" src or grep -R "pattern" src)
 - Glob/find-style discovery: find files (equivalent: find . -name "*.ts")
 Use Shell as fallback when those tools cannot complete the task.
-Avoid destructive commands and prefer deterministic, non-interactive commands.`,
+Avoid destructive commands and prefer deterministic, non-interactive commands.
+Output returned to you is capped at 30720 bytes: beyond that only the tail is kept and a notice is prepended (the terminal buffer uses the same rule). The user still sees the full output in the terminal panel. When output may be large, narrow it in the command itself (pipe through head/tail/grep, or add flags like --no-pager).`,
       inputSchema: z4.object({
         command: z4.string().describe("Executable command."),
         args: z4.array(z4.string()).optional().describe("Command arguments."),
         cwd: z4.string().optional().describe("Absolute working directory."),
         env: z4.record(z4.string(), z4.string()).optional().describe("Environment variables map."),
-        outputByteLimit: z4.number().int().positive().optional().describe("Output retention byte limit."),
+        outputByteLimit: z4.number().int().positive().optional().describe(
+          "Terminal buffer retention limit in bytes. Defaults to 30720, which is also the cap on the output returned to you."
+        ),
         timeoutSeconds: z4.number().positive().optional().describe("Timeout before killing command.")
       }),
       execute: async ({ command, args: args2, cwd, env, outputByteLimit, timeoutSeconds }, { toolCallId }) => {
@@ -4147,7 +4340,8 @@ Avoid destructive commands and prefer deterministic, non-interactive commands.`,
             args: args2,
             cwd: cwd ?? null,
             env: toEnvVariables(env),
-            outputByteLimit: outputByteLimit ?? null
+            // 未指定时用统一预算，避免 ACP 侧落回 agent-bridge 的 1MB 默认值
+            outputByteLimit: outputByteLimit ?? SHELL_OUTPUT_BYTE_LIMIT
           });
           terminals.set(terminal.id, terminal);
           const toolCallStartUpdate = {
@@ -4184,11 +4378,12 @@ Avoid destructive commands and prefer deterministic, non-interactive commands.`,
             terminals.delete(terminal.id);
           }
           const finalOutput = output ?? { output: "", truncated: false, exitStatus: null };
+          const exitStatus = finalOutput.exitStatus ?? null;
           const sessionOutput = {
             terminalId: terminal.id,
             output: finalOutput.output,
             truncated: finalOutput.truncated,
-            exitStatus: finalOutput.exitStatus ?? null,
+            exitStatus,
             timedOut
           };
           await connection.sessionUpdate({
@@ -4201,7 +4396,13 @@ Avoid destructive commands and prefer deterministic, non-interactive commands.`,
               content: toolCallStartUpdate.content
             }
           });
-          return sessionOutput;
+          const keptOutput = keepTailWithinByteLimit(finalOutput.output, SHELL_OUTPUT_BYTE_LIMIT);
+          const headDropped = finalOutput.truncated || keptOutput.trimmed;
+          return formatShellResultForModel({
+            output: headDropped ? SHELL_OUTPUT_TRUNCATED_NOTICE + keptOutput.text : keptOutput.text,
+            exitStatus,
+            timedOut
+          });
         } catch (error) {
           const errorText = error instanceof Error ? error.message : String(error);
           await connection.sessionUpdate({
@@ -4821,67 +5022,87 @@ import { z as z5 } from "zod";
 function createImageAnalysisTool(params) {
   return {
     ImageAnalysis: tool2({
-      description: `Analyze an image file by reading it and using vision capabilities to understand its content.
+      description: `Analyze one or more image files by reading them and using vision capabilities to understand their content.
 
-Use this when you need to visually understand or analyze image content (e.g., describe what's in the image, extract text from a screenshot, analyze a diagram, identify UI elements, read charts).
+Use this when you need to visually understand or analyze image content (e.g., describe what's in the image, extract text from a screenshot, analyze a diagram, identify UI elements, read charts). Pass every image that belongs to the same question in a single call (up to 10 per call) so the model can compare them: each image carries a name that labels it in the request, so you can refer to that name in the query and attribute the findings in the answer.
 
 For simple metadata queries (dimensions, format), use image_metadata instead.
 
-Provide a specific query describing what you want to know about the image \u2014 the more specific the query, the better the analysis.`,
+Provide a specific query describing what you want to know about the images \u2014 the more specific the query, the better the analysis.`,
       inputSchema: z5.object({
-        path: z5.string().describe("Absolute or project-relative path to the image file."),
+        images: z5.array(
+          z5.object({
+            name: z5.string().describe(
+              "Short label identifying this image (e.g. 'login page' or 'before'). It is sent to the model as the image's caption and also shown in the UI."
+            ),
+            path: z5.string().describe("Absolute or project-relative path to the image file.")
+          })
+        ).min(1).max(10).describe(
+          "Images to analyze together, in order. Min 1, max 10 \u2014 every image is sent to the model in the same request, so split larger batches into several calls."
+        ),
         query: z5.string().describe(
-          "What you want to know about the image. Be specific (e.g., 'Extract all text from this screenshot', 'Describe the UI layout', 'What colors are used in this chart?')."
+          "What you want to know about the images. Be specific (e.g., 'Extract all text from this screenshot', 'Describe the UI layout', 'Which of these charts has the highest value?')."
         )
       }),
-      execute: async ({ path: imgPath, query }, { toolCallId }) => {
+      execute: async ({ images, query }, { toolCallId }) => {
         const connection = params.getConnection();
+        const imageLabel = images.map((image) => image.name).join(", ");
         if (connection) {
           await connection.sessionUpdate({
             sessionId: params.sessionId,
             update: {
               sessionUpdate: "tool_call",
               toolCallId,
-              title: `image_analysis ${imgPath}`,
+              title: `image_analysis ${imageLabel}`,
               kind: "read",
               status: "in_progress",
-              rawInput: { path: imgPath, query }
+              rawInput: { images, query }
             }
           });
         }
         try {
-          const absPath = resolve7(params.cwd, imgPath);
-          const buffer = await readFile6(absPath);
-          const base64 = buffer.toString("base64");
-          const mimeType = mime.lookup(absPath) || "image/png";
+          const content = [];
+          const failures = [];
+          for (const image of images) {
+            try {
+              const absPath = resolve7(params.cwd, image.path);
+              const buffer = await readFile6(absPath);
+              const mimeType = mime.lookup(absPath) || "image/png";
+              content.push({ type: "text", text: `Image "${image.name}":` });
+              content.push({
+                type: "file",
+                data: buffer.toString("base64"),
+                mediaType: mimeType
+              });
+            } catch (error) {
+              const reason = error instanceof Error ? error.message : String(error);
+              failures.push(`${image.name} (${image.path}): ${reason}`);
+            }
+          }
+          if (content.length === 0) {
+            throw new Error(`Failed to read any image \u2014 ${failures.join("; ")}`);
+          }
+          content.push({ type: "text", text: query });
           const result = await generateText({
             model: params.getModel(),
             messages: [
               {
                 role: "user",
-                content: [
-                  {
-                    type: "image",
-                    image: base64,
-                    mediaType: mimeType
-                  },
-                  {
-                    type: "text",
-                    text: query
-                  }
-                ]
+                content
               }
             ],
             abortSignal: params.parentSignal,
             providerOptions: {
               openaiCompatible: {
                 thinking: { type: "disabled" },
-                enable_thinking: false,
-                reasoningEffort: "high"
+                enable_thinking: false
               }
             }
           });
           const analysisText = result.text || "(no analysis returned)";
+          const outputText = failures.length > 0 ? `${analysisText}
+
+[failed to read: ${failures.join("; ")}]` : analysisText;
           if (connection) {
             await connection.sessionUpdate({
               sessionId: params.sessionId,
@@ -4892,13 +5113,13 @@ Provide a specific query describing what you want to know about the image \u2014
                 content: [
                   {
                     type: "content",
-                    content: { type: "text", text: analysisText }
+                    content: { type: "text", text: outputText }
                   }
                 ]
               }
             });
           }
-          return analysisText;
+          return outputText;
         } catch (error) {
           const errorText = error instanceof Error ? error.message : String(error);
           if (connection) {
@@ -4911,13 +5132,16 @@ Provide a specific query describing what you want to know about the image \u2014
                 content: [
                   {
                     type: "content",
-                    content: { type: "text", text: `Error analyzing image: ${errorText}` }
+                    content: {
+                      type: "text",
+                      text: `Error analyzing images: ${errorText}`
+                    }
                   }
                 ]
               }
             });
           }
-          return `Error analyzing image: ${errorText}`;
+          return `Error analyzing images: ${errorText}`;
         }
       }
     })
@@ -5468,6 +5692,17 @@ var COMPACT_PROMPT = `Compress the conversation into a structured markdown summa
  Use headings and bullet points for clarity.
  Detect the user's commonly used language from the conversation history and respond in that language.
  Output only the summary.`;
+function buildCompactSummaryMessage(summary) {
+  return {
+    role: "user",
+    content: `<previous_conversation_summary>
+This session continues from a previous conversation that ran out of context.
+The summary below covers the earlier portion of the conversation.
+
+${summary}
+</previous_conversation_summary>`
+  };
+}
 var OpenaiCompatibleAgent = class {
   sessions = /* @__PURE__ */ new Map();
   provider;
@@ -5498,6 +5733,9 @@ var OpenaiCompatibleAgent = class {
       name: "openai-compatible",
       baseURL: this.baseUrl,
       apiKey: this.apiKey,
+      // 流式请求需带 stream_options.include_usage，否则 vLLM 等服务端
+      // 不会在流中返回 usage，导致整轮 token 用量为 0。
+      includeUsage: true,
       headers: {
         "User-Agent": AgentDescription,
         ...this.headers
@@ -5863,12 +6101,7 @@ var OpenaiCompatibleAgent = class {
       maxOutputTokens: 5e3
     });
     const summary = summaryResult.text;
-    session.history = [
-      {
-        role: "system",
-        content: `Summary of previous conversation: ${summary}`
-      }
-    ];
+    session.history = [buildCompactSummaryMessage(summary)];
     await savePersistedSessionHistory({
       agentId: this.agentId,
       sessionId: session.id,
@@ -6016,7 +6249,7 @@ var OpenaiCompatibleAgent = class {
         system: systemPrompt,
         messages: [...session.history, userMessage],
         tools: allTools,
-        stopWhen: isStepCount2(128),
+        stopWhen: isStepCount2(256),
         abortSignal: abortController.signal,
         providerOptions: {
           openaiCompatible: {
@@ -6246,6 +6479,7 @@ var AgentTerminalManager = class {
       process: proc,
       outputBuffer: Buffer.alloc(0),
       outputByteLimit,
+      truncated: false,
       exitCode: null,
       signal: null,
       isFinished: false,
@@ -6258,7 +6492,12 @@ var AgentTerminalManager = class {
     const handleData = (chunk) => {
       let newBuffer = Buffer.concat([terminal.outputBuffer, chunk]);
       if (newBuffer.length > terminal.outputByteLimit) {
-        newBuffer = newBuffer.subarray(newBuffer.length - terminal.outputByteLimit);
+        let start = newBuffer.length - terminal.outputByteLimit;
+        while (start < newBuffer.length && (newBuffer.readUInt8(start) & 192) === 128) {
+          start += 1;
+        }
+        newBuffer = newBuffer.subarray(start);
+        terminal.truncated = true;
       }
       terminal.outputBuffer = newBuffer;
       const text = terminal.outputDecoder.decode(chunk, { stream: true });
@@ -6287,8 +6526,7 @@ var AgentTerminalManager = class {
     }
     return {
       output: terminal.outputDecoder.decode(terminal.outputBuffer),
-      truncated: false
-      // Simplification
+      truncated: terminal.truncated
     };
   }
   getTerminal(terminalId) {
@@ -7710,6 +7948,9 @@ function createTerminalModule(ctx, deps) {
   };
 }
 
+// src/backend/project/index.ts
+import { stat as stat5 } from "fs/promises";
+
 // src/backend/project/filesystem.ts
 import Fuse from "fuse.js";
 import {
@@ -8203,7 +8444,12 @@ function createProjectModule(ctx, deps) {
     return storage.listProjects();
   }
   async function addProject2(cwd) {
-    const info = storage.addProject(cwd);
+    const trimmed = cwd.trim();
+    const s = await stat5(trimmed).catch(() => null);
+    if (!s || !s.isDirectory()) {
+      throw new Error(`Not a directory: ${trimmed}`);
+    }
+    const info = storage.addProject(trimmed);
     fs2.initProjectFsVersion(info.id);
     await deps.watcher.syncWatchers();
     sendEvent("projects-changed", void 0);
@@ -10067,6 +10313,32 @@ function createIlinkModule(ctx) {
     if (!handlers) throw new Error("[ilink] handlers not yet initialized");
     return handlers;
   }
+  function parseMenuIndex(input) {
+    const match = input.match(/^\d+/);
+    return match ? parseInt(match[0], 10) : null;
+  }
+  async function replyInvalidIndex(msg, max) {
+    if (!msg.from_user_id) return;
+    await bridge?.sendTextReply(
+      msg.from_user_id,
+      t("ilink.invalidMenuNumber", { min: "1", max: String(max) })
+    );
+  }
+  async function replyUnknownCommand(msg) {
+    if (!msg.from_user_id) return;
+    await bridge?.sendTextReply(msg.from_user_id, t("ilink.unknownCommand"));
+  }
+  const FEATURE_LABEL_KEYS = {
+    skills: "ilink.featureSkills",
+    search: "ilink.featureSearch",
+    image_generation: "ilink.featureImageGeneration",
+    memory: "ilink.featureMemory",
+    ask_user: "ilink.featureAskUser",
+    share_to_user: "ilink.featureShareToUser"
+  };
+  function getFeatureLabel(feature) {
+    return t(FEATURE_LABEL_KEYS[feature]);
+  }
   const state = {
     getBridge: () => bridge,
     getActiveSessionId: () => activeSessionId,
@@ -10099,88 +10371,99 @@ function createIlinkModule(ctx) {
           const combinedText = [text, voiceText].filter(Boolean).join("\n");
           if (!combinedText.trim() && !hasImages) return;
           const trimmed = text.trim();
-          if (commandPending) {
-            commandPending(trimmed);
-            commandPending = null;
-            return;
-          }
           if (trimmed[0] === "!" || trimmed[0] === "\uFF01") {
+            commandPending = null;
             await handleIlinkCommand(trimmed, msg);
             return;
           }
-          const sessionId = activeSessionId ?? "";
-          if (!sessionId) {
-            console.warn("[iLink] No active session, ignoring message");
-            if (msg.from_user_id) {
-              const lines = [
-                `\u{1F4CB} **${t("ilink.noActiveSession")}**`,
-                "",
-                t("ilink.switchSessionGuide"),
-                t("ilink.createSessionGuide")
-              ];
-              await bridge?.sendTextReply(msg.from_user_id, lines.join("\n"));
-            }
-            return;
-          }
-          const contents = [];
-          if (combinedText.trim()) contents.push({ type: "text", text: combinedText });
-          if (hasImages && bridge) {
-            const { useOriginalImage } = storage.getSettings().ilink;
-            for (const item of msg.item_list ?? []) {
-              if (item.type !== 2 || !item.image_item) continue;
-              try {
-                const base64 = await bridge.downloadImage(item.image_item, { useOriginalImage });
-                if (base64) contents.push({ type: "image", data: base64, mimeType: "image/jpeg" });
-              } catch (err) {
-                console.error("[iLink] Failed to download image:", err);
-              }
-            }
-          }
-          if (contents.length === 0) return;
-          const h = getHandlers();
-          const pending = await h.getPendingAskUserRequests({ sessionId });
-          if (pending.length > 0) {
-            const req = pending[0];
-            const options = req.options;
-            let respondedValue = null;
-            if (/^\d+$/.test(trimmed)) {
-              const index = parseInt(trimmed, 10) - 1;
-              const option = options[index];
-              if (option) respondedValue = option.value;
-            }
-            if (respondedValue !== null) {
-              await h.respondAskUser({
-                sessionId,
-                askUserId: req.askUserId,
-                value: respondedValue
-              });
-            } else {
-              await h.respondAskUser({
-                sessionId,
-                askUserId: req.askUserId,
-                value: null,
-                reason: trimmed || t("ilink.noInput")
-              });
-            }
-            if (bridge?.isConnected && activeSessionId === sessionId) {
-              const userId = bridge.userId;
-              if (userId) bridge.sendTyping(userId, true).catch(() => {
-              });
+          if (commandPending) {
+            const index = parseMenuIndex(trimmed);
+            if (index !== null) {
+              const pending = commandPending;
+              commandPending = null;
+              await pending(index);
+              return;
             }
-            return;
-          }
-          try {
-            await h.sendPrompt({ sessionId, contents });
-          } catch (err) {
-            console.error("[iLink] Failed to route message to session:", err);
-            if (msg.from_user_id)
-              await bridge?.sendTextReply(msg.from_user_id, t("ilink.errorProcessing"));
+            commandPending = null;
           }
+          await handleUserMessage(msg, { trimmed, combinedText, hasImages });
         }
       });
     }
     return bridge;
   }
+  async function handleUserMessage(msg, input) {
+    const { trimmed, combinedText, hasImages } = input;
+    const sessionId = activeSessionId ?? "";
+    if (!sessionId) {
+      console.warn("[iLink] No active session, ignoring message");
+      if (msg.from_user_id) {
+        const lines = [
+          `\u{1F4CB} **${t("ilink.noActiveSession")}**`,
+          "",
+          t("ilink.switchSessionGuide"),
+          "",
+          t("ilink.createSessionGuide")
+        ];
+        await bridge?.sendTextReply(msg.from_user_id, lines.join("\n"));
+      }
+      return;
+    }
+    const contents = [];
+    if (combinedText.trim()) contents.push({ type: "text", text: combinedText });
+    if (hasImages && bridge) {
+      const { useOriginalImage } = storage.getSettings().ilink;
+      for (const item of msg.item_list ?? []) {
+        if (item.type !== 2 || !item.image_item) continue;
+        try {
+          const base64 = await bridge.downloadImage(item.image_item, { useOriginalImage });
+          if (base64) contents.push({ type: "image", data: base64, mimeType: "image/jpeg" });
+        } catch (err) {
+          console.error("[iLink] Failed to download image:", err);
+        }
+      }
+    }
+    if (contents.length === 0) return;
+    const h = getHandlers();
+    const pending = await h.getPendingAskUserRequests({ sessionId });
+    if (pending.length > 0) {
+      const req = pending[0];
+      const options = req.options;
+      let respondedValue = null;
+      if (/^\d+$/.test(trimmed)) {
+        const index = parseInt(trimmed, 10) - 1;
+        const option = options[index];
+        if (option) respondedValue = option.value;
+      }
+      if (respondedValue !== null) {
+        await h.respondAskUser({
+          sessionId,
+          askUserId: req.askUserId,
+          value: respondedValue
+        });
+      } else {
+        await h.respondAskUser({
+          sessionId,
+          askUserId: req.askUserId,
+          value: null,
+          reason: trimmed || t("ilink.noInput")
+        });
+      }
+      if (bridge?.isConnected && activeSessionId === sessionId) {
+        const userId = bridge.userId;
+        if (userId) bridge.sendTyping(userId, true).catch(() => {
+        });
+      }
+      return;
+    }
+    try {
+      await h.sendPrompt({ sessionId, contents });
+    } catch (err) {
+      console.error("[iLink] Failed to route message to session:", err);
+      if (msg.from_user_id)
+        await bridge?.sendTextReply(msg.from_user_id, t("ilink.errorProcessing"));
+    }
+  }
   async function handleIlinkCommand(trimmed, msg) {
     const session = activeSessionId ? storage.getSession(activeSessionId) : null;
     if (session && session.isStreaming) {
@@ -10189,11 +10472,16 @@ function createIlinkModule(ctx) {
       });
     }
     const [command] = trimmed.slice(1).split(/\s+/);
-    if (command.toLowerCase() === "s") await handleCommandSwitchSession(msg);
-    else if (command.toLowerCase() === "n") await handleCommandNewSession(msg);
-    else if (command.toLowerCase() === "m") await handleCommandSwitchModel(msg);
-    else if (command.toLowerCase() === "q") await handleCommandSnippet(msg);
-    else await handleCommandInfo(msg);
+    const name = command.toLowerCase();
+    if (name === "") await handleCommandInfo(msg);
+    else if (name === "s") await handleCommandSwitchSession(msg);
+    else if (name === "n") await handleCommandNewSession(msg);
+    else if (name === "m") await handleCommandSwitchModel(msg);
+    else if (name === "p") await handleCommandPermission(msg);
+    else if (name === "f") await handleCommandFeatures(msg);
+    else if (name === "c") await handleCommandMcpServers(msg);
+    else if (name === "q") await handleCommandSnippet(msg);
+    else await replyUnknownCommand(msg);
   }
   async function handleCommandSwitchSession(msg) {
     const allSessions = storage.listSessions();
@@ -10205,7 +10493,7 @@ function createIlinkModule(ctx) {
     const projectMap = new Map(projects.map((p) => [p.id, p]));
     const lines = [];
     lines.push(`\u{1F4CB} **${t("ilink.sessionList")}**`);
-    lines.push(t("ilink.sessionListDesc"));
+    lines.push("", t("ilink.sessionListDesc"));
     let index = 1;
     let isFirstGroup = true;
     const sessionEntries = [];
@@ -10222,39 +10510,37 @@ function createIlinkModule(ctx) {
 ---`);
       isFirstGroup = false;
       lines.push(`
-**${projectName}**`);
+**${projectName}**`, "");
       for (const s of sessions) {
         const marker = s.id === activeSessionId ? " \u{1F448}" : "";
         const label = s.title || t("ilink.newSession");
-        lines.push(`  ${index}. ${label}${marker}`);
+        const agentId = s.agentId;
+        lines.push(`  ${index}. [${agentId}] ${label}${marker}`);
         sessionEntries.push({ sessionId: s.id, label });
         index++;
       }
     }
     lines.push("", "---", t("ilink.switchSessionHint"));
     if (msg.from_user_id) await bridge?.sendTextReply(msg.from_user_id, lines.join("\n"));
-    commandPending = (input) => {
-      const num = parseInt(input, 10);
-      if (isNaN(num) || num < 1 || num > sessionEntries.length) {
-        if (msg.from_user_id)
-          bridge?.sendTextReply(
-            msg.from_user_id,
-            t("ilink.invalidSessionNumber", { min: "1", max: String(sessionEntries.length) })
-          );
+    const pending = async (index2) => {
+      const entry = sessionEntries[index2 - 1];
+      if (!entry) {
+        await replyInvalidIndex(msg, sessionEntries.length);
+        commandPending = pending;
         return;
       }
-      const entry = sessionEntries[num - 1];
       activeSessionId = entry.sessionId;
       replyBuffer = "";
       writeActiveSessionId(entry.sessionId).catch(() => {
       });
       sendEvent("ilink-active-session-changed", { sessionId: entry.sessionId });
       if (msg.from_user_id)
-        bridge?.sendTextReply(
+        await bridge?.sendTextReply(
           msg.from_user_id,
           t("ilink.switchedToSession", { label: entry.label })
         );
     };
+    commandPending = pending;
   }
   async function handleCommandNewSession(msg) {
     const allProjects = storage.listProjects();
@@ -10265,7 +10551,7 @@ function createIlinkModule(ctx) {
     const sortedProjects = [...allProjects].sort((a, b) => a.title.localeCompare(b.title));
     const lines = [];
     lines.push(`\u{1F4CB} **${t("ilink.newSessionTitle")}**`);
-    lines.push(t("ilink.newSessionDesc"));
+    lines.push("", t("ilink.newSessionDesc"));
     const projectEntries = [];
     sortedProjects.forEach((p, i) => {
       lines.push(`  ${i + 1}. ${p.title}`);
@@ -10273,17 +10559,13 @@ function createIlinkModule(ctx) {
     });
     lines.push("", "---", t("ilink.createSessionHint"));
     if (msg.from_user_id) await bridge?.sendTextReply(msg.from_user_id, lines.join("\n"));
-    commandPending = (input) => {
-      const num = parseInt(input, 10);
-      if (isNaN(num) || num < 1 || num > projectEntries.length) {
-        if (msg.from_user_id)
-          bridge?.sendTextReply(
-            msg.from_user_id,
-            t("ilink.invalidSessionNumber", { min: "1", max: String(projectEntries.length) })
-          );
+    const pending = (index) => {
+      const entry = projectEntries[index - 1];
+      if (!entry) {
+        void replyInvalidIndex(msg, projectEntries.length);
+        commandPending = pending;
         return;
       }
-      const entry = projectEntries[num - 1];
       const settings = storage.getSettings();
       const agent2 = settings.agents.find((a) => !a.disabled);
       if (!agent2) {
@@ -10313,31 +10595,34 @@ function createIlinkModule(ctx) {
         if (msg.from_user_id) bridge?.sendTextReply(msg.from_user_id, t("ilink.errorProcessing"));
       });
     };
+    commandPending = pending;
   }
   async function handleCommandSwitchModel(msg) {
     const sessionId = activeSessionId ?? "";
     if (!sessionId) {
-      if (msg.from_user_id) {
-        await bridge?.sendTextReply(
-          msg.from_user_id,
-          [
-            `\u{1F4CB} **${t("ilink.noActiveSession")}**`,
-            "",
-            t("ilink.switchSessionGuide"),
-            t("ilink.createSessionGuide")
-          ].join("\n")
-        );
+      await replyNoActiveSession(msg);
+      return;
+    }
+    let modelState;
+    try {
+      modelState = await getHandlers().getModels({ sessionId });
+      if (!modelState) {
+        await getHandlers().loadSession({ sessionId });
+        modelState = await getHandlers().getModels({ sessionId });
       }
+    } catch (err) {
+      console.error("[iLink] Failed to prepare model list:", err);
+      if (msg.from_user_id)
+        await bridge?.sendTextReply(msg.from_user_id, t("ilink.errorProcessing"));
       return;
     }
-    const modelState = await getHandlers().getModels({ sessionId });
     if (!modelState || !modelState.availableModels || modelState.availableModels.length === 0) {
       if (msg.from_user_id) await bridge?.sendTextReply(msg.from_user_id, t("ilink.noModels"));
       return;
     }
     const lines = [];
     lines.push(`\u{1F9E0} **${t("ilink.modelList")}**`);
-    lines.push(t("ilink.modelListDesc"));
+    lines.push("", t("ilink.modelListDesc"));
     const modelEntries = [];
     modelState.availableModels.forEach((m, i) => {
       const marker = m.modelId === modelState.currentModelId ? " \u{1F448}" : "";
@@ -10347,28 +10632,225 @@ function createIlinkModule(ctx) {
     });
     lines.push("", "---", t("ilink.switchModelHint"));
     if (msg.from_user_id) await bridge?.sendTextReply(msg.from_user_id, lines.join("\n"));
-    commandPending = (input) => {
-      const num = parseInt(input, 10);
-      if (isNaN(num) || num < 1 || num > modelEntries.length) {
+    const pending = (index) => {
+      const entry = modelEntries[index - 1];
+      if (!entry) {
+        void replyInvalidIndex(msg, modelEntries.length);
+        commandPending = pending;
+        return;
+      }
+      getHandlers().setModel({ sessionId, modelId: entry.modelId }).then(() => {
         if (msg.from_user_id)
           bridge?.sendTextReply(
             msg.from_user_id,
-            t("ilink.invalidSessionNumber", { min: "1", max: String(modelEntries.length) })
+            t("ilink.switchedToModel", { model: entry.label })
           );
+      }).catch((err) => {
+        console.error("[iLink] Failed to set model:", err);
+        if (msg.from_user_id) bridge?.sendTextReply(msg.from_user_id, t("ilink.errorProcessing"));
+      });
+    };
+    commandPending = pending;
+  }
+  async function replyNoActiveSession(msg) {
+    if (!msg.from_user_id) return;
+    await bridge?.sendTextReply(
+      msg.from_user_id,
+      [
+        `\u{1F4CB} **${t("ilink.noActiveSession")}**`,
+        "",
+        t("ilink.switchSessionGuide"),
+        "",
+        t("ilink.createSessionGuide")
+      ].join("\n")
+    );
+  }
+  const PERMISSION_MODES = ["ask", "allow-all"];
+  function getPermissionModeLabel(mode) {
+    return mode === "allow-all" ? t("ilink.permissionAllowAll") : t("ilink.permissionAsk");
+  }
+  async function handleCommandPermission(msg) {
+    const sessionId = activeSessionId ?? "";
+    const session = sessionId ? storage.getSession(sessionId) : null;
+    if (!session) {
+      await replyNoActiveSession(msg);
+      return;
+    }
+    const lines = [];
+    lines.push(`\u{1F4CB} **${t("ilink.permissionMenu")}**`);
+    lines.push("", t("ilink.permissionMenuDesc"));
+    const modeEntries = [];
+    PERMISSION_MODES.forEach((mode, index) => {
+      const marker = mode === session.permissionMode ? " \u{1F448}" : "";
+      const label = getPermissionModeLabel(mode);
+      lines.push(`  ${index + 1}. ${label}${marker}`);
+      modeEntries.push({ mode, label });
+    });
+    lines.push("", "---", t("ilink.switchPermissionHint"));
+    if (msg.from_user_id) await bridge?.sendTextReply(msg.from_user_id, lines.join("\n"));
+    const pending = (index) => {
+      const entry = modeEntries[index - 1];
+      if (!entry) {
+        void replyInvalidIndex(msg, modeEntries.length);
+        commandPending = pending;
         return;
       }
-      const entry = modelEntries[num - 1];
-      getHandlers().setModel({ sessionId, modelId: entry.modelId }).then(() => {
+      getHandlers().updateSession({ sessionId, permissionMode: entry.mode }).then(() => {
         if (msg.from_user_id)
           bridge?.sendTextReply(
             msg.from_user_id,
-            t("ilink.switchedToModel", { model: entry.label })
+            t("ilink.permissionSwitched", { mode: entry.label })
           );
       }).catch((err) => {
-        console.error("[iLink] Failed to set model:", err);
+        console.error("[iLink] Failed to update permission mode:", err);
         if (msg.from_user_id) bridge?.sendTextReply(msg.from_user_id, t("ilink.errorProcessing"));
       });
     };
+    commandPending = pending;
+  }
+  async function handleCommandFeatures(msg) {
+    const sessionId = activeSessionId ?? "";
+    if (!sessionId || !storage.getSession(sessionId)) {
+      await replyNoActiveSession(msg);
+      return;
+    }
+    const getEntries = () => {
+      const enabled = new Set(storage.getSession(sessionId)?.features ?? []);
+      return ALL_FEATURES.map((feature) => ({
+        id: feature,
+        label: getFeatureLabel(feature),
+        enabled: enabled.has(feature)
+      }));
+    };
+    const buildMenuText = (entries2) => {
+      const lines = [];
+      lines.push(`\u{1F4CB} **${t("ilink.featuresMenu")}**`);
+      lines.push("", t("ilink.featuresMenuDesc"));
+      entries2.forEach((entry, index) => {
+        lines.push(`  ${index + 1}. ${entry.enabled ? "\u2713" : "\u2717"} ${entry.label}`);
+      });
+      lines.push("", "---", t("ilink.toggleHint"));
+      return lines.join("\n");
+    };
+    const entries = getEntries();
+    if (entries.length === 0) {
+      if (msg.from_user_id) await bridge?.sendTextReply(msg.from_user_id, t("ilink.noToggleItems"));
+      return;
+    }
+    if (msg.from_user_id) await bridge?.sendTextReply(msg.from_user_id, buildMenuText(entries));
+    const pending = async (index) => {
+      if (index === 0) {
+        if (msg.from_user_id)
+          await bridge?.sendTextReply(msg.from_user_id, t("ilink.toggleCancelled"));
+        return;
+      }
+      const current = getEntries();
+      const target = current[index - 1];
+      if (!target) {
+        await replyInvalidIndex(msg, current.length);
+        commandPending = pending;
+        return;
+      }
+      const label = `${t(target.enabled ? "ilink.toggledOff" : "ilink.toggledOn")} ${target.label}`;
+      const nextIds = current.filter((entry) => entry.enabled && entry.id !== target.id).map((entry) => entry.id);
+      if (!target.enabled) nextIds.push(target.id);
+      try {
+        await getHandlers().updateSession({ sessionId, features: nextIds });
+      } catch (err) {
+        console.error("[iLink] Failed to update session features:", err);
+        if (msg.from_user_id)
+          await bridge?.sendTextReply(msg.from_user_id, t("ilink.errorProcessing"));
+        return;
+      }
+      try {
+        await getHandlers().loadSession({ sessionId, force: true });
+        if (msg.from_user_id) await bridge?.sendTextReply(msg.from_user_id, label);
+      } catch (err) {
+        console.error("[iLink] Failed to restart session after feature toggle:", err);
+        if (msg.from_user_id)
+          await bridge?.sendTextReply(
+            msg.from_user_id,
+            t("ilink.toggleSavedRestartFailed", { label })
+          );
+      }
+      const fresh = getEntries();
+      if (msg.from_user_id && fresh.length > 0)
+        await bridge?.sendTextReply(msg.from_user_id, buildMenuText(fresh));
+      commandPending = pending;
+    };
+    commandPending = pending;
+  }
+  async function handleCommandMcpServers(msg) {
+    const sessionId = activeSessionId ?? "";
+    if (!sessionId || !storage.getSession(sessionId)) {
+      await replyNoActiveSession(msg);
+      return;
+    }
+    const getEntries = () => {
+      const enabled = new Set(storage.getSession(sessionId)?.mcpServers ?? []);
+      return (storage.getSettings().mcpServers ?? []).map((server) => ({
+        id: server.id,
+        label: server.id,
+        enabled: enabled.has(server.id)
+      }));
+    };
+    const buildMenuText = (entries2) => {
+      const lines = [];
+      lines.push(`\u{1F4CB} **${t("ilink.mcpMenu")}**`);
+      lines.push("", t("ilink.mcpMenuDesc"));
+      entries2.forEach((entry, index) => {
+        lines.push(`  ${index + 1}. ${entry.enabled ? "\u2713" : "\u2717"} ${entry.label}`);
+      });
+      lines.push("", "---", t("ilink.toggleHint"));
+      return lines.join("\n");
+    };
+    const entries = getEntries();
+    if (entries.length === 0) {
+      if (msg.from_user_id) await bridge?.sendTextReply(msg.from_user_id, t("ilink.noToggleItems"));
+      return;
+    }
+    if (msg.from_user_id) await bridge?.sendTextReply(msg.from_user_id, buildMenuText(entries));
+    const pending = async (index) => {
+      if (index === 0) {
+        if (msg.from_user_id)
+          await bridge?.sendTextReply(msg.from_user_id, t("ilink.toggleCancelled"));
+        return;
+      }
+      const current = getEntries();
+      const target = current[index - 1];
+      if (!target) {
+        await replyInvalidIndex(msg, current.length);
+        commandPending = pending;
+        return;
+      }
+      const label = `${t(target.enabled ? "ilink.toggledOff" : "ilink.toggledOn")} ${target.label}`;
+      const nextIds = current.filter((entry) => entry.enabled && entry.id !== target.id).map((entry) => entry.id);
+      if (!target.enabled) nextIds.push(target.id);
+      try {
+        await getHandlers().updateSession({ sessionId, mcpServers: nextIds });
+      } catch (err) {
+        console.error("[iLink] Failed to update session MCP servers:", err);
+        if (msg.from_user_id)
+          await bridge?.sendTextReply(msg.from_user_id, t("ilink.errorProcessing"));
+        return;
+      }
+      try {
+        await getHandlers().loadSession({ sessionId, force: true });
+        if (msg.from_user_id) await bridge?.sendTextReply(msg.from_user_id, label);
+      } catch (err) {
+        console.error("[iLink] Failed to restart session after MCP toggle:", err);
+        if (msg.from_user_id)
+          await bridge?.sendTextReply(
+            msg.from_user_id,
+            t("ilink.toggleSavedRestartFailed", { label })
+          );
+      }
+      const fresh = getEntries();
+      if (msg.from_user_id && fresh.length > 0)
+        await bridge?.sendTextReply(msg.from_user_id, buildMenuText(fresh));
+      commandPending = pending;
+    };
+    commandPending = pending;
   }
   async function handleCommandSnippet(msg) {
     const settings = storage.getSettings();
@@ -10379,7 +10861,7 @@ function createIlinkModule(ctx) {
     }
     const lines = [];
     lines.push(`\u{1F4DD} **${t("ilink.snippetList")}**`);
-    lines.push(t("ilink.snippetListDesc"));
+    lines.push("", t("ilink.snippetListDesc"));
     const snippetEntries = [];
     snippets.forEach((s, i) => {
       const preview = s.content.length > 50 ? s.content.substring(0, 50) + "..." : s.content;
@@ -10388,17 +10870,13 @@ function createIlinkModule(ctx) {
     });
     lines.push("", "---", t("ilink.selectSnippetHint"));
     if (msg.from_user_id) await bridge?.sendTextReply(msg.from_user_id, lines.join("\n"));
-    commandPending = (input) => {
-      const num = parseInt(input, 10);
-      if (isNaN(num) || num < 1 || num > snippetEntries.length) {
-        if (msg.from_user_id)
-          bridge?.sendTextReply(
-            msg.from_user_id,
-            t("ilink.invalidSessionNumber", { min: "1", max: String(snippetEntries.length) })
-          );
+    const pending = (index) => {
+      const entry = snippetEntries[index - 1];
+      if (!entry) {
+        void replyInvalidIndex(msg, snippetEntries.length);
+        commandPending = pending;
         return;
       }
-      const entry = snippetEntries[num - 1];
       const sessionId = activeSessionId ?? "";
       if (!sessionId) {
         if (msg.from_user_id)
@@ -10408,6 +10886,7 @@ function createIlinkModule(ctx) {
               `\u{1F4CB} **${t("ilink.noActiveSession")}**`,
               "",
               t("ilink.switchSessionGuide"),
+              "",
               t("ilink.createSessionGuide")
             ].join("\n")
           );
@@ -10421,43 +10900,55 @@ function createIlinkModule(ctx) {
         if (msg.from_user_id) bridge?.sendTextReply(msg.from_user_id, t("ilink.errorProcessing"));
       });
     };
+    commandPending = pending;
   }
   async function handleCommandInfo(msg) {
     const currentSession = activeSessionId ? storage.getSession(activeSessionId) : null;
     const message = (() => {
       const lines = [];
-      lines.push(`\u{1F4CB} **${t("ilink.sessionInfo")}**`);
       if (!currentSession) {
         lines.push(t("ilink.noActiveSession"));
-        lines.push("", "---", t("ilink.switchSessionGuide"), t("ilink.createSessionGuide"));
+        lines.push("", "---", t("ilink.switchSessionGuide"), "", t("ilink.createSessionGuide"));
         return lines.join("\n");
       }
       const projects = storage.listProjects();
       const project = projects.find((p) => p.id === currentSession.projectId);
-      lines.push(`**${t("ilink.title")}**: ${currentSession.title || t("ilink.newSession")}`);
-      if (project) lines.push(`**${t("ilink.project")}**: ${project.title}`);
-      lines.push(`**${t("ilink.projectDir")}**: \`${currentSession.cwd}\``);
-      lines.push(`**${t("ilink.agent")}**: \`${currentSession.agentId}\``);
+      lines.push(`\u{1F4CB} **${currentSession.title || t("ilink.newSession")}**
+`);
+      if (project) lines.push(`**${t("ilink.project")}**: ${project.title}
+`);
+      lines.push(`**${t("ilink.projectDir")}**: \`${currentSession.cwd}\`
+`);
+      lines.push(`**${t("ilink.agent")}**: \`${currentSession.agentId}\`
+`);
+      lines.push(
+        `**${t("ilink.permissionMenu")}**: ${getPermissionModeLabel(currentSession.permissionMode)}
+`
+      );
       const enabledFeatures = new Set(currentSession.features ?? []);
       lines.push(`**${t("ilink.features")}**:`);
-      for (const f of ALL_FEATURES) lines.push(`  - ${enabledFeatures.has(f) ? "\u2713" : "\u2717"} ${f}`);
-      const globalSettings = storage.getSettings();
+      for (const f of ALL_FEATURES)
+        lines.push(`  - ${enabledFeatures.has(f) ? "\u2713" : "\u2717"} ${getFeatureLabel(f)}`);
       const sessionMcpIds = new Set(currentSession.mcpServers ?? []);
-      const allMcpServers = globalSettings.mcpServers ?? [];
+      const allMcpServers = storage.getSettings().mcpServers ?? [];
+      lines.push("");
       if (allMcpServers.length > 0) {
         lines.push(`**${t("ilink.mcpServers")}**:`);
         for (const srv of allMcpServers)
-          lines.push(`  - ${sessionMcpIds.has(srv.id) && !srv.disabled ? "\u2713" : "\u2717"} \`${srv.id}\``);
+          lines.push(`  - ${sessionMcpIds.has(srv.id) ? "\u2713" : "\u2717"} ${srv.id}`);
       } else {
         lines.push(`**${t("ilink.mcpServers")}**: \u2014`);
       }
       lines.push(
         "",
         "---",
-        t("ilink.switchSessionGuide"),
-        t("ilink.createSessionGuide"),
-        t("ilink.modelGuide"),
-        t("ilink.snippetGuide")
+        "- " + t("ilink.switchSessionGuide"),
+        "- " + t("ilink.createSessionGuide"),
+        "- " + t("ilink.modelGuide"),
+        "- " + t("ilink.permissionGuide"),
+        "- " + t("ilink.featureGuide"),
+        "- " + t("ilink.mcpServerGuide"),
+        "- " + t("ilink.snippetGuide")
       );
       return lines.join("\n");
     })();
@@ -10678,6 +11169,11 @@ function createAutomationModule(ctx, deps) {
   const scheduledCrons = /* @__PURE__ */ new Map();
   const runningTasks = /* @__PURE__ */ new Set();
   function getNextRun(schedule) {
+    if (schedule.cron.type === "once") {
+      if (isRunLimitReached(schedule)) return null;
+      const at = schedule.cron.at;
+      return at && at > Date.now() ? at : null;
+    }
     const job = scheduledCrons.get(schedule.id);
     if (!job) return null;
     try {
@@ -10703,6 +11199,34 @@ function createAutomationModule(ctx, deps) {
   function scheduleCron(schedule) {
     unscheduleCron(schedule.id);
     if (isRunLimitReached(schedule)) return;
+    if (schedule.cron.type === "once") {
+      const at = schedule.cron.at;
+      if (!at || at <= Date.now()) return;
+      try {
+        const onceJob = new CronJob(
+          new Date(at),
+          async () => {
+            try {
+              await executeTask(schedule.id, "cron");
+            } catch (err) {
+              console.error(`[Automation] Failed to run once task for "${schedule.name}":`, err);
+            } finally {
+              unscheduleCron(schedule.id);
+            }
+          },
+          null,
+          false
+        );
+        scheduledCrons.set(schedule.id, onceJob);
+        onceJob.start();
+        console.log(
+          `[Automation] Scheduled once "${schedule.name}" at ${new Date(at).toLocaleString(storage.getSettings().i18n?.language)}`
+        );
+      } catch (err) {
+        console.error(`[Automation] Failed to schedule once "${schedule.name}":`, err);
+      }
+      return;
+    }
     if (schedule.cron.type !== "cron" || !schedule.cron.expr) return;
     try {
       const cronJob = new CronJob(
@@ -10742,9 +11266,21 @@ function createAutomationModule(ctx, deps) {
   function restoreActiveSchedules() {
     const schedules = store.listSchedules();
     for (const s of schedules) {
-      if (s.cron.type === "cron" && s.cron.expr) scheduleCron(s);
-    }
-    console.log(`[Automation] Restored ${scheduledCrons.size} active schedule(s)`);
+      if (s.cron.type === "cron" && s.cron.expr) {
+        scheduleCron(s);
+      } else if (s.cron.type === "once") {
+        if (isRunLimitReached(s)) continue;
+        const at = s.cron.at;
+        if (at && at > Date.now()) {
+          scheduleCron(s);
+        } else {
+          console.log(
+            `[Automation] "${s.name}" once trigger missed (scheduled at ${at ? new Date(at).toLocaleString(storage.getSettings().i18n?.language) : "?"})`
+          );
+        }
+      }
+    }
+    console.log(`[Automation] Restored ${scheduledCrons.size} active schedule(s)`);
   }
   function buildAutomationMcpServers(mcpIds) {
     const settings = storage.getSettings();
@@ -10789,6 +11325,10 @@ function createAutomationModule(ctx, deps) {
     const task = { id: taskId, scheduleId, startedAt, completedAt: null, status: "running" };
     store.saveTask(scheduleId, task);
     sendEvent("task-update", { scheduleId, task });
+    schedule.lastRunAt = Date.now();
+    schedule.updatedAt = Date.now();
+    store.saveSchedule(schedule);
+    sendEvent("schedules-changed", void 0);
     const taskDir = store.taskDir(scheduleId, taskId);
     try {
       if (source === "cron") consumeRun(schedule);
@@ -10837,7 +11377,6 @@ function createAutomationModule(ctx, deps) {
           2
         )
       );
-      schedule.lastRunAt = Date.now();
       schedule.updatedAt = Date.now();
       store.saveSchedule(schedule);
       sendEvent("schedules-changed", void 0);
@@ -10864,19 +11403,21 @@ function createAutomationModule(ctx, deps) {
   }
   function createSchedule(params) {
     const schedule = store.createSchedule(params);
-    if (schedule.cron.type === "cron" && schedule.cron.expr) scheduleCron(schedule);
+    if (schedule.cron.type !== "manual") scheduleCron(schedule);
     return schedule;
   }
   function updateSchedule(scheduleId, updates) {
     const schedule = store.getSchedule(scheduleId);
     if (!schedule) throw new Error("Schedule not found");
     Object.assign(schedule, updates);
-    if ("remainingRuns" in updates) {
+    if (schedule.cron.type === "once") {
+      schedule.remainingRuns = 1;
+    } else if ("remainingRuns" in updates) {
       schedule.remainingRuns = normalizeRemainingRuns(updates.remainingRuns);
     }
     schedule.updatedAt = Date.now();
     store.saveSchedule(schedule);
-    if (schedule.cron.type === "cron" && schedule.cron.expr) scheduleCron(schedule);
+    if (schedule.cron.type !== "manual") scheduleCron(schedule);
     else unscheduleCron(scheduleId);
     return schedule;
   }
@@ -11503,7 +12044,7 @@ async function callOpenAICompatibleApi(provider, request) {
 }
 function createImageGenerationModule(ctx, deps) {
   const { storage } = ctx;
-  function getActiveProvider2() {
+  function getActiveProvider() {
     const settings = storage.getSettings();
     const provider = settings.imageGeneration?.find((p) => p.active);
     if (!provider) {
@@ -11514,7 +12055,7 @@ function createImageGenerationModule(ctx, deps) {
     return provider;
   }
   async function generateImage(sessionId, request) {
-    const provider = getActiveProvider2();
+    const provider = getActiveProvider();
     const apiResult = await callOpenAICompatibleApi(provider, request);
     const shareDir = storage.sessionShareDir(sessionId);
     if (!shareDir) throw new Error(`Session not found: ${sessionId}`);
@@ -11587,8 +12128,8 @@ function createImageGenerationModule(ctx, deps) {
 }
 
 // src/backend/toolbox.ts
-import { join as join24, resolve as resolve8, dirname as dirname9, basename as basename4, extname as extname3 } from "path";
-import { writeFile as writeFile6 } from "fs/promises";
+import { join as join25, resolve as resolve8, dirname as dirname11, basename as basename4, extname as extname3 } from "path";
+import { writeFile as writeFile7 } from "fs/promises";
 import { createHash as createHash6, randomUUID as randomUUID13, randomInt } from "crypto";
 import * as qr from "qr-image";
 
@@ -11733,6 +12274,606 @@ var qrCodeRespondSchema = z10.object({
     output: z10.string()
   })
 });
+var audioTranscribeRequestSchema = z10.object({
+  path: z10.string().describe("Absolute or project-relative path to the audio file to transcribe."),
+  language: z10.string().optional().describe(
+    "BCP-47 language hint, e.g. 'zh-CN' or 'en-US'. If omitted, the language configured for the active speech-to-text provider is used."
+  ),
+  ffmpegPath: z10.string().optional().describe(
+    "Absolute path to the ffmpeg executable, for when it is not on PATH (e.g. a custom install location). When provided it is used as-is: an unusable path is reported as an error instead of falling back to auto-detection. Omit it to auto-detect (FFMPEG_PATH env var, then PATH, then common install directories)."
+  ),
+  timeoutSeconds: z10.number().int().min(10).max(3600).default(600).describe("Maximum time to wait for the transcription, in seconds (10-3600). Default: 600.")
+});
+var audioTranscribeRespondSchema = z10.object({
+  result: z10.object({
+    text: z10.string(),
+    durationSeconds: z10.number(),
+    segments: z10.number()
+  })
+});
+var textToSpeechRequestSchema = z10.object({
+  text: z10.string().min(1).describe("The text to synthesize into speech."),
+  output: z10.string().optional().describe(
+    "Output audio path; a relative path resolves against the project root. If omitted, saves as 'speech.wav' (or 'speech.mp3' when format is 'mp3') in the project root."
+  ),
+  format: z10.enum(["wav", "mp3"]).default("wav").describe(
+    "Output audio format. 'wav' needs no extra tools; 'mp3' additionally requires the system ffmpeg. Default: wav."
+  )
+});
+var textToSpeechRespondSchema = z10.object({
+  result: z10.object({
+    output: z10.string(),
+    format: z10.enum(["wav", "mp3"]),
+    sampleRate: z10.number(),
+    channels: z10.number(),
+    durationSeconds: z10.number(),
+    bytes: z10.number()
+  })
+});
+
+// src/backend/speech/transcribe.ts
+import { stat as stat6 } from "node:fs/promises";
+import { createASRClient } from "unified-realtime-asr";
+
+// src/shared/speech.ts
+var DASHSCOPE_ASR_MODEL = "fun-asr-flash-8k-realtime";
+var OPENAI_ASR_MODEL = "gpt-4o-transcribe";
+var DEFAULT_ASR_MODELS = {
+  dashscope: DASHSCOPE_ASR_MODEL,
+  openai: OPENAI_ASR_MODEL
+};
+function effectiveAsrModel(provider) {
+  return provider.asrModel?.trim() || DEFAULT_ASR_MODELS[provider.provider];
+}
+var DASHSCOPE_TTS_VOICE = "longanhuan_v3.6";
+var OPENAI_TTS_VOICE = "coral";
+var IFLYTEK_TTS_VCN = "x5_lingxiaoxuan_flow";
+var VOLC_TTS_VOICE = "zh_female_vv_uranus_bigtts";
+var DEFAULT_TTS_VOICES = {
+  dashscope: DASHSCOPE_TTS_VOICE,
+  openai: OPENAI_TTS_VOICE,
+  iflytek: IFLYTEK_TTS_VCN,
+  volcengine: VOLC_TTS_VOICE
+};
+function effectiveTtsVoice(provider) {
+  return provider.voice?.trim() || DEFAULT_TTS_VOICES[provider.provider];
+}
+
+// src/backend/speech/util.ts
+function optionalString(value) {
+  const trimmed = value?.trim();
+  return trimmed || void 0;
+}
+function requireField(value, name, direction) {
+  const result = optionalString(value);
+  if (!result) throw new Error(`${direction}\u914D\u7F6E\u7F3A\u5C11 ${name}\u3002`);
+  return result;
+}
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+// src/backend/speech/asr-config.ts
+function required(value, name) {
+  return requireField(value, name, "\u5B9E\u65F6\u8BED\u97F3\u8BC6\u522B");
+}
+function buildOptions(provider, overrides = {}) {
+  return {
+    language: optionalString(overrides.language) ?? optionalString(provider.language) ?? "zh-CN",
+    sampleRate: 16e3,
+    channels: 1,
+    format: "pcm",
+    interimResults: true,
+    punctuation: true,
+    autoReconnect: false,
+    transcriptionModel: provider.provider === "openai" ? effectiveAsrModel(provider) : void 0
+  };
+}
+function buildAsrConfig(provider, overrides = {}) {
+  const options = buildOptions(provider, overrides);
+  const url = optionalString(provider.baseUrl);
+  switch (provider.provider) {
+    case "volcengine":
+      return {
+        provider: "volcengine",
+        apiKey: required(provider.apiKey, "API Key"),
+        resourceId: optionalString(provider.asrResourceId),
+        appId: optionalString(provider.appId),
+        url,
+        options
+      };
+    case "dashscope":
+      return {
+        provider: "dashscope",
+        apiKey: required(provider.apiKey, "API Key"),
+        model: effectiveAsrModel(provider),
+        workspaceId: optionalString(provider.workspaceId),
+        region: provider.region,
+        workspace: optionalString(provider.workspace),
+        url,
+        options
+      };
+    case "openai":
+      return {
+        provider: "openai",
+        apiKey: required(provider.apiKey, "API Key"),
+        url,
+        options
+      };
+    case "iflytek":
+      return {
+        provider: "iflytek",
+        appId: required(provider.appId, "App ID"),
+        apiKey: required(provider.apiKey, "API Key"),
+        apiSecret: required(provider.apiSecret, "API Secret"),
+        url,
+        options
+      };
+  }
+}
+function getActiveAsrProvider(ctx) {
+  const provider = ctx.storage.getSettings().speechProviders.find((item) => item.asrEnabled);
+  if (!provider) {
+    throw new Error(
+      "\u8BBE\u7F6E\u4E2D\u6CA1\u6709\u627E\u5230\u8BED\u97F3\u8BC6\u522B\uFF08ASR\uFF09\u914D\u7F6E\uFF1A\u5F53\u524D\u6CA1\u6709\u542F\u7528\u4E2D\u7684 Provider\u3002\u8BF7\u5148\u5728\u300C\u8BBE\u7F6E \u2192 \u8BED\u97F3 \u2192 \u8BC6\u522B\u300D\u4E2D\u914D\u7F6E\u5E76\u542F\u7528\u4E00\u4E2A Provider\uFF0C\u7136\u540E\u91CD\u65B0\u8C03\u7528\u672C\u5DE5\u5177\u3002"
+    );
+  }
+  return provider;
+}
+
+// src/backend/speech/ffmpeg.ts
+import { spawn as spawn4 } from "node:child_process";
+import { access, constants } from "node:fs/promises";
+import { delimiter, dirname as dirname9, join as join24 } from "node:path";
+var FFMPEG_BIN = process.platform === "win32" ? "ffmpeg.exe" : "ffmpeg";
+var MAX_STDERR_BYTES = 8192;
+function fallbackDirs() {
+  switch (process.platform) {
+    case "darwin":
+      return ["/opt/homebrew/bin", "/usr/local/bin", "/opt/local/bin", "/usr/bin"];
+    case "win32": {
+      const dirs = ["C:\\ffmpeg\\bin"];
+      if (process.env.ProgramFiles) dirs.unshift(join24(process.env.ProgramFiles, "ffmpeg", "bin"));
+      if (process.env.LOCALAPPDATA) {
+        dirs.push(join24(process.env.LOCALAPPDATA, "Microsoft", "WinGet", "Links"));
+      }
+      return dirs;
+    }
+    default:
+      return ["/usr/bin", "/usr/local/bin", "/snap/bin", "/var/lib/flatpak/exports/bin"];
+  }
+}
+async function isExecutable(filePath) {
+  try {
+    await access(filePath, process.platform === "win32" ? constants.F_OK : constants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function ffmpegInstallHint() {
+  const howTo = process.platform === "darwin" ? "  macOS:   brew install ffmpeg" : process.platform === "win32" ? "  Windows: winget install --id Gyan.FFmpeg -e    (\u6216 choco install ffmpeg)" : "  Linux:   sudo apt install ffmpeg    (\u6216 sudo dnf install ffmpeg)";
+  return [
+    "\u672A\u627E\u5230 ffmpeg\uFF0C\u65E0\u6CD5\u89E3\u7801\u97F3\u9891\u6587\u4EF6\u3002",
+    "\u8BF7\u5148\u5B89\u88C5 ffmpeg\uFF0C\u7136\u540E\u91CD\u65B0\u8C03\u7528\u672C\u5DE5\u5177\uFF1A",
+    howTo,
+    "\u4E5F\u53EF\u4EE5\u7528 FFMPEG_PATH \u73AF\u5883\u53D8\u91CF\u6307\u5B9A ffmpeg \u53EF\u6267\u884C\u6587\u4EF6\u7684\u7EDD\u5BF9\u8DEF\u5F84\u3002"
+  ].join("\n");
+}
+function ffmpegPathUnusableHint(explicitPath) {
+  return [
+    `\u6307\u5B9A\u7684 ffmpeg \u8DEF\u5F84\u4E0D\u53EF\u7528\uFF1A${explicitPath}`,
+    "\u8BE5\u6587\u4EF6\u4E0D\u5B58\u5728\u6216\u6CA1\u6709\u6267\u884C\u6743\u9650\u3002",
+    "\u8BF7\u4F20\u5165\u6B63\u786E\u7684 ffmpegPath\uFF0C\u6216\u8005\u4E0D\u4F20\u8BE5\u53C2\u6570\u3001\u7531\u5DE5\u5177\u81EA\u52A8\u63A2\u6D4B\uFF08FFMPEG_PATH \u73AF\u5883\u53D8\u91CF \u2192 \u7CFB\u7EDF PATH \u2192 \u5E38\u89C1\u5B89\u88C5\u76EE\u5F55\uFF09\u3002"
+  ].join("\n");
+}
+async function resolveFfmpegPath(explicitPath) {
+  const explicit = explicitPath?.trim();
+  if (explicit) {
+    return await isExecutable(explicit) ? explicit : null;
+  }
+  const candidates = [];
+  const envPath = process.env.FFMPEG_PATH?.trim();
+  if (envPath) candidates.push(envPath);
+  const dirs = [
+    ...envPath ? [dirname9(envPath)] : [],
+    ...(process.env.PATH ?? "").split(delimiter),
+    ...fallbackDirs()
+  ];
+  for (const dir of dirs) {
+    if (dir) candidates.push(join24(dir, FFMPEG_BIN));
+  }
+  for (const candidate of candidates) {
+    if (await isExecutable(candidate)) return candidate;
+  }
+  return null;
+}
+function decodeArgs(inputPath) {
+  return [
+    "-nostdin",
+    "-hide_banner",
+    "-loglevel",
+    "error",
+    "-i",
+    inputPath,
+    "-vn",
+    "-f",
+    "s16le",
+    "-acodec",
+    "pcm_s16le",
+    "-ac",
+    "1",
+    "-ar",
+    "16000",
+    "-"
+  ];
+}
+async function decodeAudioToPcm16k(options) {
+  const { ffmpegPath, inputPath, onChunk, signal } = options;
+  const child = spawn4(ffmpegPath, decodeArgs(inputPath), {
+    stdio: ["ignore", "pipe", "pipe"],
+    windowsHide: true
+  });
+  let stderr = "";
+  child.stderr.setEncoding("utf8");
+  child.stderr.on("data", (chunk) => {
+    if (stderr.length < MAX_STDERR_BYTES) stderr += chunk;
+  });
+  const abort = () => child.kill("SIGKILL");
+  if (signal?.aborted) abort();
+  else signal?.addEventListener("abort", abort, { once: true });
+  const exited = new Promise(
+    (resolve9, reject) => {
+      child.once("error", reject);
+      child.once("close", (code2, closeSignal2) => resolve9({ code: code2, signal: closeSignal2 }));
+    }
+  );
+  try {
+    for await (const chunk of child.stdout) {
+      await onChunk(chunk);
+    }
+  } catch (error) {
+    child.kill("SIGKILL");
+    await exited.catch(() => {
+    });
+    throw error;
+  } finally {
+    signal?.removeEventListener("abort", abort);
+  }
+  const { code, signal: closeSignal } = await exited;
+  if (code !== 0) {
+    const detail = stderr.trim() || `\u8FDB\u7A0B\u88AB\u7EC8\u6B62\uFF08${closeSignal ?? "unknown"}\uFF09`;
+    throw new Error(`ffmpeg \u89E3\u7801\u97F3\u9891\u5931\u8D25\uFF1A${detail}`);
+  }
+}
+var MP3_ARGS = ["-codec:a", "libmp3lame", "-b:a", "128k", "-f", "mp3"];
+async function encodePcmToMp3(options) {
+  const { ffmpegPath, pcm, sampleRate, channels, outputPath } = options;
+  const child = spawn4(
+    ffmpegPath,
+    [
+      "-y",
+      "-nostdin",
+      "-hide_banner",
+      "-loglevel",
+      "error",
+      "-f",
+      "s16le",
+      "-ar",
+      String(sampleRate),
+      "-ac",
+      String(channels),
+      "-i",
+      "-",
+      ...MP3_ARGS,
+      outputPath
+    ],
+    { stdio: ["pipe", "ignore", "pipe"], windowsHide: true }
+  );
+  let stderr = "";
+  child.stderr.setEncoding("utf8");
+  child.stderr.on("data", (chunk) => {
+    if (stderr.length < MAX_STDERR_BYTES) stderr += chunk;
+  });
+  const exited = new Promise((resolve9, reject) => {
+    child.once("error", reject);
+    child.once("close", (code2) => resolve9(code2));
+  });
+  try {
+    await new Promise((resolve9, reject) => {
+      child.stdin.once("error", reject);
+      child.stdin.end(pcm, () => resolve9());
+    });
+  } catch (error) {
+    child.kill("SIGKILL");
+    await exited.catch(() => {
+    });
+    throw new Error(
+      `ffmpeg \u7F16\u7801\u97F3\u9891\u5931\u8D25\uFF1A${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  const code = await exited;
+  if (code !== 0) {
+    const detail = stderr.trim() || `\u9000\u51FA\u7801 ${code}`;
+    throw new Error(`ffmpeg \u7F16\u7801 mp3 \u5931\u8D25\uFF1A${detail}`);
+  }
+}
+
+// src/backend/speech/transcribe.ts
+var FEED_FRAME_BYTES = 320 * 2;
+var FEED_FRAME_MS = 20;
+var FEED_SPEED = 20;
+var FLUSH_WAIT_MS = 1500;
+var DEFAULT_TIMEOUT_SECONDS = 600;
+function sleep(ms) {
+  return new Promise((resolve9) => setTimeout(resolve9, ms));
+}
+var LOCAL_INDEX_BASE = 1e6;
+function joinFinals(finals) {
+  return [...finals.entries()].sort((a, b) => a[0] - b[0]).map(([, text]) => text).join("");
+}
+async function transcribeAudioFile(ctx, options) {
+  const provider = getActiveAsrProvider(ctx);
+  await stat6(options.path).catch(() => {
+    throw new Error(`\u97F3\u9891\u6587\u4EF6\u4E0D\u5B58\u5728\uFF1A${options.path}`);
+  });
+  const explicitFfmpegPath = options.ffmpegPath?.trim();
+  const ffmpegPath = await resolveFfmpegPath(explicitFfmpegPath);
+  if (!ffmpegPath) {
+    throw new Error(
+      explicitFfmpegPath ? ffmpegPathUnusableHint(explicitFfmpegPath) : ffmpegInstallHint()
+    );
+  }
+  const timeoutSeconds = options.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS;
+  const timeoutError = () => new Error(`\u97F3\u9891\u6587\u4EF6\u8F6C\u5199\u8D85\u65F6\uFF08\u8D85\u8FC7 ${timeoutSeconds} \u79D2\uFF09\u3002`);
+  const client2 = createASRClient(buildAsrConfig(provider, { language: options.language }));
+  const finals = /* @__PURE__ */ new Map();
+  let seq = 0;
+  let lastError = null;
+  client2.on("transcript", (transcript) => {
+    if (!transcript.isFinal) return;
+    finals.set(transcript.index ?? LOCAL_INDEX_BASE + ++seq, transcript.text);
+  });
+  client2.on("error", (error) => {
+    lastError = errorMessage(error);
+  });
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutSeconds * 1e3);
+  let fedBytes = 0;
+  let pending = Buffer.alloc(0);
+  let closed = false;
+  let startedAt = 0;
+  let fedMs = 0;
+  const sendFrame = (frame) => {
+    if (controller.signal.aborted) return;
+    try {
+      client2.sendAudio(frame);
+    } catch (error) {
+      throw new Error(`\u8BED\u97F3\u8BC6\u522B\u8FDE\u63A5\u5DF2\u65AD\u5F00\uFF1A${errorMessage(error)}`);
+    }
+    fedBytes += frame.length;
+  };
+  const feed = async (chunk) => {
+    pending = pending.length === 0 ? chunk : Buffer.concat([pending, chunk]);
+    while (pending.length >= FEED_FRAME_BYTES) {
+      if (controller.signal.aborted) return;
+      const frame = pending.subarray(0, FEED_FRAME_BYTES);
+      pending = pending.subarray(FEED_FRAME_BYTES);
+      sendFrame(frame);
+      fedMs += FEED_FRAME_MS;
+      const wait = startedAt + fedMs / FEED_SPEED - Date.now();
+      if (wait > 1) await sleep(wait);
+    }
+  };
+  try {
+    await client2.connect();
+    startedAt = Date.now();
+    try {
+      await decodeAudioToPcm16k({
+        ffmpegPath,
+        inputPath: options.path,
+        signal: controller.signal,
+        onChunk: feed
+      });
+    } catch (error) {
+      if (controller.signal.aborted) throw timeoutError();
+      throw error;
+    }
+    if (controller.signal.aborted) throw timeoutError();
+    if (pending.length > 0) sendFrame(pending);
+    await sleep(FLUSH_WAIT_MS);
+    await client2.close();
+    closed = true;
+    if (finals.size === 0 && lastError) throw new Error(lastError);
+    return {
+      text: joinFinals(finals),
+      durationSeconds: Math.round(fedBytes / 2 / 16e3 * 10) / 10,
+      segments: finals.size
+    };
+  } finally {
+    clearTimeout(timer);
+    client2.removeAllListeners();
+    if (!closed) await client2.close().catch(() => {
+    });
+  }
+}
+
+// src/backend/speech/synthesize.ts
+import { Buffer as Buffer2 } from "node:buffer";
+import { mkdir as mkdir3, stat as stat7, writeFile as writeFile6 } from "node:fs/promises";
+import { dirname as dirname10 } from "node:path";
+import { createTTSClient } from "unified-realtime-asr";
+
+// src/backend/speech/tts-config.ts
+function required2(value, name) {
+  return requireField(value, name, "\u8BED\u97F3\u5408\u6210");
+}
+function buildTtsConfig(provider) {
+  const options = {
+    voice: effectiveTtsVoice(provider),
+    format: "pcm",
+    language: optionalString(provider.language),
+    autoReconnect: false
+  };
+  const baseUrl = optionalString(provider.baseUrl);
+  switch (provider.provider) {
+    case "volcengine":
+      return {
+        provider: "volcengine",
+        apiKey: required2(provider.apiKey, "API Key"),
+        appId: optionalString(provider.appId),
+        // 双向流式：文本可增量输入，配合逐句 flush 延迟最低
+        mode: "duplex",
+        url: baseUrl,
+        options
+      };
+    case "dashscope":
+      return {
+        provider: "dashscope",
+        apiKey: required2(provider.apiKey, "API Key"),
+        model: optionalString(provider.ttsModel),
+        workspaceId: optionalString(provider.workspaceId),
+        region: provider.region,
+        workspace: optionalString(provider.workspace),
+        url: baseUrl,
+        options
+      };
+    case "openai":
+      return {
+        provider: "openai",
+        apiKey: required2(provider.apiKey, "API Key"),
+        model: optionalString(provider.ttsModel),
+        baseUrl,
+        options
+      };
+    case "iflytek":
+      return {
+        provider: "iflytek",
+        appId: required2(provider.appId, "App ID"),
+        apiKey: required2(provider.apiKey, "API Key"),
+        apiSecret: required2(provider.apiSecret, "API Secret"),
+        url: baseUrl,
+        options
+      };
+  }
+}
+function getActiveTtsProvider(ctx) {
+  const provider = ctx.storage.getSettings().speechProviders.find((item) => item.ttsEnabled);
+  if (!provider) {
+    throw new Error(
+      "\u8BBE\u7F6E\u4E2D\u6CA1\u6709\u627E\u5230\u8BED\u97F3\u5408\u6210\uFF08TTS\uFF09\u914D\u7F6E\uFF1A\u5F53\u524D\u6CA1\u6709\u542F\u7528\u4E2D\u7684 Provider\u3002\u8BF7\u5148\u5728\u300C\u8BBE\u7F6E \u2192 \u8BED\u97F3 \u2192 \u5408\u6210\u300D\u4E2D\u914D\u7F6E\u5E76\u542F\u7528\u4E00\u4E2A Provider\uFF0C\u7136\u540E\u91CD\u8BD5\u3002"
+    );
+  }
+  return provider;
+}
+
+// src/backend/speech/synthesize.ts
+var MAX_TEXT_LENGTH = 1e4;
+var FALLBACK_SAMPLE_RATE = 24e3;
+var FALLBACK_CHANNELS = 1;
+var DEFAULT_TIMEOUT_SECONDS2 = 600;
+function encodeWav(pcm, sampleRate, channels) {
+  const bitsPerSample = 16;
+  const blockAlign = channels * (bitsPerSample / 8);
+  const header = Buffer2.alloc(44);
+  header.write("RIFF", 0, "ascii");
+  header.writeUInt32LE(36 + pcm.length, 4);
+  header.write("WAVE", 8, "ascii");
+  header.write("fmt ", 12, "ascii");
+  header.writeUInt32LE(16, 16);
+  header.writeUInt16LE(1, 20);
+  header.writeUInt16LE(channels, 22);
+  header.writeUInt32LE(sampleRate, 24);
+  header.writeUInt32LE(sampleRate * blockAlign, 28);
+  header.writeUInt16LE(blockAlign, 32);
+  header.writeUInt16LE(bitsPerSample, 34);
+  header.write("data", 36, "ascii");
+  header.writeUInt32LE(pcm.length, 40);
+  return Buffer2.concat([header, pcm]);
+}
+async function requireFfmpegPath() {
+  const ffmpegPath = await resolveFfmpegPath();
+  if (!ffmpegPath) throw new Error(ffmpegInstallHint());
+  return ffmpegPath;
+}
+async function synthesizeSpeechToFile(ctx, options) {
+  const text = options.text.trim();
+  if (!text) throw new Error("\u5F85\u5408\u6210\u7684\u6587\u672C\u4E3A\u7A7A\u3002");
+  if (text.length > MAX_TEXT_LENGTH) {
+    throw new Error(
+      `\u5F85\u5408\u6210\u6587\u672C\u8FC7\u957F\uFF08${text.length} \u5B57\uFF0C\u4E0A\u9650 ${MAX_TEXT_LENGTH} \u5B57\uFF09\uFF1A\u8BF7\u62C6\u6210\u51E0\u6BB5\u5206\u522B\u5408\u6210\u3002`
+    );
+  }
+  if (!/[\p{L}\p{N}]/u.test(text)) {
+    throw new Error("\u5F85\u5408\u6210\u7684\u6587\u672C\u6CA1\u6709\u53EF\u6717\u8BFB\u5185\u5BB9\uFF08\u5168\u662F\u7B26\u53F7 / \u7A7A\u767D / emoji\uFF09\u3002");
+  }
+  const ffmpegPath = options.format === "mp3" ? await requireFfmpegPath() : null;
+  await mkdir3(dirname10(options.output), { recursive: true });
+  const client2 = createTTSClient(buildTtsConfig(getActiveTtsProvider(ctx)));
+  const chunks = [];
+  let sampleRate;
+  let channels;
+  let lastError = null;
+  client2.on("audio", (chunk) => {
+    chunks.push(Buffer2.from(chunk.audio));
+    sampleRate ??= chunk.sampleRate;
+    channels ??= chunk.channels;
+  });
+  client2.on("error", (error) => {
+    lastError = errorMessage(error);
+  });
+  const timeoutSeconds = options.timeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS2;
+  let timer;
+  try {
+    await client2.connect();
+    await Promise.race([
+      (async () => {
+        client2.sendText(text);
+        await client2.flush();
+      })(),
+      new Promise((_, reject) => {
+        timer = setTimeout(
+          () => reject(new Error(`\u8BED\u97F3\u5408\u6210\u8D85\u65F6\uFF08\u8D85\u8FC7 ${timeoutSeconds} \u79D2\uFF09\u3002`)),
+          timeoutSeconds * 1e3
+        );
+      })
+    ]);
+  } catch (error) {
+    if (lastError) throw new Error(lastError);
+    throw error;
+  } finally {
+    clearTimeout(timer);
+    client2.removeAllListeners();
+    await client2.close().catch(() => {
+    });
+  }
+  const pcm = Buffer2.concat(chunks);
+  if (pcm.length === 0) {
+    throw new Error(lastError ?? "\u8BED\u97F3\u5408\u6210\u6CA1\u6709\u8FD4\u56DE\u4EFB\u4F55\u97F3\u9891\u6570\u636E\u3002");
+  }
+  const rate = sampleRate || FALLBACK_SAMPLE_RATE;
+  const channelCount = channels || FALLBACK_CHANNELS;
+  if (ffmpegPath) {
+    await encodePcmToMp3({
+      ffmpegPath,
+      pcm,
+      sampleRate: rate,
+      channels: channelCount,
+      outputPath: options.output
+    });
+  } else {
+    await writeFile6(options.output, encodeWav(pcm, rate, channelCount));
+  }
+  const { size } = await stat7(options.output);
+  return {
+    output: options.output,
+    format: options.format,
+    sampleRate: rate,
+    channels: channelCount,
+    durationSeconds: Math.round(pcm.length / (rate * channelCount * 2) * 10) / 10,
+    bytes: size
+  };
+}
 
 // src/backend/toolbox.ts
 var CHARSETS = {
@@ -11751,7 +12892,7 @@ function getSharp() {
   }
   return sharpPromise;
 }
-function createToolboxModule(_ctx) {
+function createToolboxModule(ctx) {
   function extractMetadata(metadata) {
     return {
       width: metadata.width,
@@ -11842,8 +12983,8 @@ function createToolboxModule(_ctx) {
     server.registry("toolbox/image-thumbnail", async (payload) => {
       const { path: imgPath, width, output } = imageThumbnailRequestSchema.parse(payload);
       const absPath = resolve8(projectDir, imgPath);
-      const outputPath = output ? resolve8(projectDir, output) : join24(
-        dirname9(absPath),
+      const outputPath = output ? resolve8(projectDir, output) : join25(
+        dirname11(absPath),
         `${basename4(absPath, extname3(absPath))}.thumb${width}${extname3(absPath)}`
       );
       const sharp = await getSharp();
@@ -11861,15 +13002,15 @@ function createToolboxModule(_ctx) {
       const actualHeight = resizedMeta.height ?? height ?? 0;
       const ext = extname3(absPath);
       const base = basename4(absPath, ext);
-      const outputPath = output ? resolve8(projectDir, output) : join24(dirname9(absPath), `${base}.${actualWidth}x${actualHeight}${ext}`);
-      await writeFile6(outputPath, resized);
+      const outputPath = output ? resolve8(projectDir, output) : join25(dirname11(absPath), `${base}.${actualWidth}x${actualHeight}${ext}`);
+      await writeFile7(outputPath, resized);
       const metadata = await sharp(outputPath).metadata();
       return { result: { output: outputPath, metadata: extractMetadata(metadata) } };
     });
     server.registry("toolbox/image-convert", async (payload) => {
       const { path: imgPath, format, quality, output } = imageConvertRequestSchema.parse(payload);
       const absPath = resolve8(projectDir, imgPath);
-      const outputPath = output ? resolve8(projectDir, output) : join24(dirname9(absPath), `${basename4(absPath, extname3(absPath))}.${format}`);
+      const outputPath = output ? resolve8(projectDir, output) : join25(dirname11(absPath), `${basename4(absPath, extname3(absPath))}.${format}`);
       const sharp = await getSharp();
       let pipeline = sharp(absPath);
       const opts = {};
@@ -11888,16 +13029,41 @@ function createToolboxModule(_ctx) {
         margin,
         ec_level: errorCorrection
       });
-      await writeFile6(outputPath, png);
+      await writeFile7(outputPath, png);
       return { result: { output: outputPath } };
     });
+    server.registry(
+      "toolbox/audio-transcribe",
+      async (payload) => {
+        const {
+          path: audioPath,
+          language,
+          ffmpegPath,
+          timeoutSeconds
+        } = audioTranscribeRequestSchema.parse(payload);
+        const absPath = resolve8(projectDir, audioPath);
+        const outcome = await transcribeAudioFile(ctx, {
+          path: absPath,
+          language,
+          ffmpegPath,
+          timeoutSeconds
+        });
+        return { result: outcome };
+      }
+    );
+    server.registry("toolbox/text-to-speech", async (payload) => {
+      const { text, output, format } = textToSpeechRequestSchema.parse(payload);
+      const outputPath = resolve8(projectDir, output ?? `speech.${format}`);
+      const outcome = await synthesizeSpeechToFile(ctx, { text, output: outputPath, format });
+      return { result: outcome };
+    });
   }
   function buildToolboxMcpServer(options) {
     return {
       name: "toolbox",
       command: process.execPath,
       args: [
-        join24(process.scriptsPath, "mcp-toolbox/server.mjs"),
+        join25(process.scriptsPath, "mcp-toolbox/server.mjs"),
         "--project-dir",
         options.projectDir,
         "--socket-path",
@@ -11912,85 +13078,11 @@ function createToolboxModule(_ctx) {
   };
 }
 
-// src/backend/speech/manager.ts
-import { Buffer as Buffer2 } from "node:buffer";
-import {
-  createASRClient
-} from "unified-realtime-asr";
-var DEFAULT_DASHSCOPE_MODEL = "fun-asr-flash-8k-realtime";
-var DEFAULT_OPENAI_MODEL = "gpt-4o-transcribe";
-function optionalString(value) {
-  const trimmed = value?.trim();
-  return trimmed || void 0;
-}
-function required(value, name) {
-  const result = optionalString(value);
-  if (!result) throw new Error(`\u5B9E\u65F6\u8BED\u97F3\u8BC6\u522B\u914D\u7F6E\u7F3A\u5C11 ${name}\u3002`);
-  return result;
-}
-function buildOptions(provider) {
-  return {
-    language: optionalString(provider.language) ?? "zh-CN",
-    sampleRate: 16e3,
-    channels: 1,
-    format: "pcm",
-    interimResults: true,
-    punctuation: true,
-    autoReconnect: false,
-    transcriptionModel: provider.provider === "openai" ? optionalString(provider.model) ?? DEFAULT_OPENAI_MODEL : void 0
-  };
-}
-function buildConfig(provider) {
-  const options = buildOptions(provider);
-  const url = optionalString(provider.baseUrl);
-  switch (provider.provider) {
-    case "volcengine":
-      return {
-        provider: "volcengine",
-        apiKey: required(provider.apiKey, "API Key"),
-        resourceId: optionalString(provider.resourceId),
-        appId: optionalString(provider.appId),
-        url,
-        options
-      };
-    case "dashscope":
-      return {
-        provider: "dashscope",
-        apiKey: required(provider.apiKey, "API Key"),
-        model: optionalString(provider.model) ?? DEFAULT_DASHSCOPE_MODEL,
-        workspaceId: optionalString(provider.workspaceId),
-        region: provider.region,
-        workspace: optionalString(provider.workspace),
-        url,
-        options
-      };
-    case "openai":
-      return {
-        provider: "openai",
-        apiKey: required(provider.apiKey, "API Key"),
-        url,
-        options
-      };
-    case "iflytek":
-      return {
-        provider: "iflytek",
-        appId: required(provider.appId, "App ID"),
-        apiKey: required(provider.apiKey, "API Key"),
-        apiSecret: required(provider.apiSecret, "API Secret"),
-        url,
-        options
-      };
-  }
-}
-function getActiveProvider(ctx) {
-  const provider = ctx.storage.getSettings().speechToText.find((item) => item.active);
-  if (!provider) {
-    throw new Error("\u8BF7\u5148\u5728\u8BBE\u7F6E \u2192 \u8BED\u97F3\u8BC6\u522B\u4E2D\u914D\u7F6E\u5E76\u542F\u7528\u4E00\u4E2A Provider\u3002");
-  }
-  return provider;
-}
-function errorMessage(error) {
-  return error instanceof Error ? error.message : String(error);
+// src/backend/speech/asr-manager.ts
+import { Buffer as Buffer3 } from "node:buffer";
+import { createASRClient as createASRClient2 } from "unified-realtime-asr";
+function isNotConnectedError(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === "not-connected";
 }
 function createAsrManager(ctx) {
   const sessions = /* @__PURE__ */ new Map();
@@ -12017,9 +13109,9 @@ function createAsrManager(ctx) {
     async start(clientId, asrSessionId) {
       const key = keyOf2(clientId, asrSessionId);
       if (sessions.has(key)) return { ok: true };
-      const provider = getActiveProvider(ctx);
-      const client2 = createASRClient(buildConfig(provider));
-      const active = { clientId, asrSessionId, client: client2 };
+      const provider = getActiveAsrProvider(ctx);
+      const client2 = createASRClient2(buildAsrConfig(provider));
+      const active = { clientId, asrSessionId, client: client2, ready: false };
       sessions.set(key, active);
       client2.on("transcript", (transcript) => {
         if (sessions.get(key) === active) emitTranscript(active, transcript);
@@ -12029,6 +13121,7 @@ function createAsrManager(ctx) {
       });
       client2.on("close", (info) => {
         if (sessions.get(key) !== active) return;
+        active.ready = false;
         sessions.delete(key);
         ctx.sendEvent("asr-closed", {
           clientId,
@@ -12039,6 +13132,7 @@ function createAsrManager(ctx) {
       });
       try {
         await client2.connect();
+        active.ready = true;
         return { ok: true };
       } catch (error) {
         sessions.delete(key);
@@ -12049,9 +13143,14 @@ function createAsrManager(ctx) {
     frame(clientId, asrSessionId, audioB64) {
       const active = sessions.get(keyOf2(clientId, asrSessionId));
       if (!active) return;
+      if (!active.ready) return;
       try {
-        active.client.sendAudio(Buffer2.from(audioB64, "base64"));
+        active.client.sendAudio(Buffer3.from(audioB64, "base64"));
       } catch (error) {
+        if (isNotConnectedError(error)) {
+          active.ready = false;
+          return;
+        }
         emitError(active, error);
       }
     },
@@ -12084,6 +13183,116 @@ function createAsrManager(ctx) {
   };
 }
 
+// src/backend/speech/tts-manager.ts
+import { Buffer as Buffer4 } from "node:buffer";
+import { createTTSClient as createTTSClient2 } from "unified-realtime-asr";
+function createTtsManager(ctx) {
+  const connections = /* @__PURE__ */ new Map();
+  const ensureConnected = async (connection) => {
+    if (connection.connected) return;
+    if (connection.connectFailed) throw new Error("\u8BED\u97F3\u5408\u6210\u8FDE\u63A5\u4E0D\u53EF\u7528\u3002");
+    if (!connection.connecting) {
+      connection.connecting = connection.client.connect().then(() => {
+        connection.connected = true;
+      }).catch((error) => {
+        connection.connectFailed = true;
+        if (connections.get(connection.ttsSessionId) === connection) {
+          ctx.sendEvent("tts-error", {
+            ttsSessionId: connection.ttsSessionId,
+            message: errorMessage(error)
+          });
+        }
+        throw error;
+      }).finally(() => {
+        connection.connecting = null;
+      });
+    }
+    await connection.connecting;
+  };
+  const teardown = (connection) => {
+    if (connections.get(connection.ttsSessionId) === connection) {
+      connections.delete(connection.ttsSessionId);
+    }
+    connection.client.removeAllListeners();
+  };
+  return {
+    async start(ttsSessionId) {
+      if (connections.has(ttsSessionId)) return { ok: true };
+      const client2 = createTTSClient2(buildTtsConfig(getActiveTtsProvider(ctx)));
+      const connection = {
+        ttsSessionId,
+        client: client2,
+        connected: false,
+        connecting: null,
+        connectFailed: false
+      };
+      connections.set(ttsSessionId, connection);
+      client2.on("audio", (chunk) => {
+        if (connections.get(ttsSessionId) !== connection) return;
+        ctx.sendEvent("tts-audio", {
+          ttsSessionId,
+          audioB64: Buffer4.from(chunk.audio).toString("base64"),
+          format: chunk.format,
+          sampleRate: chunk.sampleRate,
+          channels: chunk.channels,
+          isFinal: chunk.isFinal,
+          index: chunk.index
+        });
+      });
+      client2.on("error", (error) => {
+        if (connections.get(ttsSessionId) !== connection) return;
+        ctx.sendEvent("tts-error", { ttsSessionId, message: errorMessage(error) });
+      });
+      client2.on("close", (info) => {
+        if (connections.get(ttsSessionId) !== connection) return;
+        connections.delete(ttsSessionId);
+        ctx.sendEvent("tts-closed", {
+          ttsSessionId,
+          code: info?.code,
+          reason: info?.reason
+        });
+      });
+      return { ok: true };
+    },
+    async speak(ttsSessionId, text) {
+      const connection = connections.get(ttsSessionId);
+      if (!connection) return;
+      await ensureConnected(connection);
+      connection.client.sendText(text);
+      await connection.client.flush();
+    },
+    async end(ttsSessionId) {
+      const connection = connections.get(ttsSessionId);
+      if (!connection) return;
+      if (connection.connected || connection.connecting) {
+        try {
+          await connection.connecting;
+        } catch {
+        }
+        try {
+          await connection.client.close();
+        } catch (error) {
+          ctx.sendEvent("tts-error", { ttsSessionId, message: errorMessage(error) });
+        }
+      }
+      teardown(connection);
+    },
+    async closeAll() {
+      await Promise.all(
+        Array.from(connections.values(), async (connection) => {
+          try {
+            if (connection.connected || connection.connecting) await connection.client.close();
+          } catch {
+          } finally {
+            teardown(connection);
+          }
+        })
+      );
+      connections.clear();
+    }
+  };
+}
+
 // src/backend/backend.ts
 function initBackend(emitter) {
   const listeners = [];
@@ -12110,6 +13319,7 @@ function initBackend(emitter) {
   const memory = createMemoryModule(ctx, { inference: _inference });
   const imageGeneration = createImageGenerationModule(ctx, { ilink: ilink.state });
   const asr = createAsrManager(ctx);
+  const tts = createTtsManager(ctx);
   const session = createSessionModule(ctx, {
     bridgeConnect,
     askUser,
@@ -12129,6 +13339,8 @@ function initBackend(emitter) {
     newSession: session.newSession,
     getModels: session.getModels,
     setModel: session.setModel,
+    updateSession: session.updateSession,
+    loadSession: session.loadSession,
     respondAskUser: askUser.respondAskUser,
     getPendingAskUserRequests: askUser.getPendingAskUserRequests
   });
@@ -12228,7 +13440,7 @@ function initBackend(emitter) {
       const projectRoot = projectId ? storageOps.getProject(projectId)?.cwd : void 0;
       const skillDir = skills.getSkillSystemPathFromId(skillId, { projectRoot });
       if (!skillDir) throw new Error(`Failed to read skill: ${skillId}`);
-      return join25(skillDir, SKILL_FILENAME);
+      return join26(skillDir, SKILL_FILENAME);
     },
     async uninstallSkill({ skillId, projectId }) {
       const projectRoot = projectId ? storageOps.getProject(projectId)?.cwd : void 0;
@@ -12480,7 +13692,7 @@ function initBackend(emitter) {
     }) {
       const shareDir = storageOps.sessionShareDir(sessionId);
       if (!shareDir) throw new Error("Session not found");
-      return join25(shareDir, sharePath);
+      return join26(shareDir, sharePath);
     },
     async deleteTask({ scheduleId, taskId }) {
       automation.deleteTask(scheduleId, taskId);
@@ -12507,12 +13719,23 @@ function initBackend(emitter) {
     },
     async stopRealtimeAsr({ clientId, asrSessionId }) {
       await asr.stop(clientId, asrSessionId);
+    },
+    // Speech Synthesis (TTS)：无状态转发，文本整理在渲染层
+    async startTts({ ttsSessionId }) {
+      return tts.start(ttsSessionId);
+    },
+    async speakTts({ ttsSessionId, text }) {
+      await tts.speak(ttsSessionId, text);
+    },
+    async endTts({ ttsSessionId }) {
+      await tts.end(ttsSessionId);
     }
   };
   webui.setHandlers(backendHandlers2);
   async function closeBackend2() {
     automation.stopAllCrons();
     await asr.closeAll();
+    await tts.closeAll();
     webui.stop();
     await ilink.stopIlink({ logout: false });
     session.clearSession();
@@ -12521,14 +13744,14 @@ function initBackend(emitter) {
     terminal.killAllTerminals();
     await watcher2.stopAll();
     for (const file of await readdir2(TEMP_DIR)) {
-      await rm3(join25(TEMP_DIR, file), { recursive: true, force: true });
+      await rm3(join26(TEMP_DIR, file), { recursive: true, force: true });
     }
   }
   return { backendHandlers: backendHandlers2, closeBackend: closeBackend2 };
 }
 
 // package.json
-var version = "0.1.55";
+var version = "0.1.57";
 
 // src/server/main.ts
 var port;