dsh-done-sound 0.1.4 → 0.1.5

package/README.md

@@ -1,38 +1,57 @@
 # dsh-done-sound
 
-DeepSeek Harness Web GUI 鐨勩€屽璇濆畬鎴愰煶鏁堛€嶆彃浠讹細浣犲湪璁剧疆閲岄€変竴娈甸煶棰戯紝姣忔 Agent 瀹屾暣缁撴潫涓€杞璇濇椂鑷姩鎾斁鎻愮ず闊炽€?
-## 鍔熻兘
+DeepSeek Harness Web GUI 的「对话完成音效」插件：你在设置里选一段音频，每次 Agent 完整结束一轮对话时自动播放提示音。
 
-- **璁剧疆鍗＄墖**锛堣缃?鈫?瀵硅瘽瀹屾垚闊虫晥锛夛細閫夋嫨闊抽鏂囦欢锛坢p3 / wav / ogg / webm / m4a / aac / flac锛屸墹2MB锛夈€佽瘯鍚€佹竻闄ゃ€侀煶閲忚皟鑺傘€?- **瀹屾垚妫€娴?*锛氫互瀹夸富 `turn/end` 浜嬩欢鐨?reason锛堟甯?涓柇/鍑洪敊/瓒呴暱锛変负鏉冨▉瑙﹀彂淇″彿锛屽揩鎱㈠璇濋兘涓嶆紡銆佷笉璇垽锛涙瘡杞彧鍝嶄竴娆°€?- **瑙﹀彂寮€鍏?*锛?  - `涓柇鏃朵篃鍝峘锛堥粯璁?*鍏?*锛夛細鎵嬪姩鍋滄鐢熸垚鏃舵槸鍚︿篃鎾斁銆?  - `鍑洪敊鏃朵篃鍝峘锛堥粯璁?*寮€**锛夛細瀵硅瘽浠ラ敊璇粨鏉燂紙turn-error / 瓒呴暱鎴柇锛夋椂鏄惁涔熸挱鏀俱€?- 闊抽鏂囦欢淇濆瓨鍦?profile 鐩綍 `.dsh-done-sound/`锛岀粡 Host 璺敱 `/dsh-done-sound/audio/<fileId>` 鎾斁锛岄厤缃寔涔呭寲鍦ㄨ缃腑銆?
-## 瀹夎
+## 功能
+
+- **设置卡片**（设置 → 对话完成音效）：选择音频文件（mp3 / 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`锛屾墦寮€璁剧疆椤靛嵆鍙湅鍒般€屽璇濆畬鎴愰煶鏁堛€嶅崱鐗囥€?
-## 鏋舵瀯
+安装后重启 `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` 去重）。
+
+## 开发
 
-- **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      # 璇硶妫€鏌ヤ袱涓骇鐗?```
+pnpm install        # 安装 esbuild
+pnpm run build      # 打包 src/index.js -> lib/index.js（自带）
+pnpm run check      # 语法检查两个产物
+```
+
+修改 host 源码后重新 `pnpm run build`；client 半区直接改 `lib/client.js`（`__ModuleLoader__` 格式即运行时契约，无需打包）。
+
+## 音效库下载
+
+内置提示音不够用？社区精选音色库（百度网盘，永久有效）：
 
-淇敼 host 婧愮爜鍚庨噸鏂?`pnpm run build`锛沜lient 鍗婂尯鐩存帴鏀?`lib/client.js`锛坄__ModuleLoader__` 鏍煎紡鍗宠繍琛屾椂濂戠害锛屾棤闇€鎵撳寘锛夈€?
-## 闊虫晥搴撲笅杞?
-鍐呯疆鎻愮ず闊充笉澶熺敤锛熺ぞ鍖虹簿閫夐煶鑹插簱锛堢櫨搴︾綉鐩橈紝姘镐箙鏈夋晥锛夛細
+- 链接：https://pan.baidu.com/s/1xnef4xkCy8pkooXMGi2ApQ?pwd=1234
+- 提取码：1234
 
-- 閾炬帴锛歨ttps://pan.baidu.com/s/1xnef4xkCy8pkooXMGi2ApQ?pwd=1234
-- 鎻愬彇鐮侊細1234
+下载解压后，在 设置 → 对话完成音效 → 选择音频 中选用即可。
 
