dsh-done-sound 0.1.7 → 0.1.9

package/README.md

@@ -1,18 +1,28 @@
 # dsh-done-sound
 
-DeepSeek Harness Web GUI 的「对话完成音效」插件：你在设置里选一段音频，每次 Agent 完整结束一轮对话时自动播放提示音。
+DeepSeek Harness Web GUI 的对话音效插件。不同触发情况可以分别设置音频提醒，并为每种情况提供内置默认音效。
 
 ## 功能
 
-- **设置卡片**（设置 → 对话完成音效）：选择音频文件（mp3 / wav / ogg / webm / m4a / aac / flac，≤2MB）、试听、清除、音量调节。
-- **完成检测**：以宿主 `turn/end` 事件的 reason（正常/中断/出错/超长）为权威触发信号，快慢对话都不漏、不误判；每轮只响一次。
+- **五种场景独立配置**：正常完成、中断、出错、等待确认、自动重连成功各自使用独立音频，可分别选择、试听和清除。
+- **内置默认音效**：即使没有上传任何文件，也会使用对应场景的默认音效：
+  - 正常完成：`turn-done.wav`
+  - 中断：`turn-interrupt.wav`
+  - 出错：`turn-error.wav`
+  - 等待确认：`turn-pending.wav`
+  - 自动重连成功：`turn-retry.wav`
+- **音频格式**：支持 `mp3`、`wav`、`ogg`、`webm`、`m4a`、`aac`、`flac`，单个文件最大 10MB。
+- **完成检测**：根据宿主 `turn/end` 事件的 reason 判断正常完成、中断、出错和超长截断，避免误触发；每轮只播放一次。
 - **触发开关**：
-  - `中断时也响`（默认**关**）：手动停止生成时是否也播放。
-  - `出错时也响`（默认**开**）：对话以错误结束（turn-error / 超长截断）时是否也播放。
-- **确认等待提醒**：对话中出现等待确认 / 提问时播放提示音。
-- **出错自动重连**：对话报错后自动发送「继续」重试（可配置等待秒数）。
-- **版本检查**：设置卡片显示当前版本与更新状态。
-- 音频文件保存在 profile 目录 `.dsh-done-sound/`，经 Host 路由 `/dsh-done-sound/audio/<fileId>` 播放，配置持久化在设置中。
+  - `中断时也响`：手动停止生成时是否播放，默认关闭。
+  - `出错时也响`：对话以错误结束或超长截断时是否播放，默认开启。
+  - `等待确认提醒`：Agent 等待批准、提问或其他人工确认时是否播放，默认开启。
+  - `重连成功也响`：自动发送「继续」成功后是否播放专属音效，默认开启。
+  - `出错自动重连`：出错后是否自动发送「继续」重试，默认开启。
+- **自动重连等待时间**：可设置 10-300 秒，按 5 秒步进；等待期间显示倒计时，若会话自行恢复则自动取消。
+- **全局音量**：统一调节五种场景的播放音量。
+- **版本检查**：设置卡片显示当前版本和更新状态。
+- **日志与导出**：Host 和 Client 诊断日志保存到 profile 目录，可从设置卡片导出当天日志。
 
 ## 安装
 
@@ -28,10 +38,22 @@ dsh plugin --profile web add link:F:\0.AI-CodeProject\DSHProject\0.日常聊天\
 
 安装后重启 `dsh web`，打开设置页即可看到「对话完成音效」卡片。
 
+升级已有安装后，请重启 `dsh web` 使 Host 端更新生效。旧版本中保存的单个自定义音频会自动作为「正常完成」音保留，不会丢失。
+
+## 配置位置
+
+设置 → 对话完成音效中会显示五行独立音频配置。每行都可以选择文件、试听或清除当前自定义音频；清除后会恢复该场景的内置默认音效。
+
+自定义音频文件保存在 profile 目录的 `.dsh-done-sound/` 中，配置保存在 DSH 设置中。Host 音频路由为：
+
+```text
+/dsh-done-sound/audio/<fileId>
+```
+
 ## 架构
 
-- **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` 去重）。
+- **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；`conversation.session.header.utilities` 完成检测器订阅会话状态，按场景选择音效并处理等待确认与自动重连倒计时。
 
 ## 开发
 
@@ -39,9 +61,10 @@ dsh plugin --profile web add link:F:\0.AI-CodeProject\DSHProject\0.日常聊天\
 pnpm install        # 安装 esbuild
 pnpm run build      # 打包 src/index.js -> lib/index.js（自带）
 pnpm run check      # 语法检查两个产物
+npm test            # Host API 与完成检测测试
 ```
 
