dsh-notify-say 0.4.46 → 0.4.48

package/lib/client.js

@@ -137,6 +137,15 @@ window.__ModuleLoader__.load({
       }).then(function (r) { return r ? r.json() : null }).catch(function () { return null })
     }
 
+    // 检查更新（v0.4.48）。只读：不下载、不覆盖文件、不执行命令。
+    // force=true 表示用户手动点，绕过宿主侧 24 小时缓存。
+    function fetchVersion(force) {
+      var url = apiUrl('version') + (force ? '?force=1' : '')
+      return fetch(url, { cache: 'no-store', credentials: 'same-origin' })
+        .then(function (r) { return r && r.ok ? r.json() : null })
+        .catch(function () { return null })
+    }
+
     function openSession(ctx, sessionId) {
       try {
         if (!sessionId) return false
@@ -386,6 +395,20 @@ window.__ModuleLoader__.load({
       // ⚠️ 真实值必须以 host 返回的**生效值**为准（见下方 useEffect 的 merge）。
       // 这些占位数字**不代表实际配置**：例如 patch 里 volume 可能是 100，
       // 这里写 80 只是防 undefined；生效值到达后会被覆盖。
+      // 版本与更新（v0.4.48）—— **独立 state**，与主 state 隔离。
+      //
+      // 为什么不用主 state：主 state 有 25 处 set() 逐字段重建，
+      // 加一个字段要改 25 处，已因此出过 4 次 bug。
+      // 独立 useState 能彻底避开这个坑。
+      var vst = React.useState({
+        // null = 还没查过；失败时是 { ok:false, error }
+        info: null,
+        loading: false,
+        copied: false,
+      })
+      var vset = vst[1]
+      var vs = vst[0]
+
       var st = React.useState({
         loaded: false,
         values: {
@@ -411,6 +434,15 @@ window.__ModuleLoader__.load({
 
       React.useEffect(function () {
         var alive = true
+        // 版本信息：挂载时查一次（宿主侧有 24 小时缓存，很便宜）。
+        //
+        // ⚠️ 必须走 Promise：直接 set 会触发重渲染 → effect 重跑 → 死循环
+        // （v0.4.33 语音包那块就是这么把 4GB 堆打满的）。
+        // 异步 .then 里 set 是安全的 —— 那时 effect 已经跑完了。
+        fetchVersion(false).then(function (r) {
+          if (!alive || !r) return
+          vset(function (p) { return { info: r, loading: false, copied: p.copied } })
+        })
         loadConfig().then(function (v) {
           if (!alive) return
           set(function (p) {
@@ -728,6 +760,38 @@ window.__ModuleLoader__.load({
           })
         })
       }
+      // ── 版本与更新（v0.4.48）────────────────────────────────────────
+      //
+      // 只检查、不安装。升级由用户自己执行 DSH 命令。
+      // 详见 lib/update-check.js 头注释（为什么不自动更新）。
+      function checkVersion(force) {
+        vset(function (p) {
+          return { info: p.info, loading: true, copied: false }
+        })
+        fetchVersion(force).then(function (r) {
+          vset(function (p) {
+            return { info: r || { ok: false, error: "无法连接" }, loading: false, copied: p.copied }
+          })
+        })
+      }
+
+      // 复制升级命令。失败就退回"显示命令让用户自己选"。
+      function copyUpgradeCommand(cmd) {
+        var done = function (ok) {
+          vset(function (p) { return { info: p.info, loading: p.loading, copied: ok } })
+          if (!ok) {
+            // 复制失败：至少把命令显示出来（界面上本来就有）
+            console.warn("[dsh-notify-say] 复制失败，请手动选择命令文本")
+          }
+        }
+        try {
+          if (typeof navigator !== "undefined" && navigator.clipboard && navigator.clipboard.writeText) {
+            navigator.clipboard.writeText(cmd).then(function () { done(true) }).catch(function () { done(false) })
+            return
+          }
+        } catch (e) { /* 继续用兜底 */ }
+        done(false)
+      }
 
       var v = s.values || {}
       var rows = []
@@ -1192,7 +1256,7 @@ window.__ModuleLoader__.load({
                     } else {
                       set(function (prev) {
                         return {
-                          loaded: prev.loaded, values: prev.values, advOpen: prev.advOpen, packs: p.packs,
+                          loaded: prev.loaded, values: prev.values, advOpen: prev.advOpen, packs: prev.packs,
                           termsAck: prev.termsAck, termsPending: prev.termsPending,
                           busy: false, msg: '',
                           err: '没有取到文件路径。若点了没反应，可手动在配置里填该事件的 customFile。',
@@ -1714,6 +1778,82 @@ window.__ModuleLoader__.load({
         rows.push(h('div', { key: 'dg-hint', style: S.subHint },
           '导出到日志同目录（%TEMP%\\dsh-notify-say\\）。会自动把用户名替换为 <user>、'
             + '绝对路径替换为 <path>，但**仍请自己再看一遍**再上传。'))
+
+        // ── 版本与更新（v0.4.48）─────────────────────────────────────
+        //
+        // 只显示版本状态 + 给升级指引。**不自动下载、不覆盖文件**：
+        // 本机可能是 Junction 指向开发源码，自动覆盖会直接毁掉源码；
+        // 而且 DSH 官方 CLI 已经能升级插件。
+        rows.push(h('div', { key: 'up-title', style: S.label }, '版本与更新'))
+        var vi = vs.info
+        var cur = vi && vi.current ? vi.current : "(未知)"
+        var lat = vi && vi.latest ? vi.latest : null
+
+        rows.push(h('div', { key: 'up-cur', style: S.row },
+          h('span', { style: S.label }, '当前版本'),
+          h('span', null, 'v' + cur)))
+
+        if (vs.loading) {
+          rows.push(h('div', { key: 'up-loading', style: S.subHint }, '正在检查…'))
+        } else if (!vi) {
+          rows.push(h('div', { key: 'up-idle', style: S.subHint },
+            '还没检查过。点下面的按钮查一下有没有新版本。'))
+        } else if (!vi.ok) {
+          rows.push(h('div', { key: 'up-err', style: S.subHint },
+            '暂时无法检查（' + (vi.error || '网络不可用') + '）。'
+              + '本地通知和语音不依赖它，照常工作。'))
+        } else if (vi.hasUpdate === true) {
+          rows.push(h('div', { key: 'up-new', style: S.row },
+            h('span', { style: S.label }, '最新版本'),
+            h('span', { style: { color: '#e0a030', fontWeight: 600 } }, 'v' + lat + '（有新版）')))
+        } else if (vi.hasUpdate === false) {
+          rows.push(h('div', { key: 'up-same', style: S.row },
+            h('span', { style: S.label }, '最新版本'),
+            h('span', { style: { color: '#2a7' } }, 'v' + lat + '（已是最新）')))
+        } else {
+          rows.push(h('div', { key: 'up-unknown', style: S.subHint },
+            '最新版本 v' + lat + '（本地版本格式无法比较）'))
+        }
+
+        // 有新版时给命令；开发模式给说明而不是命令（不能覆盖源码）
+        if (vi && vi.hasUpdate === true) {
+          if (vi.command) {
+            rows.push(h('div', { key: 'up-cmd', style: {
+              marginTop: '4px', padding: '8px', borderRadius: '4px',
+              background: 'rgba(255,255,255,.06)',
+              fontFamily: 'monospace', fontSize: '12px', wordBreak: 'break-all',
+            } }, vi.command))
+          }
+          rows.push(h('div', { key: 'up-note', style: S.subHint }, vi.note || ''))
+        } else if (vi && vi.note) {
+          rows.push(h('div', { key: 'up-mode', style: S.subHint }, vi.note))
+        }
+
+        rows.push(h('div', { key: 'up-btn', style: S.row },
+          h('button', {
+            type: 'button',
+            disabled: vs.loading,
+            style: S.btn,
+            onClick: function () { checkVersion(true) },
+          }, vs.loading ? '检查中…' : '检查更新'),
+          vi && vi.hasUpdate === true && vi.command
+            ? h('button', {
+              type: 'button',
+              style: S.btn,
+              onClick: function () { copyUpgradeCommand(vi.command) },
+            }, vs.copied ? '已复制' : '复制命令')
+            : null,
+          vi && vi.changelogUrl
+            ? h('a', {
+              href: vi.changelogUrl,
+              target: '_blank',
+              rel: 'noreferrer noopener',
+              style: { color: '#4a9', fontSize: '12px' },
+            }, '更新日志 ↗')
+            : null,
+        ))
+        rows.push(h('div', { key: 'up-offline', style: S.subHint },
+          '本地通知与语音不依赖更新检查；网络不可用时照常工作。'))
       }
 
       if (s.msg) rows.push(h('div', { key: 'msg', style: S.ok }, s.msg))

package/lib/index.js

@@ -98,6 +98,7 @@ import {
 import { checkLocalOrigin, throttle } from './http-guard.js';
 import { poolSummary } from './voice-pack-store.js';
 import { voiceRootsArg as computeVoiceRootsArg } from './voice-regions.js';
+import { checkForUpdate } from './update-check.js';
 import { createVoicePackRoute } from './voice-pack-route.js';
 import { isDebug, redactText } from './log-privacy.js';
 import { exportDiagnostics } from './diagnostics.js';
@@ -106,6 +107,14 @@ import { pickTtsText, sanitizeTtsText, MAX_TEXT_LEN } from './tts-lines.js';
 
 const PLUGIN_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
 
+
+// 检查更新的宿主侧缓存（v0.4.48）。
+//
+// 为什么放宿主侧而不是浏览器：
+//   · 一天最多查一次 —— 不管用户开几次设置页，都不该反复打 npm/GitHub
+//   · 报错也不影响功能：查不到就是查不到，通知与语音照常
+//   · 缓存跨会话存活（模块级），设置页重开不必重新联网
+const UPDATE_CACHE = { at: 0, result: null };
 // 插件版本（诊断导出用）。读 package.json，失败就返回 unknown ——
 // 这只是个信息字段，不值得为它抛异常。
 const PLUGIN_VERSION = (() => {
@@ -1611,7 +1620,42 @@ function hasVoiceLine(psKind) {
                 return;
                 }
 
-                if (head === 'config') return configRoute.handler(req, res);
+                // ── 检查更新（v0.4.48）──────────────────────────────────
+        //
+        // **只读**：不下载、不覆盖文件、不执行命令。
+        // 也刻意不放进 isWriteRoute —— 它没有任何副作用。
+        //
+        // 为什么不接受客户端传 URL：那等于让本机访问任意地址（SSRF）。
+        // 查询地址固定在 update-check.js 里。
+        if (head === 'version') {
+          // ?force=1 表示用户手动点了「检查更新」，绕过 24 小时缓存
+          const force = /[?&]force=1\b/.test(String((req && req.url) || ''));
+          //
+          // ⚠️ 必须包一层 catch：检查更新永远不该把设置页弄崩。
+          // 网络不通是常态（用户可能在离线环境），此时只报错误，
+          // 通知与语音完全不受影响。
+          Promise.resolve()
+            .then(() => checkForUpdate({
+              pluginRoot: PLUGIN_ROOT,
+              force,
+              cache: UPDATE_CACHE,
+            }))
+            .then((r) => {
+              try {
+                res.writeHead(200, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' });
+                res.end(JSON.stringify(r));
+              } catch { /* 响应已发出 */ }
+            })
+            .catch((e) => {
+              try {
+                res.writeHead(200, { 'content-type': 'application/json; charset=utf-8' });
+                res.end(JSON.stringify({ ok: false, error: String((e && e.message) || e) }));
+              } catch { /* 响应已发出 */ }
+            });
+          return;
+        }
+
+        if (head === 'config') return configRoute.handler(req, res);
 
                 // ── 自测端点（v0.4.11）────────────────────────────────────
                 //

package/lib/update-check.js

@@ -0,0 +1,296 @@
+/**
+ * 检查更新（v0.4.48）。
+ *
+ * ## 定位：只检查，不安装
+ *
+ * 本模块**只做三件事**：读出当前版本、查出最新版本、给出升级指引。
+ * 它不下载、不覆盖文件、不执行命令、不重启宿主。
+ *
+ * 为什么不做自动更新：
+ *   · 插件正在运行时替换自己的文件，失败后很难恢复
+ *   · 用户可能装在任意 profile，插件无从得知
+ *   · 本机安装可能是 Junction（指向开发源码），覆盖会直接毁掉开发目录
+ *   · DSH 官方 CLI 已经能升级插件（`dsh plugin update`），重复实现没意义
+ *
+ * 所以分工是：**本插件发现新版本 + 说明变更 + 告诉用户命令；DSH 执行升级。**
+ *
+ * ## 为什么不用 GitHub Releases 的 latest
+ *
+ * ⚠️ 实测（2026-10-18）：本仓库的 `/releases/latest` 指向 **`voice-packs`**
+ * —— 那是语音包索引的固定 tag，跟插件版本毫无关系。
+ * 仓库里只有 `v0.4.30`（语音包下载支持那一版）和 `voice-packs` 两个 Release，
+ * 插件版本只打 git tag、不发 Release。
+ *
+ * 所以用 `/releases/latest` 做更新检查会得出荒谬结论（"最新版是 voice-packs"）。
+ *
+ * ## 用什么当权威源
+ *
+ * 两个来源，都是"发布时同步更新"的：
+ *   ① npm registry 的 `dist-tags.latest`（npm 安装的用户）
+ *   ② GitHub 仓库 main 分支的 package.json（GitHub / link 安装的用户）
+ *
+ * 先查 ①，失败回退 ②。两者都由 `tools/release.ps1` 同时更新，正常情况下一致。
+ *
+ * ## 缓存
+ *
+ * 宿主侧缓存 24 小时：GUI 每次打开不必真的联网，
+ * 但一天最多查一次，足够"发现有新版"。
+ * 用户手动点「检查更新」时强制绕过缓存。
+ *
+ * @module lib/update-check.js
+ */
+
+import { readFileSync, realpathSync } from 'node:fs';
+import { join } from 'node:path';
+
+/** npm registry 的包元数据地址。 */
+export const NPM_REGISTRY_URL = 'https://registry.npmjs.org/dsh-notify-say';
+
+/** GitHub main 分支的 package.json（GitHub 安装的用户看这个）。 */
+export const GITHUB_RAW_PKG_URL =
+  'https://raw.githubusercontent.com/unifilitence/dsh-notify-say/main/package.json';
+
+/** 更新日志（人看的页面）。 */
+export const CHANGELOG_URL =
+  'https://github.com/unifilitence/dsh-notify-say/blob/main/CHANGELOG.md';
+
+/** 单次查询超时。网络不通时不要拖住界面。 */
+export const FETCH_TIMEOUT_MS = 5000;
+
+/** 自动检查的最小间隔：一天。 */
+export const AUTO_CHECK_TTL_MS = 24 * 60 * 60 * 1000;
+
+/**
+ * 读当前版本（读自己的 package.json，不联网）。
+ *
+ * @param {string} pluginRoot
+ * @returns {string} 读不到时返回空串
+ */
+export function currentVersion(pluginRoot) {
+  try {
+    const pkg = JSON.parse(readFileSync(join(pluginRoot, 'package.json'), 'utf8'));
+    return typeof pkg.version === 'string' ? pkg.version : '';
+  } catch {
+    return '';
+  }
+}
+
+/**
+ * 把 `1.2.3` / `v1.2.3` 规整成可比较的数组。
+ *
+ * 只处理数字点分版本；带 `-rc.1` 之类后缀时只取前面的数字段
+ * （预发布版不该被建议"升级到正式版"以外的东西，这里不做精细 semver）。
+ *
+ * @param {string} v
+ * @returns {number[] | null}
+ */
+export function parseVersion(v) {
+  const s = String(v || '').trim().replace(/^v/i, '');
+  const m = /^(\d+)\.(\d+)\.(\d+)/.exec(s);
+  if (!m) return null;
+  return [Number(m[1]), Number(m[2]), Number(m[3])];
+}
+
+/**
+ * 比较两个版本。返回 -1 / 0 / 1；任一不可解析时返回 null。
+ *
+ * @param {string} a
+ * @param {string} b
+ * @returns {number | null}
+ */
+export function compareVersions(a, b) {
+  const pa = parseVersion(a);
+  const pb = parseVersion(b);
+  if (!pa || !pb) return null;
+  for (let i = 0; i < 3; i++) {
+    if (pa[i] !== pb[i]) return pa[i] > pb[i] ? 1 : -1;
+  }
+  return 0;
+}
+
+/**
+ * 判断当前安装形态，决定给什么升级建议。
+ *
+ * 三种情况：
+ *   · `dev`    —— 目录是 junction/symlink，或本身就是 git 仓库
+ *                 （开发模式：**绝不能**用升级命令覆盖源码）
+ *   · `npm`    —— 其余情况，按 npm 包给出命令
+ *
+ * 判断失败一律当 `dev`（保守：宁可让用户看到"请手动处理"，
+ * 也不要给一条会覆盖开发目录的命令）。
+ *
+ * @param {string} pluginRoot
+ * @returns {'dev' | 'npm'}
+ */
+export function detectInstallMode(pluginRoot) {
+  try {
+    // ① 自身或父目录是 git 仓库 → 源码安装
+    let dir = pluginRoot;
+    for (let i = 0; i < 6; i++) {
+      try {
+        readFileSync(join(dir, '.git', 'HEAD'));
+        return 'dev';
+      } catch { /* 继续往上 */ }
+      const parent = join(dir, '..');
+      if (parent === dir) break;
+      dir = parent;
+    }
+  } catch { /* ignore */ }
+
+  try {
+    // ② 真实路径与自身不同 → junction / symlink
+    const real = realpathSync(pluginRoot);
+    if (real && real !== pluginRoot) return 'dev';
+  } catch { /* 拿不到就当 npm */ }
+
+  return 'npm';
+}
+
+/**
+ * 从 npm registry 取最新版本。
+ *
+ * @param {Function} doFetch
+ * @returns {Promise<{ok:boolean, version?:string, error?:string}>}
+ */
+async function fetchFromNpm(doFetch) {
+  try {
+    const res = await doFetch(NPM_REGISTRY_URL, { cache: 'no-store' });
+    if (!res || !res.ok) return { ok: false, error: `npm-http-${res ? res.status : 'none'}` };
+    const doc = await res.json();
+    const v = doc && doc['dist-tags'] ? doc['dist-tags'].latest : '';
+    if (!v) return { ok: false, error: 'npm-no-latest-tag' };
+    return { ok: true, version: String(v) };
+  } catch (e) {
+    return { ok: false, error: `npm: ${(e && e.message) || e}` };
+  }
+}
+
+/**
+ * 从 GitHub main 的 package.json 取版本。
+ *
+ * @param {Function} doFetch
+ * @returns {Promise<{ok:boolean, version?:string, error?:string}>}
+ */
+async function fetchFromGithub(doFetch) {
+  try {
+    const res = await doFetch(GITHUB_RAW_PKG_URL, { cache: 'no-store' });
+    if (!res || !res.ok) return { ok: false, error: `gh-http-${res ? res.status : 'none'}` };
+    const doc = await res.json();
+    const v = doc && doc.version;
+    if (!v) return { ok: false, error: 'gh-no-version' };
+    return { ok: true, version: String(v) };
+  } catch (e) {
+    return { ok: false, error: `gh: ${(e && e.message) || e}` };
+  }
+}
+
+/** 带超时的 fetch 包装（超时不 abort 也没关系，只是不再等）。 */
+function withTimeout(doFetch, ms) {
+  return (url, opts) => Promise.race([
+    doFetch(url, opts),
+    new Promise((_, reject) => {
+      const t = setTimeout(() => reject(new Error('timeout')), ms);
+      if (t && typeof t.unref === 'function') t.unref();
+    }),
+  ]);
+}
+
+/**
+ * 给某个安装形态的升级指引。
+ *
+ * ⚠️ profile 名无法可靠得知，所以命令里用占位符并说明要替换。
+ * 不要假装知道用户装在哪。
+ *
+ * @param {'dev' | 'npm'} mode
+ * @returns {{ command: string, note: string }}
+ */
+export function upgradeHint(mode) {
+  if (mode === 'dev') {
+    return {
+      command: '',
+      note: '检测到源码/链接安装（开发模式）。请直接更新源码目录后重启 DSH —— '
+        + '**不要**用插件升级命令，那会覆盖你的源码。',
+    };
+  }
+  return {
+    command: 'dsh plugin --profile <你的 profile> update dsh-notify-say',
+    note: '把 <你的 profile> 换成实际名称（常见是 desktop）。'
+      + '更新后需要重启对应的 DSH profile 才会完整生效。',
+  };
+}
+
+/**
+ * 检查更新。
+ *
+ * @param {object} opts
+ * @param {string} opts.pluginRoot
+ * @param {boolean} [opts.force] 绕过缓存（用户手动点「检查更新」）
+ * @param {Function} [opts.fetchImpl]
+ * @param {object} [opts.cache] 宿主持有的缓存对象（`{ at, result }`）
+ * @param {number} [opts.now]
+ * @returns {Promise<object>} 结构化结果，**永不抛异常**
+ */
+export async function checkForUpdate(opts = {}) {
+  const pluginRoot = opts.pluginRoot || '';
+  const now = Number.isFinite(opts.now) ? opts.now : Date.now();
+  const current = currentVersion(pluginRoot);
+  const mode = detectInstallMode(pluginRoot);
+
+  const base = {
+    current,
+    installMode: mode,
+    changelogUrl: CHANGELOG_URL,
+    ...upgradeHint(mode),
+  };
+
+  // 缓存命中（未强制刷新且未过期）
+  const cache = opts.cache;
+  if (!opts.force && cache && cache.at && cache.result
+      && (now - cache.at) < AUTO_CHECK_TTL_MS) {
+    return { ...cache.result, cached: true, checkedAt: cache.at };
+  }
+
+  const doFetch = typeof (opts.fetchImpl || globalThis.fetch) === 'function'
+    ? (opts.fetchImpl || globalThis.fetch)
+    : null;
+  if (!doFetch) {
+    return { ok: false, ...base, error: 'fetch-unavailable', cached: false, checkedAt: now };
+  }
+
+  const timed = withTimeout(doFetch, opts.timeoutMs || FETCH_TIMEOUT_MS);
+
+  // 先 npm，失败回退 GitHub
+  let r = await fetchFromNpm(timed);
+  let source = 'npm';
+  if (!r.ok) {
+    const r2 = await fetchFromGithub(timed);
+    if (r2.ok) { r = r2; source = 'github'; }
+    else {
+      // 两个都失败：明确报告，但**不影响插件任何功能**
+      const result = {
+        ok: false,
+        ...base,
+        error: `npm(${r.error}) / github(${r2.error})`,
+        cached: false,
+        checkedAt: now,
+      };
+      if (cache) { cache.at = now; cache.result = result; }
+      return result;
+    }
+  }
+
+  const cmp = compareVersions(r.version, current);
+  const result = {
+    ok: true,
+    ...base,
+    latest: r.version,
+    // 解析不出（比如本地是 0.0.0-stage）时不下"有新版"的结论
+    hasUpdate: cmp === null ? null : cmp < 0,
+    source,
+    cached: false,
+    checkedAt: now,
+  };
+
+  if (cache) { cache.at = now; cache.result = result; }
+  return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "dsh-notify-say",
-    "version":  "0.4.46",
+    "version":  "0.4.48",
     "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/client-contract.test.mjs

@@ -329,4 +329,60 @@ test('C42: 点遮罩外部可取消，点卡片内部不取消', () => {
     '应区分"点遮罩"与"点卡片内部" —— 否则点卡片任意位置都会关掉弹窗');
   assert.match(seg, /cancelTerms\(\)/,
     '点外部应取消');
+});
+// ── C43: set() 里的状态字段必须来自它自己的参数 ─────────────────────────
+test('C43: 状态字段引用必须用 set() 自己的参数，不得用外层变量', () => {
+  // ⚠️ 2026-10-18 真实 bug（外部审阅发现）：
+  //
+  //   pickCustomFile().then(function (p) {      // p 是文件路径字符串
+  //     set(function (prev) {                   // 状态参数叫 prev
+  //       return { ..., packs: p.packs, ... }   // ← 用错的变量！
+  //     })
+  //   })
+  //
+  // `p` 是路径字符串（取消时是空串），`p.packs` 恒为 undefined →
+  // 用户取消选择自定义音频后，**已加载的语音包状态被清掉**。
+  //
+  // 这类"状态字段遗漏/用错变量"已经出现 4 次（advOpen / packs /
+  // termsAck / 这次的 p.packs）。所以用静态扫描固定住，而不是靠人记得。
+  const lines = client.split(/\r?\n/);
+  const FIELDS = ['loaded', 'values', 'advOpen', 'packs', 'termsAck', 'termsPending', 'busy', 'msg', 'err'];
+
+  // 允许引用非状态参数的对象：它们是**接口响应**，恰好也有同名字段。
+  //   r    —— saveConfig 的返回值（含 values）
+  //   doc  —— fetchVoicePacks 的返回值（含 packs）
+  const ALLOW = new Set(['r', 'doc']);
+
+  const bad = [];
+  for (let i = 0; i < lines.length; i++) {
+    const m = lines[i].match(/set\(function \((\w+)\) \{/);
+    if (!m) continue;
+    const param = m[1];
+
+    // 取该 set 的块
+    let depth = 0, started = false, end = i;
+    for (let j = i; j < Math.min(i + 30, lines.length); j++) {
+      for (const ch of lines[j]) {
+        if (ch === '{') { depth++; started = true; }
+        else if (ch === '}') { depth--; }
+      }
+      if (started && depth === 0) { end = j; break; }
+    }
+    const block = lines.slice(i, end + 1).join('\n');
+
+    for (const f of FIELDS) {
+      const re = new RegExp(`([A-Za-z_$][\\w$]*)\\.${f}\\b`, 'g');
+      let mm;
+      while ((mm = re.exec(block)) !== null) {
+        const ident = mm[1];
+        if (ident === param || ALLOW.has(ident)) continue;
+        bad.push(`L${i + 1}: 参数=${param} 但用了 ${mm[0]}`);
+      }
+    }
+  }
+
+  assert.deepEqual(bad, [],
+    '这些 set() 引用了不属于它自己状态参数的字段 —— '
+    + '典型后果是把已加载的状态清成 undefined（语音包列表消失等）。\n'
+    + bad.join('\n'));
 });