dsh-done-sound 0.1.2 → 0.1.4

package/README.md

@@ -1,54 +1,38 @@
 # dsh-done-sound
 
-DeepSeek Harness Web GUI 的「对话完成音效」插件：你在设置里选一段音频，每次 Agent 完整结束一轮对话时自动播放提示音。
+DeepSeek Harness Web GUI 鐨勩€屽璇濆畬鎴愰煶鏁堛€嶆彃浠讹細浣犲湪璁剧疆閲岄€変竴娈甸煶棰戯紝姣忔 Agent 瀹屾暣缁撴潫涓€杞璇濇椂鑷姩鎾斁鎻愮ず闊炽€?
+## 鍔熻兘
 
-## 功能
-
-- **设置卡片**（设置 → 对话完成音效）：选择音频文件（mp3 / wav / ogg / webm / m4a / aac / flac，≤2MB）、试听、清除、音量调节。
-- **完成检测**：以宿主 `turn/end` 事件的 reason（正常/中断/出错/超长）为权威触发信号，快慢对话都不漏、不误判；每轮只响一次。
-- **触发开关**：
-  - `中断时也响`（默认**关**）：手动停止生成时是否也播放。
-  - `出错时也响`（默认**开**）：对话以错误结束（turn-error / 超长截断）时是否也播放。
-- 音频文件保存在 profile 目录 `.dsh-done-sound/`，经 Host 路由 `/dsh-done-sound/audio/<fileId>` 播放，配置持久化在设置中。
-
-## 安装
+- **璁剧疆鍗＄墖**锛堣缃?鈫?瀵硅瘽瀹屾垚闊虫晥锛夛細閫夋嫨闊抽鏂囦欢锛坢p3 / wav / ogg / webm / m4a / aac / flac锛屸墹2MB锛夈€佽瘯鍚€佹竻闄ゃ€侀煶閲忚皟鑺傘€?- **瀹屾垚妫€娴?*锛氫互瀹夸富 `turn/end` 浜嬩欢鐨?reason锛堟甯?涓柇/鍑洪敊/瓒呴暱锛変负鏉冨▉瑙﹀彂淇″彿锛屽揩鎱㈠璇濋兘涓嶆紡銆佷笉璇垽锛涙瘡杞彧鍝嶄竴娆°€?- **瑙﹀彂寮€鍏?*锛?  - `涓柇鏃朵篃鍝峘锛堥粯璁?*鍏?*锛夛細鎵嬪姩鍋滄鐢熸垚鏃舵槸鍚︿篃鎾斁銆?  - `鍑洪敊鏃朵篃鍝峘锛堥粯璁?*寮€**锛夛細瀵硅瘽浠ラ敊璇粨鏉燂紙turn-error / 瓒呴暱鎴柇锛夋椂鏄惁涔熸挱鏀俱€?- 闊抽鏂囦欢淇濆瓨鍦?profile 鐩綍 `.dsh-done-sound/`锛岀粡 Host 璺敱 `/dsh-done-sound/audio/<fileId>` 鎾斁锛岄厤缃寔涔呭寲鍦ㄨ缃腑銆?
+## 瀹夎
 
 ```sh
 dsh plugin --profile web add dsh-done-sound
 ```
 
-本地开发：
+鏈湴寮€鍙戯細
 
 ```sh
-dsh plugin --profile web add link:F:\0.AI-CodeProject\DSHProject\0.日常聊天\dsh-done-sound
+dsh plugin --profile web add link:F:\0.AI-CodeProject\DSHProject\0.鏃ュ父鑱婂ぉ\dsh-done-sound
 ```
 
-安装后重启 `dsh web`，打开设置页即可看到「对话完成音效」卡片。
-
-## 架构
-
-- **Host 半区**（`src/index.js` → 构建产物 `lib/index.js`）：`dsh-done-sound` 设置作用域（`ctx.settings`）、音频文件存储、`webServer` 路由与同源 JSON API（`/dsh-done-sound/api/status|config|audio|clear`）、`dsh-done-sound` 命令。路由经 `ctx.inject(['webServer'], cb)` 延迟挂载；构建时用 esbuild 内联 `@deepseek-ai/schemastery`，产物自包含（link 安装时无需依赖 profile 的模块解析）。
-- **Client 半区**（`lib/client.js`）：`settings.section` 设置卡片（**fetch 调 HTTP API，不依赖会话/命令 RPC**）+ `conversation.session.header.utilities` 完成检测器（`useSession` 订阅 `ConversationSnapshot`，`partial/running → 空闲` 转移触发，按最后节点 seq 去重）。
-
-## 开发
+瀹夎鍚庨噸鍚?`dsh web`锛屾墦寮€璁剧疆椤靛嵆鍙湅鍒般€屽璇濆畬鎴愰煶鏁堛€嶅崱鐗囥€?
+## 鏋舵瀯
 
+- **Host 鍗婂尯**锛坄src/index.js` 鈫?鏋勫缓浜х墿 `lib/index.js`锛夛細`dsh-done-sound` 璁剧疆浣滅敤鍩燂紙`ctx.settings`锛夈€侀煶棰戞枃浠跺瓨鍌ㄣ€乣webServer` 璺敱涓庡悓婧?JSON API锛坄/dsh-done-sound/api/status|config|audio|clear`锛夈€乣dsh-done-sound` 鍛戒护銆傝矾鐢辩粡 `ctx.inject(['webServer'], cb)` 寤惰繜鎸傝浇锛涙瀯寤烘椂鐢?esbuild 鍐呰仈 `@deepseek-ai/schemastery`锛屼骇鐗╄嚜鍖呭惈锛坙ink 瀹夎鏃舵棤闇€渚濊禆 profile 鐨勬ā鍧楄В鏋愶級銆?- **Client 鍗婂尯**锛坄lib/client.js`锛夛細`settings.section` 璁剧疆鍗＄墖锛?*fetch 璋?HTTP API锛屼笉渚濊禆浼氳瘽/鍛戒护 RPC**锛? `conversation.session.header.utilities` 瀹屾垚妫€娴嬪櫒锛坄useSession` 璁㈤槄 `ConversationSnapshot`锛宍partial/running 鈫?绌洪棽` 杞Щ瑙﹀彂锛屾寜鏈€鍚庤妭鐐?seq 鍘婚噸锛夈€?
+## 寮€鍙?
 ```sh
