dsh-notify-say 0.4.21 → 0.4.25

package/test/idle-gate.test.mjs

@@ -0,0 +1,167 @@
+/**
+ * dsh-notify-desktop 空闲门（idle gate）单元测试。
+ *
+ * 覆盖 v0.3.0 引入的三个纯函数与关键判定：
+ *  - reasonKindOf：turn/end 的 reason.kind 取值（对象 / 字符串 / 缺失）
+ *  - isDescendantOf：子代理后代判定（含 sessions.fork 分叉会话**不得**误判为后代）
+ *  - collectInFlight：两路在飞工作汇总（jobs + agents），缺一不可
+ *
+ * 为什么这些断言是 exact 而非宽松：判定协议（空闲门）的语义漂移会让"误报完成"
+ * 这个原始缺陷复发，而宽松断言会把漂移伪装成绿灯。故每条都断言精确结果。
+ *
+ * 运行：node --test tools/plugins/dsh-notify-desktop/test/idle-gate.test.mjs
+ */
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+
+import { reasonKindOf, isDescendantOf, collectInFlight } from '../lib/index.js';
+
+/** 造一个最小 agent 替身（只含判定用到的字段）。 */
+function mkAgent(id, { origin, parentSession, status = 'idle' } = {}) {
+  return {
+    id,
+    status,
+    session: { id, header: { id, origin, parentSession } },
+  };
+}
+
+// ── reasonKindOf ─────────────────────────────────────────────────────────
+test('reasonKindOf: 对象形态取 kind', () => {
+  assert.equal(reasonKindOf({ reason: { kind: 'completed' } }), 'completed');
+  assert.equal(reasonKindOf({ reason: { kind: 'error' } }), 'error');
+  assert.equal(reasonKindOf({ reason: { kind: 'aborted' } }), 'aborted');
+});
+
+test('reasonKindOf: 字符串形态向前兼容', () => {
+  assert.equal(reasonKindOf({ reason: 'completed' }), 'completed');
+});
+
+test('reasonKindOf: 缺失/畸形一律空串（不抛）', () => {
+  assert.equal(reasonKindOf(undefined), '');
+  assert.equal(reasonKindOf({}), '');
+  assert.equal(reasonKindOf({ reason: {} }), '');
+  assert.equal(reasonKindOf({ reason: null }), '');
+});
+
+// ── isDescendantOf：子代理后代判定 ────────────────────────────────────────
+test('isDescendantOf: 直接子代理（origin=subagent, parentSession=root）→ true', () => {
+  const root = mkAgent('root-1');
+  const child = mkAgent('child-1', { origin: 'subagent', parentSession: 'root-1' });
+  const byId = new Map([['root-1', root], ['child-1', child]]);
+  assert.equal(isDescendantOf(child, 'root-1', byId), true);
+});
+
+test('isDescendantOf: 孙代子代理（多跳）→ true', () => {
+  const root = mkAgent('root-1');
+  const child = mkAgent('child-1', { origin: 'subagent', parentSession: 'root-1' });
+  const grand = mkAgent('grand-1', { origin: 'subagent', parentSession: 'child-1' });
+  const byId = new Map([['root-1', root], ['child-1', child], ['grand-1', grand]]);
+  assert.equal(isDescendantOf(grand, 'root-1', byId), true);
+});
+
+test('isDescendantOf: 分叉会话（有 parentSession 但 origin 为空）→ false', () => {
+  // 这是关键负例：sessions.fork 的分叉会话 header 也带 parentSession，
+  // 但它是用户自己的顶层会话。误判为后代会让主会话完成通知被拖住。
+  const root = mkAgent('root-1');
+  const forked = mkAgent('fork-1', { parentSession: 'root-1' });
+  const byId = new Map([['root-1', root], ['fork-1', forked]]);
+  assert.equal(isDescendantOf(forked, 'root-1', byId), false);
+});
+
+test('isDescendantOf: 无关顶层会话 → false', () => {
+  const other = mkAgent('other-1');
+  const byId = new Map([['other-1', other]]);
+  assert.equal(isDescendantOf(other, 'root-1', byId), false);
+});
+
+test('isDescendantOf: 链上祖先已不在注册表 → false（不臆断）', () => {
+  const child = mkAgent('child-1', { origin: 'subagent', parentSession: 'gone-1' });
+  const byId = new Map([['child-1', child]]);
+  assert.equal(isDescendantOf(child, 'root-1', byId), false);
+});
+
+test('isDescendantOf: 畸形输入不抛，返回 false', () => {
+  assert.equal(isDescendantOf(null, 'root-1', new Map()), false);
+  assert.equal(isDescendantOf({}, 'root-1', new Map()), false);
+  assert.equal(isDescendantOf(mkAgent('x'), 'root-1', null), false);
+});
+
+// ── collectInFlight：两路在飞汇总 ─────────────────────────────────────────
+test('collectInFlight: 全部空闲 → 空数组（可播报）', () => {
+  const root = mkAgent('root-1');
+  assert.deepEqual(collectInFlight([], [root], 'root-1'), []);
+});
+
+test('collectInFlight: running 的后台任务算在飞', () => {
+  const root = mkAgent('root-1');
+  const jobs = [{ id: 'bash-1', label: 'sleep 100', status: 'running' }];
+  const items = collectInFlight(jobs, [root], 'root-1');
+  assert.equal(items.length, 1);
+  assert.equal(items[0].kind, 'job');
+  assert.equal(items[0].id, 'bash-1');
+});
+
+test('collectInFlight: stopping 也算在飞（尚未真正停止）', () => {
+  const root = mkAgent('root-1');
+  const jobs = [{ id: 'bash-2', label: 'x', status: 'stopping' }];
+  assert.equal(collectInFlight(jobs, [root], 'root-1').length, 1);
+});
+
+test('collectInFlight: 终态任务不算在飞', () => {
+  const root = mkAgent('root-1');
+  for (const status of ['completed', 'killed', 'failed']) {
+    const jobs = [{ id: 'bash-3', label: 'x', status }];
+    assert.equal(collectInFlight(jobs, [root], 'root-1').length, 0, `status=${status} 不应算在飞`);
+  }
+});
+
+test('collectInFlight: continuable 子代理不注册 job，只能靠 agents 一路发现', () => {
+  // 关键正例：这是本缺陷最容易漏掉的一路。
+  // dsh-base/cordis.patch.yml:354 的 subagent 工具默认 backgroundMode=continuable，
+  // 走 ctx.agents.create({parentAgent})，**不经过 jobs.start**。
+  const root = mkAgent('root-1', { status: 'idle' });
+  const child = mkAgent('child-1', { origin: 'subagent', parentSession: 'root-1', status: 'running' });
+  const items = collectInFlight([], [root, child], 'root-1');
+  assert.equal(items.length, 1);
+  assert.equal(items[0].kind, 'subagent');
+  assert.equal(items[0].id, 'child-1');
+});
+
+test('collectInFlight: 子代理已 idle 不算在飞', () => {
+  const root = mkAgent('root-1');
+  const child = mkAgent('child-1', { origin: 'subagent', parentSession: 'root-1', status: 'idle' });
+  assert.deepEqual(collectInFlight([], [root, child], 'root-1'), []);
+});
+
+test('collectInFlight: 主会话自身 running 不算"在飞子工作"', () => {
+  // 主会话正在跑是正常状态，不该被当作"需要等待的子工作"（否则永不播报）。
+  const root = mkAgent('root-1', { status: 'running' });
+  assert.deepEqual(collectInFlight([], [root], 'root-1'), []);
+});
+
+test('collectInFlight: 无关顶层会话 running 不影响本会话判定', () => {
+  const root = mkAgent('root-1');
+  const other = mkAgent('other-1', { status: 'running' });
+  assert.deepEqual(collectInFlight([], [root, other], 'root-1'), []);
+});
+
+test('collectInFlight: 分叉会话 running 不影响本会话判定（负例）', () => {
+  const root = mkAgent('root-1');
+  const forked = mkAgent('fork-1', { parentSession: 'root-1', status: 'running' });
+  assert.deepEqual(collectInFlight([], [root, forked], 'root-1'), []);
+});
+
+test('collectInFlight: 两路同时有在飞 → 都报出来', () => {
+  const root = mkAgent('root-1');
+  const child = mkAgent('child-1', { origin: 'subagent', parentSession: 'root-1', status: 'running' });
+  const jobs = [{ id: 'bash-9', label: 'y', status: 'running' }];
+  const items = collectInFlight(jobs, [root, child], 'root-1');
+  assert.equal(items.length, 2);
+  assert.deepEqual(items.map((i) => i.kind).sort(), ['job', 'subagent']);
+});
+
+test('collectInFlight: 畸形输入退化为空（fail-visible：宁可播报不静默）', () => {
+  assert.deepEqual(collectInFlight(null, null, 'root-1'), []);
+  assert.deepEqual(collectInFlight(undefined, undefined, 'root-1'), []);
+  assert.deepEqual(collectInFlight([null, undefined], [null, undefined], 'root-1'), []);
+});

