dsh-dock 0.9.2 → 0.9.3

package/README.md

@@ -19,7 +19,7 @@
 | **用量记录** | 记录全部 LLM API 调用：秒级时间筛选、Token/费用统计（峰谷计价 + 官网价目自动同步）、分组汇总、明细检索与 CSV 导出 |
 | **模型设置** | 编辑各 Provider 模型目录：输入类型（文本/图片 + 标注）与思考强度档位；图片能力可由你手动声明，新增 Provider 自动刷新加载，写回官方配置热生效 |
 | **模型余额** | 展示所有模型 Provider 账户余额（5 分钟自动刷新） |
-| **任务动画** | 19 种任务运行动画（含星际远征、星云潮汐、曲速航道、量子雷达、星座网络、深海脉动、神经电路等）与完成通知（通知音、浏览器系统通知、钉钉/飞书群机器人推送），动画速度随任务活动联动，两组开关独立，配置全部持久化 |
+| **任务动画** | 19 种任务运行动画（含星际远征、星云潮汐、曲速航道、量子雷达、星座网络、深海脉动、神经电路等）与完成/需确认通知（通知音、浏览器系统通知、钉钉/飞书群机器人推送），动画速度随任务活动联动，两组开关独立，配置全部持久化 |
 
 | **图片理解代理** | 图片识别等（visionproxy）；原图候选默认折叠展示，图片能力以你的声明为准 |
 | **手机接力** | 手机扫码安全接入同一 DSH（反向代理 + 任务/备注同步）；**局域网电脑直连（0.0.0.0）**——另起一个 0.0.0.0 绑定的完整 DSH 子实例，局域网电脑访问到的功能、交互与 127.0.0.1 完全一致（会话记录、工作区文件夹选择等） |
@@ -122,7 +122,8 @@ dsh plugin --profile web remove dsh-dock  # 卸载
      - 代码雨：字符列沿屏幕缓落如数据流
      - 星野：细碎星点飘移闪烁，带弯月与流星
      - 极光：屏幕顶部柔光带缓慢呼吸流动
-   - **完成通知**：任务结束时右上角弹出通知卡片（标题 / 模型 / 耗时 / 回合步骤 / Token / 结果摘要 / 结束原因），可分别开关「完成 / 异常」通知、选择停留时长、开启浏览器系统通知（仅页面后台时推送）；**提示音** 6 种 WebAudio 合成音效可选（完成 / 异常各配一音，可单独试听）
+   - **完成通知**：任务结束时右上角弹出通知卡片（标题 / 模型 / 耗时 / 回合步骤 / Token / 结果摘要 / 结束原因），可分别开关「完成 / 异常」通知、选择停留时长、开启浏览器系统通知（仅页面后台时推送）；**提示音** 6 种 WebAudio 合成音效可选（完成 / 异常 / 确认各配一音，可单独试听）
+   - **需确认提醒**：工具等待用户批准（如沙箱越界执行命令）时弹常驻通知卡片 + 确认音（页面后台时同步系统通知），人不在屏幕前任务也不会干等；等待 / 卡住状态卡片只对当前正在看的会话出现，停靠屏幕右上不挡正文
 2. 任务结束动效自动消失，完成瞬间一缕流光掠过；功能坞面板打开时环境动效自动隐藏避免重叠
 
 3. **钉钉推送**（可选）：任务结束由宿主直发 markdown 消息到钉钉群机器人（浏览器关着也能推）——填入 Webhook 地址保存，「发送测试消息」验证连通；机器人安全设置选「自定义关键词」填「任务」或「dsh」；推送哪些事件跟随上方「完成 / 异常通知」开关
@@ -249,7 +250,8 @@ dsh plugin --profile web remove dsh-dock  # 卸载
      - 代码雨：字符列沿屏幕缓落如数据流
      - 星野：细碎星点飘移闪烁，带弯月与流星
      - 极光：屏幕顶部柔光带缓慢呼吸流动
-   - **完成通知**：任务结束时右上角弹出通知卡片（标题 / 模型 / 耗时 / 回合步骤 / Token / 结果摘要 / 结束原因），可分别开关「完成 / 异常」通知、选择停留时长、开启浏览器系统通知（仅页面后台时推送）；**提示音** 6 种 WebAudio 合成音效可选（完成 / 异常各配一音，可单独试听）
+   - **完成通知**：任务结束时右上角弹出通知卡片（标题 / 模型 / 耗时 / 回合步骤 / Token / 结果摘要 / 结束原因），可分别开关「完成 / 异常」通知、选择停留时长、开启浏览器系统通知（仅页面后台时推送）；**提示音** 6 种 WebAudio 合成音效可选（完成 / 异常 / 确认各配一音，可单独试听）
+   - **需确认提醒**：工具等待用户批准（如沙箱越界执行命令）时弹常驻通知卡片 + 确认音（页面后台时同步系统通知），人不在屏幕前任务也不会干等；等待 / 卡住状态卡片只对当前正在看的会话出现，停靠屏幕右上不挡正文
 2. 任务结束动效自动消失，完成瞬间一缕流光掠过；功能坞面板打开时环境动效自动隐藏避免重叠
 
 3. **钉钉推送**（可选）：任务结束由宿主直发 markdown 消息到钉钉群机器人（浏览器关着也能推）——填入 Webhook 地址保存，「发送测试消息」验证连通；机器人安全设置选「自定义关键词」填「任务」或「dsh」；推送哪些事件跟随上方「完成 / 异常通知」开关

package/client.js

@@ -3876,6 +3876,13 @@ var PHASE_COLORS = { think: "#2f6fed", write: "#0d9488", code: "#b45309", search
 function phaseColor(p) {
   return PHASE_COLORS[p] || "#2f6fed";
 }
+function toolLabel(name) {
+  const n = String(name || "").toLowerCase();
+  if (/bash|shell|terminal|cmd|pwsh|powershell|exec/.test(n)) return "\u6267\u884C\u547D\u4EE4";
+  if (/write|edit|patch|apply|create|mkdir|remove|delete/.test(n)) return "\u4FEE\u6539\u6587\u4EF6";
+  if (/web|fetch|browser|navigate|search/.test(n)) return "\u8BBF\u95EE\u7F51\u9875";
+  return "";
+}
 var END_LABELS = {
   completed: { label: "\u5B8C\u6210", cls: "ok" },
   error: { label: "\u51FA\u9519", cls: "err" },
@@ -4109,12 +4116,12 @@ function RobotScene(props) {
   ] });
 }
 var SOUND_LIBRARY = {
-  chime: { name: "\u6E05\u8106\u53CC\u97F3", notes: { done: [[659.25, 0, 0.14], [880, 0.13, 0.24]], err: [[220, 0, 0.16], [164.81, 0.15, 0.3]] } },
-  ding: { name: "\u53EE", notes: { done: [[987.77, 0, 0.35]], err: [[246.94, 0, 0.4]] } },
-  coin: { name: "\u91D1\u5E01", notes: { done: [[988, 0, 0.08], [1319, 0.08, 0.35], [988, 0, 0.08, "square"], [1319, 0.08, 0.3, "square"]], err: [[196, 0, 0.12], [147, 0.11, 0.35]] } },
-  bell: { name: "\u949F\u58F0", notes: { done: [[523.25, 0, 0.5], [659.25, 0.02, 0.45], [783.99, 0.04, 0.4]], err: [[174.61, 0, 0.5], [130.81, 0.05, 0.5]] } },
-  pulse: { name: "\u8109\u51B2", notes: { done: [[440, 0, 0.09], [440, 0.14, 0.09], [440, 0.28, 0.16]], err: [[174.61, 0, 0.1], [174.61, 0.14, 0.1], [174.61, 0.28, 0.18]] } },
-  arp: { name: "\u7436\u97F3", notes: { done: [[523.25, 0, 0.12], [659.25, 0.09, 0.12], [783.99, 0.18, 0.12], [1046.5, 0.27, 0.3]], err: [[392, 0, 0.12], [329.63, 0.1, 0.12], [261.63, 0.2, 0.12], [196, 0.3, 0.32]] } }
+  chime: { name: "\u6E05\u8106\u53CC\u97F3", notes: { done: [[659.25, 0, 0.14], [880, 0.13, 0.24]], err: [[220, 0, 0.16], [164.81, 0.15, 0.3]], ask: [[587.33, 0, 0.16], [880, 0.19, 0.34]] } },
+  ding: { name: "\u53EE", notes: { done: [[987.77, 0, 0.35]], err: [[246.94, 0, 0.4]], ask: [[783.99, 0, 0.18], [1174.66, 0.2, 0.42]] } },
+  coin: { name: "\u91D1\u5E01", notes: { done: [[988, 0, 0.08], [1319, 0.08, 0.35], [988, 0, 0.08, "square"], [1319, 0.08, 0.3, "square"]], err: [[196, 0, 0.12], [147, 0.11, 0.35]], ask: [[880, 0, 0.09], [1108.73, 0.1, 0.12], [1318.51, 0.22, 0.3]] } },
+  bell: { name: "\u949F\u58F0", notes: { done: [[523.25, 0, 0.5], [659.25, 0.02, 0.45], [783.99, 0.04, 0.4]], err: [[174.61, 0, 0.5], [130.81, 0.05, 0.5]], ask: [[659.25, 0, 0.4], [523.25, 0.05, 0.55]] } },
+  pulse: { name: "\u8109\u51B2", notes: { done: [[440, 0, 0.09], [440, 0.14, 0.09], [440, 0.28, 0.16]], err: [[174.61, 0, 0.1], [174.61, 0.14, 0.1], [174.61, 0.28, 0.18]], ask: [[523.25, 0, 0.09], [523.25, 0.15, 0.09], [659.25, 0.3, 0.22]] } },
+  arp: { name: "\u7436\u97F3", notes: { done: [[523.25, 0, 0.12], [659.25, 0.09, 0.12], [783.99, 0.18, 0.12], [1046.5, 0.27, 0.3]], err: [[392, 0, 0.12], [329.63, 0.1, 0.12], [261.63, 0.2, 0.12], [196, 0.3, 0.32]], ask: [[440, 0, 0.11], [554.37, 0.12, 0.11], [659.25, 0.24, 0.11], [880, 0.36, 0.34]] } }
 };
 var soundCtx = null;
 function playTone(seq) {
@@ -4146,6 +4153,10 @@ function playDoneSound(success, effect) {
   const lib = SOUND_LIBRARY[effect] || SOUND_LIBRARY.chime;
   playTone(success ? lib.notes.done : lib.notes.err);
 }
+function playAskSound(effect) {
+  const lib = SOUND_LIBRARY[effect] || SOUND_LIBRARY.chime;
+  playTone(lib.notes.ask || lib.notes.done);
+}
 function previewSound(effect) {
   const lib = SOUND_LIBRARY[effect] || SOUND_LIBRARY.chime;
   playTone(lib.notes.done);
@@ -4168,11 +4179,14 @@ function Toast(props) {
     const timer = setTimeout(() => props.onClose(t.id), 240);
     return () => clearTimeout(timer);
   }, [closing]);
-  const markColor = t.kind === "success" ? "var(--dk-ok)" : t.kind === "error" ? "var(--dk-err)" : "var(--dk-warn)";
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dkan-toast" + (closing ? " out" : ""), children: [
+  const markColor = t.kind === "success" ? "var(--dk-ok)" : t.kind === "error" ? "var(--dk-err)" : t.kind === "confirm" ? "var(--dk-warn)" : "var(--dk-warn)";
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dkan-toast" + (t.kind === "confirm" ? " dkan-toast-confirm" : "") + (closing ? " out" : ""), children: [
     /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dkan-toast-head", children: [
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dkan-toast-mark", style: { background: markColor } }),
-      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dkan-toast-title", title: t.title, children: t.title }),
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("span", { className: "dkan-toast-title", title: t.title, children: [
+        t.kind === "confirm" ? "\u270B " : "",
+        t.title
+      ] }),
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("button", { type: "button", className: "dkan-toast-close", "aria-label": "\u5173\u95ED", onClick: close, children: "\u2715" })
     ] }),
     t.body ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: "dkan-toast-body", children: t.body }) : null