-pnpm install        # 安装 esbuild
-pnpm run build      # 打包 src/index.js -> lib/index.js（自包含）
-pnpm run check      # 语法检查两个产物
-```
-
-修改 host 源码后重新 `pnpm run build`；client 半区直接改 `lib/client.js`（`__ModuleLoader__` 格式即运行时契约，无需打包）。
-
-## 音效库下载
-
-内置提示音不够用？社区精选音色库（百度网盘，永久有效）：
+pnpm install        # 瀹夎 esbuild
+pnpm run build      # 鎵撳寘 src/index.js -> lib/index.js锛堣嚜鍖呭惈锛?pnpm run check      # 璇硶妫€鏌ヤ袱涓骇鐗?```
 
-- 链接：https://pan.baidu.com/s/1xnef4xkCy8pkooXMGi2ApQ?pwd=1234
-- 提取码：1234
+淇敼 host 婧愮爜鍚庨噸鏂?`pnpm run build`锛沜lient 鍗婂尯鐩存帴鏀?`lib/client.js`锛坄__ModuleLoader__` 鏍煎紡鍗宠繍琛屾椂濂戠害锛屾棤闇€鎵撳寘锛夈€?
+## 闊虫晥搴撲笅杞?
+鍐呯疆鎻愮ず闊充笉澶熺敤锛熺ぞ鍖虹簿閫夐煶鑹插簱锛堢櫨搴︾綉鐩橈紝姘镐箙鏈夋晥锛夛細
 
-下载解压后，在 设置 → 对话完成音效 → 选择音频 中选用即可。
+- 閾炬帴锛歨ttps://pan.baidu.com/s/1xnef4xkCy8pkooXMGi2ApQ?pwd=1234
+- 鎻愬彇鐮侊細1234
 
+涓嬭浇瑙ｅ帇鍚庯紝鍦?璁剧疆 鈫?瀵硅瘽瀹屾垚闊虫晥 鈫?閫夋嫨闊抽 涓€夌敤鍗冲彲銆?
 ## License
 
 MIT

package/lib/client.js

@@ -35,6 +35,15 @@ window.__ModuleLoader__.load({
       '.dtc-slider{flex:1;max-width:220px}',
       '.dtc-vol{min-width:44px;text-align:right;font-variant-numeric:tabular-nums}',
       '.dtc-toggle{display:flex;align-items:center;gap:6px;cursor:pointer}',
+      '.dtc-update{color:var(--dsw-alias-state-error-primary);font-weight:600}',
+      '.dtc-uptodate{color:var(--dsw-alias-state-success-primary)}',
+      '.dtc-num{width:72px;border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);background:0 0;border-radius:6px;padding:2px 6px;font-size:12px;font-family:inherit}',
+      '.dtc-saved{color:var(--dsw-alias-state-success-primary);font-size:12px;white-space:nowrap}',
+      '@keyframes dtc-pulse{0%,100%{transform:scale(1);box-shadow:0 0 0 0 rgba(245,158,11,.5)}50%{transform:scale(1.06);box-shadow:0 0 0 8px rgba(245,158,11,0)}}',
+      '.dtc-retry-chip{display:inline-flex;align-items:center;gap:8px;border:2px solid #f59e0b;border-radius:999px;padding:7px 18px;font-size:15px;font-weight:700;color:#fff;background:linear-gradient(135deg,#f59e0b,#ea580c);white-space:nowrap;font-variant-numeric:tabular-nums;line-height:1.2;animation:dtc-pulse 1.2s ease-in-out infinite}',
+      '.dtc-retry-chip .dtc-retry-ico{font-size:17px;line-height:1}',
+      '.dtc-retry-chip .dtc-retry-num{font-size:19px;font-weight:800;margin-left:2px}',
+      '.dtc-cooldown-line{color:var(--dsw-alias-state-warn-primary,#f59e0b);font-weight:600}',
     ].join('');
     if (typeof document !== 'undefined' && document.querySelector('style[data-plugin-css=' + JSON.stringify(CSS_ID) + ']') === null) {
       const tag = document.createElement('style');
@@ -60,7 +69,26 @@ window.__ModuleLoader__.load({
         interruptHint: '手动停止生成时也播放（默认关闭）',
         error: '出错时也响',
         errorHint: '对话以错误结束时也播放（默认开启）',
-        saved: '已保存：',
+        pending: '等待确认时提醒',
+        pendingHint: 'Agent 需要你确认操作（如审批）而停住等待时播放提醒（默认开启）',
+        autoRetry: '报错自动重连',
+        autoRetryHint: '模型重试耗尽、报错结束后自动发送「继续」恢复（默认开启）',
+        retryDelay: '自动重连等待（秒）',
+        retryDelayHint: '报错后等待多久再自动重连；期间恢复则取消（10-300 秒）',
+        confirm: '确定',
+        retrying: '自动重连',
+        retryChipTitle: '报错后自动重连等待中，期间恢复则自动取消',
+        secondsUnit: '秒',
+        retryCooldown: '自动重连冷却中：{s} 秒后可用',
+        retryArmed: '等待 {s} 秒后自动发送「继续」',
+        retrySent: '已自动发送「继续」',
+        retryFailed: '自动发送「继续」失败',
+        version: '当前版本',
+        updateAvailable: '有新版本',
+        upToDate: '已是最新',
+        updateCheckFailed: '无法检查更新',
+        saved: '已保存 ✓',
+        saveMismatch: '保存未生效，当前值仍为 {v} 秒',
         readFailed: '读取文件失败',
         apiFailed: '无法连接插件服务（Host 未加载？），请重启 dsh web',
         noSession: '打开一个会话后配置',
@@ -69,6 +97,7 @@ window.__ModuleLoader__.load({
         evNormal: '正常完成',
         evInterrupt: '中断',
         evError: '出错',
+        evPending: '等待确认',
         evPlayed: '已播放',
         evNotPlayed: '未播放',
       },
@@ -86,7 +115,26 @@ window.__ModuleLoader__.load({
         interruptHint: 'Also play when generation is stopped (default off)',
         error: 'Play on error',
         errorHint: 'Also play when a turn ends in error (default on)',
-        saved: 'Saved:',
+        pending: 'Alert on approval wait',
+        pendingHint: 'Play a reminder when the agent is waiting for your confirmation (default on)',
+        autoRetry: 'Auto-retry on error',
+        autoRetryHint: 'After the model exhausts its retries and the turn ends in error, automatically send "continue" to resume (default on)',
+        retryDelay: 'Auto-retry wait (seconds)',
+        retryDelayHint: 'How long to wait before auto-retrying; cancelled if it recovers meanwhile (10-300s)',
+        confirm: 'OK',
+        retrying: 'Retry',
+        retryChipTitle: 'Auto-retrying after error; auto-cancelled if it recovers',
+        secondsUnit: 's',
+        retryCooldown: 'auto-retry cooling down: {s}s',
+        retryArmed: 'will auto-send "continue" in {s}s',
+        retrySent: 'auto-sent "continue"',
+        retryFailed: 'failed to auto-send "continue"',
+        version: 'Version',
+        updateAvailable: 'Update available',
+        upToDate: 'Up to date',
+        updateCheckFailed: 'Update check failed',
+        saved: 'Saved ✓',
+        saveMismatch: 'Save did not take effect; current value is still {v}s',
         readFailed: 'Failed to read file',
         apiFailed: 'Cannot reach the plugin host service (host not loaded?), restart dsh web',
         noSession: 'Open a session to configure',
@@ -95,6 +143,7 @@ window.__ModuleLoader__.load({
         evNormal: 'completed',
         evInterrupt: 'interrupted',
         evError: 'error',
+        evPending: 'approval wait',
         evPlayed: 'played',
         evNotPlayed: 'not played',
       },
@@ -122,6 +171,15 @@ window.__ModuleLoader__.load({
         return '';
       }
     }
+    function compareVersions(a, b) {
+      const pa = String(a || '0').split('.').map((n) => parseInt(n, 10) || 0);
+      const pb = String(b || '0').split('.').map((n) => parseInt(n, 10) || 0);
+      for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const diff = (pa[i] || 0) - (pb[i] || 0);
+        if (diff !== 0) return diff > 0 ? 1 : -1;
+      }
+      return 0;
+    }
 
     // ---- tiny shared config store (card writes, detector reads) ----
     const configStore = {
@@ -130,7 +188,15 @@ window.__ModuleLoader__.load({
         volume: 0.8,
         playOnInterrupt: false,
         playOnError: true,
+        playOnPending: true,
+        autoRetryOnError: true,
+        retryDelaySeconds: 60,
+        version: null,
+        latestVersion: null,
+        updateStatus: null, // 'update' | 'uptodate' | 'error' | null
+        retryCooldownUntil: null, // timestamp until which auto-retry is cooling down
         url: null,
+        defaultUrl: null,
         fileName: '',
         mime: '',
         size: 0,
@@ -159,14 +225,109 @@ window.__ModuleLoader__.load({
       return cfg;
     }
     function playChime(cfg) {
-      if (!cfg.enabled || !cfg.url) return;
+      const url = cfg.url || cfg.defaultUrl;
+      if (!cfg.enabled || !url) return;
       try {
-        const audio = new Audio(cfg.url);
+        const audio = new Audio(url);
         audio.volume = cfg.volume;
-        audio.play().catch(() => {});
+        const p = audio.play();
+        if (p && typeof p.catch === 'function') {
+          p.catch((err) => {
+            try {
+              console.warn('[dsh-done-sound] audio play failed (browser blocked it?):', err && err.message ? err.message : err);
+            } catch {
+              // ignore
+            }
+          });
+        }
+      } catch (err) {
+        try {
+          console.warn('[dsh-done-sound] audio play failed:', err && err.message ? err.message : err);
+        } catch {
+          // ignore playback failures (autoplay policy, missing audio device)
+        }
+      }
+    }
+
+    // ---- module-level deferred auto-retry ----
+    // Lives outside the component so the "continue" still fires even if the
+    // user navigates away and the header (and its timers) unmount.
+    let pluginCtx = null;
+    const retryState = { armed: false, sessionId: null, endTurnAtError: 0, deadline: 0, timer: null };
+    function cancelModuleRetry() {
+      if (retryState.timer !== null) {
+        clearTimeout(retryState.timer);
+        retryState.timer = null;
+      }
+      retryState.armed = false;
+      retryState.sessionId = null;
+      retryState.endTurnAtError = 0;
+      retryState.deadline = 0;
+    }
+    function fireModuleRetry() {
+      retryState.timer = null;
+      if (!retryState.armed) return;
+      retryState.armed = false;
+      const sid = retryState.sessionId;
+      retryState.sessionId = null;
+      retryState.deadline = 0;
+      // Real send path: the browser→host RPC client (same route the composer's
+      // "send" uses). ctx.connection is provided by @deepseek-ai/dsh-client-connection;
+      // its api.sessions.prompt carries an RpcResponse whose `.result` is {ok} |
+      // {ok:false,error}. Failures are surfaced (console + settings-card row) —
+      // the old remote.sessions guess was silently skipped because no such
+      // namespace exists on the client context.
+      const prompt = pluginCtx && pluginCtx.connection && pluginCtx.connection.api && pluginCtx.connection.api.sessions
+        ? pluginCtx.connection.api.sessions.prompt
+        : null;
+      const fail = (why) => {
+        try {
+          console.error('[dsh-done-sound] auto-retry could not send "继续":', why);
+        } catch {
+          // console may be gone during teardown
+        }
+        setConfig({
+          retryCooldownUntil: null,
+          lastEvent: { at: Date.now(), kind: 'error', reason: 'error', play: false, retried: true, retryFailed: true },
+        });
+      };
+      if (typeof prompt !== 'function') {
+        fail('connection.api.sessions.prompt unavailable');
+        return;
+      }
+      let tz = 'UTC';
+      try {
+        tz = Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC';
       } catch {
-        // ignore playback failures (autoplay policy, missing audio device)
+        // keep UTC
       }
+      Promise.resolve(prompt({ sessionId: sid, mode: 'queue', content: [{ type: 'text', text: '继续' }], clientTimeZone: tz }))
+        .then((res) => {
+          const result = res && res.result;
+          if (result && result.ok) {
+            try {
+              console.log('[dsh-done-sound] auto-retry sent "继续" to session', sid);
+            } catch {
+              // ignore
+            }
+            setConfig({
+              retryCooldownUntil: null,
+              lastEvent: { at: Date.now(), kind: 'error', reason: 'error', play: false, retried: true, retryFailed: false },
+            });
+          } else {
+            const err = result && result.error ? result.error.message : JSON.stringify(result);
+            fail(err || 'prompt not accepted');
+          }
+        })
+        .catch((err) => fail(err && err.message ? err.message : String(err)));
+    }
+    function armModuleRetry(sessionId, endTurnAtError, delayMs) {
+      cancelModuleRetry();
+      retryState.armed = true;
+      retryState.sessionId = sessionId;
+      retryState.endTurnAtError = endTurnAtError;
+      retryState.deadline = Date.now() + delayMs;
+      retryState.timer = setTimeout(fireModuleRetry, delayMs);
     }
 
     // ---- same-origin JSON API transport (no session needed) ----
@@ -196,6 +357,7 @@ window.__ModuleLoader__.load({
     }
 
     function apply(ctx) {
+      pluginCtx = ctx;
       const syncConfig = (payload) => {
         if (!payload || typeof payload !== 'object') return;
         setConfig({
@@ -203,7 +365,12 @@ window.__ModuleLoader__.load({
           volume: typeof payload.volume === 'number' ? payload.volume : 0.8,
           playOnInterrupt: payload.playOnInterrupt === true,
           playOnError: payload.playOnError !== false,
+          playOnPending: payload.playOnPending !== false,
+          autoRetryOnError: payload.autoRetryOnError !== false,
+          retryDelaySeconds: typeof payload.retryDelaySeconds === 'number' ? payload.retryDelaySeconds : 60,
+          version: typeof payload.version === 'string' ? payload.version : null,
           url: typeof payload.url === 'string' && payload.url ? payload.url : null,
+          defaultUrl: typeof payload.defaultUrl === 'string' && payload.defaultUrl ? payload.defaultUrl : null,
           fileName: payload.audio && typeof payload.audio.fileName === 'string' ? payload.audio.fileName : '',
           mime: payload.audio && typeof payload.audio.mime === 'string' ? payload.audio.mime : '',
           size: payload.audio && typeof payload.audio.size === 'number' ? payload.audio.size : 0,
@@ -218,13 +385,59 @@ window.__ModuleLoader__.load({
         const [busy, setBusy] = react.useState(false);
         const [lang] = react.useState(resolveLang());
         const L = (key) => t(lang, key);
+        const [cardTick, setCardTick] = react.useState(Date.now());
+        react.useEffect(() => {
+          const timer = setInterval(() => setCardTick(Date.now()), 1000);
+          return () => clearInterval(timer);
+        }, []);
+        // Auto-retry delay: local draft while editing, committed on blur/Enter.
+        const delayDraftRef = react.useRef(null);
+        const [delayDraft, setDelayDraft] = react.useState(cfg.retryDelaySeconds || 60);
+        react.useEffect(() => {
+          if (delayDraftRef.current !== document.activeElement) {
+            setDelayDraft(cfg.retryDelaySeconds || 60);
+          }
+        }, [cfg.retryDelaySeconds]);
+        const commitDelay = async () => {
+          const v = Number(delayDraft);
+          if (!Number.isFinite(v)) {
+            setDelayDraft(cfg.retryDelaySeconds || 60);
+            return;
+          }
+          const rounded = Math.min(300, Math.max(10, Math.round(v / 5) * 5));
+          if (rounded !== Number(cfg.retryDelaySeconds)) {
+            setDelayDraft(String(rounded));
+            const payload = await run('/dsh-done-sound/api/config', { retryDelaySeconds: rounded });
+            if (!payload) return;
+            // Verify the host actually persisted it (a 200 alone is not proof).
+            if (payload.retryDelaySeconds !== rounded) {
+              setError(L('saveMismatch').replace('{v}', String(payload.retryDelaySeconds)));
+              return;
+            }
+          }
+          // Save feedback (also confirms the current value without changes).
+          setDelaySaved(true);
+          if (delaySavedTimer.current) clearTimeout(delaySavedTimer.current);
+          delaySavedTimer.current = setTimeout(() => setDelaySaved(false), 2000);
+        };
+        const [delaySaved, setDelaySaved] = react.useState(false);
+        const delaySavedTimer = react.useRef(null);
+        react.useEffect(
+          () => () => {
+            if (delaySavedTimer.current) clearTimeout(delaySavedTimer.current);
+          },
+          [],
+        );
 
         react.useEffect(() => {
           let disposed = false;
           (async () => {
             try {
               const payload = await api('/dsh-done-sound/api/status');
-              if (!disposed) syncConfig(payload);
+              if (!disposed) {
+                syncConfig(payload);
+                checkLatestVersion(typeof payload.version === 'string' ? payload.version : null);
+              }
             } catch (e) {
               if (!disposed) {
                 setError(L('apiFailed') + ' (' + (e && e.message ? e.message : String(e)) + ')');
@@ -237,6 +450,26 @@ window.__ModuleLoader__.load({
           };
         }, []);
 
+        // Query the npm registry for the latest published version and compare
+        // with the installed one (red if an update exists, green if up to date).
+        const checkLatestVersion = (currentVersion) => {
+          if (typeof currentVersion !== 'string' || currentVersion.length === 0) return;
+          fetch('https://registry.npmjs.org/dsh-done-sound/latest')
+            .then((res) => (res.ok ? res.json() : Promise.reject(new Error('http ' + res.status))))
+            .then((data) => {
+              const latest = data && typeof data.version === 'string' ? data.version : null;
+              if (latest === null) {
+                setConfig({ updateStatus: 'error' });
+                return;
+              }
+              setConfig({
+                latestVersion: latest,
+                updateStatus: compareVersions(latest, currentVersion) > 0 ? 'update' : 'uptodate',
+              });
+            })
+            .catch(() => setConfig({ updateStatus: 'error' }));
+        };
+
         const run = async (pathname, body) => {
           setBusy(true);
           setError(null);
@@ -317,6 +550,24 @@ window.__ModuleLoader__.load({
             ),
           ),
 
+          // version + update status row (red when an update is available)
+          react.createElement(
+            'div',
+            { className: 'dtc-row' },
+            react.createElement(
+              'span',
+              null,
+              L('version') + '：' + (cfg.version || '—'),
+            ),
+            cfg.updateStatus === 'update'
+              ? react.createElement('span', { className: 'dtc-update' }, L('updateAvailable') + (cfg.latestVersion ? ' v' + cfg.latestVersion : ''))
+              : cfg.updateStatus === 'uptodate'
+                ? react.createElement('span', { className: 'dtc-uptodate' }, L('upToDate'))
+                : cfg.updateStatus === 'error'
+                  ? react.createElement('span', { className: 'dtc-muted' }, L('updateCheckFailed'))
+                  : null,
+          ),
+
           react.createElement(
             'div',
             { className: 'dtc-row' },
@@ -395,9 +646,100 @@ window.__ModuleLoader__.load({
             ),
             react.createElement('span', { className: 'dtc-muted' }, L('errorHint')),
           ),
+          react.createElement(
+            'div',
+            { className: 'dtc-row' },
+            react.createElement(
+              'label',
+              { className: 'dtc-toggle' },
+              react.createElement('input', {
+                type: 'checkbox',
+                checked: cfg.playOnPending,
+                disabled: busy,
+                onChange: (e) => {
+                  run('/dsh-done-sound/api/config', { playOnPending: e.target.checked });
+                },
+              }),
+              react.createElement('span', null, L('pending')),
+            ),
+            react.createElement('span', { className: 'dtc-muted' }, L('pendingHint')),
+          ),
+          react.createElement(
+            'div',
+            { className: 'dtc-row' },
+            react.createElement(
+              'label',
+              { className: 'dtc-toggle' },
+              react.createElement('input', {
+                type: 'checkbox',
+                checked: cfg.autoRetryOnError,
+                disabled: busy,
+                onChange: (e) => {
+                  run('/dsh-done-sound/api/config', { autoRetryOnError: e.target.checked });
+                },
+              }),
+              react.createElement('span', null, L('autoRetry')),
+            ),
+            react.createElement('span', { className: 'dtc-muted' }, L('autoRetryHint')),
+          ),
+          react.createElement(
+            'div',
+            { className: 'dtc-row' },
+            react.createElement('span', null, L('retryDelay')),
+            react.createElement('input', {
+              className: 'dtc-num',
+              type: 'number',
+              min: 10,
+              max: 300,
+              step: 5,
+              ref: delayDraftRef,
+              value: delayDraft,
+              disabled: busy,
+              onChange: (e) => setDelayDraft(e.target.value),
+              onBlur: () => {
+                commitDelay();
+              },
+              onKeyDown: (e) => {
+                if (e.key === 'Enter') {
+                  e.preventDefault();
+                  commitDelay();
+                }
+              },
+            }),
+            react.createElement('span', { className: 'dtc-muted' }, L('secondsUnit')),
+            react.createElement(
+              'button',
+              {
+                className: 'dtc-btn',
+                type: 'button',
+                disabled: busy,
+                onClick: () => {
+                  commitDelay();
+                },
+              },
+              L('confirm'),
+            ),
+            delaySaved && react.createElement('span', { className: 'dtc-saved' }, L('saved')),
+          ),
+          react.createElement('span', { className: 'dtc-muted' }, L('retryDelayHint')),
 
           error !== null && react.createElement('div', { className: 'dtc-err' }, error),
           !cfg.loaded && react.createElement('div', { className: 'dtc-muted' }, L('loading')),
+          cfg.retryCooldownUntil && cfg.retryCooldownUntil > Date.now()
+            ? react.createElement(
+                'div',
+                { className: 'dtc-muted dtc-cooldown-line' },
+                '🔄 ' + L('retryCooldown').replace('{s}', String(Math.ceil((cfg.retryCooldownUntil - cardTick) / 1000))),
+              )
+            : null,
+          retryState.armed && retryState.deadline > cardTick
+            ? react.createElement(
+                'div',
+                { className: 'dtc-muted dtc-cooldown-line' },
+                '🔄 ' +
+                  L('retryArmed').replace('{s}', String(Math.max(0, Math.ceil((retryState.deadline - cardTick) / 1000)))),
+              )
+            : null,
           cfg.lastEvent &&
             react.createElement(
               'div',
@@ -406,9 +748,21 @@ window.__ModuleLoader__.load({
                 '：' +
                 formatEventTime(cfg.lastEvent.at) +
                 ' ' +
-                (cfg.lastEvent.kind === 'interrupt' ? L('evInterrupt') : cfg.lastEvent.kind === 'error' ? L('evError') : L('evNormal')) +
+                (cfg.lastEvent.kind === 'interrupt'
+                  ? L('evInterrupt')
+                  : cfg.lastEvent.kind === 'error'
+                    ? L('evError')
+                    : cfg.lastEvent.kind === 'pending'
+                      ? L('evPending')
+                      : L('evNormal')) +
                 ' → ' +
-                (cfg.lastEvent.play ? L('evPlayed') : L('evNotPlayed')),
+                (cfg.lastEvent.retried === true
+                  ? cfg.lastEvent.retryFailed
+                    ? L('retryFailed')
+                    : L('retrySent')
+                  : cfg.lastEvent.play
+                    ? L('evPlayed')
+                    : L('evNotPlayed')),
             ),
         );
       };
@@ -426,6 +780,8 @@ window.__ModuleLoader__.load({
         const pendingReasonRef = react.useRef(null);
         const lastEndTurnRef = react.useRef(0);
         const lastSessionRef = react.useRef(null);
+        const prevPendingKeysRef = react.useRef('');
+        const seededRef = react.useRef(false);
 
         const snap =
           typeof useSession === 'function'
@@ -444,9 +800,28 @@ window.__ModuleLoader__.load({
                 }
                 return {
                   sessionId: s && typeof s.sessionId === 'string' ? s.sessionId : null,
+                  openState: s && typeof s.openState === 'string' ? s.openState : null,
                   streaming: s.partial !== null || s.running === true,
                   endReason,
                   endTurn,
+                  // agent is waiting for human intervention (approval etc.)
+                  pendingCount: s && Array.isArray(s.pending) ? s.pending.length : 0,
+                  // Stable fingerprint of the items currently waiting, so a
+                  // replacement wait (one approval resolved while the next is
+                  // requested — count stays at 1) is still detected as a NEW
+                  // wait. The old 0->N edge detector missed those, which is the
+                  // "sometimes no sound" cause.
+                  pendingKey:
+                    s && Array.isArray(s.pending) && s.pending.length
+                      ? s.pending
+                          .map((it) => {
+                            const p = it && it.payload;
+                            if (p && typeof p.approvalId === 'string') return 'a:' + p.approvalId;
+                            if (p && typeof p.questionRpcId === 'string') return 'q:' + p.questionRpcId;
+                            return 'i:' + JSON.stringify(it || null);
+                          })
+                          .join('|')
+                      : '',
                 };
               })
             : null;
@@ -454,15 +829,99 @@ window.__ModuleLoader__.load({
         react.useEffect(() => {
           if (snap === null) return;
 
-          // New session (or first mount): seed with its current state; never
-          // play history or a completion that happened before we mounted.
+          // Fire the "waiting for human input" reminder for the current config
+          // view. When no audio URL is known yet (status fetch still in flight,
+          // or the audio was changed elsewhere), re-fetch status once and play
+          // with the fresh view instead of silently skipping.
+          const notifyPending = () => {
+            const canPlay = (view) => view.enabled && view.playOnPending && (view.url || view.defaultUrl);
+            const record = (value) => setConfig({ lastEvent: { at: Date.now(), kind: 'pending', reason: 'pending', play: value } });
+            if (canPlay(cfg)) {
+              playChime(cfg);
+              record(true);
+              return;
+            }
+            api('/dsh-done-sound/api/status')
+              .then((payload) => {
+                if (!payload || typeof payload !== 'object') return;
+                syncConfig(payload);
+                const fresh = {
+                  ...cfg,
+                  enabled: payload.enabled === true,
+                  playOnPending: payload.playOnPending !== false,
+                  url: typeof payload.url === 'string' && payload.url ? payload.url : null,
+                  defaultUrl: typeof payload.defaultUrl === 'string' && payload.defaultUrl ? payload.defaultUrl : null,
+                };
+                if (canPlay(fresh)) {
+                  playChime(fresh);
+                  record(true);
+                }
+              })
+              .catch(() => {});
+            record(false);
+          };
+
+          // New session (or first mount): reset and wait for the history to
+          // settle before listening.
           if (snap.sessionId !== lastSessionRef.current) {
             lastSessionRef.current = snap.sessionId;
+            seededRef.current = false;
             pendingReasonRef.current = null;
-            lastEndTurnRef.current = snap.endTurn;
+            lastEndTurnRef.current = 0;
+            prevPendingKeysRef.current = '';
+            cancelModuleRetry();
+            setConfig({ retryCooldownUntil: null });
+          }
+
+          // Before the session window is open, the timeline fills with the
+          // conversation history (replayed turn/end events). Do NOT treat that
+          // replay as new completions: seed only once openState reaches 'open'
+          // (the latest tail is loaded; older pages only add lower turn
+          // numbers, which never move endTurn).
+          if (!seededRef.current) {
+            if (snap.openState === 'open') {
+              seededRef.current = true;
+              lastEndTurnRef.current = snap.endTurn;
+              // Seed with the current key so the pending detector only fires
+              // for NEW waiting items, but still notify once if we mounted
+              // into an already-waiting conversation (e.g. refresh mid-approval).
+              prevPendingKeysRef.current = snap.pendingKey || '';
+              if (snap.pendingCount > 0) notifyPending();
+            }
             return;
           }
 
+          // Cancel a pending auto-retry when the session recovers on its own
+          // (agent runs again, a new turn closes, it waits for human input, or
+          // we switched sessions) — no need to send "继续" then.
+          if (retryState.armed) {
+            const cancel =
+              snap.sessionId !== retryState.sessionId ||
+              snap.streaming === true ||
+              snap.endTurn > retryState.endTurnAtError ||
+              snap.pendingCount > 0;
+            if (cancel) {
+              cancelModuleRetry();
+              setConfig({ retryCooldownUntil: null });
+            }
+          }
+
+          // Agent entered a waiting-for-human state. Notify on ANY new waiting item:
+// the first pending, a replacement approval (one resolved, next requested —
+// count stays 1, which the old 0->N rising-edge detector missed, i.e. the
+// "sometimes no sound" bug), or an additional item stacking on top.
+if (snap.pendingCount > 0) {
+            const prevKeys = new Set((prevPendingKeysRef.current || '').split('|').filter(Boolean));
+            const curKeys = (snap.pendingKey || '').split('|').filter(Boolean);
+            const hasNew = curKeys.some((k) => !prevKeys.has(k));
+            if (hasNew) {
+              prevPendingKeysRef.current = snap.pendingKey || '';
+              notifyPending();
+              return;
+            }
+          }
+          prevPendingKeysRef.current = snap.pendingKey || '';
+
           // A newly-closed turn is the authoritative "a turn ended" signal.
           if (snap.endTurn > lastEndTurnRef.current) {
             lastEndTurnRef.current = snap.endTurn;
@@ -480,26 +939,96 @@ window.__ModuleLoader__.load({
           else if (reason === 'error' || reason === 'max-tokens') kind = 'error';
           else kind = 'normal'; // 'completed' (and unknown future reasons default to playing)
 
-          let played = false;
-          if (kind === 'interrupt') {
-            if (cfg.playOnInterrupt && cfg.url) {
-              playChime(cfg);
-              played = true;
+          // Fire the chime for a given config view; returns whether it played.
+          const effectiveUrlOf = (view) => view.url || view.defaultUrl;
+          const firePlay = (view) => {
+            if (kind === 'interrupt') {
+              if (view.playOnInterrupt && effectiveUrlOf(view)) {
+                playChime(view);
+                return true;
+              }
+              return false;
             }
-          } else if (kind === 'error') {
-            if (cfg.playOnError && cfg.url) {
-              playChime(cfg);
-              played = true;
+            if (kind === 'error') {
+              if (view.playOnError && effectiveUrlOf(view)) {
+                playChime(view);
+                return true;
+              }
+              return false;
+            }
+            if (effectiveUrlOf(view)) {
+              playChime(view);
+              return true;
             }
-          } else if (cfg.url) {
-            playChime(cfg);
-            played = true;
+            return false;
+          };
+
+          let played = firePlay(cfg);
+          const record = (value) =>
+            setConfig({ lastEvent: { at: Date.now(), kind, reason, play: value } });
+          if (!played && !cfg.url && !cfg.defaultUrl) {
+            // Self-heal: the in-memory config may be stale (e.g. the audio was
+            // uploaded after this page mounted, or in another tab). Re-fetch
+            // status once and retry before giving up.
+            api('/dsh-done-sound/api/status')
+              .then((payload) => {
+                if (payload && typeof payload === 'object') {
+                  syncConfig(payload);
+                  const fresh = {
+                    ...cfg,
+                    enabled: payload.enabled === true,
+                    volume: typeof payload.volume === 'number' ? payload.volume : 0.8,
+                    playOnInterrupt: payload.playOnInterrupt === true,
+                    playOnError: payload.playOnError !== false,
+                    playOnPending: payload.playOnPending !== false,
+                    url: typeof payload.url === 'string' && payload.url ? payload.url : null,
+                    defaultUrl: typeof payload.defaultUrl === 'string' && payload.defaultUrl ? payload.defaultUrl : null,
+                  };
+                  record(firePlay(fresh));
+                } else {
+                  record(false);
+                }
+              })
+              .catch(() => record(false));
+          } else {
+            record(played);
           }
 
-          // Visible diagnostic for the settings card (and future debugging).
-          setConfig({ lastEvent: { at: Date.now(), kind, reason, play: played } });
+          // Arm the deferred auto-retry: after a real 'error' end, wait the
+          // configured window; if the session recovers during the window
+          // (streaming, new turn, approval wait) the retry is cancelled above,
+          // otherwise the module-level timer fires "继续" when it expires.
+          if (reason === 'error' && cfg.enabled && cfg.autoRetryOnError && snap.sessionId) {
+            if (!retryState.armed) {
+              const delayMs = (cfg.retryDelaySeconds || 60) * 1000;
+              armModuleRetry(snap.sessionId, snap.endTurn, delayMs);
+              setConfig({ retryCooldownUntil: retryState.deadline });
+              setConfig({ lastEvent: { at: Date.now(), kind, reason, play: played, retryPending: true } });
+            }
+          }
         }, [snap, cfg]);
 
+        // Countdown chip display only (the actual fire is a module-level timer
+        // that survives navigation away from the conversation).
+        const [nowTick, setNowTick] = react.useState(Date.now());
+        react.useEffect(() => {
+          const timer = setInterval(() => setNowTick(Date.now()), 1000);
+          return () => clearInterval(timer);
+        }, []);
+        const cooldownLeft =
+          cfg.retryCooldownUntil && cfg.retryCooldownUntil > Date.now()
+            ? Math.ceil((cfg.retryCooldownUntil - nowTick) / 1000)
+            : 0;
+        if (cooldownLeft > 0) {
+          const chipLang = resolveLang();
+          return react.createElement(
+            'span',
+            { className: 'dtc-retry-chip', title: t(chipLang, 'retryChipTitle') },
+            react.createElement('span', { className: 'dtc-retry-ico' }, '🔄'),
+            react.createElement('span', null, t(chipLang, 'retrying')),
+            react.createElement('span', { className: 'dtc-retry-num' }, cooldownLeft + 's'),
+          );
+        }
         return null;
       };
 
@@ -529,7 +1058,7 @@ window.__ModuleLoader__.load({
     }
 
     exports.name = 'dsh-done-sound';
-    exports.inject = ['slots', 'remote', 'remote.commands'];
+    exports.inject = ['slots', 'remote', 'remote.commands', 'connection'];
     exports.apply = apply;
     return module.exports;
   },

package/lib/index.js

@@ -1,7 +1,8 @@
-// dsh-done-sound/src/index.js
+// src/index.js
 import { fileURLToPath } from "node:url";
+import { readFileSync } from "node:fs";
 import { mkdir, readFile, writeFile, unlink } from "node:fs/promises";
-import { join } from "node:path";
+import { join, dirname } from "node:path";
 import { randomUUID } from "node:crypto";
 
 // C:/Users/Administrator/.dsh/profiles/web/node_modules/@deepseek-ai/cosmokit/lib/index.js
@@ -792,10 +793,25 @@ defineMethod("transform", [
   "preserve"
 ], ({ inner }, isInner) => inner.toString(isInner));
 
-// dsh-done-sound/src/index.js
+// src/index.js
 var name = "dsh-done-sound";
 var inject = ["settings", "commands", "webServer"];
-var MAX_BYTES = 2 * 1024 * 1024;
+var cachedPluginVersion = null;
+function pluginVersion() {
+  if (cachedPluginVersion !== null) return cachedPluginVersion;
+  try {
+    const pkgPath = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    cachedPluginVersion = typeof pkg.version === "string" ? pkg.version : "unknown";
+  } catch {
+    cachedPluginVersion = "unknown";
+  }
+  return cachedPluginVersion;
+}
+var MAX_BYTES = 10 * 1024 * 1024;
+var DEFAULT_AUDIO_PATH = join(dirname(fileURLToPath(import.meta.url)), "..", "assets", "turn-done.wav");
+var DEFAULT_AUDIO_URL = "/dsh-done-sound/audio/default";
+var DEFAULT_AUDIO_MIME = "audio/wav";
 var AUDIO_MIMES = {
   "audio/mpeg": "mp3",
   "audio/mp3": "mp3",
@@ -816,6 +832,9 @@ var TurnChimeSchema = Schema.object({
   volume: Schema.number().min(0).max(1).step(0.01).default(0.8),
   playOnInterrupt: Schema.boolean().default(false),
   playOnError: Schema.boolean().default(true),
+  playOnPending: Schema.boolean().default(true),
+  autoRetryOnError: Schema.boolean().default(true),
+  retryDelaySeconds: Schema.number().min(10).max(300).step(5).default(60),
   audio: Schema.object({
     fileId: Schema.string().default(""),
     fileName: Schema.string().default(""),
@@ -836,17 +855,22 @@ function apply(ctx) {
     const fileId = value.audio?.fileId ?? "";
     return {
       ok: true,
+      version: pluginVersion(),
       enabled: value.enabled,
       volume: value.volume,
       playOnInterrupt: value.playOnInterrupt,
       playOnError: value.playOnError,
+      playOnPending: value.playOnPending,
+      autoRetryOnError: value.autoRetryOnError,
+      retryDelaySeconds: value.retryDelaySeconds,
       audio: {
         fileId,
         fileName: value.audio?.fileName ?? "",
         mime: value.audio?.mime ?? "",
         size: value.audio?.size ?? 0
       },
-      url: fileId ? `${ROUTE_PREFIX}/audio/${fileId}` : null
+      url: fileId ? `${ROUTE_PREFIX}/audio/${fileId}` : null,
+      defaultUrl: DEFAULT_AUDIO_URL
     };
   };
   const clearAudio = async () => {
@@ -868,7 +892,7 @@ function apply(ctx) {
     if (!ext) throw new Error(`unsupported audio type: ${mime} (mp3/wav/ogg/webm/m4a/aac/flac only)`);
     const buffer = Buffer.from(match[2], "base64");
     if (buffer.length === 0) throw new Error("empty audio content");
-    if (buffer.length > MAX_BYTES) throw new Error(`audio exceeds 2MB (got ${buffer.length} bytes)`);
+    if (buffer.length > MAX_BYTES) throw new Error(`audio exceeds 10MB (got ${buffer.length} bytes)`);
     const fileId = randomUUID();
     await mkdir(dataDir, { recursive: true });
     await writeFile(audioPath(fileId), buffer);
@@ -972,6 +996,22 @@ function apply(ctx) {
       pathname = "/";
     }
     const method = (req.method ?? "GET").toUpperCase();
+    if (pathname === DEFAULT_AUDIO_URL) {
+      try {
+        const buffer = await readFile(DEFAULT_AUDIO_PATH);
+        res.writeHead(200, {
+          "Content-Type": DEFAULT_AUDIO_MIME,
+          "Content-Length": buffer.length,
+          "Cache-Control": "no-cache",
+          "X-Content-Type-Options": "nosniff"
+        });
+        res.end(buffer);
+      } catch {
+        res.writeHead(404);
+        res.end("not found");
+      }
+      return;
+    }
     const audioMatch = /^\/dsh-done-sound\/audio\/([A-Za-z0-9-]+)$/.exec(pathname);
     if (audioMatch) {
       const fileId = audioMatch[1];
@@ -1008,6 +1048,11 @@ function apply(ctx) {
         if (typeof body.volume === "number" && body.volume >= 0 && body.volume <= 1) patch.volume = body.volume;
         if (typeof body.playOnInterrupt === "boolean") patch.playOnInterrupt = body.playOnInterrupt;
         if (typeof body.playOnError === "boolean") patch.playOnError = body.playOnError;
+        if (typeof body.playOnPending === "boolean") patch.playOnPending = body.playOnPending;
+        if (typeof body.autoRetryOnError === "boolean") patch.autoRetryOnError = body.autoRetryOnError;
+        if (typeof body.retryDelaySeconds === "number" && body.retryDelaySeconds >= 10 && body.retryDelaySeconds <= 300) {
+          patch.retryDelaySeconds = Math.round(body.retryDelaySeconds / 5) * 5;
+        }
         if (Object.keys(patch).length > 0) await scope.update(patch);
         sendJson(res, 200, statusPayload());
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-done-sound",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Play a user-chosen sound whenever a conversation finishes in the DeepSeek Harness web GUI",
   "license": "MIT",
   "type": "module",
@@ -30,6 +30,7 @@
   },
   "files": [
     "lib",
+    "assets",
     "cordis.patch.yml",
     "README.md",
     "LICENSE"
@@ -81,8 +82,12 @@
   "devDependencies": {
     "esbuild": "^0.25.0"
   },
+  "engines": {
+    "node": ">=18"
+  },
   "scripts": {
     "build": "esbuild src/index.js --bundle --format=esm --platform=node --target=node22 --outfile=lib/index.js",
-    "check": "node --check lib/index.js && node --check lib/client.js"
+    "check": "node --check lib/index.js && node --check lib/client.js",
+    "test": "node test/host.test.mjs && node test/classify.test.mjs"
   }
 }