-涓嬭浇瑙ｅ帇鍚庯紝鍦?璁剧疆 鈫?瀵硅瘽瀹屾垚闊虫晥 鈫?閫夋嫨闊抽 涓€夌敤鍗冲彲銆?
 ## License
 
 MIT

package/lib/client.js

@@ -44,6 +44,7 @@ window.__ModuleLoader__.load({
       '.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}',
+      '.dtc-logpath{word-break:break-all;text-align:right;max-width:70%;line-height:1.4}',
     ].join('');
     if (typeof document !== 'undefined' && document.querySelector('style[data-plugin-css=' + JSON.stringify(CSS_ID) + ']') === null) {
       const tag = document.createElement('style');
@@ -83,6 +84,7 @@ window.__ModuleLoader__.load({
         retryArmed: '等待 {s} 秒后自动发送「继续」',
         retrySent: '已自动发送「继续」',
         retryFailed: '自动发送「继续」失败',
+        logPath: '日志文件',
         version: '当前版本',
         updateAvailable: '有新版本',
         upToDate: '已是最新',
@@ -129,6 +131,7 @@ window.__ModuleLoader__.load({
         retryArmed: 'will auto-send "continue" in {s}s',
         retrySent: 'auto-sent "continue"',
         retryFailed: 'failed to auto-send "continue"',
+        logPath: 'Log file',
         version: 'Version',
         updateAvailable: 'Update available',
         upToDate: 'Up to date',
@@ -224,6 +227,36 @@ window.__ModuleLoader__.load({
       react.useEffect(() => subscribeConfig(setCfg), []);
       return cfg;
     }
+    // ---- browser -> host log reporting ----
+    // Mirrors console output into the host's daily log file
+    // (<pluginRoot>/logs/<YYYYMMDD>/dsh-done-sound.log) so issues survive a
+    // closed DevTools. Must never call console itself (avoids recursion) and
+    // must never break the plugin when the report fails.
+    function reportLog(level, args) {
+      try {
+        const parts = [];
+        for (let i = 0; i < args.length; i++) {
+          const a = args[i];
+          try {
+            if (typeof a === 'string') parts.push(a);
+            else if (a instanceof Error) parts.push(a.stack || 'Error: ' + (a.message || String(a)));
+            else parts.push(JSON.stringify(a));
+          } catch {
+            parts.push(String(a));
+          }
+        }
+        const message = parts.join(' ');
+        if (!message) return;
+        fetch('/dsh-done-sound/api/log', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ level: level, source: 'client', message: message }),
+        }).catch(() => {});
+      } catch {
+        // reporting must never break the plugin
+      }
+    }
+
     function playChime(cfg) {
       const url = cfg.url || cfg.defaultUrl;
       if (!cfg.enabled || !url) return;
@@ -235,6 +268,7 @@ window.__ModuleLoader__.load({
           p.catch((err) => {
             try {
               console.warn('[dsh-done-sound] audio play failed (browser blocked it?):', err && err.message ? err.message : err);
+              reportLog('warn', ['audio play failed (browser blocked it?):', err && err.message ? err.message : err]);
             } catch {
               // ignore
             }
@@ -243,6 +277,7 @@ window.__ModuleLoader__.load({
       } catch (err) {
         try {
           console.warn('[dsh-done-sound] audio play failed:', err && err.message ? err.message : err);
+          reportLog('warn', ['audio play failed:', err && err.message ? err.message : err]);
         } catch {
           // ignore playback failures (autoplay policy, missing audio device)
         }
@@ -283,6 +318,7 @@ window.__ModuleLoader__.load({
       const fail = (why) => {
         try {
           console.error('[dsh-done-sound] auto-retry could not send "继续":', why);
+          reportLog('error', ['auto-retry could not send "继续":', why]);
         } catch {
           // console may be gone during teardown
         }
@@ -307,6 +343,7 @@ window.__ModuleLoader__.load({
           if (result && result.ok) {
             try {
               console.log('[dsh-done-sound] auto-retry sent "继续" to session', sid);
+              reportLog('info', ['auto-retry sent "继续" to session', sid]);
             } catch {
               // ignore
             }
@@ -369,6 +406,7 @@ window.__ModuleLoader__.load({
           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,
           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 : '',
@@ -568,6 +606,15 @@ window.__ModuleLoader__.load({
                   : null,
           ),
 
+          cfg.logPath
+            ? react.createElement(
+                'div',
+                { className: 'dtc-row' },
+                react.createElement('span', { className: 'dtc-muted' }, L('logPath') + '：'),
+                react.createElement('span', { className: 'dtc-muted dtc-logpath' }, cfg.logPath),
+              )
+            : null,
+
           react.createElement(
             'div',
             { className: 'dtc-row' },

package/lib/index.js

@@ -1,6 +1,6 @@
 // src/index.js
 import { fileURLToPath } from "node:url";
-import { readFileSync } from "node:fs";
+import { readFileSync, mkdirSync, appendFileSync } from "node:fs";
 import { mkdir, readFile, writeFile, unlink } from "node:fs/promises";
 import { join, dirname } from "node:path";
 import { randomUUID } from "node:crypto";
@@ -808,6 +808,24 @@ function pluginVersion() {
   }
   return cachedPluginVersion;
 }
+var LOGS_ROOT = join(dirname(fileURLToPath(import.meta.url)), "..", "logs");
+function datedLogPath(now = /* @__PURE__ */ new Date()) {
+  const y = now.getFullYear();
+  const m = String(now.getMonth() + 1).padStart(2, "0");
+  const d = String(now.getDate()).padStart(2, "0");
+  return join(LOGS_ROOT, `${y}${m}${d}`, "dsh-done-sound.log");
+}
+function writeLog(level, message) {
+  try {
+    const now = /* @__PURE__ */ new Date();
+    const stamp = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")} ${String(now.getHours()).padStart(2, "0")}:${String(now.getMinutes()).padStart(2, "0")}:${String(now.getSeconds()).padStart(2, "0")}`;
+    const file = datedLogPath(now);
+    mkdirSync(dirname(file), { recursive: true });
+    appendFileSync(file, `[${stamp}] [${level}] ${message}
+`, "utf8");
+  } catch {
+  }
+}
 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";
@@ -870,7 +888,8 @@ function apply(ctx) {
         size: value.audio?.size ?? 0
       },
       url: fileId ? `${ROUTE_PREFIX}/audio/${fileId}` : null,
-      defaultUrl: DEFAULT_AUDIO_URL
+      defaultUrl: DEFAULT_AUDIO_URL,
+      logPath: datedLogPath()
     };
   };
   const clearAudio = async () => {
@@ -883,6 +902,7 @@ function apply(ctx) {
       }
     }
     await scope.update({ audio: { fileId: "", fileName: "", mime: "", size: 0 } });
+    writeLog("INFO", "audio cleared");
   };
   const setAudio = async (dataUrl, fileName) => {
     const match = /^data:([^;,]+);base64,([A-Za-z0-9+/=]+)$/.exec(dataUrl);
@@ -906,6 +926,7 @@ function apply(ctx) {
       } catch {
       }
     }
+    writeLog("INFO", `audio stored: ${fileName || "chime"} (${buffer.length} bytes, ${mime})`);
     return fileId;
   };
   ctx.commands.register({
@@ -962,6 +983,7 @@ function apply(ctx) {
             return { kind: "error", text: `\u672A\u77E5\u64CD\u4F5C\uFF1A${action}` };
         }
       } catch (error) {
+        writeLog("ERROR", `command failed: ${error instanceof Error ? error.message : String(error)}`);
         return { kind: "error", text: error instanceof Error ? error.message : String(error) };
       }
     }
@@ -1068,7 +1090,22 @@ function apply(ctx) {
         sendJson(res, 200, statusPayload());
         return;
       }
+      if (pathname === "/dsh-done-sound/api/log" && method === "POST") {
+        const body = await readJsonBody(req);
+        const message = typeof body.message === "string" ? body.message : "";
+        if (message) {
+          const level = typeof body.level === "string" && /^[A-Za-z]+$/.test(body.level) ? body.level.toUpperCase() : "INFO";
+          writeLog(body.source === "client" ? `CLIENT-${level}` : level, message.slice(0, 4e3));
+        }
+        sendJson(res, 200, { ok: true });
+        return;
+      }
+      if (pathname === "/dsh-done-sound/api/log" && method === "GET") {
+        sendJson(res, 200, { ok: true, logPath: datedLogPath() });
+        return;
+      }
     } catch (error) {
+      writeLog("ERROR", `api ${method} ${pathname} failed: ${error instanceof Error ? error.message : String(error)}`);
       sendJson(res, 400, { ok: false, error: error instanceof Error ? error.message : String(error) });
       return;
     }

package/package.json

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