@@ -4376,6 +4390,24 @@ function visibleRect(el) {
   const r = el.getBoundingClientRect();
   return r.width > 0 && r.height > 0 && r.bottom > 0 && r.top < window.innerHeight ? r : null;
 }
+function currentSessionTitle() {
+  if (typeof document === "undefined") return "";
+  for (const el of document.querySelectorAll('[role="treeitem"][aria-selected="true"]')) {
+    const r = el.getBoundingClientRect();
+    if (r.width > 0 && r.height > 0 && r.right <= window.innerWidth * 0.35) {
+      const text = (el.textContent || "").trim();
+      if (text) return text;
+    }
+  }
+  return "";
+}
+function taskOnScreen(task, titleCache) {
+  const title = task && (task.title || "");
+  if (!title) return true;
+  const current = titleCache !== void 0 ? titleCache : currentSessionTitle();
+  if (!current) return true;
+  return current === title || current.indexOf(title) !== -1 || title.indexOf(current) !== -1;
+}
 var COMPOSER_SEND_SELECTOR = 'button[aria-label="Send message"],button[aria-label*="\u53D1\u9001"],button[data-testid*="send"],button[data-testid*="submit"],button[type="submit"]';
 function conversationComposer() {
   if (typeof document === "undefined" || typeof window === "undefined") return null;
@@ -4445,7 +4477,6 @@ function useSpaceDocks(enabled) {
     let frame = 0;
     let idle = 0;
     let timer = 0;
-    let pollTimer = 0;
     let retries = 0;
     let pending = false;
     let observedComposer = null;
@@ -4501,7 +4532,25 @@ function useSpaceDocks(enabled) {
     }) : null;
     if (mutationObserver && document.body) mutationObserver.observe(document.body, { childList: true, subtree: true });
     schedule(0, true);
-    pollTimer = window.setInterval(() => schedule(), 700);
+    let calibrationInterval = 700;
+    let lastActivityAt = Date.now();
+    const markActivity = () => {
+      lastActivityAt = Date.now();
+      if (calibrationInterval !== 700) {
+        calibrationInterval = 700;
+        restartPoll();
+      }
+    };
+    const unsubscribeActivity = animationStore.subscribe(markActivity);
+    let pollTimer = 0;
+    function restartPoll() {
+      if (pollTimer) window.clearInterval(pollTimer);
+      pollTimer = window.setInterval(() => {
+        if (Date.now() - lastActivityAt > 2e4 && calibrationInterval !== 5e3) calibrationInterval = 5e3;
+        schedule();
+      }, calibrationInterval);
+    }
+    restartPoll();
     const onResize = () => {
       if (idle && typeof window.cancelIdleCallback === "function") window.cancelIdleCallback(idle);
       if (timer) window.clearTimeout(timer);
@@ -4517,6 +4566,7 @@ function useSpaceDocks(enabled) {
       if (pollTimer) window.clearInterval(pollTimer);
       if (mutationObserver) mutationObserver.disconnect();
       if (resizeObserver) resizeObserver.disconnect();
+      unsubscribeActivity();
       window.removeEventListener("resize", onResize);
     };
   }, [enabled]);
@@ -4597,13 +4647,14 @@ function MissionDeparture(props) {
   }, "aria-hidden": "true", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(FreighterHull, { units: 3, empty: true }) });
 }
 function ProgrammingStuck(props) {
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dkan-space-stuck", "aria-hidden": "true", children: [
+  const waiting = !!props.waiting;
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dkan-space-stuck" + (waiting ? " waiting" : ""), "aria-hidden": "true", children: [
     /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(FreighterHull, { units: 3, empty: true }),
     /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("span", { className: "dkan-stuck-code", children: [
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("i", {}),
       `{ }`
     ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("strong", { children: "\u7F16\u7A0B\u7B49\u5F85\u4E2D" }),
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("strong", { children: waiting ? "\u7B49\u5F85\u786E\u8BA4" : "\u7F16\u7A0B\u7B49\u5F85\u4E2D" }),
     /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("small", { children: truncate(props.task && props.task.title || "\u5DE5\u5177\u6682\u65E0\u65B0\u54CD\u5E94", 28) })
   ] });
 }
@@ -4725,6 +4776,56 @@ function AnimationOverlay(props) {
     }
     prevActiveRef.current = st2.active.slice();
   }, [snap.status]);