-修改 host 源码后重新 `pnpm run build`；client 半区直接改 `lib/client.js`（`__ModuleLoader__` 格式即运行时契约，无需打包）。
+修改 Host 源码后重新 `pnpm run build`；Client 半区直接改 `lib/client.js`（`__ModuleLoader__` 格式即运行时契约，无需打包）。
 
 ## 音效库下载
 
@@ -50,7 +73,7 @@ pnpm run check      # 语法检查两个产物
 - 链接：https://pan.baidu.com/s/1xnef4xkCy8pkooXMGi2ApQ?pwd=1234
 - 提取码：1234
 
-下载解压后，在 设置 → 对话完成音效 → 选择音频 中选用即可。
+下载解压后，在 设置 → 对话完成音效 → 对应场景 → 选择音频 中选用即可。
 
 ## License
 

package/lib/client.js

@@ -28,6 +28,7 @@ window.__ModuleLoader__.load({
       '.dtc-row{justify-content:space-between;align-items:center;gap:12px;display:flex}',
       '.dtc-muted{color:var(--dsw-alias-label-secondary);font-size:12px}',
       '.dtc-err{color:var(--dsw-alias-state-error-primary);white-space:pre-wrap;font-size:12px}',
+      '.dtc-ok{color:var(--dsw-alias-state-success-primary);white-space:pre-wrap;font-size:12px;word-break:break-all}',
       '.dtc-btn{border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);cursor:pointer;background:0 0;border-radius:6px;padding:3px 12px;font-size:12px;white-space:nowrap}',
       '.dtc-btn:disabled{opacity:.5;cursor:default}',
       '.dtc-file{display:inline-flex;align-items:center}',
@@ -86,6 +87,19 @@ window.__ModuleLoader__.load({
         retryFailed: '自动发送「继续」失败',
         logPath: '日志文件',
         exportLog: '导出日志',
+        exportSaved: '日志已导出',
+        exportSavedFile: '保存文件名：{name}',
+        exportSavedFallbackHint: '未弹出保存窗口，文件已存到浏览器默认下载文件夹（通常 C:\\Users\\你的用户名\\Downloads）',
+        exportLogPath: '原始日志路径：{path}（复制到资源管理器地址栏可打开）',
+        exportLogPathUnknown: '原始日志路径未知（可在插件目录 logs 文件夹查看）',
+        sceneNormal: '正常完成音',
+        sceneInterrupt: '中断音',
+        sceneError: '出错音',
+        scenePending: '等待确认音',
+        sceneRetry: '自动重连成功音',
+        defaultSound: '（默认音）',
+        retrySound: '重连成功也响',
+        retrySoundHint: '自动发送「继续」成功后播放提示音（默认开启）',
         version: '当前版本',
         updateAvailable: '有新版本',
         upToDate: '已是最新',
@@ -134,6 +148,19 @@ window.__ModuleLoader__.load({
         retryFailed: 'failed to auto-send "continue"',
         logPath: 'Log file',
         exportLog: 'Export log',
+        exportSaved: 'Log exported',
+        exportSavedFile: 'Saved file name: {name}',
+        exportSavedFallbackHint: 'No save dialog shown; saved to the browser default Downloads folder (usually C:\\Users\\YourName\\Downloads)',
+        exportLogPath: 'Original log path: {path} (copy into File Explorer address bar to open)',
+        exportLogPathUnknown: 'Original log path unknown (check the plugin logs folder)',
+        sceneNormal: 'Completion sound',
+        sceneInterrupt: 'Interrupt sound',
+        sceneError: 'Error sound',
+        scenePending: 'Approval-wait sound',
+        sceneRetry: 'Auto-retry success sound',
+        defaultSound: '(default)',
+        retrySound: 'Play on retry success',
+        retrySoundHint: 'Play a sound when "continue" is sent successfully (default on)',
         version: 'Version',
         updateAvailable: 'Update available',
         upToDate: 'Up to date',
@@ -187,6 +214,29 @@ window.__ModuleLoader__.load({
     }
 
     // ---- tiny shared config store (card writes, detector reads) ----
+    const SCENES = ['normal', 'interrupt', 'error', 'pending', 'retry'];
+    const emptySounds = () =>
+      Object.fromEntries(
+        SCENES.map((s) => [s, { fileId: '', fileName: '', mime: '', size: 0, url: null, defaultUrl: null }]),
+      );
+    // Build the per-scene sounds map from a host status payload (reused by
+    // syncConfig and by the detector's fresh-view re-fetches).
+    const syncSoundsFrom = (payload, fallback) => {
+      const out = (fallback && fallback.sounds && typeof fallback.sounds === 'object' ? { ...fallback.sounds } : emptySounds());
+      const rawSounds = payload.sounds && typeof payload.sounds === 'object' ? payload.sounds : {};
+      for (const scene of SCENES) {
+        const s = rawSounds[scene] && typeof rawSounds[scene] === 'object' ? rawSounds[scene] : {};
+        out[scene] = {
+          fileId: typeof s.fileId === 'string' ? s.fileId : '',
+          fileName: typeof s.fileName === 'string' ? s.fileName : '',
+          mime: typeof s.mime === 'string' ? s.mime : '',
+          size: typeof s.size === 'number' ? s.size : 0,
+          url: typeof s.url === 'string' && s.url ? s.url : null,
+          defaultUrl: typeof s.defaultUrl === 'string' && s.defaultUrl ? s.defaultUrl : null,
+        };
+      }
+      return out;
+    };
     const configStore = {
       value: {
         enabled: true,
@@ -194,17 +244,14 @@ window.__ModuleLoader__.load({
         playOnInterrupt: false,
         playOnError: true,
         playOnPending: true,
+        playOnRetry: 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,
+        sounds: emptySounds(),
         loaded: false,
         lastEvent: null,
       },
@@ -259,8 +306,9 @@ window.__ModuleLoader__.load({
       }
     }
 
-    function playChime(cfg) {
-      const url = cfg.url || cfg.defaultUrl;
+    function playChime(cfg, scene) {
+      const s = (cfg.sounds && cfg.sounds[scene]) || {};
+      const url = s.url || s.defaultUrl;
       if (!cfg.enabled || !url) return;
       try {
         const audio = new Audio(url);
@@ -349,6 +397,13 @@ window.__ModuleLoader__.load({
             } catch {
               // ignore
             }
+            // Play the dedicated "auto-retry ok" sound when enabled.
+            try {
+              const view = configStore.value;
+              if (view && view.enabled && view.playOnRetry !== false) playChime(view, 'retry');
+            } catch {
+              // never let a playback error break the retry flow
+            }
             setConfig({
               retryCooldownUntil: null,
               lastEvent: { at: Date.now(), kind: 'error', reason: 'error', play: false, retried: true, retryFailed: false },
@@ -399,30 +454,38 @@ window.__ModuleLoader__.load({
       pluginCtx = ctx;
       const syncConfig = (payload) => {
         if (!payload || typeof payload !== 'object') return;
+        const sounds = syncSoundsFrom(payload, null);
         setConfig({
           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,
+          playOnRetry: payload.playOnRetry !== false,
           autoRetryOnError: payload.autoRetryOnError !== false,
           retryDelaySeconds: typeof payload.retryDelaySeconds === 'number' ? payload.retryDelaySeconds : 60,
           version: typeof payload.version === 'string' ? payload.version : null,
           logPath: typeof payload.logPath === 'string' && payload.logPath ? payload.logPath : null,
           logFileName: typeof payload.logFileName === 'string' && payload.logFileName ? payload.logFileName : 'dsh-done-sound.log',
-          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,
+          sounds,
           loaded: true,
         });
       };
+      // 预热：模块一激活就拉取 Host 持久化配置（如自动重连秒数），
+      // 避免页面刷新后倒计时/自动重连先用初始默认值（60s），
+      // 而设置卡却显示已保存值（20s）——两者必须一致。
+      // 失败静默，卡片挂载和 detector 挂载时还会再次同步兜底。
+      api('/dsh-done-sound/api/status')
+        .then((payload) => {
+          if (payload && typeof payload === 'object') syncConfig(payload);
+        })
+        .catch(() => {});
 
       // ---- Settings card (global slot) ----
       const TurnChimeCard = (props) => {
         const cfg = useConfig();
         const [error, setError] = react.useState(null);
+        const [exportInfo, setExportInfo] = react.useState(null);
         const [busy, setBusy] = react.useState(false);
         const [lang] = react.useState(resolveLang());
         const L = (key) => t(lang, key);
@@ -471,8 +534,20 @@ window.__ModuleLoader__.load({
         );
         // Export today's log file: fetch it from the host, then hand the
         // browser a Blob download — the native save dialog lets the user pick
-        // where to store it (filename is today's dated log name).
+        // where to store it (filename is today's dated log name). After a
+        // successful export, show a green banner with the saved file name and
+        // the original log path so the user can find the file on Windows even
+        // when the browser cannot show a save dialog.
         const exportLog = () => {
+          setExportInfo(null);
+          const showSaved = (savedName, fallbackHint) => {
+            const lines = [L('exportSaved') + ' ✓', L('exportSavedFile').replace('{name}', savedName)];
+            if (fallbackHint) lines.push(L('exportSavedFallbackHint'));
+            // 原始日志路径来自 Host，复制到资源管理器地址栏即可直接打开，
+            // 最方便排查「有概率无音效」类问题。
+            lines.push(cfg.logPath ? L('exportLogPath').replace('{path}', cfg.logPath) : L('exportLogPathUnknown'));
+            setExportInfo(lines.join('\n'));
+          };
           fetch('/dsh-done-sound/api/log/export')
             .then((res) => {
               if (!res.ok) {
@@ -483,15 +558,50 @@ window.__ModuleLoader__.load({
               return res.text();
             })
             .then((text) => {
-              const blob = new Blob([text], { type: 'text/plain;charset=utf-8' });
-              const url = URL.createObjectURL(blob);
-              const a = document.createElement('a');
-              a.href = url;
-              a.download = cfg.logFileName || 'dsh-done-sound.log';
-              document.body.appendChild(a);
-              a.click();
-              a.remove();
-              setTimeout(() => URL.revokeObjectURL(url), 2000);
+              const fileName = cfg.logFileName || 'dsh-done-sound.log';
+              const fallbackDownload = () => {
+                const blob = new Blob([text], { type: 'text/plain;charset=utf-8' });
+                const url = URL.createObjectURL(blob);
+                const a = document.createElement('a');
+                a.href = url;
+                a.download = fileName;
+                document.body.appendChild(a);
+                a.click();
+                a.remove();
+                setTimeout(() => URL.revokeObjectURL(url), 2000);
+                showSaved(fileName, true);
+              };
+              // 优先用浏览器原生「另存为」对话框（File System Access API，
+              // Chrome/Edge 支持），让用户自己选择保存位置；
+              // 不支持或用户取消时回退为普通下载。
+              if (typeof window.showSaveFilePicker === 'function') {
+                window
+                  .showSaveFilePicker({
+                    suggestedName: fileName,
+                    types: [{ description: '日志文件', accept: { 'text/plain': ['.log', '.txt'] } }],
+                  })
+                  .then((handle) => {
+                    const savedName = handle && typeof handle.name === 'string' && handle.name ? handle.name : fileName;
+                    return handle.createWritable().then(async (writable) => {
+                      await writable.write(text);
+                      await writable.close();
+                      showSaved(savedName, false);
+                    });
+                  })
+                  .catch((err) => {
+                    // 用户点了「取消」关闭对话框 → 不算错误，直接结束。
+                    if (err && err.name === 'AbortError') return;
+                    // 其他失败（如手势过期、浏览器限制）→ 回退为普通下载。
+                    try {
+                      if (typeof console !== 'undefined') console.warn('[dsh-done-sound] save picker failed, falling back to download:', err);
+                    } catch {
+                      // ignore
+                    }
+                    fallbackDownload();
+                  });
+                return;
+              }
+              fallbackDownload();
             })
             .catch((err) => {
               try {
@@ -559,7 +669,7 @@ window.__ModuleLoader__.load({
           }
         };
 
-        const onPick = (event) => {
+        const onPick = (event, scene) => {
           const file = event.target.files && event.target.files[0];
           if (event.target) event.target.value = '';
           if (!file) return;
@@ -570,7 +680,7 @@ window.__ModuleLoader__.load({
               setError(L('readFailed'));
               return;
             }
-            await run('/dsh-done-sound/api/audio', { dataUrl, fileName: file.name });
+            await run('/dsh-done-sound/api/audio', { dataUrl, fileName: file.name, scene });
           };
           reader.onerror = () => setError(L('readFailed'));
           reader.readAsDataURL(file);
@@ -601,6 +711,34 @@ window.__ModuleLoader__.load({
           if (volumeTimerRef.current) clearTimeout(volumeTimerRef.current);
         }, []);
 
+        // One audio picker row per trigger scene. Each scene has its own
+        // uploaded file (or falls back to its bundled default sound).
+        const sceneRow = (scene) => {
+          const s = (cfg.sounds && cfg.sounds[scene]) || {};
+          return react.createElement(
+            'div',
+            { className: 'dtc-row' },
+            react.createElement('span', { className: 'dtc-muted' }, L('scene' + scene[0].toUpperCase() + scene.slice(1))),
+            react.createElement('span', { className: 'dtc-muted dtc-logpath' }, s.fileName || L('defaultSound')),
+            react.createElement(
+              'label',
+              { className: 'dtc-btn dtc-file' },
+              react.createElement('input', { type: 'file', accept: 'audio/*', disabled: busy, onChange: (e) => onPick(e, scene) }),
+              L('pick'),
+            ),
+            react.createElement(
+              'button',
+              { className: 'dtc-btn', type: 'button', disabled: busy || !(s.url || s.defaultUrl), onClick: () => playChime(cfg, scene) },
+              L('preview'),
+            ),
+            react.createElement(
+              'button',
+              { className: 'dtc-btn', type: 'button', disabled: busy || !s.fileId, onClick: () => run('/dsh-done-sound/api/clear', { scene }) },
+              L('clear'),
+            ),
+          );
+        };
+
         return react.createElement(
           'div',
           { className: 'dtc-card' },
@@ -658,32 +796,9 @@ window.__ModuleLoader__.load({
               L('exportLog'),
             ),
           ),
+          exportInfo !== null && react.createElement('div', { className: 'dtc-ok' }, exportInfo),
 
-          react.createElement(
-            'div',
-            { className: 'dtc-row' },
-            react.createElement('span', { className: 'dtc-muted' }, L('audio') + '：' + (cfg.fileName || L('none')) + (cfg.size ? ' (' + formatSize(cfg.size) + ')' : '')),
-          ),
-          react.createElement(
-            'div',
-            { className: 'dtc-row' },
-            react.createElement(
-              'label',
-              { className: 'dtc-btn dtc-file' },
-              react.createElement('input', { type: 'file', accept: 'audio/*', disabled: busy, onChange: onPick }),
-              L('pick'),
-            ),
-            react.createElement(
-              'button',
-              { className: 'dtc-btn', type: 'button', disabled: busy || !cfg.url, onClick: () => playChime(cfg) },
-              L('preview'),
-            ),
-            react.createElement(
-              'button',
-              { className: 'dtc-btn', type: 'button', disabled: busy || !cfg.url, onClick: () => run('/dsh-done-sound/api/clear', {}) },
-              L('clear'),
-            ),
-          ),
+          SCENES.map((scene) => sceneRow(scene)),
 
           react.createElement(
             'div',
@@ -755,6 +870,24 @@ window.__ModuleLoader__.load({
             ),
             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.playOnRetry,
+                disabled: busy,
+                onChange: (e) => {
+                  run('/dsh-done-sound/api/config', { playOnRetry: e.target.checked });
+                },
+              }),
+              react.createElement('span', null, L('retrySound')),
+            ),
+            react.createElement('span', { className: 'dtc-muted' }, L('retrySoundHint')),
+          ),
           react.createElement(
             'div',
             { className: 'dtc-row' },
@@ -874,6 +1007,17 @@ window.__ModuleLoader__.load({
         const prevPendingKeysRef = react.useRef('');
         const seededRef = react.useRef(false);
 
+        // 兜底：挂载时若配置尚未从 Host 同步（如页面刚刷新、apply 预热未完成），
+        // 主动拉取一次，确保自动重连倒计时使用用户保存的秒数而非初始默认值。
+        react.useEffect(() => {
+          if (configStore.value.loaded) return;
+          api('/dsh-done-sound/api/status')
+            .then((payload) => {
+              if (payload && typeof payload === 'object') syncConfig(payload);
+            })
+            .catch(() => {});
+        }, []);
+
         const snap =
           typeof useSession === 'function'
             ? useSession((s) => {
@@ -925,10 +1069,13 @@ window.__ModuleLoader__.load({
           // 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 canPlay = (view) => {
+              const s = (view.sounds && view.sounds.pending) || {};
+              return view.enabled && view.playOnPending && (s.url || s.defaultUrl);
+            };
             const record = (value) => setConfig({ lastEvent: { at: Date.now(), kind: 'pending', reason: 'pending', play: value } });
             if (canPlay(cfg)) {
-              playChime(cfg);
+              playChime(cfg, 'pending');
               record(true);
               return;
             }
@@ -940,11 +1087,10 @@ window.__ModuleLoader__.load({
                   ...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,
+                  sounds: syncSoundsFrom(payload, cfg),
                 };
                 if (canPlay(fresh)) {
-                  playChime(fresh);
+                  playChime(fresh, 'pending');
                   record(true);
                 }
               })
@@ -1031,33 +1177,40 @@ if (snap.pendingCount > 0) {
           else kind = 'normal'; // 'completed' (and unknown future reasons default to playing)
 
           // Fire the chime for a given config view; returns whether it played.
-          const effectiveUrlOf = (view) => view.url || view.defaultUrl;
+          // Each trigger kind maps to its own per-scene audio (normal /
+          // interrupt / error); pending and retry scenes are handled by their
+          // own paths (notifyPending / fireModuleRetry success).
           const firePlay = (view) => {
             if (kind === 'interrupt') {
-              if (view.playOnInterrupt && effectiveUrlOf(view)) {
-                playChime(view);
+              if (view.playOnInterrupt) {
+                playChime(view, 'interrupt');
                 return true;
               }
               return false;
             }
             if (kind === 'error') {
-              if (view.playOnError && effectiveUrlOf(view)) {
-                playChime(view);
+              if (view.playOnError) {
+                playChime(view, 'error');
                 return true;
               }
               return false;
             }
-            if (effectiveUrlOf(view)) {
-              playChime(view);
-              return true;
-            }
-            return false;
+            const normalSound = (view) => {
+              const s = (view.sounds && view.sounds.normal) || {};
+              return s.url || s.defaultUrl;
+            };
+            playChime(view, 'normal');
+            return normalSound(view) ? true : false;
           };
 
           let played = firePlay(cfg);
           const record = (value) =>
             setConfig({ lastEvent: { at: Date.now(), kind, reason, play: value } });
-          if (!played && !cfg.url && !cfg.defaultUrl) {
+          const normalSoundMissing = () => {
+            const s = (cfg.sounds && cfg.sounds.normal) || {};
+            return !s.url && !s.defaultUrl;
+          };
+          if (!played && normalSoundMissing()) {
             // 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.
@@ -1072,8 +1225,8 @@ if (snap.pendingCount > 0) {
                     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,
+                    playOnRetry: payload.playOnRetry !== false,
+                    sounds: syncSoundsFrom(payload, cfg),
                   };
                   record(firePlay(fresh));
                 } else {

package/lib/index.js

@@ -5,7 +5,7 @@ import { mkdir, readFile, writeFile, unlink } from "node:fs/promises";
 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
+// node_modules/@deepseek-ai/cosmokit/lib/index.js
 function isNullable(value) {
   return value === null || value === void 0;
 }
@@ -191,7 +191,7 @@ var Time;
   Time2.template = template;
 })(Time || (Time = {}));
 
-// C:/Users/Administrator/.dsh/profiles/web/node_modules/@deepseek-ai/schemastery/lib/index.mjs
+// node_modules/@deepseek-ai/schemastery/lib/index.mjs
 var kSchema = Symbol.for("schemastery");
 var kValidationError = Symbol.for("ValidationError");
 globalThis.__schemastery_index__ ??= 0;
@@ -830,8 +830,21 @@ function writeLog(level, message) {
   }
 }
 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 SCENES = ["normal", "interrupt", "error", "pending", "retry"];
+var DEFAULT_AUDIO_FILES = {
+  normal: "turn-done.wav",
+  interrupt: "turn-interrupt.wav",
+  error: "turn-error.wav",
+  pending: "turn-pending.wav",
+  retry: "turn-retry.wav"
+};
+var DEFAULT_AUDIO_PATHS = Object.fromEntries(
+  Object.entries(DEFAULT_AUDIO_FILES).map(([scene, file]) => [
+    scene,
+    join(dirname(fileURLToPath(import.meta.url)), "..", "assets", file)
+  ])
+);
+var DEFAULT_AUDIO_URLS = Object.fromEntries(SCENES.map((s) => [s, `/dsh-done-sound/audio/default-${s}`]));
 var DEFAULT_AUDIO_MIME = "audio/wav";
 var AUDIO_MIMES = {
   "audio/mpeg": "mp3",
@@ -848,14 +861,32 @@ var AUDIO_MIMES = {
   "audio/flac": "flac",
   "audio/x-flac": "flac"
 };
+var SoundMetaSchema = Schema.object({
+  fileId: Schema.string().default(""),
+  fileName: Schema.string().default(""),
+  mime: Schema.string().default(""),
+  size: Schema.number().default(0)
+}).default({});
 var TurnChimeSchema = Schema.object({
   enabled: Schema.boolean().default(true),
   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),
+  playOnRetry: Schema.boolean().default(true),
   autoRetryOnError: Schema.boolean().default(true),
   retryDelaySeconds: Schema.number().min(10).max(300).step(5).default(60),
+  // One independently configurable audio per trigger scene.
+  sounds: Schema.object({
+    normal: SoundMetaSchema,
+    interrupt: SoundMetaSchema,
+    error: SoundMetaSchema,
+    pending: SoundMetaSchema,
+    retry: SoundMetaSchema
+  }).default({}),
+  // Legacy single-audio field (pre-0.1.9). Kept for migration: when
+  // `sounds.normal` is empty, the old `audio` value is used for the normal
+  // scene until the user picks a new one.
   audio: Schema.object({
     fileId: Schema.string().default(""),
     fileName: Schema.string().default(""),
@@ -871,9 +902,30 @@ function apply(ctx) {
   const dataDir = join(profileDir, ".dsh-done-sound");
   const scope = ctx.settings.register(NS, TurnChimeSchema, { base: {} });
   const audioPath = (fileId) => join(dataDir, `${fileId}.bin`);
+  const isScene = (s) => typeof s === "string" && SCENES.includes(s);
+  const sceneAudio = (value, scene) => {
+    const s = value.sounds?.[scene];
+    if (s && typeof s.fileId === "string" && s.fileId) return s;
+    if (scene === "normal" && value.audio && typeof value.audio.fileId === "string" && value.audio.fileId) {
+      return value.audio;
+    }
+    return { fileId: "", fileName: "", mime: "", size: 0 };
+  };
   const statusPayload = () => {
     const value = scope.get();
-    const fileId = value.audio?.fileId ?? "";
+    const sounds = {};
+    for (const scene of SCENES) {
+      const meta = sceneAudio(value, scene);
+      const fileId = meta.fileId ?? "";
+      sounds[scene] = {
+        fileId,
+        fileName: meta.fileName ?? "",
+        mime: meta.mime ?? "",
+        size: meta.size ?? 0,
+        url: fileId ? `${ROUTE_PREFIX}/audio/${fileId}` : null,
+        defaultUrl: DEFAULT_AUDIO_URLS[scene]
+      };
+    }
     return {
       ok: true,
       version: pluginVersion(),
@@ -882,33 +934,31 @@ function apply(ctx) {
       playOnInterrupt: value.playOnInterrupt,
       playOnError: value.playOnError,
       playOnPending: value.playOnPending,
+      playOnRetry: value.playOnRetry,
       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,
-      defaultUrl: DEFAULT_AUDIO_URL,
+      sounds,
       logPath: datedLogPath(),
       logFileName: datedLogFileName()
     };
   };
-  const clearAudio = async () => {
+  const clearAudio = async (scene) => {
     const value = scope.get();
-    const fileId = value.audio?.fileId;
+    const target = isScene(scene) ? scene : "normal";
+    const meta = sceneAudio(value, target);
+    const fileId = meta.fileId;
     if (fileId) {
       try {
         await unlink(audioPath(fileId));
       } catch {
       }
     }
-    await scope.update({ audio: { fileId: "", fileName: "", mime: "", size: 0 } });
-    writeLog("INFO", "audio cleared");
+    const patch = { sounds: { ...value.sounds ?? {}, [target]: { fileId: "", fileName: "", mime: "", size: 0 } } };
+    if (target === "normal") patch.audio = { fileId: "", fileName: "", mime: "", size: 0 };
+    await scope.update(patch);
+    writeLog("INFO", `audio cleared (${target})`);
   };
-  const setAudio = async (dataUrl, fileName) => {
+  const setAudio = async (dataUrl, fileName, scene) => {
     const match = /^data:([^;,]+);base64,([A-Za-z0-9+/=]+)$/.exec(dataUrl);
     if (!match) throw new Error("invalid audio data (need data:<mime>;base64,<data>)");
     const mime = match[1].toLowerCase();
@@ -917,20 +967,23 @@ function apply(ctx) {
     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 10MB (got ${buffer.length} bytes)`);
+    const target = isScene(scene) ? scene : "normal";
     const fileId = randomUUID();
     await mkdir(dataDir, { recursive: true });
     await writeFile(audioPath(fileId), buffer);
-    const previous = scope.get().audio?.fileId;
-    await scope.update({
-      audio: { fileId, fileName: fileName || "chime", mime, size: buffer.length }
-    });
+    const previous = sceneAudio(scope.get(), target).fileId;
+    const patch = {
+      sounds: { ...scope.get().sounds ?? {}, [target]: { fileId, fileName: fileName || "chime", mime, size: buffer.length } }
+    };
+    if (target === "normal") patch.audio = { fileId, fileName: fileName || "chime", mime, size: buffer.length };
+    await scope.update(patch);
     if (previous && previous !== fileId) {
       try {
         await unlink(audioPath(previous));
       } catch {
       }
     }
-    writeLog("INFO", `audio stored: ${fileName || "chime"} (${buffer.length} bytes, ${mime})`);
+    writeLog("INFO", `audio stored (${target}): ${fileName || "chime"} (${buffer.length} bytes, ${mime})`);
     return fileId;
   };
   ctx.commands.register({
@@ -1022,9 +1075,11 @@ function apply(ctx) {
       pathname = "/";
     }
     const method = (req.method ?? "GET").toUpperCase();
-    if (pathname === DEFAULT_AUDIO_URL) {
+    const defaultMatch = /^\/dsh-done-sound\/audio\/default-([A-Za-z0-9-]+)$/.exec(pathname);
+    if (defaultMatch && SCENES.includes(defaultMatch[1])) {
+      const scene = defaultMatch[1];
       try {
-        const buffer = await readFile(DEFAULT_AUDIO_PATH);
+        const buffer = await readFile(DEFAULT_AUDIO_PATHS[scene]);
         res.writeHead(200, {
           "Content-Type": DEFAULT_AUDIO_MIME,
           "Content-Length": buffer.length,
@@ -1041,8 +1096,9 @@ function apply(ctx) {
     const audioMatch = /^\/dsh-done-sound\/audio\/([A-Za-z0-9-]+)$/.exec(pathname);
     if (audioMatch) {
       const fileId = audioMatch[1];
-      const audio = scope.get().audio;
-      if (!FILE_ID_RE.test(fileId) || !audio || audio.fileId !== fileId) {
+      const value = scope.get();
+      const meta = SCENES.map((s) => sceneAudio(value, s)).find((m) => m.fileId === fileId);
+      if (!FILE_ID_RE.test(fileId) || !meta) {
         res.writeHead(404);
         res.end("not found");
         return;
@@ -1050,7 +1106,7 @@ function apply(ctx) {
       try {
         const buffer = await readFile(audioPath(fileId));
         res.writeHead(200, {
-          "Content-Type": audio.mime || "application/octet-stream",
+          "Content-Type": meta.mime || "application/octet-stream",
           "Content-Length": buffer.length,
           "Cache-Control": "no-cache",
           "X-Content-Type-Options": "nosniff"
@@ -1075,6 +1131,7 @@ function apply(ctx) {
         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.playOnRetry === "boolean") patch.playOnRetry = body.playOnRetry;
         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;
@@ -1085,12 +1142,15 @@ function apply(ctx) {
       }
       if (pathname === "/dsh-done-sound/api/audio" && method === "POST") {
         const body = await readJsonBody(req);
-        await setAudio(typeof body.dataUrl === "string" ? body.dataUrl : "", typeof body.fileName === "string" ? body.fileName : "");
+        const scene = typeof body.scene === "string" && SCENES.includes(body.scene) ? body.scene : "normal";
+        await setAudio(typeof body.dataUrl === "string" ? body.dataUrl : "", typeof body.fileName === "string" ? body.fileName : "", scene);
         sendJson(res, 200, statusPayload());
         return;
       }
       if (pathname === "/dsh-done-sound/api/clear" && method === "POST") {
-        await clearAudio();
+        const body = await readJsonBody(req);
+        const scene = typeof body.scene === "string" && SCENES.includes(body.scene) ? body.scene : "normal";
+        await clearAudio(scene);
         sendJson(res, 200, statusPayload());
         return;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-done-sound",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Play a user-chosen sound whenever a conversation finishes in the DeepSeek Harness web GUI",
   "license": "MIT",
   "type": "module",