dsh-notify-say 0.4.54 → 0.4.56

package/README.md

@@ -330,7 +330,7 @@ npm run test:route    # 需要 --import loader 的接线测试
 npm run test:audio-wire
 ```
 
-**410 条测试通过。** 绝大多数是纯逻辑测试，克隆仓库后 `npm test` 即可跑。
+**418 条测试通过。** 绝大多数是纯逻辑测试，克隆仓库后 `npm test` 即可跑。
 
 少数用例需要真实的 DSH 宿主（用于验证 Cordis 上下文行为）。
 找不到宿主时它们会**自动 skip** —— 注意 skip 不等于通过。

package/lib/client.js

@@ -194,7 +194,8 @@ window.__ModuleLoader__.load({
       ok: { color: '#1e8449', fontSize: '12px', marginTop: '6px' },
       foot: { opacity: 0.65, marginTop: '12px', fontSize: '12.5px', lineHeight: '1.6' },
       // 事件开关：勾选框 + 可换行的说明文字
-      toggleRow: { display: 'flex', alignItems: 'flex-start', gap: '8px', margin: '8px 0' },
+      // 行间距略放大（v0.4.56）：420px 下说明文字密集，靠间距而不是缩字号。
+      toggleRow: { display: 'flex', alignItems: 'flex-start', gap: '8px', margin: '10px 0' },
       toggleBox: { marginTop: '3px', flex: '0 0 auto' },
       toggleText: { flex: '1', lineHeight: '1.5' },
       toggleLabel: { fontWeight: 500 },
@@ -266,6 +267,56 @@ window.__ModuleLoader__.load({
         opacity: 0.78, fontSize: '12.5px',
       },
 
+      // ── 试听按钮组（v0.4.55）────────────────────────────────────────
+      //
+      // 用户反馈：420px 下五个按钮挤成 4+1，最后一个「拦截」孤零零一行。
+      //
+      // 改法：整组**独占一行**（flex-basis 100%），用 grid 自动定列数。
+      //   · 420px：内容宽约 364 → 排得下 5 列（每列约 63px）→ 一行五个
+      //   · 更窄时自动降列 → 自然换行，行距列距一致（都是 6px）
+      //   · maxWidth 340：720px 下不让按钮被拉成大块头
+      //
+      // 不缩小按钮：minmax 下限 56px 比原来的约 51px 还宽一点。
+      pvGroup: {
+        display: 'grid',
+        gridTemplateColumns: 'repeat(auto-fit, minmax(56px, 1fr))',
+        gap: '6px',
+        flex: '1 1 100%',
+        maxWidth: '340px',
+        marginTop: '2px',
+      },
+
+      // ── 中性提示框（v0.4.55）────────────────────────────────────────
+      //
+      // 用于「不是错误、但用户应当知道」的状态（如弹窗与声音都关掉）。
+      // 刻意**不用红/黄**：这不是故障，是用户自己的选择，只需告知结果。
+      noticeBox: {
+        margin: '8px 0 2px',
+        padding: '8px 10px',
+        borderLeft: '3px solid rgba(128,128,128,.5)',
+        background: 'rgba(128,128,128,.08)',
+        fontSize: '12.5px',
+        lineHeight: '1.6',
+        opacity: 0.92,
+      },
+
+      // 可点击的折叠标题（v0.4.55）：整行可点，箭头固定在最右。
+      foldHead: {
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'space-between',
+        gap: '8px',
+        cursor: 'pointer',
+        userSelect: 'none',
+        margin: '16px 0 2px',
+        padding: '2px 4px',
+        marginLeft: '-4px',
+        borderRadius: '4px',
+      },
+      // 悬停/键盘焦点时的反馈（同一套，键盘用户也要看得见）。
+      foldHeadActive: { background: 'rgba(128,128,128,.14)' },
+      foldArrow: { flex: '0 0 auto', opacity: 0.6, fontSize: '11px' },
+
       // 说明文字：弱化但保持可读对比度（不要低到看不清）。
       fieldHint: { fontSize: '12.5px', opacity: 0.72, lineHeight: '1.6', flex: '1 1 100%', margin: '0 0 7px' },
 
@@ -416,6 +467,54 @@ window.__ModuleLoader__.load({
       'shikoku-metang', 'ameharu-hau', 'namiine-ritsu', 'shirakami-kotaro',
     ]
 
+    /**
+     * 音色友好显示名（v0.4.55）。
+     *
+     * 用户反馈：下拉里显示 `zundamon-normal` 是**开发者内部标识**，
+     * 普通用户看不懂。改为「角色名 · 风格名」；原 key 只在 title 悬停提示
+     * 与诊断日志里出现。
+     *
+     * ⚠️ 只影响**显示**：保存提交的仍是原 key（voiceName / kindVoiceName），
+     * 配置格式、默认值、后端一字未动。
+     *
+     * ⚠️ 名字与 `tools/build-voice-packs.ps1` 的 $Approved.Name 同源，
+     * 由测试 cross-check 防漂移（见 test/voice-label.test.mjs）。
+     */
+    var VOICE_LABELS = {
+      'zundamon-normal': 'ずんだもん · ノーマル',
+      'zundamon-amama': 'ずんだもん · あまあま',
+      'ankomon': 'あんこもん',
+      'goki-nuigurumi': '後鬼 · ぬいぐるみ',
+      'kyushu-sora': '九州そら',
+      'manbetsu-hanamaru-genki': '満別花丸 · 元気',
+      'meimei-meria': '冥鳴ひまり',
+      'shikoku-metang': '四国めたん',
+      'ameharu-hau': '雨晴はう',
+      'namiine-ritsu': '波音リツ',
+      'shirakami-kotaro': '白上虎太郎',
+    }
+
+    /**
+     * key → 友好名。未知 key **原样返回**（不猜、不美化）——
+     * 用户手填的自定义 key 显示成它自己，比显示一个错的别名安全。
+     */
+    function voiceLabel(key) {
+      if (!key) return ''
+      return VOICE_LABELS[key] || key
+    }
+
+    /**
+     * 语音包元数据里的官方名（`ずんだもん（ノーマル）`）
+     * → 统一成「角色名 · 风格名」，与 VOICE_LABELS 风格一致。
+     *
+     * 否则「语音包列表」用括号、「音色下拉」用点，同一件事两种叫法。
+     */
+    function prettyPackName(name) {
+      var s = String(name || '')
+      var m = /^(.+?)（(.+?)）$/.exec(s)
+      return m ? (m[1] + ' · ' + m[2]) : s
+    }
+
     /** 事件开关定义（键 → 中文名）。 */
     // 事件开关：[键, 名称, 一句话说明]。
     //
@@ -493,6 +592,24 @@ window.__ModuleLoader__.load({
       var avset = avst[1]
       var advSec = avst[0]
 
+      // 高级子组标题的悬停/焦点高亮（v0.4.55）。
+      // 独立 state：它纯粹是瞬时交互反馈，与配置无关，
+      // 也不该因为保存配置（25 处 set 重建主 state）被重置。
+      var hvst = React.useState({ id: "" })
+      var hvset = hvst[1]
+      var advHover = hvst[0].id || ""
+
+      // 声音设置区的展开状态（v0.4.56）。
+      //
+      // `null` = 跟随默认：声音提醒开着就展开、关了就收起。
+      // 用户手动点过之后才固定成 true/false（不覆盖用户的显式选择）。
+      //
+      // ⚠️ 收起**只是隐藏**，配置一律保留；试听也在里面，
+      // 用户想看随时能展开 —— 不禁用任何操作。
+      var sndst = React.useState({ open: null })
+      var sndset = sndst[1]
+      var sndPref = sndst[0].open
+
       var st = React.useState({
         loaded: false,
         values: {
@@ -935,6 +1052,17 @@ window.__ModuleLoader__.load({
         h('span', { style: S.hint }, '关掉只弹 Toast'),
       ))
 
+      // ⚠️ 两个都关掉 = 完全没有任何提醒（v0.4.55）。
+      //
+      // 用户指出这个歧义：不禁止这样设置（那是用户的选择），
+      // 但必须**如实告知结果**，否则用户以为"我配过了怎么没反应"。
+      // 用中性样式，不用红/黄 —— 这不是故障。
+      if (v.showToast === false && v.voice === false) {
+        rows.push(h('div', { key: 'all-silent', style: S.noticeBox },
+          '弹窗与声音都已关闭 —— 插件不会产生任何可见或可听的提醒。'
+            + '（提醒规则里的事件仍会照常触发，只是没有任何表现。）'))
+      }
+
       // ── 音源选择（v0.4.4）─────────────────────────────────────────────────
       //
       // 这是本插件最核心的可配置项：用户想听系统语音、想听语音包、想要系统音效、
@@ -971,6 +1099,31 @@ window.__ModuleLoader__.load({
       // ── 二、声音设置 ────────────────────────────────────────────────
       rows.push(section('sound', '声音设置', '音量、音色与试听；语音包可按需下载。'))
 
+      // 声音提醒关掉时，把音频控件收起来（v0.4.56）。
+      //
+      // 用户指出：两个提醒都关了，下面还铺着整套 TTS 设置，视觉噪音大。
+      // 但**不能删**配置 —— 用户可能只是暂时静音，回头还要用。
+      var voiceOff = v.voice === false
+      var sndOpen = sndPref === null ? !voiceOff : sndPref === true
+      if (voiceOff) {
+        rows.push(h('div', { key: 'snd-off-head', style: S.foldHead,
+          onClick: function () { sndset({ open: !sndOpen }) },
+          role: 'button', tabIndex: 0,
+          'aria-expanded': sndOpen ? 'true' : 'false',
+          onKeyDown: function (e) {
+            if (e.key === 'Enter' || e.key === ' ') {
+              e.preventDefault()
+              sndset({ open: !sndOpen })
+            }
+          },
+        },
+          h('span', { style: { fontSize: '13px', opacity: 0.9 } },
+            '声音提醒已关闭，原有配置已保留'),
+          h('span', { style: S.foldArrow }, sndOpen ? '▾' : '▸'),
+        ))
+      }
+
+      if (sndOpen) {
       pushIf(curSource !== 'none', h('div', { key: 'vol', style: S.row },
         h('span', { style: S.label }, '音量'),
         h('input', {
@@ -1083,7 +1236,7 @@ window.__ModuleLoader__.load({
             ['done', '完成'], ['fail', '失败'], ['question', '提问'],
             ['approval', '批准'], ['blocked', '拦截'],
           ]
-          return h('div', { style: { display: 'flex', gap: '6px', flexWrap: 'wrap', flex: '1' } },
+                      return h('div', { style: S.pvGroup },
             KINDS.map(function (pair) {
               var isBusy = pvState.kind === pair[0]
               return h('button', {
@@ -1175,7 +1328,8 @@ window.__ModuleLoader__.load({
               // 条款要**下载前**可见 —— 不能只靠 zip 里的 TERMS.md（那要下载后才看得到）。
               return h('div', { key: 'vp-item-' + p.key, style: { display: 'flex', flexDirection: 'column', gap: '2px', padding: '3px 0' } },
                 h('div', { style: { display: 'flex', alignItems: 'center', gap: '8px' } },
-                  h('span', { style: { flex: '1' } }, (p.name || p.key) + (mb ? '（' + mb + '）' : '')),
+                  h('span', { style: { flex: '1' }, title: p.key },
+              (prettyPackName(p.name) || p.key) + (mb ? '（' + mb + '）' : '')),
                   p.installed ? h('span', { style: { color: '#2a7' } }, '已安装') : null,
                   h('button', {
                     type: 'button',
@@ -1195,10 +1349,21 @@ window.__ModuleLoader__.load({
                     },
                   }, p.installed ? '卸载' : (p.downloadable ? '下载' : '不可用')),
                 ),
-                // 署名与条款：小字，不抢视觉但随时可查
+                // 署名与条款：小字，不抢视觉但随时可查。
+                //
+                // ⚠️ 占位提示的判据是「**能下载却没有条款**」（v0.4.56）：
+                // 那才是真的数据问题，值得提示。
+                //
+                // 原来判据是「没有 termsUrl 就提示」，于是**离线**时
+                // （索引取不到 → 已安装的包也没有 termsUrl）界面会显示
+                // 「条款链接待补」，看起来像插件发布缺字段 —— 虚报。
+                //
+                // 许可安全本身不受影响：下载按钮要求 p.downloadable，
+                // 而 downloadable 只可能来自带 terms 的远程索引。
                 h('div', { style: S.subHint },
                   (p.credit ? '署名：' + p.credit : '')
-                  + (p.termsUrl ? '' : '　（条款链接待补）'),
+                  // 内联判断（这里是表达式上下文，不能写 var）
+                  + ((p.downloadable && !p.termsUrl) ? '　（条款链接待补）' : ''),
                   p.termsUrl
                     ? h('a', {
                       href: p.termsUrl,
@@ -1242,7 +1407,10 @@ window.__ModuleLoader__.load({
             value: v.voiceName || 'zundamon-normal',
             disabled: s.busy || !fixedMode,
             onChange: function (e) { apply({ voiceName: e.target.value }, '音色已更新') },
-          }, keyOpts.map(function (k) { return h('option', { key: k, value: k }, k) })),
+          }, keyOpts.map(function (k) {
+            // value 仍是原 key（保存用它），只改显示文本；原 key 放 title
+            return h('option', { key: k, value: k, title: k }, voiceLabel(k))
+          })),
           fixedMode ? null : h('span', { style: S.hint }, '随机模式下不生效'),
         ))
       }
@@ -1421,6 +1589,8 @@ window.__ModuleLoader__.load({
         notifyOnAborted: false, notifyOnApproval: true, notifyOnQuestion: true,
         subagents: false, idleGate: true,
       }
+      }   // ← 声音设置区展开/收起（v0.4.56）
+
       // ── 三、提醒规则 ────────────────────────────────────────────────
       rows.push(section('rules', '提醒规则', '哪些事件要提醒你。默认只提醒需要你关注的那些。'))
       // 按「什么时候会用到」分三组渲染（v0.4.54）。
@@ -1647,13 +1817,33 @@ window.__ModuleLoader__.load({
         ADV_SECTIONS.forEach(function (sec) {
           var id = sec[0]
           var isOpen = advSec[id] === true
+          // 整行可点 + 箭头固定最右 + 悬停/焦点反馈 + 键盘可操作（v0.4.55）。
+          //
+          // 用户反馈：原来箭头跟在文字后面（`高级设置 ▸`），不明显能点。
+          // 现在整行是点击区、箭头靠右、Enter/Space 也能展开 ——
+          // 键盘用户与鼠标用户看到同一套反馈（foldHeadActive）。
+          var headActive = advHover === id
           rows.push(h('div', {
             key: 'adv-sec-' + id,
-            style: Object.assign({}, S.groupLabel, {
-              cursor: 'pointer', userSelect: 'none', margin: '16px 0 2px',
-            }),
+            role: 'button',
+            tabIndex: 0,
+            'aria-expanded': isOpen ? 'true' : 'false',
+            style: Object.assign({}, S.foldHead, headActive ? S.foldHeadActive : null),
             onClick: function () { toggleAdvSec(id) },
-          }, sec[1] + (isOpen ? '  ▾' : '  ▸')))
+            onMouseEnter: function () { hvset({ id: id }) },
+            onMouseLeave: function () { hvset({ id: advHover === id ? '' : advHover }) },
+            onFocus: function () { hvset({ id: id }) },
+            onBlur: function () { hvset({ id: advHover === id ? '' : advHover }) },
+            onKeyDown: function (e) {
+              if (e.key === 'Enter' || e.key === ' ') {
+                e.preventDefault()
+                toggleAdvSec(id)
+              }
+            },
+          },
+            h('span', { style: { fontWeight: 600, fontSize: '13px' } }, sec[1]),
+            h('span', { style: S.foldArrow }, isOpen ? '▾' : '▸'),
+          ))
           rows.push(h('div', { key: 'adv-sec-desc-' + id, style: S.subHint }, sec[2]))
 
           if (isOpen) {
@@ -1663,7 +1853,8 @@ window.__ModuleLoader__.load({
               var KIND_ROWS = [['Done', '任务完成'], ['Fail', '任务失败'],
                 ['Question', '向你提问'], ['Approval', '待你批准'], ['Blocked', '被拦截']]
               var FOLLOW = '__follow__'
-          rows.push(h('div', { key: 'adv-group', style: S.groupLabel }, '按事件覆盖声音来源'))
+          // 内层不再重复标题 —— 二级分组已经叫「按事件定制声音」（v0.4.56）。
+        // 只保留说明，直接接五个事件选择器。
           rows.push(h('div', { key: 'advhint', style: S.subHint },
             '默认跟随上面的「声音来源」。只有你改过的那几行才会单独生效。'))
           KIND_ROWS.forEach(function (pair) {
@@ -1871,7 +2062,9 @@ window.__ModuleLoader__.load({
                     return function (e) { var o = {}; o[k] = e.target.value; apply(o, '已更新') }
                   })(nKey),
                 }, [h('option', { key: '', value: '' }, '跟随全局')].concat(
-                  kOpts2.map(function (x) { return h('option', { key: x, value: x }, x) }),
+                  kOpts2.map(function (x) {
+                    return h('option', { key: x, value: x, title: x }, voiceLabel(x))
+                  }),
                 )),
                 mCur === 'random' ? h('span', { style: S.hint }, '随机模式下不生效') : null,
               ))

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "dsh-notify-say",
-    "version":  "0.4.54",
+    "version":  "0.4.56",
     "description":  "Desktop notifications for DSH Desktop that actually speak: Windows TTS out of the box (zero download), VOICEVOX voice packs optional, a selectable system-sound fallback, and an idle gate that waits for running subagents before saying the turn is done. Includes a settings-page GUI (sound source, per-event overrides, jump-back-to-session, cooldowns) and a self hot-reload for development.",
     "license":  "MIT",
     "type":  "module",

package/test/ui-final.test.mjs

@@ -0,0 +1,220 @@
+/**
+ * 定稿前的收尾行为测试（v0.4.56）。
+ *
+ * 这两条来自用户评审：
+ *   ① 静音时音频设置应收起，但**不能禁用试听**
+ *   ② 「条款链接待补」不能虚报
+ */
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import { resolve, dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const CLIENT = readFileSync(join(ROOT, 'lib', 'client.js'), 'utf8');
+
+function fakeReact() {
+  const createElement = (type, props, ...children) => ({
+    $$typeof: Symbol.for('react.element'),
+    type,
+    props: { ...(props || {}), children },
+  });
+  const hooks = { slots: [], index: 0, eff: 0, ranEff: new Set(), rerender: null };
+  const useState = (init) => {
+    const i = hooks.index++;
+    if (hooks.slots[i] === undefined) {
+      hooks.slots[i] = { value: typeof init === 'function' ? init() : init };
+    }
+    const slot = hooks.slots[i];
+    const set = (updater) => {
+      slot.value = typeof updater === 'function' ? updater(slot.value) : updater;
+      if (typeof hooks.rerender === 'function') hooks.rerender();
+    };
+    return [slot.value, set];
+  };
+  // 只跑一次（模拟 [] 依赖）；不调 cleanup（否则 alive=false，配置永远不合并）
+  const useEffect = (fn) => {
+    const i = hooks.eff++;
+    if (hooks.ranEff.has(i)) return;
+    hooks.ranEff.add(i);
+    try { fn(); } catch { /* ignore */ }
+  };
+  const resetIndex = () => { hooks.index = 0; hooks.eff = 0; };
+  return { createElement, useState, useEffect, __hooks: hooks, __resetIndex: resetIndex };
+}
+
+const FULL = {
+  voice: true, voiceMode: 'fixed', voiceName: 'zundamon-normal', volume: 80,
+  notifyOnComplete: true, notifyOnError: true, notifyOnBlocked: true,
+  notifyOnAborted: false, notifyOnApproval: true, notifyOnQuestion: true,
+  subagents: false, idleGate: true,
+  audioSource: 'tts', showToast: true, ttsVoice: '', ttsRate: 0, devReload: false,
+  logLevel: 'info', voiceGain: 2.0, normalizeCustomAudio: false,
+  jumpWhenBackground: true, jumpWhenForeground: false,
+  debounceSeconds: 60, globalCooldownSeconds: 0,
+  audioSourceByKind: {}, ttsTexts: {}, kindSystemSound: {}, kindVoiceName: {},
+  customFiles: {},
+};
+
+function texts(node, out) {
+  const acc = out || [];
+  if (node === null || node === undefined || node === false) return acc;
+  if (typeof node === 'string' || typeof node === 'number') { acc.push(String(node)); return acc; }
+  if (Array.isArray(node)) { node.forEach((n) => texts(n, acc)); return acc; }
+  texts(node.props && node.props.children, acc);
+  return acc;
+}
+
+function elements(node, out) {
+  const acc = out || [];
+  if (!node || typeof node !== 'object') return acc;
+  if (Array.isArray(node)) { node.forEach((n) => elements(n, acc)); return acc; }
+  if (node.type) acc.push(node);
+  elements(node.props && node.props.children, acc);
+  return acc;
+}
+
+/** 按形状找主 state 槽（组件有多个 useState，不能写死索引）。 */
+function findMainSlot(card) {
+  const s = card.r.__hooks.slots.find(
+    (x) => x && x.value && typeof x.value === 'object'
+      && 'values' in x.value && 'loaded' in x.value,
+  );
+  if (!s) throw new Error('找不到主 state 槽');
+  return s;
+}
+
+/** 按形状找「声音设置展开状态」槽（{ open: ... }）。 */
+function findSoundSlot(card) {
+  const s = card.r.__hooks.slots.find(
+    (x) => x && x.value && typeof x.value === 'object'
+      && 'open' in x.value && Object.keys(x.value).length === 1,
+  );
+  if (!s) throw new Error('找不到声音区 state 槽');
+  return s;
+}
+
+async function loadCard() {
+  let captured = null;
+  new Function('window', 'document', CLIENT)(
+    { __ModuleLoader__: { load(def) { captured = def; } }, addEventListener() {}, removeEventListener() {} },
+    undefined,
+  );
+  if (!captured) throw new Error('client.js 没有注册');
+
+  const r = fakeReact();
+  const mod = captured.factory((id) => {
+    if (id === 'react') return r;
+    throw new Error('client 不应 require: ' + id);
+  });
+
+  let component = null;
+  mod.apply({
+    get(id) {
+      if (id === 'slots') return { inject(_n, fn) { fn(); }, register(_m, c) { component = c; } };
+      return undefined;
+    },
+  });
+  if (!component) throw new Error('没有注册设置卡');
+
+  globalThis.fetch = (url) => Promise.resolve({
+    ok: true, status: 200,
+    json: () => Promise.resolve(
+      String(url).includes('version')
+        ? {
+          ok: true, running: '0.4.56', installed: '0.4.56', latest: '0.4.56',
+          hasUpdate: false, needsRestart: false, npmLatest: '0.4.56',
+          githubLatest: '0.4.56', installMode: 'managed', changelogUrl: 'x',
+        }
+        : { ok: true, values: FULL, packs: [] },
+    ),
+  });
+
+  const render = () => { r.__resetIndex(); return component({}); };
+  render();
+  r.__hooks.rerender = render;
+  for (let i = 0; i < 8; i++) await Promise.resolve();
+  return { r, render };
+}
+
+const has = (text, s) => text.includes(s);
+
+/** 设 state 后渲染。 */
+function renderWith(card, main, sound) {
+  findMainSlot(card).value = { ...findMainSlot(card).value, ...main };
+  if (sound !== undefined) findSoundSlot(card).value = { open: sound };
+  const tree = card.render();
+  return { text: texts(tree).join(' '), els: elements(tree) };
+}
+
+// ── N6: 静音时收起声音设置，但不禁用试听 ────────────────────────────────
+test('N6: 声音提醒关闭时收起音频设置，试听仍可用', async () => {
+  const card = await loadCard();
+
+  // 声音开着 → 正常展开；手动把 open 置 null（跟随默认）
+  {
+    const { text } = renderWith(card,
+      { values: { ...FULL, audioSource: 'tts', voice: true } }, null);
+    assert.ok(has(text, '朗读声音'), '声音开着时应正常显示音频控件');
+    assert.ok(!has(text, '声音提醒已关闭'), '声音开着时不该出现收起提示');
+  }
+
+  // 声音关掉 → 收起，但说明"配置还在"
+  {
+    const { text } = renderWith(card,
+      { values: { ...FULL, audioSource: 'tts', voice: false } }, null);
+    assert.ok(has(text, '声音提醒已关闭，原有配置已保留'),
+      '静音时应说明「配置还在」，否则用户以为被清掉了');
+    assert.ok(!has(text, '朗读声音'), '静音时应收起音频控件');
+  }
+
+  // 用户手动展开 → 控件回来，且试听**没有**被禁用
+  {
+    const { text, els } = renderWith(card,
+      { values: { ...FULL, audioSource: 'tts', voice: false } }, true);
+    assert.ok(has(text, '朗读声音'), '手动展开后应能看到音频控件');
+
+    const pvButtons = els.filter((e) => {
+      if (e.type !== 'button') return false;
+      const kids = e.props.children || [];
+      return ['完成', '失败', '提问', '批准', '拦截'].includes(kids[0]);
+    });
+    assert.ok(pvButtons.length >= 5, `五个试听按钮都应存在（实际 ${pvButtons.length}）`);
+    assert.ok(pvButtons.every((b) => !b.props.disabled),
+      '静音**不得禁用试听** —— 试听是测试配置的行为，与通知开关无关');
+  }
+});
+
+// ── N7: 条款占位不虚报 ──────────────────────────────────────────────────
+test('N7: 条款占位只在「能下载却没条款」时出现', () => {
+  // 用户评审时看到「条款链接待补」，要求核实是不是发布缺字段。
+  //
+  // 核实结论：真实 packs.json 的 13 个音色都有 terms，服务端也转成 termsUrl
+  // （R7 用真实请求钉住）。但**离线**时索引取不到，已安装的包没有 termsUrl ——
+  // 原来会显示占位，看起来像发布缺字段。
+  //
+  // 现在判据收窄为「能下载 && 没条款」。
+  assert.match(
+    CLIENT,
+    /\(p\.downloadable && !p\.termsUrl\)/,
+    '占位提示必须同时要求 downloadable —— 否则离线时会虚报',
+  );
+  // 反面断言：不能退回「没有 termsUrl 就报」
+  assert.doesNotMatch(
+    CLIENT,
+    /\+ \(p\.termsUrl \? '' : '　（条款链接待补）'\)/,
+    '不应退回旧的「没 termsUrl 就提示」判据',
+  );
+});
+
+// ── N8: 高级区不再有重复标题 ────────────────────────────────────────────
+test('N8: 高级区四个子组没有重复的内部标题', async () => {
+  const card = await loadCard();
+  const { text } = renderWith(card, { advOpen: true }, undefined);
+  // 子组标题「按事件定制声音」只应出现一次（内部不再重复「按事件覆盖声音来源」）
+  const occurrences = text.split('按事件定制声音').length - 1;
+  assert.equal(occurrences, 1, `「按事件定制声音」应只出现一次（实际 ${occurrences}）`);
+  assert.doesNotMatch(CLIENT, /'按事件覆盖声音来源'/,
+    '内部标题应已删除 —— 与二级分组标题重复');
+});

package/test/voice-label.test.mjs

@@ -0,0 +1,123 @@
+/**
+ * 音色友好显示名的一致性测试（v0.4.55）。
+ *
+ * ## 为什么要这些测试
+ *
+ * 用户反馈：下拉里显示 `zundamon-normal` 是开发者内部标识，应显示「角色名 · 风格名」。
+ *
+ * 这个改动本身很小，但它引入了**第二份音色名字**：
+ *   ① `tools/build-voice-packs.ps1` 的 `$Approved[].Name`（打包用，权威）
+ *   ② `lib/client.js` 的 `VOICE_LABELS`（显示用）
+ *
+ * 两份名字一旦漂移，用户会在「语音包列表」看到一个名字、
+ * 在「音色下拉」看到另一个名字 —— 同一件事两种叫法。
+ * 所以必须用测试把它们钉在一起。
+ *
+ * ## 关键的"不能改"约束
+ *
+ * 只改显示。**保存提交的仍是原 key** —— 如果哪天有人把 option 的 value
+ * 改成友好名，用户的配置就会写入一个后端不认识的字符串。
+ * Q3 专门盯这一条。
+ */
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const CLIENT = readFileSync(join(ROOT, 'lib', 'client.js'), 'utf8');
+const BUILD_PS1 = join(ROOT, 'tools', 'build-voice-packs.ps1');
+const hasBuild = existsSync(BUILD_PS1);
+
+/** 解析 client.js 里的 VOICE_KEYS。 */
+function voiceKeys() {
+  const m = CLIENT.match(/var VOICE_KEYS = \[([\s\S]*?)\n    \]/);
+  assert.ok(m, '应能定位 VOICE_KEYS');
+  return [...m[1].matchAll(/'([a-z0-9-]+)'/g)].map((x) => x[1]);
+}
+
+/** 解析 client.js 里的 VOICE_LABELS。 */
+function voiceLabels() {
+  const m = CLIENT.match(/var VOICE_LABELS = \{([\s\S]*?)\n    \}/);
+  assert.ok(m, '应能定位 VOICE_LABELS');
+  const out = {};
+  for (const mm of m[1].matchAll(/'([a-z0-9-]+)':\s*'([^']+)'/g)) out[mm[1]] = mm[2];
+  return out;
+}
+
+/** 解析打包脚本的 $Approved（key → 官方 Name）。 */
+function approvedNames() {
+  const src = readFileSync(BUILD_PS1, 'utf8');
+  const out = {};
+  for (const m of src.matchAll(/'([a-z0-9-]+)'\s*=\s*@\{\s*Name\s*=\s*'([^']+)'/g)) {
+    out[m[1]] = m[2];
+  }
+  return out;
+}
+
+/** `ずんだもん（ノーマル）` → `ずんだもん`；`四国めたん` → `四国めたん`。 */
+function characterOf(official) {
+  const m = /^(.+?)（(.+?)）$/.exec(official);
+  return m ? m[1] : official;
+}
+
+// ── Q1: VOICE_KEYS 每一项都有友好名 ─────────────────────────────────────
+test('Q1: 每个可选音色都有友好显示名', () => {
+  const keys = voiceKeys();
+  const labels = voiceLabels();
+  assert.ok(keys.length >= 8, `音色数量偏少（${keys.length}）`);
+
+  const missing = keys.filter((k) => !labels[k]);
+  assert.deepEqual(missing, [],
+    '这些音色还显示着英文 key（用户看不懂），应补进 VOICE_LABELS：\n' + missing.join('\n'));
+});
+
+// ── Q2: 友好名与打包脚本的官方名同源 ────────────────────────────────────
+test('Q2: 友好名的角色部分与 build-voice-packs.ps1 一致', () => {
+  if (!hasBuild) {
+    // 发布包里没有维护者工具，跳过（与 D6/D7 同款处理）
+    return;
+  }
+  const labels = voiceLabels();
+  const approved = approvedNames();
+  assert.ok(Object.keys(approved).length >= 8, '应能解析出打包脚本的音色表');
+
+  const problems = [];
+  for (const [key, official] of Object.entries(approved)) {
+    const label = labels[key];
+    if (!label) continue;                       // Q1 管缺失
+    const wantChar = characterOf(official);
+    const gotChar = label.split(' · ')[0];
+    if (gotChar !== wantChar) {
+      problems.push(`${key}: 显示「${label}」，但打包脚本的角色名是「${wantChar}」`);
+    }
+  }
+  assert.deepEqual(problems, [],
+    '两份音色名字漂移了 —— 用户会在不同位置看到不同叫法：\n' + problems.join('\n'));
+});
+
+// ── Q3: 保存的仍是原 key，不是友好名 ───────────────────────────────────
+test('Q3: 音色下拉的 value 仍是原 key（只改显示）', () => {
+  // 如果 value 被改成友好名，用户的配置会写入后端不认识的字符串。
+  assert.match(CLIENT, /h\('option', \{ key: k, value: k, title: k \}, voiceLabel\(k\)\)/,
+    '固定音色的 option 必须 value=原key、显示=友好名');
+  assert.match(CLIENT, /h\('option', \{ key: x, value: x, title: x \}, voiceLabel\(x\)\)/,
+    '按事件覆盖的音色 option 同理');
+  // 原 key 要能在悬停提示里看到（用户排查问题时需要）
+  assert.match(CLIENT, /title: k/, '原 key 应放在 title 里（悬停可见）');
+});
+
+// ── Q4: option 显示文本不再直接是 key ──────────────────────────────────
+test('Q4: 音色 option 的显示文本走 voiceLabel，不是裸 key', () => {
+  // 反面断言：不能再出现 `h('option', { key: k, value: k }, k)` 这种裸 key 显示
+  assert.doesNotMatch(CLIENT, /h\('option', \{ key: k, value: k \}, k\)/,
+    '固定音色不应再直接显示英文 key');
+  assert.doesNotMatch(CLIENT, /h\('option', \{ key: x, value: x \}, x\)/,
+    '按事件覆盖的音色不应再直接显示英文 key');
+
+  // 语音包列表也要用统一风格（括号 → 点）
+  assert.match(CLIENT, /prettyPackName\(p\.name\)/,
+    '语音包列表的官方名应统一成「角色 · 风格」风格');
+  assert.match(CLIENT, /function prettyPackName/, '应有 prettyPackName 工具函数');
+});

package/test/voice-pack-route.test.mjs

@@ -182,3 +182,49 @@ test('R7: 安装索引里没有的音色返回 404', async () => {
       `应是 404 或 502，实际 ${res.statusCode}`);
   });
 });
+
+// ── R8: 索引里的 terms → termsUrl（前端读的是这个字段名）─────────────────
+test('R8: 路由把 packs.json 的 terms 映射成前端要的 termsUrl', async () => {
+  // ⚠️ 用户评审时看到界面显示「条款链接待补」，要求核实是不是发布缺字段。
+  //
+  // 核实结论：真实 packs.json 的 13 个音色**都有** terms，
+  // 但字段名是 `terms`，而前端读的是 `termsUrl` ——
+  // 转名这一步在 voice-pack-route.js 里（`termsUrl: p.terms`）。
+  //
+  // 这步一旦被删，界面会对**所有**音色显示「条款链接待补」。
+  // 用真实请求 + 打桩 fetch 把这条跨文件契约钉住。
+  await withDataDir(async () => {
+    const realFetch = globalThis.fetch;
+    const FAKE_TERMS = 'https://example.invalid/voice-terms';
+    globalThis.fetch = async () => ({
+      ok: true,
+      status: 200,
+      headers: { get: () => null },
+      json: async () => ({
+        packs: [{
+          key: 'zundamon-normal',
+          name: 'ずんだもん（ノーマル）',
+          file: 'zundamon-normal.zip',
+          bytes: 100,
+          sha256: 'a'.repeat(64),
+          wavs: 1,
+          credit: 'VOICEVOX:ずんだもん',
+          terms: FAKE_TERMS,
+        }],
+      }),
+    });
+    try {
+      const route = createVoicePackRoute({ pluginRoot: '.', logger: { info() {}, warn() {} } });
+      const res = await call(route, 'GET', 'index');
+      assert.equal(res.statusCode, 200);
+      const doc = res.json();
+      assert.equal(doc.indexOk, true, '索引应可用（fetch 已打桩）');
+      const p = (doc.packs || []).find((x) => x.key === 'zundamon-normal');
+      assert.ok(p, '应返回该音色');
+      assert.equal(p.termsUrl, FAKE_TERMS,
+        'packs.json 里叫 terms，前端读的是 termsUrl —— 名字不对会让界面显示「条款链接待补」');
+    } finally {
+      globalThis.fetch = realFetch;
+    }
+  });
+});