+  const remindedApprovalsRef = (0, import_react8.useRef)(/* @__PURE__ */ new Map());
+  (0, import_react8.useEffect)(() => {
+    const st2 = snap.status;
+    if (!st2 || !st2.active) return;
+    const cfg2 = st2.config || {};
+    const activeIds = new Set(st2.active.map((x) => x.sessionId));
+    for (const [sid, seen] of remindedApprovalsRef.current) {
+      if (!activeIds.has(sid)) remindedApprovalsRef.current.delete(sid);
+    }
+    for (const task of st2.active) {
+      const approvals = Array.isArray(task.approvals) ? task.approvals : [];
+      if (approvals.length === 0) continue;
+      let seen = remindedApprovalsRef.current.get(task.sessionId);
+      if (!seen) {
+        seen = /* @__PURE__ */ new Set();
+        remindedApprovalsRef.current.set(task.sessionId, seen);
+      }
+      const fresh = approvals.filter((a) => a && !seen.has(a.id));
+      if (fresh.length === 0) continue;
+      for (const a of fresh) seen.add(a.id);
+      if (!cfg2.notifyEnabled || cfg2.notifyOnConfirm === false) continue;
+      const toolName = fresh[0].toolName || "";
+      const scene = toolLabel(toolName);
+      const lines = [
+        "\u4EFB\u52A1\uFF1A" + (task.title || "(\u65E0\u6807\u9898)"),
+        "\u5DE5\u5177\uFF1A" + (toolName || "\u672A\u77E5") + (scene ? "\uFF08" + scene + "\uFF09" : "")
+      ];
+      if (fresh[0].reason) lines.push("\u8BF4\u660E\uFF1A" + truncate(fresh[0].reason, 140));
+      lines.push(fresh.length > 1 ? "\u5171 " + fresh.length + " \u9879\u7B49\u5F85\u4F60\u7684\u786E\u8BA4" : "\u8BF7\u5728\u4F1A\u8BDD\u91CC\u786E\u8BA4\u540E\u7EE7\u7EED");
+      const toast = {
+        id: Date.now() + Math.random(),
+        kind: "confirm",
+        title: "\u4EFB\u52A1\u9700\u8981\u786E\u8BA4",
+        body: lines.join("\n"),
+        // 需确认常驻到用户处理（notifyStayMs=0 同款语义），关掉开关的间隙也不会自动消失
+        stayMs: 0
+      };
+      setToasts((prev) => prev.concat([toast]).slice(-4));
+      if (cfg2.soundNotify !== false) playAskSound(cfg2.soundEffect);
+      if (cfg2.systemNotify && typeof document !== "undefined" && document.hidden && typeof Notification !== "undefined" && Notification.permission === "granted") {
+        try {
+          new Notification("dsh \u4EFB\u52A1\u9700\u8981\u786E\u8BA4", {
+            body: (task.title || "(\u65E0\u6807\u9898)") + " \xB7 " + (toolName || "\u5DE5\u5177") + " \u7B49\u5F85\u786E\u8BA4",
+            tag: "dsh-dock-approval-" + task.sessionId
+          });
+        } catch {
+        }
+      }
+    }
+  }, [snap.status]);
   const handleTaskEnd = (task, record, cfg2) => {
     const reason = record && record.endReason || "";
     const success = isSuccessReason(reason);
@@ -4795,6 +4896,18 @@ function AnimationOverlay(props) {
   const animOn = !!(cfg && cfg.animationEnabled && active.length > 0);
   const mode = cfg && cfg.effectMode ? cfg.effectMode : "flow";
   const phase = active.length > 0 ? active.reduce((best, x) => !best || (x.phaseAt || 0) > (best.phaseAt || 0) ? x : best, null).phase : "think";
+  const waitingTask = active.find((x) => Array.isArray(x.approvals) && x.approvals.length > 0) || null;
+  const sessionTitleRef = (0, import_react8.useRef)({ at: 0, title: "" });
+  const currentTitle = (0, import_react8.useMemo)(() => {
+    const c = sessionTitleRef.current;
+    if (typeof window === "undefined") return "";
+    if (Date.now() - c.at < 1e3) return c.title;
+    c.at = Date.now();
+    c.title = currentSessionTitle();
+    return c.title;
+  }, [snap.status]);
+  const onScreenTasks = (0, import_react8.useMemo)(() => active.filter((x) => taskOnScreen(x, currentTitle)), [active, currentTitle]);
+  const waitingTaskOnScreen = onScreenTasks.find((x) => Array.isArray(x.approvals) && x.approvals.length > 0) || null;
   useTicker(ctx, animOn);
   const now = Date.now();
   const elapsed = active.length > 0 ? fmtClock(now - Math.min(...active.map((x) => x.startTime || now))) : "";
@@ -4828,7 +4941,7 @@ function AnimationOverlay(props) {
   const spaceModeOn = !!(cfg && cfg.animationEnabled && mode === "space" && !panelOpen);
   const spaceDocks = useSpaceDocks(spaceModeOn);
   const spaceGalaxies = spaceModeOn && spaceDocks ? spaceGalaxyLayout() : null;
-  const stuckTask = active.find((task) => task.phase === "code" && now - (task.lastActivityAt || task.phaseAt || now) >= 18e3) || null;
+  const stuckTask = onScreenTasks.find((task) => task.phase === "code" && now - (task.lastActivityAt || task.phaseAt || now) >= 18e3) || null;
   const robotScaleFromConfig = Math.max(0.85, Math.min(2.2, Number(cfg && cfg.robotScale) || 1.35));
   const speedStyle = { "--dkan-speed": Number(speed).toFixed(2) };
   const saveRobotScale = (0, import_react8.useCallback)((robotScale) => {
@@ -4943,7 +5056,7 @@ function AnimationOverlay(props) {
     ambientOn && mode === "flow" ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: "dkan-line", style: speedStyle, "aria-hidden": "true" }) : null,
     ambientOn && AMBIENT_EFFECT_MODES.has(mode) && (mode !== "space" || spaceGalaxies) ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(AmbientLayer, { mode, phase, speed: Number(speed).toFixed(2), tasks: active, galaxies: spaceGalaxies }) : null,
     spaceModeOn && spaceDocks && active.length === 0 && deliveries.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(ReadyFreighter, { dock: spaceDocks.ready }) : null,
-    spaceModeOn && stuckTask ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(ProgrammingStuck, { task: stuckTask }) : null,
+    spaceModeOn && stuckTask ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(ProgrammingStuck, { task: stuckTask, waiting: !!(stuckTask.approvals && stuckTask.approvals.length) }) : null,
     !panelOpen ? departures.map((departure) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(MissionDeparture, { departure }, departure.id)) : null,
     ambientOn && mode === "orbit" ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: "dkan-orbit", style: speedStyle, "aria-hidden": "true" }) : null,
     /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(BurstLayer, { bursts }),
@@ -4953,8 +5066,8 @@ function AnimationOverlay(props) {
         className: "dkan-botcard",
         role: "button",
         tabIndex: 0,
-        style: botCardStyle,
-        title: active.length + " \u4E2A\u4EFB\u52A1 \xB7 " + phaseLabel(phase) + " \xB7 \u70B9\u51FB\u67E5\u770B\u4EFB\u52A1\u52A8\u753B\u9875 \xB7 \u53EF\u62D6\u52A8\u5230\u4EFB\u610F\u4F4D\u7F6E",
+        style: Object.assign({}, botCardStyle, waitingTask ? { "--dkan-phase": "#b45309" } : null),
+        title: active.length + " \u4E2A\u4EFB\u52A1 \xB7 " + (waitingTask ? "\u7B49\u5F85\u786E\u8BA4" : phaseLabel(phase)) + " \xB7 \u70B9\u51FB\u67E5\u770B\u4EFB\u52A1\u52A8\u753B\u9875 \xB7 \u53EF\u62D6\u52A8\u5230\u4EFB\u610F\u4F4D\u7F6E",
         onPointerDown: onBotPointerDown,
         onPointerMove: onBotPointerMove,
         onPointerUp: onBotPointerUp,
@@ -4973,7 +5086,7 @@ function AnimationOverlay(props) {
             " \u4E2A\u4EFB\u52A1",
             elapsed ? " \xB7 " + elapsed : "",
             " \xB7 ",
-            phaseLabel(phase)
+            waitingTask ? "\u7B49\u5F85\u786E\u8BA4" : phaseLabel(phase)
           ] }),
           /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
             "button",
@@ -5004,8 +5117,8 @@ function AnimationOverlay(props) {
       {
         type: "button",
         className: "dkan-badge" + (mode === "breathe" ? " dkan-badge-breathe" : ""),
-        style: Object.assign({}, speedStyle, { "--dkan-phase": phaseColor(phase) }),
-        title: active.length + " \u4E2A\u4EFB\u52A1\u8FDB\u884C\u4E2D \xB7 " + phaseLabel(phase) + " \xB7 \u70B9\u51FB\u67E5\u770B\u4EFB\u52A1\u52A8\u753B\u9875",
+        style: Object.assign({}, speedStyle, { "--dkan-phase": phaseColor(waitingTask ? "code" : phase) }),
+        title: active.length + " \u4E2A\u4EFB\u52A1\u8FDB\u884C\u4E2D \xB7 " + (waitingTask ? "\u7B49\u5F85\u786E\u8BA4" : phaseLabel(phase)) + " \xB7 \u70B9\u51FB\u67E5\u770B\u4EFB\u52A1\u52A8\u753B\u9875",
         onClick: () => openPanel("animation"),
         children: [
           /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("span", { className: "dkan-dotwrap", children: [
@@ -5018,7 +5131,7 @@ function AnimationOverlay(props) {
             " \u4E2A\u4EFB\u52A1",
             elapsed ? " \xB7 " + elapsed : "",
             " \xB7 ",
-            phaseLabel(phase)
+            waitingTask ? "\u7B49\u5F85\u786E\u8BA4" : phaseLabel(phase)
           ] })
         ]
       }
@@ -5093,10 +5206,11 @@ function ModePreview({ id }) {
 function TaskRow(props) {
   const t = props.t;
   const info = endInfo(t.endReason);
+  const waiting = !props.done && Array.isArray(t.approvals) && t.approvals.length > 0;
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dkan-task", children: [
     /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dkan-task-head", children: [
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dkan-task-title", title: t.title, children: t.title || "(\u65E0\u6807\u9898)" }),
-      props.done ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dkan-tag " + info.cls, children: info.label }) : /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dkan-tag on", children: phaseLabel(t.phase) })
+      props.done ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dkan-tag " + info.cls, children: info.label }) : waiting ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dkan-tag warn", children: "\u7B49\u5F85\u786E\u8BA4" }) : /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dkan-tag on", children: phaseLabel(t.phase) })
     ] }),
     /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dkan-task-meta", children: [
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { children: (t.models && t.models.length ? t.models.join(", ") : "\u672A\u77E5") + (t.provider ? "\uFF08" + t.provider + "\uFF09" : "") }),
@@ -5105,6 +5219,7 @@ function TaskRow(props) {
       t.totalTokens ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { children: "\u21A7" + fmtCompact2(t.inputTokens) + " \u21A5" + fmtCompact2(t.outputTokens) }) : null,
       props.done && t.endTime ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { children: fmtTime2(t.endTime) }) : null
     ] }),
+    waiting ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: "dkan-task-err", children: t.approvals.map((a, i) => (a && a.toolName ? a.toolName : "\u672A\u77E5\u5DE5\u5177") + (a && a.reason ? "\uFF1A" + truncate(a.reason, 80) : "")).join("\uFF1B") }) : null,
     props.done && t.errorMessage ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: "dkan-task-err", children: truncate(t.errorMessage, 120) }) : null
   ] });
 }
