dsh-notify-say 0.4.20 → 0.4.24

package/README.md

@@ -26,7 +26,7 @@
 
 | 特性 | 说明 |
 |---|---|
-| **语音播报** | 本地 wav，不联网、不调用云端 TTS。可选 16 个 VOICEVOX 音色 |
+| **语音播报** | 本地 wav，不联网、不调用云端 TTS。发布版附 1 个音色，其余可按需下载 |
 | **空闲门** | 有在飞工作时不误报"完成"，全部结束才播一次 |
 | **五类事件** | 完成 / 出错 / 被拦截 / 待批准 / 要提问，各自独立开关 |
 | **设置页 GUI** | 走官方 `Config` schema，DSH 设置页自动生成表单 |
@@ -101,7 +101,8 @@ cd <插件目录>\tools
 
 ### 语音包管理
 
-核心包只带**一个日语音色**。完整 16 音色包约 48 MB，故不随包发布。
+核心包只带**一个日语音色**（ずんだもん），体积约 2.8 MB。
+完整多音色包体积较大（十余个音色约 40 MB），故不随包发布 —— 计划通过单独下载提供（尚未实现）。
 
 ```powershell
 .\notify-config.ps1 -ListPacks         # 看已装哪些音色、各占多少
@@ -173,4 +174,6 @@ npm run test:route    # 需要 --import loader 的 6 条接线测试
 
 ## 许可
 
-MIT。语音文件由本地 VOICEVOX 合成，各音色有其自身使用条款，详见 `LICENSE` 末尾的第三方声明。
+代码以 MIT 发布。
+**语音文件不适用 MIT**，由 VOICEVOX 生成，各音色有其自身使用条款，
+详见 [`THIRD-PARTY-NOTICES.md`](THIRD-PARTY-NOTICES.md)。

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,99 @@
+# 第三方素材与致谢
+
+本项目**没有运行时依赖**（`package.json` 中 `dependencies` 为空，不含 `node_modules`）。
+但随包分发的语音与音效素材来自以下项目，特此说明并致谢。
+
+---
+
+## 一、语音合成 — VOICEVOX
+
+`sounds/voice-lines/` 下的全部 WAV 语音，以及 `sounds/master-voice.wav`，
+均由 **VOICEVOX** 在本地合成。
+
+- 项目主页：<https://voicevox.hiroshiba.jp/>
+- 引擎仓库：<https://github.com/VOICEVOX/voicevox_engine>
+- 本插件**不包含** VOICEVOX 引擎本身，只包含用它输出的音频文件
+
+### 音色署名
+
+核心包（`sounds/voice-lines/`）附带的音色为 **ずんだもん**（Zundamon）：
+
+> VOICEVOX:ずんだもん
+
+### 使用条款要点
+
+VOICEVOX 软件本体免费（含商用）。用它合成的音频可以自由使用、发布、商用，
+但**每个角色音色有各自的利用规约**，需遵守对应条款。主要包括：
+
+- 建议标注音色来源（本项目已在 README 与本文件中标注）
+- 不得用于诽谤中伤、政治宣传、宗教活动等用途
+- 各音色的具体条款以其官方发布为准
+
+完整音色列表与各自条款：<https://voicevox.hiroshiba.jp/>
+
+> **如果你要再分发本项目的语音文件**（例如打包自己的语音包），
+> 请自行确认所涉音色的最新利用规约。本项目的 `LICENSE`（MIT）
+> **不覆盖**这些音频素材。
+
+---
+
+## 二、音效素材 — 已全部移除（原 Mixkit）
+
+**2026-10-18：移除了此前随包分发的 10 个 Mixkit mp3 音效。**
+
+### 移除原因
+
+[Mixkit Sound Effects Free License](https://mixkit.co/license/modal/sfxFree/) 明确禁止：
+
+> You can't **redistribute the Item on its own, as stock, in a tool or
+> template, or with source files**.
+
+本插件通过 npm / GitHub 公开分发包含这些 mp3 的安装包，属于该条款禁止的
+「再分发素材本身 / 随源文件分发」情形。
+
+### 影响
+
+这些文件是**兜底池**成员：正常流程走「语音包 → master-voice.wav → mp3 池」，
+前两者都存在，所以移除**对实际体验没有影响**。
+
+### 如果你想要音效
+
+`sounds/` 目录支持直接放入 `.mp3` / `.wav`，插件会自动作为兜底音效使用。
+请自行确保所用素材的许可允许你的使用方式。
+
+---
+
+## 二之二、未随包分发的音色（合规说明）
+
+以下音色的 WAV 由开发者本地生成，但**不进入发布包**：
+
+| 音色 | 原因 |
+|---|---|
+| **もち子さん**（mochiko） | [官方利用规约](https://vtubermochio.wixsite.com/mochizora/)明确禁止
+  「無償配布、有償販売」利用其输出合成音频制作的音声素材。本插件免费分发，正落在该禁令内。 |
+| 个人声音样本 | 作者本人的声音，仅本地使用，不对外分发。 |
+
+其余音色的发布状态见仓库 `docs/语音包分发方案-待审阅.md`。
+
+## 三、代码参考
+
+本项目的热重载机制（`lib/dev-reload.js`）参考了本机另一插件的实现思路。
+那是作者本人的代码，不属于第三方；相关差异与取舍已在模块头注释中说明。
+
+其余代码为原创。
+
+---
+
+## 四、运行环境
+
+本项目运行在 **DeepSeek Harness (DSH) Desktop** 之上，依赖其插件 API。
+DSH 本身的许可与本项目无关，请参见其官方发布。
+
+---
+
+## 致谢
+
+感谢 **VOICEVOX** 项目与各音色作者，让本地、免费、离线的人声合成成为可能；
+感谢 **Mixkit** 提供可自由使用的音效素材。
+
+没有这些开源与免费资源，这个插件只能发出单调的系统提示音。

package/lib/client.js

@@ -58,7 +58,21 @@ window.__ModuleLoader__.load({
       }
     }
 
-    /** 取「最近一条通知对应的会话」；消费即清，避免重复跳转。 */
+    /**
+     * 取「最近一条通知对应的会话」；消费即清，避免重复跳转。
+     *
+     * ⚠️ 返回的是**对象** `{ sessionId, at }`，不是裸字符串。
+     *
+     * 2026-10-18 外部审阅发现一个 P0 bug：这里原本 `return doc.sessionId`
+     * （字符串），但调用方写的是 `if (!doc || !doc.sessionId) return`。
+     * 字符串没有 `.sessionId` 属性 → 恒为 undefined → **直接 return**。
+     * 结果是会话跳转功能**从未生效过**，而且服务端信号已被 consume 清除，
+     * 连重试的机会都没有。
+     *
+     * 教训：这类"返回类型与调用方期望不符"的 bug，静态审阅一眼可见，
+     * 但没有任何单元测试覆盖到（因为两端各自都"看起来对"）。
+     * 已加 C27 测试锁住返回形状。
+     */
     function consumeLastSession() {
       return fetch(apiUrl('consume'), { cache: 'no-store', credentials: 'same-origin' })
         .then(function (res) {
@@ -68,7 +82,10 @@ window.__ModuleLoader__.load({
         })
         .then(function (doc) {
           if (!doc || typeof doc.sessionId !== 'string' || !doc.sessionId) return null
-          return doc.sessionId
+          return {
+            sessionId: doc.sessionId,
+            at: Number(doc.at) || 0,
+          }
         })
         .catch(function () { return null })
     }
@@ -270,10 +287,20 @@ window.__ModuleLoader__.load({
     }
 
     /** 音色候选（与 sounds/voice-lines 下的基础音色一致；可手输其他 key）。 */
+    // 可下载/可选的音色清单（**只列审核通过的**）。
+    //
+    // ⚠️ 2026-10-18：移除 kasukabe-tsumugi 与 mochiko ——
+    //   · 春日部つむぎ：官方规约第 6 条禁止「二次配布」
+    //   · もち子さん：官方规约禁止「音声素材を無償配布」
+    // 审核结论见 docs/audio-audit/README.md。
+    //
+    // 注意：这个列表只影响 GUI 下拉里的候选项。真正的分发拦截在
+    // release-build.ps1 的 $NeverShipVoicePrefixes（构建期硬阻断），
+    // 两处都要维护，但**构建期那道是安全网**。
     var VOICE_KEYS = [
       'zundamon-normal', 'zundamon-amama', 'ankomon', 'goki-nuigurumi',
-      'kasukabe-tsumugi', 'kyushu-sora', 'manbetsu-hanamaru-genki',
-      'meimei-meria', 'mochiko', 'shikoku-metang', 'ameharu-hau',
+      'kyushu-sora', 'manbetsu-hanamaru-genki', 'meimei-meria',
+      'shikoku-metang', 'ameharu-hau', 'namiine-ritsu', 'shirakami-kotaro',
     ]
 
     /** 事件开关定义（键 → 中文名）。 */
@@ -1409,10 +1436,16 @@ window.__ModuleLoader__.load({
        */
       function jumpEnabled() {
         return loadConfig().then(function (v) {
-          var cfg = v || {}
+          // ⚠️ 2026-10-18 外部审阅指出逻辑矛盾：loadConfig 失败返回 {}，
+          // 而 {}.jumpWhenBackground !== false 求值为 true —— 与"拿不到就不跳"正好相反。
+          // 现在显式区分"读到了"与"没读到"。
+          if (!v || typeof v !== "object" || Object.keys(v).length === 0) {
+            return { jumpWhenBackground: false, jumpWhenForeground: false }
+          }
           return {
-            jumpWhenBackground: cfg.jumpWhenBackground !== false,
-            jumpWhenForeground: cfg.jumpWhenForeground === true,
+            // 只有明确读到 true 才跳；缺失或 null 都不跳
+            jumpWhenBackground: v.jumpWhenBackground === true,
+            jumpWhenForeground: v.jumpWhenForeground === true,
           }
         }).catch(function () {
           return { jumpWhenBackground: false, jumpWhenForeground: false }