package/test/preview.test.mjs

@@ -0,0 +1,92 @@
+/**
+ * 试听功能测试（v0.4.17）。
+ *
+ * ## 为什么要有试听
+ *
+ * 用户 2026-10-18 指出："是不是少了试听？"
+ *
+ * 对以下设置来说，试听是**必需品而不是锦上添花**：
+ *   · 音量增益（1.0~4.0）—— 光看数字根本不知道多响
+ *   · 发音人 / 音色        —— 名字看不出实际声音
+ *   · 自定义音频           —— 确认选对了文件
+ *   · 按事件覆盖           —— 确认每个事件的声音都对
+ *
+ * 没有试听就只能盲调，调一次听一次真实通知，效率极低。
+ *
+ * ## 与「测试通知」的区别（容易混淆，因此写死在这里）
+ *
+ *   试听     → 只出声，**不弹窗**（ps1 的 -Preview）
+ *   测试通知 → 完整 notify()，含 Toast 弹窗
+ */
+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 HOST = readFileSync(join(ROOT, 'lib', 'index.js'), 'utf8');
+const CLIENT = readFileSync(join(ROOT, 'lib', 'client.js'), 'utf8');
+const PS1 = readFileSync(join(ROOT, 'dsh-notify.ps1'), 'utf8');
+
+// ── P1: host 必须有 preview 端点 ─────────────────────────────────────────
+test('P1: host 注册了 /preview 试听端点', () => {
+  assert.match(HOST, /head === 'preview'/, 'host 应有 preview 分支');
+  // kind 参数用正则从查询串里解析（不写成字面量 '/preview?kind'）
+  const start = HOST.indexOf("head === 'preview'");
+  const seg = HOST.slice(start, start + 6000);  // 6KB：给限流与多音源分支留够窗口（v0.4.24 加限流后 3KB 不够）
+  assert.match(seg, /kind=\(\[a-z\]\+\)/, '应从查询串解析 kind 参数');
+});
+
+// ── P2: 试听必须走 -Preview（只出声不弹窗）───────────────────────────────
+test('P2: 试听调用 ps1 时带 -Preview（不弹 Toast）', () => {
+  // 找到 preview 分支的代码段，确认里面 push 了 '-Preview'
+  const start = HOST.indexOf("head === 'preview'");
+  assert.ok(start > 0, '应存在 preview 分支');
+  const seg = HOST.slice(start, start + 6000);  // 6KB：给限流与多音源分支留够窗口（v0.4.24 加限流后 3KB 不够）
+  assert.match(seg, /'-Preview'/, '试听必须传 -Preview，否则会弹窗');
+  // 而且不应在 preview 分支里调用 notify()（那会弹窗）
+  assert.doesNotMatch(seg, /\bnotify\(/, 'preview 分支不该调用 notify()（会弹 Toast）');
+});
+
+// ── P3: 试听要遵循当前音源（tts/bundled/system/custom）────────────────────
+test('P3: 试听按当前音源分流（不是无脑播语音包）', () => {
+  const start = HOST.indexOf("head === 'preview'");
+  const seg = HOST.slice(start, start + 6000);  // 6KB：给限流与多音源分支留够窗口（v0.4.24 加限流后 3KB 不够）
+  for (const src of ['tts', 'bundled', 'custom', 'system']) {
+    assert.ok(seg.includes(`'${src}'`), `试听应处理 ${src} 音源`);
+  }
+});
+
+// ── P4: 试听要带上增益（否则调增益时听不出差别）──────────────────────────
+test('P4: 试听应用 voiceGain（调增益后能听出差别）', () => {
+  const start = HOST.indexOf("head === 'preview'");
+  const seg = HOST.slice(start, start + 6000);  // 6KB：给限流与多音源分支留够窗口（v0.4.24 加限流后 3KB 不够）
+  assert.match(seg, /-Gain/, '试听必须带 -Gain，否则调增益时听不到变化');
+  assert.match(seg, /voiceGain/, '应从配置读 voiceGain');
+});
+
+// ── P5: client 必须有试听按钮 ───────────────────────────────────────────
+test('P5: GUI 提供试听按钮', () => {
+  assert.match(CLIENT, /function previewSound\(/, 'client 应有 previewSound 函数');
+  assert.match(CLIENT, /'试听'|试听/, 'GUI 应有试听按钮文案');
+  assert.match(CLIENT, /preview\?kind=/, '应请求 preview 端点');
+});
+
+// ── P6: 五种事件都能单独试听 ────────────────────────────────────────────
+test('P6: 五种事件都能单独试听', () => {
+  for (const k of ['done', 'fail', 'question', 'approval', 'blocked']) {
+    assert.ok(CLIENT.includes(`['${k}',`) || CLIENT.includes(`'${k}'`),
+      `应支持试听 ${k}`);
+  }
+});
+
+// ── P7: ps1 的 -Preview 不弹窗（实现保证）────────────────────────────────
+test('P7: ps1 在 -Preview 模式下不弹 Toast', () => {
+  // ps1 里 Preview 分支应只调 Play-VoiceLine，不调 Toast 展示
+  const idx = PS1.indexOf('if ($Preview)');
+  assert.ok(idx > 0, 'ps1 应有 $Preview 分支');
+  const seg = PS1.slice(idx, idx + 800);
+  assert.match(seg, /Play-VoiceLine|试听/, 'Preview 分支应播放声音');
+  assert.doesNotMatch(seg, /Show-Balloon|Toast\(/, 'Preview 分支不该弹窗');
+});

package/test/real-cordis.test.mjs

@@ -0,0 +1,204 @@
+/**
+ * dsh-notify-desktop 空闲门「真实 Cordis 接线」测试。
+ *
+ * 为什么需要这个文件（补 wiring.test.mjs 的洞）：
+ * `wiring.test.mjs` 用的是**自造 ctx 替身**，它的 `get(name)` 忽略第二个参数——
+ * 所以那套测试**无法证明** `ctx.get(name, false)`（非 strict 取服务）在真实 Cordis
+ * 上真的能拿到服务。如果真实 Cordis 语义不同，空闲门会静默失效（永不挂起 =
+ * 本缺陷原样复发），而替身测试**照样全绿**——这是典型的"假绿"。
+ *
+ * 本文件用**宿主自带的真实 @deepseek-ai/cordis**（4.0.2）加载本插件：
+ *  - 真实 Context/Service/effect/事件系统；
+ *  - 真实 `ctx.get`（含 2 参非 strict）语义；
+ *  - 真实 `ctx.on(..., { global: true })` 是否能注册成功。
+ * 只把**外部副作用**（spawn 子进程）隔离掉：SystemRoot 指向不存在路径。
+ *
+ * 运行：node --test tools/plugins/dsh-notify-desktop/test/
+ */
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { createRequire } from 'node:module';
+import { pathToFileURL } from 'node:url';
+// ⚠️ 必须在 import lib/index.js **之前**把 DSH_HOME 指到空目录。
+//
+// 插件启动时会读 `$DSH_HOME/storages/dsh-notify-desktop/config.json` 作为
+// 「运行时覆盖层」，其优先级**高于** apply() 传入的 config。若用真实 DSH_HOME，
+// 用户只要在 GUI 里改过任何一项（实测：把 notifyOnAborted 打开），
+// 那些假定默认值的用例就会红——那是用户配置导致的，不是代码缺陷。
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+const ISOLATED_HOME = mkdtempSync(join(tmpdir(), 'notify-test-home-'));
+process.env.DSH_HOME = ISOLATED_HOME;
+process.on('exit', () => { try { rmSync(ISOLATED_HOME, { recursive: true, force: true }); } catch { /* best effort */ } });
+
+// 必须在 import 插件之前设置：插件模块顶层读 SystemRoot 算 POWERSHELL_EXE。
+process.env.SystemRoot = 'Z:\\__no_such_root__';
+
+const { apply } = await import('../lib/index.js');
+
+/**
+ * 定位宿主自带的真实 cordis。找不到就**跳过**（不静默通过）：
+ * 该依赖是宿主的、不在插件包内，换机器可能不存在。
+ *
+ * ⚠️ Windows 上动态 import 绝对路径必须先转 `file://` URL，否则报
+ * `ERR_UNSUPPORTED_ESM_URL_SCHEME`（Received protocol 'd:'）——实测踩过。
+ */
+function loadRealCordis() {
+  const candidates = [
+    process.env.DSH_CORDIS_ENTRY || '',   // CI/其他机器可指定
+    'D:\\Program Files (x86)\\DSH\\.runtime\\node_modules\\@deepseek-ai\\cordis\\lib\\index.js',
+  ];
+  const req = createRequire(import.meta.url);
+  for (const p of candidates) {
+    // 显式设了 DSH_CORDIS_ENTRY 就只用它 —— 便于模拟"没有宿主"的 CI 环境
+    if (process.env.DSH_CORDIS_ENTRY) {
+      const only = process.env.DSH_CORDIS_ENTRY;
+      try { req.resolve(only); return pathToFileURL(only).href; } catch { return undefined; }
+    }
+    if (!p) continue;
+    try {
+      req.resolve(p);
+      return pathToFileURL(p).href;
+    } catch { /* 试下一个 */ }
+  }
+  return undefined;
+}
+
+const REAL_CORDIS = loadRealCordis();
+
+/** 捕获插件日志。 */
+function captureLogs() {
+  const lines = [];
+  const origLog = console.log;
+  const origWarn = console.warn;
+  console.log = (...a) => { lines.push(a.join(' ')); };
+  console.warn = (...a) => { lines.push(a.join(' ')); };
+  return {
+    lines,
+    restore() { console.log = origLog; console.warn = origWarn; },
+    get text() { return lines.join('\n'); },
+  };
+}
+
+function mkAgent(id, { origin, parentSession, status = 'idle' } = {}) {
+  return { id, status, session: { id, header: { id, origin, parentSession } } };
+}
+
+test('真实 Cordis：ctx.get(name, false) 确实能取到非 strict 提供的服务', { skip: !REAL_CORDIS && '未找到宿主 cordis（跳过，不算通过）' }, async () => {
+  const { Context, Service } = await import(REAL_CORDIS);
+  const root = new Context();
+
+  // 用真实 Service 子类注册一个 'jobs'，模拟宿主提供方式。
+  class FakeJobs extends Service {
+    constructor(ctx) { super(ctx, 'jobs'); }
+    list() { return []; }
+    onJobsChanged() { return () => {}; }
+  }
+
+  // 关键：在**已就绪**的 fiber 上提供，然后分别用 strict / non-strict 读。
+  let provided = false;
+  root.plugin((ctx) => {
+    new FakeJobs(ctx);
+    provided = true;
+  });
+  await new Promise((r) => setTimeout(r, 30));
+  assert.equal(provided, true, '前置：服务应已提供');
+
+  const strictHit = root.get('jobs');
+  const looseHit = root.get('jobs', false);
+  assert.ok(looseHit, 'ctx.get("jobs", false) 必须能取到服务（空闲门依赖此语义）');
+  assert.ok(strictHit, 'ctx.get("jobs") strict 也应取到（fiber 已 active）');
+  assert.equal(typeof looseHit.list, 'function', '取到的服务应可用');
+});
+
+test('真实 Cordis：未提供时 ctx.get(name, false) 返回 undefined 而不是抛错', { skip: !REAL_CORDIS && '未找到宿主 cordis（跳过，不算通过）' }, async () => {
+  const { Context } = await import(REAL_CORDIS);
+  const root = new Context();
+  let threw = false;
+  let val;
+  try { val = root.get('definitely-not-provided', false); } catch { threw = true; }
+  assert.equal(threw, false, '读未提供的服务不应抛（空闲门靠这个退化）');
+  assert.equal(val, undefined, '未提供应为 undefined');
+});
+
+test('真实 Cordis：插件能在真实 ctx 上加载，注册三个事件处理器且不抛', { skip: !REAL_CORDIS && '未找到宿主 cordis（跳过，不算通过）' }, async () => {
+  const { Context } = await import(REAL_CORDIS);
+  const root = new Context();
+  const logs = captureLogs();
+  let loaded = false;
+  let failure;
+  try {
+    root.plugin((ctx) => { apply(ctx, { idleGate: true }); loaded = true; });
+    await new Promise((r) => setTimeout(r, 40));
+  } catch (e) {
+    failure = e;
+  } finally {
+    logs.restore();
+  }
+  assert.equal(failure, undefined, 'apply 不应抛：' + (failure && failure.message));
+  assert.equal(loaded, true, '插件应加载成功');
+  // 未提供 jobs/agents 时应走退化路径，而不是崩
+  assert.doesNotMatch(logs.text, /idle-gate: 挂起完成播报/, '无服务时不应挂起（退化为立即播报）');
+});
+
+test('真实 Cordis：空闲门端到端——真实服务下，子代理 running 时挂起', { skip: !REAL_CORDIS && '未找到宿主 cordis（跳过，不算通过）' }, async () => {
+  const { Context, Service } = await import(REAL_CORDIS);
+  const root = new Context();
+
+  const main = mkAgent('main-1', { status: 'idle' });
+  const child = mkAgent('child-1', { origin: 'subagent', parentSession: 'main-1', status: 'running' });
+  const liveAgents = [main, child];
+
+  // 用真实 Service 注册 agents / jobs，验证插件通过 ctx.get 真能拿到。
+  class FakeAgents extends Service {
+    constructor(ctx) { super(ctx, 'agents'); }
+    list() { return liveAgents; }
+    get(id) { return liveAgents.find((a) => a.id === id); }
+  }
+  class FakeJobs2 extends Service {
+    constructor(ctx) { super(ctx, 'jobs'); }
+    list() { return []; }
+    onJobsChanged() { return () => {}; }
+  }
+
+  let ctxRef;
+  root.plugin((ctx) => {
+    new FakeAgents(ctx);
+    new FakeJobs2(ctx);
+    ctxRef = ctx;
+    apply(ctx, { idleGate: true });
+  });
+  await new Promise((r) => setTimeout(r, 40));
+  assert.ok(ctxRef, '前置：插件应已加载');
+
+  const logs = captureLogs();
+  try {
+    // 真实事件分发：session/event + agent/status
+    ctxRef.emit('session/event', main.session, { type: 'turn/end', data: { turn: 1, reason: { kind: 'completed' } } });
+    ctxRef.emit('agent/status', { agent: main, status: 'running' });
+    ctxRef.emit('agent/status', { agent: main, status: 'idle' });
+    assert.match(
+      logs.text,
+      /idle-gate: 挂起完成播报/,
+      '真实 Cordis 下，子代理 running 时**必须**挂起——若这里失败，说明 ctx.get(name,false) 语义不符，空闲门会失效',
+    );
+  } finally {
+    logs.restore();
+  }
+});
+
+test('真实 Cordis：ctx.effect 的 disposer 真能被调用（卸载清理路径）', { skip: !REAL_CORDIS && '未找到宿主 cordis（跳过，不算通过）' }, async () => {
+  const { Context } = await import(REAL_CORDIS);
+  const root = new Context();
+  let disposed = false;
+  // ctx.plugin 返回 fiber；卸载走 fiber.dispose()（不是 root.stop()——那不存在，实测踩过）。
+  const fiber = root.plugin((ctx) => {
+    ctx.effect(() => () => { disposed = true; }, 'test-effect');
+  });
+  await fiber;
+  assert.equal(disposed, false, '前置：未卸载前不应清理');
+  await fiber.dispose();
+  await new Promise((r) => setTimeout(r, 30));
+  assert.equal(disposed, true, '卸载时应调用 effect disposer（清挂起计时器靠它）');
+});

package/test/release-voice-guard.test.mjs

@@ -0,0 +1,185 @@
+/**
+ * 发布包「个人声音样本」防护测试（v0.4.21）。
+ *
+ * ## 为什么这条测试必须存在
+ *
+ * `sounds/voice-lines/my-voice-*.wav` 是作者本人的声音样本。
+ * 它们只用于本地自用。**一旦进发布包就等于把个人生物特征公开分发，
+ * 而且不可撤回**（推上 GitHub / npm 后无法真正删除）。
+ *
+ * 原有的筛选只靠 `-VoiceKey` 参数，而 `-KeepAllVoices` 会绕过它。
+ * 也就是说：任何人为了"打个全量包"加上那个开关，个人声音就会漏出去。
+ *
+ * 所以 `release-build.ps1` 里加了**前缀黑名单**，优先于一切参数。
+ * 这条测试锁住该行为。
+ *
+ * ## 测试策略
+ *
+ * 真跑 `release-build.ps1`（不是读源码字符串），
+ * 用两种最危险的参数组合验证输出目录里没有 my-voice 文件。
+ * 这样即使将来重写了筛选逻辑，只要行为对就通过；
+ * 行为一旦回退，立刻变红。
+ */
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdtempSync, readdirSync, statSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const BUILDER = join(ROOT, 'tools', 'release-build.ps1');
+
+/** 递归找匹配的文件（不引第三方库）。 */
+function findFiles(dir, predicate, out = []) {
+  if (!existsSync(dir)) return out;
+  for (const name of readdirSync(dir)) {
+    const full = join(dir, name);
+    let st;
+    try { st = statSync(full); } catch { continue; }
+    if (st.isDirectory()) findFiles(full, predicate, out);
+    else if (predicate(name)) out.push(full);
+  }
+  return out;
+}
+
+/**
+ * 只找**音频/语音文件**里的被禁音色。
+ *
+ * ⚠️ 不能对所有文件名做前缀匹配：审核文档快照（docs/audio-audit/snapshots/
+ * mochiko.txt）和测试文件本身**就应该**包含这些名字 —— 它们是"为什么禁"
+ * 的证据。原来的判据把它们也算成泄漏，属于假阳性。
+ *
+ * 真正要拦的是：这些音色的 **wav / mp3** 是否进包。
+ */
+function findBannedAudio(dir, voiceKey) {
+  return findFiles(dir, (n) => {
+    if (!/\.(wav|mp3|m4a|ogg|flac)$/i.test(n)) return false;
+    return n.toLowerCase().startsWith(voiceKey.toLowerCase());
+  });
+}
+/** 跑一次发布包构建，返回目标目录。 */
+function buildRelease(extraArgs) {
+  const dest = mkdtempSync(join(tmpdir(), 'rel-guard-'));
+  execFileSync('powershell.exe', [
+    '-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', BUILDER,
+    '-Destination', dest, '-Force', ...extraArgs,
+  ], { encoding: 'utf8', timeout: 300_000 });
+  return dest;
+}
+
+// ── P1: 默认参数下不包含个人声音 ────────────────────────────────────────
+test('P1: 默认参数构建的发布包不含 my-voice 文件', () => {
+  if (!existsSync(BUILDER)) return;
+  const dest = buildRelease([]);
+  const leaked = findBannedAudio(dest, 'my-voice');
+  assert.deepEqual(leaked, [],
+    '个人声音样本绝不能进发布包 —— 这是不可撤回的隐私泄漏：\n  '
+    + leaked.join('\n  '));
+});
+
+// ── P2: -KeepAllVoices 也必须挡住（关键：原实现会漏）────────────────────
+test('P2: -KeepAllVoices 也无法带出 my-voice（黑名单优先于一切参数）', () => {
+  if (!existsSync(BUILDER)) return;
+  const dest = buildRelease(['-KeepAllVoices']);
+  const leaked = findBannedAudio(dest, 'my-voice');
+  assert.deepEqual(leaked, [],
+    '-KeepAllVoices 会绕过 -VoiceKey 筛选，黑名单必须优先于它才能挡住：\n  '
+    + leaked.join('\n  '));
+});
+
+// ── P3: 防护不能误伤其它音色 ────────────────────────────────────────────
+test('P3: 防护只挡 my-voice，其它音色照常保留', () => {
+  if (!existsSync(BUILDER)) return;
+  const dest = buildRelease(['-KeepAllVoices']);
+  const wavs = findFiles(dest, (n) => n.toLowerCase().endsWith('.wav'));
+  const others = wavs.filter((f) => !/^my-voice/i.test(f.split(/[\\/]/).pop()));
+  assert.ok(others.length > 100,
+    `-KeepAllVoices 应保留其它全部音色，实际只有 ${others.length} 个 —— 防护可能误伤过广`);
+});
+
+// ── P4: 源码里必须有这道防护的声明 ──────────────────────────────────────
+test('P4: release-build.ps1 里有明确的 NeverShip 黑名单', () => {
+  if (!existsSync(BUILDER)) return;
+  const src = execFileSync('powershell.exe', [
+    '-NoProfile', '-Command',
+    `Get-Content -LiteralPath '${BUILDER.replace(/'/g, "''")}' -Raw`,
+  ], { encoding: 'utf8' });
+  assert.match(src, /NeverShipVoicePrefixes/,
+    '必须有显式黑名单变量，便于将来审计与修改');
+  assert.match(src, /Test-VoiceNeverShip/,
+    '必须有判断函数，且它要在 KeepAllVoices 之前生效');
+});
+
+// ── P5: mochiko 必须被阻断（许可明确禁止再分发）──────────────────────────
+test('P5: mochiko 不进发布包（官方规约禁止无偿配发音声素材）', () => {
+  if (!existsSync(BUILDER)) return;
+  const dest = buildRelease(['-KeepAllVoices']);
+  const leaked = findBannedAudio(dest, 'mochiko');
+  assert.deepEqual(leaked, [],
+    'もち子さん 的官方规约第 1 项禁止「出力した合成音声を使用した音声素材を無償配布」，'
+    + '我们的免费提醒包正落在该禁令内：\n  ' + leaked.join('\n  '));
+});
+
+// ── P6: Mixkit mp3 不得重新出现（许可禁止再分发素材本身）─────────────────
+test('P6: 发布包不含任何 .mp3（Mixkit 已移除，且禁止再分发）', () => {
+  if (!existsSync(BUILDER)) return;
+  const dest = buildRelease(['-KeepAllVoices']);
+  const mp3 = findFiles(dest, (n) => n.toLowerCase().endsWith('.mp3'));
+  assert.deepEqual(mp3, [],
+    'Mixkit 许可禁止"redistribute the Item on its own... or with source files"，'
+    + '这些 mp3 不应再随包分发：\n  ' + mp3.join('\n  '));
+});
+
+// ── P7: npm files 白名单必须包含第三方声明 ──────────────────────────────
+test('P7: 发布包 package.json 的 files 含 THIRD-PARTY-NOTICES.md', async () => {
+  if (!existsSync(BUILDER)) return;
+  const dest = buildRelease([]);
+  const pkgPath = join(dest, 'package.json');
+  if (!existsSync(pkgPath)) return;
+  const pkg = JSON.parse(execFileSync('powershell.exe', [
+    '-NoProfile', '-Command',
+    `Get-Content -LiteralPath '${pkgPath.replace(/'/g, "''")}' -Raw`,
+  ], { encoding: 'utf8' }));
+  assert.ok(Array.isArray(pkg.files), '应有 files 白名单');
+  assert.ok(pkg.files.includes('THIRD-PARTY-NOTICES.md'),
+    'npm 只打包 files 白名单里的路径；漏了第三方声明等于用户拿不到它 —— '
+    + '这正是 2026-10-18 外部审阅发现的问题');
+});
+// ── P8: kasukabe-tsumugi 必须阻断（规约禁止「二次配布」）────────────────
+test('P8: kasukabe-tsumugi 不进发布包（官方规约禁止二次配布）', () => {
+  if (!existsSync(BUILDER)) return;
+  const dest = buildRelease(['-KeepAllVoices']);
+  const leaked = findBannedAudio(dest, 'kasukabe-tsumugi');
+  assert.deepEqual(leaked, [],
+    '春日部つむぎ 官方规约第 6 条禁止事项明确列出「二次配布、自作発言」，'
+    + '我们的 ZIP 分发正属该禁令范围（2026-10-18 读原文发现，此前只当"条件保留"）：\n  '
+    + leaked.join('\n  '));
+});
+
+// ── P9: yurei-chan 必须阻断（身份未确认）────────────────────────────────
+test('P9: yurei-chan 不进发布包（角色身份未确认）', () => {
+  if (!existsSync(BUILDER)) return;
+  const dest = buildRelease(['-KeepAllVoices']);
+  const leaked = findBannedAudio(dest, 'yurei-chan');
+  assert.deepEqual(leaked, [],
+    'ユーレイちゃん(U-Stella) 与 夜語トバリ 是不同权利人，'
+    + '文件名无法证明实际用的是哪个；确认前不应分发：\n  ' + leaked.join('\n  '));
+});
+
+// ── P10: 审核记录必须存在且列明结论 ─────────────────────────────────────
+test('P10: docs/audio-audit/README.md 存在并包含三类判定', async () => {
+  const audit = join(ROOT, 'docs', 'audio-audit', 'README.md');
+  if (!existsSync(audit)) return;
+  const { readFileSync } = await import('node:fs');
+  const md = readFileSync(audit, 'utf8');
+  for (const marker of ['FORBIDDEN', 'CONDITIONAL', 'PENDING']) {
+    assert.match(md, new RegExp(marker),
+      `审核记录必须用 ${marker} 标注状态，便于机器与人工共同复核`);
+  }
+  assert.match(md, /kasukabe-tsumugi/,
+    '必须记录 kasukabe-tsumugi 的二次配布禁令——这是读原文才发现的');
+  assert.match(md, /二次配布/,
+    '必须引用官方原文关键词，而非只写结论');
+});