@@ -5232,6 +5347,7 @@ function AnimationView(props) {
   if (!cfg) {
     rows.push(/* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: "dkan-note", children: snap.error ? "\u72B6\u6001\u4E0D\u53EF\u7528\uFF1A" + snap.error : snap.loading ? "\u6B63\u5728\u62C9\u53D6\u4EFB\u52A1\u72B6\u6001\u2026" : "\u7B49\u5F85\u4EFB\u52A1\u72B6\u6001" }, "load"));
   } else {
+    const waitingCount2 = active.reduce((n, t) => n + (Array.isArray(t.approvals) ? t.approvals.length : 0), 0);
     rows.push(
       /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dkan-sec", children: [
         /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dkan-sec-head", children: [
@@ -5351,6 +5467,19 @@ function AnimationView(props) {
             ),
             /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dkan-row-sub", children: "\u51FA\u9519 / \u4E2D\u6B62 / \u8FBE\u8F93\u51FA\u4E0A\u9650\u65F6\u901A\u77E5" })
           ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dkan-row", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dkan-row-label", children: "\u9700\u786E\u8BA4\u63D0\u9192" }),
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+              "button",
+              {
+                type: "button",
+                className: "dkm-miniswitch" + (cfg.notifyOnConfirm !== false ? " on" : ""),
+                onClick: () => patch({ notifyOnConfirm: cfg.notifyOnConfirm === false }),
+                children: cfg.notifyOnConfirm !== false ? "\u5F00" : "\u5173"
+              }
+            ),
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dkan-row-sub", children: "\u5DE5\u5177\u7B49\u5F85\u4F60\u6279\u51C6\u65F6\u5F39\u5361\u7247\u5E76\u54CD\u786E\u8BA4\u97F3\uFF08\u5E38\u9A7B\u4E0D\u81EA\u52A8\u6D88\u5931\uFF09" })
+          ] }),
           /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dkan-row", children: [
             /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dkan-row-label", children: "\u505C\u7559\u65F6\u957F" }),
             /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
@@ -5393,7 +5522,7 @@ function AnimationView(props) {
                 children: cfg.soundNotify !== false ? "\u5F00" : "\u5173"
               }
             ),
-            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dkan-row-sub", children: "\u4EFB\u52A1\u7ED3\u675F\u65F6\u64AD\u653E\uFF08\u8BD5\u542C\u4E3A\u5148\u64AD\u5B8C\u6210\u97F3\u3001\u540E\u64AD\u5F02\u5E38\u97F3\uFF09" })
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dkan-row-sub", children: "\u4EFB\u52A1\u7ED3\u675F/\u9700\u786E\u8BA4\u65F6\u64AD\u653E\uFF08\u8BD5\u542C\u4E3A\u5148\u64AD\u5B8C\u6210\u97F3\u3001\u540E\u64AD\u5F02\u5E38\u97F3\uFF09" })
           ] }),
           cfg.soundNotify !== false ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: "dkan-sounds", children: Object.keys(SOUND_LIBRARY).map((key) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
             "button",
@@ -5558,7 +5687,7 @@ function AnimationView(props) {
     /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dkan-sec", children: [
       /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dkan-sec-head", children: [
         /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dkan-sec-title", children: "\u8FD0\u884C\u72B6\u6001" }),
-        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dkan-sec-sub", children: snap.error ? "\u72B6\u6001\u62C9\u53D6\u5931\u8D25\uFF1A" + snap.error : active.length > 0 ? active.length + " \u4E2A\u4EFB\u52A1\u8FDB\u884C\u4E2D" : recent.length > 0 ? "\u7A7A\u95F2 \xB7 \u663E\u793A\u6700\u8FD1\u5B8C\u6210" : "\u7A7A\u95F2 \xB7 \u6682\u65E0\u4EFB\u52A1\u8BB0\u5F55" }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dkan-sec-sub", children: snap.error ? "\u72B6\u6001\u62C9\u53D6\u5931\u8D25\uFF1A" + snap.error : waitingCount > 0 ? waitingCount + " \u9879\u7B49\u5F85\u786E\u8BA4 \xB7 " + active.length + " \u4E2A\u4EFB\u52A1\u8FDB\u884C\u4E2D" : active.length > 0 ? active.length + " \u4E2A\u4EFB\u52A1\u8FDB\u884C\u4E2D" : recent.length > 0 ? "\u7A7A\u95F2 \xB7 \u663E\u793A\u6700\u8FD1\u5B8C\u6210" : "\u7A7A\u95F2 \xB7 \u6682\u65E0\u4EFB\u52A1\u8BB0\u5F55" }),
         /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("button", { type: "button", className: "dkan-refresh", onClick: () => animationStore.refresh(), children: snap.loading ? "\u5237\u65B0\u4E2D\u2026" : "\u5237\u65B0" })
       ] }),
       active.length > 0 ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: "dkan-tasks", children: active.map((t) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(TaskRow, { t }, t.sessionId)) }) : null,
@@ -5630,7 +5759,9 @@ var css2 = [
   ".dkan-delivery-label{position:absolute;left:21px;top:58px;display:flex;align-items:baseline;gap:6px;padding:4px 8px;border:1px solid color-mix(in srgb,#93c5fd 30%,var(--dsw-alias-border-l1));border-radius:999px;background:color-mix(in srgb,var(--dsw-alias-bg-layer-2) 82%,transparent);backdrop-filter:blur(10px);color:var(--dsw-alias-label-secondary);font:10px/1.2 var(--ds-font-family,system-ui,sans-serif);white-space:nowrap;}.dkan-delivery-label b{color:var(--dsw-alias-label-primary);font-weight:650}.dkan-delivery-label span{color:var(--dk-accent);}",
   "@media (max-width:1100px){.dkan-space-system,.dkan-space-runner{display:none}}",
   ".dkan-ready-freighter{position:fixed;width:210px;height:88px;z-index:9994;pointer-events:none;filter:drop-shadow(0 10px 14px rgb(0 0 0 / .18));}.dkan-ready-freighter>span:last-child{position:absolute;left:21px;top:58px;padding:4px 8px;border:1px solid color-mix(in srgb,#93c5fd 28%,var(--dsw-alias-border-l1));border-radius:999px;background:color-mix(in srgb,var(--dsw-alias-bg-layer-2) 80%,transparent);backdrop-filter:blur(10px);color:var(--dsw-alias-label-secondary);font:10px/1.2 var(--ds-font-family,system-ui,sans-serif);white-space:nowrap;}.dkan-departure{position:fixed;left:0;top:0;width:210px;height:88px;z-index:9994;pointer-events:none;will-change:transform,opacity;contain:layout paint style;isolation:isolate;animation:dkan-departure-flight var(--dkan-departure-duration,8600ms) cubic-bezier(.42,0,.85,.45) forwards;}@keyframes dkan-departure-flight{0%{opacity:0;transform:translate3d(var(--dkan-from-x),var(--dkan-from-y),0) scale(1) rotate(var(--dkan-flight-angle,0deg))}6%{opacity:1;transform:translate3d(var(--dkan-from-x),var(--dkan-from-y),0) scale(1) rotate(var(--dkan-flight-angle,0deg))}100%{opacity:0;transform:translate3d(var(--dkan-to-x),var(--dkan-to-y),0) scale(.24) rotate(var(--dkan-flight-angle,0deg))}}",
-  ".dkan-space-stuck{position:fixed;left:50%;top:50%;width:244px;height:160px;z-index:9993;pointer-events:none;transform:translate(-50%,-50%);border:1px solid color-mix(in srgb,#f59e0b 48%,var(--dsw-alias-border-l1));border-radius:20px;background:color-mix(in srgb,var(--dsw-alias-bg-layer-2) 88%,transparent);backdrop-filter:blur(16px);box-shadow:0 18px 54px rgb(0 0 0 / .28),0 0 30px color-mix(in srgb,#f59e0b 15%,transparent);}.dkan-space-stuck .dkan-freighter{left:37px;top:11px;transform:scale(.9);transform-origin:top left;}.dkan-stuck-code{position:absolute;left:17px;right:17px;top:60px;height:36px;border-radius:7px;background:linear-gradient(90deg,color-mix(in srgb,#f59e0b 18%,transparent),transparent);color:var(--dk-warn);font:700 14px/36px var(--ds-font-family-code,monospace);letter-spacing:.12em;text-align:center;overflow:hidden;}.dkan-stuck-code::after{content:'';position:absolute;inset:0;background:linear-gradient(90deg,transparent,color-mix(in srgb,#fef3c7 70%,transparent),transparent);transform:translateX(-110%);animation:dkan-stuck-scan 1.25s linear infinite;}.dkan-stuck-code i{display:inline-block;width:7px;height:7px;margin-right:8px;border-radius:50%;background:#f59e0b;box-shadow:0 0 9px #f59e0b;animation:dkan-stuck-pulse .8s ease-in-out infinite alternate;}.dkan-space-stuck strong{position:absolute;left:0;right:0;top:108px;color:var(--dsw-alias-label-primary);font:650 13px/1.2 var(--ds-font-family,system-ui,sans-serif);text-align:center;}.dkan-space-stuck small{position:absolute;left:18px;right:18px;top:128px;color:var(--dsw-alias-label-secondary);font:11px/1.25 var(--ds-font-family,system-ui,sans-serif);text-align:center;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;}@keyframes dkan-stuck-scan{to{transform:translateX(110%)}}@keyframes dkan-stuck-pulse{to{transform:scale(.55);opacity:.45}}",
+  ".dkan-space-stuck{position:fixed;right:20px;top:88px;width:244px;height:160px;z-index:9993;pointer-events:none;border:1px solid color-mix(in srgb,#f59e0b 48%,var(--dsw-alias-border-l1));border-radius:20px;background:color-mix(in srgb,var(--dsw-alias-bg-layer-2) 88%,transparent);backdrop-filter:blur(16px);box-shadow:0 18px 54px rgb(0 0 0 / .28),0 0 30px color-mix(in srgb,#f59e0b 15%,transparent);}.dkan-space-stuck .dkan-freighter{left:37px;top:11px;transform:scale(.9);transform-origin:top left;}.dkan-stuck-code{position:absolute;left:17px;right:17px;top:60px;height:36px;border-radius:7px;background:linear-gradient(90deg,color-mix(in srgb,#f59e0b 18%,transparent),transparent);color:var(--dk-warn);font:700 14px/36px var(--ds-font-family-code,monospace);letter-spacing:.12em;text-align:center;overflow:hidden;}.dkan-stuck-code::after{content:'';position:absolute;inset:0;background:linear-gradient(90deg,transparent,color-mix(in srgb,#fef3c7 70%,transparent),transparent);transform:translateX(-110%);animation:dkan-stuck-scan 1.25s linear infinite;}.dkan-stuck-code i{display:inline-block;width:7px;height:7px;margin-right:8px;border-radius:50%;background:#f59e0b;box-shadow:0 0 9px #f59e0b;animation:dkan-stuck-pulse .8s ease-in-out infinite alternate;}.dkan-space-stuck strong{position:absolute;left:0;right:0;top:108px;color:var(--dsw-alias-label-primary);font:650 13px/1.2 var(--ds-font-family,system-ui,sans-serif);text-align:center;}.dkan-space-stuck small{position:absolute;left:18px;right:18px;top:128px;color:var(--dsw-alias-label-secondary);font:11px/1.25 var(--ds-font-family,system-ui,sans-serif);text-align:center;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;}@keyframes dkan-stuck-scan{to{transform:translateX(110%)}}@keyframes dkan-stuck-pulse{to{transform:scale(.55);opacity:.45}}",
+  // 窄屏（手机/分屏）贴右会溢出：回落到水平居中、屏幕上方，避开正文重心
+  "@media (max-width:760px){.dkan-space-stuck{right:50%;transform:translateX(50%);top:64px;}}",
   // 极光：顶部柔光带呼吸流动（加浓）
   ".dkan-aurora i{position:absolute;top:-40%;left:-20%;width:70%;height:80%;border-radius:50%;filter:blur(50px);opacity:.32;animation:dkan-aurora ease-in-out infinite alternate;}",
   ".dkan-aurora i:nth-child(1){background:#4d9fff;}",
@@ -5719,6 +5850,9 @@ var css2 = [
   ".dkan-toast-close{cursor:pointer;flex:none;border:none;background:transparent;color:var(--dsw-alias-label-tertiary);border-radius:6px;width:22px;height:22px;font-size:11px;line-height:1;display:inline-flex;align-items:center;justify-content:center;font-family:inherit;}",
   ".dkan-toast-close:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary);}",
   ".dkan-toast-body{font-size:12px;color:var(--dsw-alias-label-secondary);line-height:1.7;white-space:pre-line;word-break:break-word;}",
+  // 需确认卡片：琥珀描边 + 缓慢呼吸光晕，常驻提醒直到用户处理
+  ".dkan-toast-confirm{border-color:color-mix(in srgb,var(--dk-warn) 55%,transparent);animation:dkan-toast-in .32s var(--ds-ease-in-out),dkan-confirm-glow 2.4s ease-in-out 0.4s infinite;}",
+  "@keyframes dkan-confirm-glow{0%,100%{box-shadow:0 10px 36px rgb(0 0 0 / .22),0 0 0 0 color-mix(in srgb,var(--dk-warn) 30%,transparent)}50%{box-shadow:0 10px 36px rgb(0 0 0 / .22),0 0 14px 2px color-mix(in srgb,var(--dk-warn) 32%,transparent)}}",
   // 面板页布局
   ".dkan-root{display:flex;flex-direction:column;gap:10px;}",
   ".dkan-note{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:1.6;}",
@@ -9861,7 +9995,7 @@ var feature8 = {
 };
 
 // src/client.jsx
-var DOCK_VERSION = "0.9.1";
+var DOCK_VERSION = "0.9.3";
 var BUILTIN_FEATURES = [feature, feature2, feature3, feature4, feature5, feature6, feature7, feature8];
 var PLANNED_FEATURES = [];
 var PLANNED_NOTES = {};

package/features/animation/host.js

@@ -9,7 +9,7 @@
 //
 // 配置模型（schemastery schema 见 src/host-core.js DockConfig.animation）：
 //   animationEnabled / effectMode / notifyEnabled / notifyOnComplete /
-//   notifyOnError / notifyStayMs / systemNotify
+//   notifyOnError / notifyOnConfirm / notifyStayMs / systemNotify
 // 动画与通知是两个独立开关，可只开其一；全部经 settings 持久化，重启后恢复。
 import { DOCK_NS, ANIMATION_MODES, SOUND_EFFECTS, sendJson, readBody } from '../../src/host-core.js'
 
@@ -22,6 +22,7 @@ function defaultConfig() {
     notifyEnabled: true,
     notifyOnComplete: true,
     notifyOnError: true,
+    notifyOnConfirm: true,
     notifyStayMs: 8000,
     systemNotify: false,
     soundNotify: true,
@@ -132,6 +133,8 @@ export const feature = {
         errorMessage: '',
         lastText: '',
         firstPrompt: '',
+        // 工具等待用户确认（dsh 会话流 approval/asked）：浏览器侧据此弹"需确认"通知
+        approvals: new Map(), // approvalId -> { toolName, reason, askedAt }
         phase: 'think',
         phaseAt: Date.now(),
         lastActivityAt: Date.now(),
@@ -393,6 +396,19 @@ export const feature = {
           const msg = (reason.error && (reason.error.message || reason.error.code)) || ''
           s.errorMessage = typeof msg === 'string' ? msg : String(msg)
         }
+      } else if (event.type === 'approval/asked' && event.data) {
+        // 工具等待用户确认/批准：挂在会话记录上，/status 下发给浏览器弹"需确认"通知
+        const id = typeof event.data.id === 'string' ? event.data.id : ''
+        if (id) {
+          s.approvals.set(id, {
+            toolName: typeof event.data.toolName === 'string' ? event.data.toolName : '',
+            reason: typeof event.data.reason === 'string' ? truncate(event.data.reason, 200) : '',
+            askedAt: event.time || Date.now(),
+          })
+        }
+        s.lastActivityAt = now
+      } else if (event.type === 'approval/decided' && event.data) {
+        s.approvals.delete(typeof event.data.id === 'string' ? event.data.id : '')
       } else if (event.type === 'tool/call') {
         s.toolCalls++
         s.phase = phaseOfToolName(event.data && event.data.name)
@@ -506,6 +522,7 @@ export const feature = {
                   lastActivityAt: s.lastActivityAt,
                   motionTicks: s.motionTicks,
                   lastMotionAt: s.lastMotionAt,
+                  approvals: [...s.approvals.entries()].map(([id, v]) => ({ id, ...v })),
                 })
               }
               return sendJson(res, 200, {
@@ -531,6 +548,7 @@ export const feature = {
               if (typeof p.notifyEnabled === 'boolean') cfg.notifyEnabled = p.notifyEnabled
               if (typeof p.notifyOnComplete === 'boolean') cfg.notifyOnComplete = p.notifyOnComplete
               if (typeof p.notifyOnError === 'boolean') cfg.notifyOnError = p.notifyOnError
+              if (typeof p.notifyOnConfirm === 'boolean') cfg.notifyOnConfirm = p.notifyOnConfirm
               if (typeof p.notifyStayMs === 'number' && Number.isFinite(p.notifyStayMs)) {
                 cfg.notifyStayMs = Math.max(0, Math.min(600000, Math.round(p.notifyStayMs)))
               }

package/features/animation/view.jsx

@@ -66,6 +66,15 @@ function phaseLabel(p) { return PHASE_LABELS[p] || "工作中"; }
 const PHASE_COLORS = { think: "#2f6fed", write: "#0d9488", code: "#b45309", search: "#0e7490" };
 function phaseColor(p) { return PHASE_COLORS[p] || "#2f6fed"; }
 
+// 工具名 → 中文场景（"需确认"通知里说清楚是什么在等确认）
+function toolLabel(name) {
+	const n = String(name || "").toLowerCase();
+	if (/bash|shell|terminal|cmd|pwsh|powershell|exec/.test(n)) return "执行命令";
+	if (/write|edit|patch|apply|create|mkdir|remove|delete/.test(n)) return "修改文件";
+	if (/web|fetch|browser|navigate|search/.test(n)) return "访问网页";
+	return "";
+}
+
 // ---------- 结束原因 ----------
 const END_LABELS = {
 	completed: { label: "完成", cls: "ok" },
@@ -305,15 +314,16 @@ function RobotScene(props) {
 }
 
 // ---------- 提示音（WebAudio 合成；macOS/Windows 通用，无音频文件） ----------
-// 音效库：每种含完成音（done）与异常音（err）两套音符序列。
-// 音符 [频率, 起始秒, 时长秒, 波形?]，波形缺省 sine。
+// 音效库：每种含完成音（done）、异常音（err）与确认音（ask）三套音符序列。
+// 音符 [频率, 起始秒, 时长秒, 波形?]，波形缺省 sine。确认音双音上扬、偏长，
+// 听感是"来人搭话"，和完成音的收束感、异常音的下坠感区分开。
 const SOUND_LIBRARY = {
-	chime:  { name: "清脆双音", notes: { done: [[659.25, 0, .14], [880, .13, .24]], err: [[220, 0, .16], [164.81, .15, .3]] } },
-	ding:   { name: "叮",       notes: { done: [[987.77, 0, .35]], err: [[246.94, 0, .4]] } },
-	coin:   { name: "金币",     notes: { done: [[988, 0, .08], [1319, .08, .35], [988, 0, .08, "square"], [1319, .08, .3, "square"]], err: [[196, 0, .12], [147, .11, .35]] } },
-	bell:   { name: "钟声",     notes: { done: [[523.25, 0, .5], [659.25, .02, .45], [783.99, .04, .4]], err: [[174.61, 0, .5], [130.81, .05, .5]] } },
-	pulse:  { name: "脉冲",     notes: { done: [[440, 0, .09], [440, .14, .09], [440, .28, .16]], err: [[174.61, 0, .1], [174.61, .14, .1], [174.61, .28, .18]] } },
-	arp:    { name: "琶音",     notes: { done: [[523.25, 0, .12], [659.25, .09, .12], [783.99, .18, .12], [1046.5, .27, .3]], err: [[392, 0, .12], [329.63, .1, .12], [261.63, .2, .12], [196, .3, .32]] } },
+	chime:  { name: "清脆双音", notes: { done: [[659.25, 0, .14], [880, .13, .24]], err: [[220, 0, .16], [164.81, .15, .3]], ask: [[587.33, 0, .16], [880, .19, .34]] } },
+	ding:   { name: "叮",       notes: { done: [[987.77, 0, .35]], err: [[246.94, 0, .4]], ask: [[783.99, 0, .18], [1174.66, .2, .42]] } },
+	coin:   { name: "金币",     notes: { done: [[988, 0, .08], [1319, .08, .35], [988, 0, .08, "square"], [1319, .08, .3, "square"]], err: [[196, 0, .12], [147, .11, .35]], ask: [[880, 0, .09], [1108.73, .1, .12], [1318.51, .22, .3]] } },
+	bell:   { name: "钟声",     notes: { done: [[523.25, 0, .5], [659.25, .02, .45], [783.99, .04, .4]], err: [[174.61, 0, .5], [130.81, .05, .5]], ask: [[659.25, 0, .4], [523.25, .05, .55]] } },
+	pulse:  { name: "脉冲",     notes: { done: [[440, 0, .09], [440, .14, .09], [440, .28, .16]], err: [[174.61, 0, .1], [174.61, .14, .1], [174.61, .28, .18]], ask: [[523.25, 0, .09], [523.25, .15, .09], [659.25, .3, .22]] } },
+	arp:    { name: "琶音",     notes: { done: [[523.25, 0, .12], [659.25, .09, .12], [783.99, .18, .12], [1046.5, .27, .3]], err: [[392, 0, .12], [329.63, .1, .12], [261.63, .2, .12], [196, .3, .32]], ask: [[440, 0, .11], [554.37, .12, .11], [659.25, .24, .11], [880, .36, .34]] } },
 };
 // AudioContext 按需创建（浏览器自动播放策略：首次用户交互后才能出声，静默失败不报错）
 let soundCtx = null;
@@ -338,11 +348,15 @@ function playTone(seq) {
 		}
 	} catch { /* 音频不可用静默 */ }
 }
-// 按音效播放：完成音 / 异常音（未知音效回退 chime）
+// 按音效播放：完成音 / 异常音 / 确认音（未知音效回退 chime）
 function playDoneSound(success, effect) {
 	const lib = SOUND_LIBRARY[effect] || SOUND_LIBRARY.chime;
 	playTone(success ? lib.notes.done : lib.notes.err);
 }
+function playAskSound(effect) {
+	const lib = SOUND_LIBRARY[effect] || SOUND_LIBRARY.chime;
+	playTone(lib.notes.ask || lib.notes.done);
+}
 // 试听：完成音 + 异常音 连播（间隔 0.55s）
 function previewSound(effect) {
 	const lib = SOUND_LIBRARY[effect] || SOUND_LIBRARY.chime;
@@ -371,12 +385,14 @@ function Toast(props) {
 		? "var(--dk-ok)"
 		: t.kind === "error"
 			? "var(--dk-err)"
-			: "var(--dk-warn)";
+			: t.kind === "confirm"
+				? "var(--dk-warn)"
+				: "var(--dk-warn)";
 	return (
-		<div className={"dkan-toast" + (closing ? " out" : "")}>
+		<div className={"dkan-toast" + (t.kind === "confirm" ? " dkan-toast-confirm" : "") + (closing ? " out" : "")}>
 			<div className="dkan-toast-head">
 				<span className="dkan-toast-mark" style={{ background: markColor }} />
-				<span className="dkan-toast-title" title={t.title}>{t.title}</span>
+				<span className="dkan-toast-title" title={t.title}>{t.kind === "confirm" ? "✋ " : ""}{t.title}</span>
 				<button type="button" className="dkan-toast-close" aria-label="关闭" onClick={close}>✕</button>
 			</div>
 			{t.body ? <div className="dkan-toast-body">{t.body}</div> : null}
@@ -587,6 +603,28 @@ function visibleRect(el) {
 	const r = el.getBoundingClientRect();
 	return r.width > 0 && r.height > 0 && r.bottom > 0 && r.top < window.innerHeight ? r : null;
 }
+// 当前正在看的会话标题（侧栏高亮行）。dsh 会话树行 = role="treeitem" + aria-selected，
+// 行文本即会话标题；据此把"需确认/卡住"这类会话级卡片限定到当前会话，别的会话等待时不打扰。
+function currentSessionTitle() {
+	if (typeof document === "undefined") return "";
+	for (const el of document.querySelectorAll('[role="treeitem"][aria-selected="true"]')) {
+		const r = el.getBoundingClientRect();
+		// 侧栏在左：跳过正文区可能出现的同名高亮节点（右上搜索结果等）
+		if (r.width > 0 && r.height > 0 && r.right <= window.innerWidth * .35) {
+			const text = (el.textContent || "").trim();
+			if (text) return text;
+		}
+	}
+	return "";
+}
+// 指定任务是否属于当前正在看的会话（按标题对齐；侧栏不可见时退回"是"避免整层失效）
+function taskOnScreen(task, titleCache) {
+	const title = task && (task.title || "");
+	if (!title) return true;
+	const current = titleCache !== undefined ? titleCache : currentSessionTitle();
+	if (!current) return true;
+	return current === title || current.indexOf(title) !== -1 || title.indexOf(current) !== -1;
+}
 const COMPOSER_SEND_SELECTOR = 'button[aria-label="Send message"],button[aria-label*="发送"],button[data-testid*="send"],button[data-testid*="submit"],button[type="submit"]';
 function conversationComposer() {
 	if (typeof document === "undefined" || typeof window === "undefined") return null;
@@ -651,7 +689,6 @@ function useSpaceDocks(enabled) {
 		let frame = 0;
 		let idle = 0;
 		let timer = 0;
-		let pollTimer = 0;
 		let retries = 0;
 		let pending = false;
 		let observedComposer = null;
@@ -710,7 +747,21 @@ function useSpaceDocks(enabled) {
 		if (mutationObserver && document.body) mutationObserver.observe(document.body, { childList: true, subtree: true });
 		schedule(0, true);
 		// 部分会话会复用同一输入框节点、只改变祖先布局；低频校准覆盖这种无 DOM 替换的位移。
-		pollTimer = window.setInterval(() => schedule(), 700);
+		// 校准只在任务活动时才值得跑：空闲期每 700ms 一次全页 querySelectorAll + getBoundingClientRect
+		// 是持续掉帧的来源（每次都强制布局）。空闲 20s 后降频到 5s，任务恢复立即回到快节奏。
+		let calibrationInterval = 700;
+		let lastActivityAt = Date.now();
+		const markActivity = () => { lastActivityAt = Date.now(); if (calibrationInterval !== 700) { calibrationInterval = 700; restartPoll(); } };
+		const unsubscribeActivity = animationStore.subscribe(markActivity);
+		let pollTimer = 0;
+		function restartPoll() {
+			if (pollTimer) window.clearInterval(pollTimer);
+			pollTimer = window.setInterval(() => {
+				if (Date.now() - lastActivityAt > 20000 && calibrationInterval !== 5000) calibrationInterval = 5000;
+				schedule();
+			}, calibrationInterval);
+		}
+		restartPoll();
 		const onResize = () => {
 			if (idle && typeof window.cancelIdleCallback === "function") window.cancelIdleCallback(idle);
 			if (timer) window.clearTimeout(timer);
@@ -726,6 +777,7 @@ function useSpaceDocks(enabled) {
 			if (pollTimer) window.clearInterval(pollTimer);
 			if (mutationObserver) mutationObserver.disconnect();
 			if (resizeObserver) resizeObserver.disconnect();
+			unsubscribeActivity();
 			window.removeEventListener("resize", onResize);
 		};
 	}, [enabled]);
@@ -787,7 +839,8 @@ function MissionDeparture(props) {
 	}} aria-hidden="true"><FreighterHull units={3} empty /></div>;
 }
 function ProgrammingStuck(props) {
-	return <div className="dkan-space-stuck" aria-hidden="true"><FreighterHull units={3} empty /><span className="dkan-stuck-code"><i />{`{ }`}</span><strong>编程等待中</strong><small>{truncate((props.task && props.task.title) || "工具暂无新响应", 28)}</small></div>;
+	const waiting = !!props.waiting;
+	return <div className={"dkan-space-stuck" + (waiting ? " waiting" : "")} aria-hidden="true"><FreighterHull units={3} empty /><span className="dkan-stuck-code"><i />{`{ }`}</span><strong>{waiting ? "等待确认" : "编程等待中"}</strong><small>{truncate((props.task && props.task.title) || "工具暂无新响应", 28)}</small></div>;
 }
 
 // ---------- 全局浮层：轮询 + 动效 + 通知（功能启用即常驻） ----------
@@ -915,6 +968,58 @@ export function AnimationOverlay(props) {
 		prevActiveRef.current = st.active.slice();
 	}, [snap.status]);
 
+	// ===== 需确认检测：工具等待用户批准时通知（页内卡片 + 确认音 + 后台系统通知） =====
+	// host 从会话流 approval/asked 收集待确认项，approval/decided 后移除；
+	// 这里对"任务首次出现待确认"触发一次提醒，已提醒过的会话不再重复打扰。
+	const remindedApprovalsRef = useRef(new Map()); // sessionId -> 提醒过的 approvalId 集合
+	useEffect(() => {
+		const st = snap.status;
+		if (!st || !st.active) return;
+		const cfg = st.config || {};
+		const activeIds = new Set(st.active.map((x) => x.sessionId));
+		for (const [sid, seen] of remindedApprovalsRef.current) {
+			if (!activeIds.has(sid)) remindedApprovalsRef.current.delete(sid);
+		}
+		for (const task of st.active) {
+			const approvals = Array.isArray(task.approvals) ? task.approvals : [];
+			if (approvals.length === 0) continue;
+			let seen = remindedApprovalsRef.current.get(task.sessionId);
+			if (!seen) { seen = new Set(); remindedApprovalsRef.current.set(task.sessionId, seen); }
+			const fresh = approvals.filter((a) => a && !seen.has(a.id));
+			if (fresh.length === 0) continue;
+			for (const a of fresh) seen.add(a.id);
+			// 提醒开关在"收到新确认项"时检查，保证开关中途打开对下一项生效
+			if (!cfg.notifyEnabled || cfg.notifyOnConfirm === false) continue;
+			const toolName = fresh[0].toolName || "";
+			const scene = toolLabel(toolName);
+			const lines = [
+				"任务：" + (task.title || "(无标题)"),
+				"工具：" + (toolName || "未知") + (scene ? "（" + scene + "）" : ""),
+			];
+			if (fresh[0].reason) lines.push("说明：" + truncate(fresh[0].reason, 140));
+			lines.push(fresh.length > 1 ? "共 " + fresh.length + " 项等待你的确认" : "请在会话里确认后继续");
+			const toast = {
+				id: Date.now() + Math.random(),
+				kind: "confirm",
+				title: "任务需要确认",
+				body: lines.join("\n"),
+				// 需确认常驻到用户处理（notifyStayMs=0 同款语义），关掉开关的间隙也不会自动消失
+				stayMs: 0,
+			};
+			setToasts((prev) => prev.concat([toast]).slice(-4));
+			if (cfg.soundNotify !== false) playAskSound(cfg.soundEffect);
+			if (cfg.systemNotify && typeof document !== "undefined" && document.hidden
+				&& typeof Notification !== "undefined" && Notification.permission === "granted") {
+				try {
+					new Notification("dsh 任务需要确认", {
+						body: (task.title || "(无标题)") + " · " + (toolName || "工具") + " 等待确认",
+						tag: "dsh-dock-approval-" + task.sessionId,
+					});
+				} catch { /* 系统通知失败不影响页面内通知 */ }
+			}
+		}
+	}, [snap.status]);
+
 	const handleTaskEnd = (task, record, cfg) => {
 		const reason = (record && record.endReason) || "";
 		const success = isSuccessReason(reason);
@@ -1002,6 +1107,21 @@ export function AnimationOverlay(props) {
 	const phase = active.length > 0
 		? active.reduce((best, x) => (!best || (x.phaseAt || 0) > (best.phaseAt || 0) ? x : best), null).phase
 		: "think";
+	// 有会话在等用户确认时，状态文字让位给"等待确认"（优先级最高：不动手就卡住）。
+	// 会话级卡片（等待确认/编程等待中）只对"当前正在看的会话"出现，别的会话等待不打扰。
+	const waitingTask = active.find((x) => Array.isArray(x.approvals) && x.approvals.length > 0) || null;
+	const sessionTitleRef = useRef({ at: 0, title: "" });
+	const currentTitle = useMemo(() => {
+		// 标题查询要 getBoundingClientRect（强制布局），限频 1s；面板页/任务行为不受此限制
+		const c = sessionTitleRef.current;
+		if (typeof window === "undefined") return "";
+		if (Date.now() - c.at < 1000) return c.title;
+		c.at = Date.now();
+		c.title = currentSessionTitle();
+		return c.title;
+	}, [snap.status]);
+	const onScreenTasks = useMemo(() => active.filter((x) => taskOnScreen(x, currentTitle)), [active, currentTitle]);
+	const waitingTaskOnScreen = onScreenTasks.find((x) => Array.isArray(x.approvals) && x.approvals.length > 0) || null;
 	useTicker(ctx, animOn);
 	// 徽标计时：以最早开始的任务为基准
 	const now = Date.now();
@@ -1033,7 +1153,8 @@ export function AnimationOverlay(props) {
 	const spaceDocks = useSpaceDocks(spaceModeOn);
 	const spaceGalaxies = spaceModeOn && spaceDocks ? spaceGalaxyLayout() : null;
 	// Host 在编程阶段持续 18 秒没有 chunk/tool 活动，才把它视为卡住；正常长任务不会误触发。
-	const stuckTask = active.find((task) => task.phase === "code" && now - (task.lastActivityAt || task.phaseAt || now) >= 18000) || null;
+	// 卡住卡片同样只对当前会话出现。
+	const stuckTask = onScreenTasks.find((task) => task.phase === "code" && now - (task.lastActivityAt || task.phaseAt || now) >= 18000) || null;
 	const robotScaleFromConfig = Math.max(.85, Math.min(2.2, Number(cfg && cfg.robotScale) || 1.35));
 	const speedStyle = { "--dkan-speed": Number(speed).toFixed(2) };
 	const saveRobotScale = useCallback((robotScale) => {
@@ -1147,7 +1268,7 @@ export function AnimationOverlay(props) {
 			? <AmbientLayer mode={mode} phase={phase} speed={Number(speed).toFixed(2)} tasks={active} galaxies={spaceGalaxies} /> : null}
 		{/* 星际模式：空闲时在输入框上方待命；任务卡住时在中央呈现编程等待状态。 */}
 		{spaceModeOn && spaceDocks && active.length === 0 && deliveries.length === 0 ? <ReadyFreighter dock={spaceDocks.ready} /> : null}
-		{spaceModeOn && stuckTask ? <ProgrammingStuck task={stuckTask} /> : null}
+		{spaceModeOn && stuckTask ? <ProgrammingStuck task={stuckTask} waiting={!!(stuckTask.approvals && stuckTask.approvals.length)} /> : null}
 		{!panelOpen ? departures.map((departure) => <MissionDeparture key={departure.id} departure={departure} />) : null}
 		{/* 环屏巡航：一颗光点沿屏幕边缘转圈（orbit 模式） */}
 		{ambientOn && mode === "orbit" ? <div className="dkan-orbit" style={speedStyle} aria-hidden="true" /> : null}
@@ -1155,8 +1276,8 @@ export function AnimationOverlay(props) {
 		<BurstLayer bursts={bursts} />
 		{/* 桌面伙伴：背侧视角紧凑双工位人物，阶段与任务同步；整卡可拖到任意位置（robot 模式） */}
 		{ambientOn && mode === "robot" ? (
-			<div className="dkan-botcard" role="button" tabIndex={0} style={botCardStyle}
-				title={active.length + " 个任务 · " + phaseLabel(phase) + " · 点击查看任务动画页 · 可拖动到任意位置"}
+			<div className="dkan-botcard" role="button" tabIndex={0} style={Object.assign({}, botCardStyle, waitingTask ? { "--dkan-phase": "#b45309" } : null)}
+				title={active.length + " 个任务 · " + (waitingTask ? "等待确认" : phaseLabel(phase)) + " · 点击查看任务动画页 · 可拖动到任意位置"}
 				onPointerDown={onBotPointerDown}
 				onPointerMove={onBotPointerMove}
 				onPointerUp={onBotPointerUp}
@@ -1165,7 +1286,7 @@ export function AnimationOverlay(props) {
 				onKeyDown={(e) => { if (e.target === e.currentTarget && (e.key === "Enter" || e.key === " ")) { e.preventDefault(); onBotClick(); } }}>
 				<RobotScene phase={phase} tasks={active} />
 				<span className="dkan-bot-cap">
-					<span className="n">{active.length}</span> 个任务{elapsed ? " · " + elapsed : ""} · {phaseLabel(phase)}
+					<span className="n">{active.length}</span> 个任务{elapsed ? " · " + elapsed : ""} · {waitingTask ? "等待确认" : phaseLabel(phase)}
 				</span>
 				<button type="button" className="dkan-bot-resize" aria-label="调整桌面伙伴大小"
 					title="拖动调整桌面伙伴大小"
@@ -1185,15 +1306,15 @@ export function AnimationOverlay(props) {
 		{/* 右下角状态徽标：dot 随模式变化（breathe/ring 装饰），颜色随任务阶段、呼吸随吞吐；点击进功能坞动画页 */}
 		{ambientOn && mode !== "robot" ? (
 			<button type="button" className={"dkan-badge" + (mode === "breathe" ? " dkan-badge-breathe" : "")}
-				style={Object.assign({}, speedStyle, { "--dkan-phase": phaseColor(phase) })}
-				title={active.length + " 个任务进行中 · " + phaseLabel(phase) + " · 点击查看任务动画页"}
+				style={Object.assign({}, speedStyle, { "--dkan-phase": phaseColor(waitingTask ? "code" : phase) })}
+				title={active.length + " 个任务进行中 · " + (waitingTask ? "等待确认" : phaseLabel(phase)) + " · 点击查看任务动画页"}
 				onClick={() => openPanel("animation")}>
 				<span className="dkan-dotwrap">
 					<span className="dkan-dot" />
 					{mode === "breathe" ? <span className="dkan-halo" /> : null}
 					{mode === "ring" ? <span className="dkan-ring" /> : null}
 				</span>
-				<span className="dkan-badge-txt"><span className="n">{active.length}</span> 个任务{elapsed ? " · " + elapsed : ""} · {phaseLabel(phase)}</span>
+				<span className="dkan-badge-txt"><span className="n">{active.length}</span> 个任务{elapsed ? " · " + elapsed : ""} · {waitingTask ? "等待确认" : phaseLabel(phase)}</span>
 			</button>
 		) : null}
 		{/* 完成瞬间的一次性流光（成功绿 / 异常红），动画结束自动清场 */}
@@ -1273,12 +1394,14 @@ function ModePreview({ id }) {
 function TaskRow(props) {
 	const t = props.t;
 	const info = endInfo(t.endReason);
+	const waiting = !props.done && Array.isArray(t.approvals) && t.approvals.length > 0;
 	return (
 		<div className="dkan-task">
 		<div className="dkan-task-head">
 			<span className="dkan-task-title" title={t.title}>{t.title || "(无标题)"}</span>
 			{props.done ? <span className={"dkan-tag " + info.cls}>{info.label}</span>
-				: <span className="dkan-tag on">{phaseLabel(t.phase)}</span>}
+				: waiting ? <span className="dkan-tag warn">等待确认</span>
+					: <span className="dkan-tag on">{phaseLabel(t.phase)}</span>}
 		</div>
 			<div className="dkan-task-meta">
 				<span>{(t.models && t.models.length ? t.models.join(", ") : "未知") + (t.provider ? "（" + t.provider + "）" : "")}</span>
@@ -1287,6 +1410,11 @@ function TaskRow(props) {
 				{t.totalTokens ? <span>{"↧" + fmtCompact(t.inputTokens) + " ↥" + fmtCompact(t.outputTokens)}</span> : null}
 				{props.done && t.endTime ? <span>{fmtTime(t.endTime)}</span> : null}
 			</div>
+			{waiting ? (
+				<div className="dkan-task-err">
+					{t.approvals.map((a, i) => (a && a.toolName ? a.toolName : "未知工具") + (a && a.reason ? "：" + truncate(a.reason, 80) : "")).join("；")}
+				</div>
+			) : null}
 			{props.done && t.errorMessage ? <div className="dkan-task-err">{truncate(t.errorMessage, 120)}</div> : null}
 		</div>
 	);
@@ -1434,6 +1562,7 @@ function AnimationView(props) {
 	if (!cfg) {
 		rows.push(<div key="load" className="dkan-note">{snap.error ? "状态不可用：" + snap.error : (snap.loading ? "正在拉取任务状态…" : "等待任务状态")}</div>);
 	} else {
+		const waitingCount = active.reduce((n, t) => n + (Array.isArray(t.approvals) ? t.approvals.length : 0), 0);
 		rows.push(
 			<div key="anim" className="dkan-sec">
 				<div className="dkan-sec-head">
@@ -1510,6 +1639,14 @@ function AnimationView(props) {
 						</button>
 						<span className="dkan-row-sub">出错 / 中止 / 达输出上限时通知</span>
 					</div>
+					<div className="dkan-row">
+						<span className="dkan-row-label">需确认提醒</span>
+						<button type="button" className={"dkm-miniswitch" + (cfg.notifyOnConfirm !== false ? " on" : "")}
+							onClick={() => patch({ notifyOnConfirm: cfg.notifyOnConfirm === false })}>
+							{cfg.notifyOnConfirm !== false ? "开" : "关"}
+						</button>
+						<span className="dkan-row-sub">工具等待你批准时弹卡片并响确认音（常驻不自动消失）</span>
+					</div>
 					<div className="dkan-row">
 						<span className="dkan-row-label">停留时长</span>
 						<select className="dkan-select" value={String(cfg.notifyStayMs)}
@@ -1535,7 +1672,7 @@ function AnimationView(props) {
 							onClick={() => patch({ soundNotify: cfg.soundNotify === false })}>
 							{cfg.soundNotify !== false ? "开" : "关"}
 						</button>
-						<span className="dkan-row-sub">任务结束时播放（试听为先播完成音、后播异常音）</span>
+						<span className="dkan-row-sub">任务结束/需确认时播放（试听为先播完成音、后播异常音）</span>
 					</div>
 					{cfg.soundNotify !== false ? (
 						<div className="dkan-sounds">
@@ -1646,8 +1783,9 @@ function AnimationView(props) {
 				<span className="dkan-sec-title">运行状态</span>
 				<span className="dkan-sec-sub">
 					{snap.error ? "状态拉取失败：" + snap.error
-						: active.length > 0 ? active.length + " 个任务进行中"
-							: recent.length > 0 ? "空闲 · 显示最近完成" : "空闲 · 暂无任务记录"}
+						: waitingCount > 0 ? waitingCount + " 项等待确认 · " + active.length + " 个任务进行中"
+							: active.length > 0 ? active.length + " 个任务进行中"
+								: recent.length > 0 ? "空闲 · 显示最近完成" : "空闲 · 暂无任务记录"}
 				</span>
 				<button type="button" className="dkan-refresh" onClick={() => animationStore.refresh()}>
 					{snap.loading ? "刷新中…" : "刷新"}
@@ -1727,7 +1865,9 @@ const css = [
 	".dkan-delivery-label{position:absolute;left:21px;top:58px;display:flex;align-items:baseline;gap:6px;padding:4px 8px;border:1px solid color-mix(in srgb,#93c5fd 30%,var(--dsw-alias-border-l1));border-radius:999px;background:color-mix(in srgb,var(--dsw-alias-bg-layer-2) 82%,transparent);backdrop-filter:blur(10px);color:var(--dsw-alias-label-secondary);font:10px/1.2 var(--ds-font-family,system-ui,sans-serif);white-space:nowrap;}.dkan-delivery-label b{color:var(--dsw-alias-label-primary);font-weight:650}.dkan-delivery-label span{color:var(--dk-accent);}",
 	"@media (max-width:1100px){.dkan-space-system,.dkan-space-runner{display:none}}",
 	".dkan-ready-freighter{position:fixed;width:210px;height:88px;z-index:9994;pointer-events:none;filter:drop-shadow(0 10px 14px rgb(0 0 0 / .18));}.dkan-ready-freighter>span:last-child{position:absolute;left:21px;top:58px;padding:4px 8px;border:1px solid color-mix(in srgb,#93c5fd 28%,var(--dsw-alias-border-l1));border-radius:999px;background:color-mix(in srgb,var(--dsw-alias-bg-layer-2) 80%,transparent);backdrop-filter:blur(10px);color:var(--dsw-alias-label-secondary);font:10px/1.2 var(--ds-font-family,system-ui,sans-serif);white-space:nowrap;}.dkan-departure{position:fixed;left:0;top:0;width:210px;height:88px;z-index:9994;pointer-events:none;will-change:transform,opacity;contain:layout paint style;isolation:isolate;animation:dkan-departure-flight var(--dkan-departure-duration,8600ms) cubic-bezier(.42,0,.85,.45) forwards;}@keyframes dkan-departure-flight{0%{opacity:0;transform:translate3d(var(--dkan-from-x),var(--dkan-from-y),0) scale(1) rotate(var(--dkan-flight-angle,0deg))}6%{opacity:1;transform:translate3d(var(--dkan-from-x),var(--dkan-from-y),0) scale(1) rotate(var(--dkan-flight-angle,0deg))}100%{opacity:0;transform:translate3d(var(--dkan-to-x),var(--dkan-to-y),0) scale(.24) rotate(var(--dkan-flight-angle,0deg))}}",
-	".dkan-space-stuck{position:fixed;left:50%;top:50%;width:244px;height:160px;z-index:9993;pointer-events:none;transform:translate(-50%,-50%);border:1px solid color-mix(in srgb,#f59e0b 48%,var(--dsw-alias-border-l1));border-radius:20px;background:color-mix(in srgb,var(--dsw-alias-bg-layer-2) 88%,transparent);backdrop-filter:blur(16px);box-shadow:0 18px 54px rgb(0 0 0 / .28),0 0 30px color-mix(in srgb,#f59e0b 15%,transparent);}.dkan-space-stuck .dkan-freighter{left:37px;top:11px;transform:scale(.9);transform-origin:top left;}.dkan-stuck-code{position:absolute;left:17px;right:17px;top:60px;height:36px;border-radius:7px;background:linear-gradient(90deg,color-mix(in srgb,#f59e0b 18%,transparent),transparent);color:var(--dk-warn);font:700 14px/36px var(--ds-font-family-code,monospace);letter-spacing:.12em;text-align:center;overflow:hidden;}.dkan-stuck-code::after{content:'';position:absolute;inset:0;background:linear-gradient(90deg,transparent,color-mix(in srgb,#fef3c7 70%,transparent),transparent);transform:translateX(-110%);animation:dkan-stuck-scan 1.25s linear infinite;}.dkan-stuck-code i{display:inline-block;width:7px;height:7px;margin-right:8px;border-radius:50%;background:#f59e0b;box-shadow:0 0 9px #f59e0b;animation:dkan-stuck-pulse .8s ease-in-out infinite alternate;}.dkan-space-stuck strong{position:absolute;left:0;right:0;top:108px;color:var(--dsw-alias-label-primary);font:650 13px/1.2 var(--ds-font-family,system-ui,sans-serif);text-align:center;}.dkan-space-stuck small{position:absolute;left:18px;right:18px;top:128px;color:var(--dsw-alias-label-secondary);font:11px/1.25 var(--ds-font-family,system-ui,sans-serif);text-align:center;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;}@keyframes dkan-stuck-scan{to{transform:translateX(110%)}}@keyframes dkan-stuck-pulse{to{transform:scale(.55);opacity:.45}}",
+	".dkan-space-stuck{position:fixed;right:20px;top:88px;width:244px;height:160px;z-index:9993;pointer-events:none;border:1px solid color-mix(in srgb,#f59e0b 48%,var(--dsw-alias-border-l1));border-radius:20px;background:color-mix(in srgb,var(--dsw-alias-bg-layer-2) 88%,transparent);backdrop-filter:blur(16px);box-shadow:0 18px 54px rgb(0 0 0 / .28),0 0 30px color-mix(in srgb,#f59e0b 15%,transparent);}.dkan-space-stuck .dkan-freighter{left:37px;top:11px;transform:scale(.9);transform-origin:top left;}.dkan-stuck-code{position:absolute;left:17px;right:17px;top:60px;height:36px;border-radius:7px;background:linear-gradient(90deg,color-mix(in srgb,#f59e0b 18%,transparent),transparent);color:var(--dk-warn);font:700 14px/36px var(--ds-font-family-code,monospace);letter-spacing:.12em;text-align:center;overflow:hidden;}.dkan-stuck-code::after{content:'';position:absolute;inset:0;background:linear-gradient(90deg,transparent,color-mix(in srgb,#fef3c7 70%,transparent),transparent);transform:translateX(-110%);animation:dkan-stuck-scan 1.25s linear infinite;}.dkan-stuck-code i{display:inline-block;width:7px;height:7px;margin-right:8px;border-radius:50%;background:#f59e0b;box-shadow:0 0 9px #f59e0b;animation:dkan-stuck-pulse .8s ease-in-out infinite alternate;}.dkan-space-stuck strong{position:absolute;left:0;right:0;top:108px;color:var(--dsw-alias-label-primary);font:650 13px/1.2 var(--ds-font-family,system-ui,sans-serif);text-align:center;}.dkan-space-stuck small{position:absolute;left:18px;right:18px;top:128px;color:var(--dsw-alias-label-secondary);font:11px/1.25 var(--ds-font-family,system-ui,sans-serif);text-align:center;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;}@keyframes dkan-stuck-scan{to{transform:translateX(110%)}}@keyframes dkan-stuck-pulse{to{transform:scale(.55);opacity:.45}}",
+	// 窄屏（手机/分屏）贴右会溢出：回落到水平居中、屏幕上方，避开正文重心
+	"@media (max-width:760px){.dkan-space-stuck{right:50%;transform:translateX(50%);top:64px;}}",
 	// 极光：顶部柔光带呼吸流动（加浓）
 	".dkan-aurora i{position:absolute;top:-40%;left:-20%;width:70%;height:80%;border-radius:50%;filter:blur(50px);opacity:.32;animation:dkan-aurora ease-in-out infinite alternate;}",
 	".dkan-aurora i:nth-child(1){background:#4d9fff;}",
@@ -1816,6 +1956,9 @@ const css = [
 	".dkan-toast-close{cursor:pointer;flex:none;border:none;background:transparent;color:var(--dsw-alias-label-tertiary);border-radius:6px;width:22px;height:22px;font-size:11px;line-height:1;display:inline-flex;align-items:center;justify-content:center;font-family:inherit;}",
 	".dkan-toast-close:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary);}",
 	".dkan-toast-body{font-size:12px;color:var(--dsw-alias-label-secondary);line-height:1.7;white-space:pre-line;word-break:break-word;}",
+	// 需确认卡片：琥珀描边 + 缓慢呼吸光晕，常驻提醒直到用户处理
+	".dkan-toast-confirm{border-color:color-mix(in srgb,var(--dk-warn) 55%,transparent);animation:dkan-toast-in .32s var(--ds-ease-in-out),dkan-confirm-glow 2.4s ease-in-out 0.4s infinite;}",
+	"@keyframes dkan-confirm-glow{0%,100%{box-shadow:0 10px 36px rgb(0 0 0 / .22),0 0 0 0 color-mix(in srgb,var(--dk-warn) 30%,transparent)}50%{box-shadow:0 10px 36px rgb(0 0 0 / .22),0 0 14px 2px color-mix(in srgb,var(--dk-warn) 32%,transparent)}}",
 	// 面板页布局
 	".dkan-root{display:flex;flex-direction:column;gap:10px;}",
 	".dkan-note{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:1.6;}",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-dock",
-  "version": "0.9.2",
-  "description": "DeepSeek Harness 功能坞插件（dsh-dock）：模块化功能中枢——每个功能一个 features/ 模块（可单独提取成包发布，又可经 dockBridge 装回面板）。含用量记录（LLM 调用记账/费用统计）、模型设置、图片理解代理、模型余额、任务动画（8 种氛围动效 + 桌面伙伴 3D 场景、完成通知与提示音、钉钉/飞书推送，开关独立、配置持久化）；侧栏入口 + 可拖拽弹窗（最大化/最小化/缩放）。",
+  "version": "0.9.3",
+  "description": "DeepSeek Harness 功能坞插件（dsh-dock）：模块化功能中枢——每个功能一个 features/ 模块（可单独提取成包发布，又可经 dockBridge 装回面板）。含用量记录（LLM 调用记账/费用统计）、模型设置、图片理解代理、模型余额、任务动画（19 种运行动画 + 桌面伙伴 3D 场景、完成/需确认通知与提示音、钉钉/飞书推送，开关独立、配置持久化）；侧栏入口 + 可拖拽弹窗（最大化/最小化/缩放）。",
   "type": "module",
   "main": "index.js",
   "files": [

package/src/client.jsx

@@ -28,7 +28,7 @@ import { feature as fGames } from "../features/games/view.jsx";
 import { feature as fMobileRelay } from "../features/mobile-relay/view.jsx";
 
 const name = "dsh-dock";
-const DOCK_VERSION = "0.9.1";
+const DOCK_VERSION = "0.9.3";
 
 // ---- 内置功能注册表：新功能 = features/<id>/ 加模块 + 这里 import 一行 ----
 const BUILTIN_FEATURES = [fTokenlog, fModelconfig, fHeartbeat, fTheme, fBalance, fAnimation, fGames, fMobileRelay];

package/src/host-core.js

@@ -27,6 +27,8 @@ export const DockConfig = z.object({
     notifyEnabled: z.boolean().default(true),
     notifyOnComplete: z.boolean().default(true),
     notifyOnError: z.boolean().default(true),
+    // 工具等待用户确认/批准时提醒（dsh 会话流 approval/asked → decided）
+    notifyOnConfirm: z.boolean().default(true),
     // 通知停留毫秒数（0 = 常驻直到手动关闭）
     notifyStayMs: z.number().default(8000),
     // 浏览器系统通知（页面后台时推送）