@memef1f1y/dsh-plugin-tts 0.6.4 → 0.6.7

package/tests/e2e-real-rvc.mjs

@@ -1,122 +1,122 @@
-// One-off real end-to-end: plugin Host -> real rvc-server (azusa-test) chain.
-//
-// [DEPRECATED in favor of tests/rvc-server-live.mjs] This one-off test hardcodes
-// Windows paths (E:/AI/.../azusa-test.pth) and is not portable. The standard,
-// environment-aware live scenario + boundary suite is `tests/rvc-server-live.mjs`
-// (npm run test:live). This file is kept for Windows reference only.
-
-// Verifies Edge base synth + real RVC conversion + audio route serving.
-import * as plugin from '../lib/index.mjs';
-
-const routes = [];
-const ctx = {
-  get(name) {
-    if (name === 'webServer') {
-      return {
-        register(route) {
-          routes.push(route);
-          return () => {
-            const i = routes.indexOf(route);
-            if (i >= 0) routes.splice(i, 1);
-          };
-        }
-      };
-    }
-    return undefined;
-  },
-  effect() {}
-};
-plugin.apply(ctx);
-
-const speakRoute = routes.find((r) => r.kind === 'exact' && r.path === '/dsh-tts-api/speak');
-const audioRoute = routes.find((r) => r.kind === 'prefix' && r.path === '/dsh-tts-audio');
-
-function mockReq(url, body) {
-  const chunks = body === undefined ? [] : [body];
-  return {
-    url,
-    [Symbol.asyncIterator]() {
-      let i = 0;
-      return {
-        next: () => (i < chunks.length ? Promise.resolve({ value: chunks[i++], done: false }) : Promise.resolve({ done: true }))
-      };
-    }
-  };
-}
-function mockRes() {
-  return { headersSent: false, head: null, body: null, writeHead(c, h) { this.head = { c, h }; }, end(b) { this.body = b; } };
-}
-
-const RVC_DIR = 'E:/AI/RVC20240604Nvidia/RVC20240604Nvidia';
-const custom = {
-  baseUrl: 'http://127.0.0.1:4892',
-  model: `${RVC_DIR}/assets/weights/azusa-test.pth`,
-  index: `${RVC_DIR}/assets/indices/azusa-test_IVF3317_Flat_nprobe_1_azusa-test_v2.index`,
-  baseVoice: 'zh-CN-YunyangNeural',
-  f0Method: 'rmvpe',
-  indexRate: 0.75
-};
-
-const t0 = Date.now();
-const res = mockRes();
-try {
-  await speakRoute.handler(
-    mockReq('/dsh-tts-api/speak', JSON.stringify({ text: '这是通过插件链路转换出的 azusa 音色，用来验证端到端流程。', provider: 'rvc', custom })),
-    res
-  );
-} catch (e) {
-  console.error('speak handler threw:', e);
-  process.exit(1);
-}
-console.log('res.head:', JSON.stringify(res.head));
-console.log('res.body type:', typeof res.body, res.body === null ? 'null' : String(res.body).slice(0, 200));
-if (!res.body) process.exit(1);
-const parsed = JSON.parse(res.body);
-console.log(`speak -> ${res.head.c} ${parsed.url ?? parsed.error}  (${((Date.now() - t0) / 1000).toFixed(1)}s)`);
-if (!parsed.url) process.exit(1);
-
-const ares = mockRes();
-await audioRoute.handler(mockReq(parsed.url), ares);
-const bytes = Buffer.isBuffer(ares.body) ? ares.body : Buffer.from(ares.body ?? '');
-console.log(`audio -> ${ares.head.c} ${bytes.length} bytes, head=${bytes.slice(0, 4).toString()}`);
-if (!(bytes.length > 1000 && bytes.slice(0, 4).toString() === 'RIFF')) process.exit(1);
-
-// ---- adaptive chunked progressive playback (long text) ----
-const nextRoute = routes.find((r) => r.kind === 'exact' && r.path === '/dsh-tts-api/rvc-next');
-if (!nextRoute) {
-  console.error('rvc-next route missing');
-  process.exit(1);
-}
-const longText = '这是一段用来验证自适应分块渐进播放的长文本，每一块都会先由 Edge 合成，再交给本地 RVC 服务转换，播放的同时后台继续合成后面的段落，从而做到长文朗读不卡顿。'.repeat(3);
-const t1 = Date.now();
-const longRes = mockRes();
-await speakRoute.handler(
-  mockReq('/dsh-tts-api/speak', JSON.stringify({ text: longText, provider: 'rvc', custom })),
-  longRes
-);
-const longParsed = JSON.parse(longRes.body);
-console.log(`long speak -> ${longRes.head.c} jobId=${longParsed.jobId ?? ''} chunks=${longParsed.chunks?.length ?? 0} total=${longParsed.total ?? 0} ratio=${longParsed.ratio ?? 'n/a'} chunkSec=${longParsed.chunkSec ?? 'n/a'} (${((Date.now() - t1) / 1000).toFixed(1)}s)`);
-if (!longParsed.jobId || !Array.isArray(longParsed.chunks) || longParsed.chunks.length < 2) process.exit(1);
-let fetched = longParsed.chunks.length;
-let more = true;
-const chunkStarts = [];
-while (more) {
-  const nr = mockRes();
-  await nextRoute.handler(mockReq(`/dsh-tts-api/rvc-next?job=${longParsed.jobId}`), nr);
-  const np = JSON.parse(nr.body);
-  if (np && np.url) {
-    fetched++;
-    chunkStarts.push(np.url);
-  }
-  more = !!(np && np.more);
-}
-console.log(`rvc-next drained: fetched=${fetched} total=${longParsed.total} (${((Date.now() - t1) / 1000).toFixed(1)}s)`);
-if (fetched !== longParsed.total) process.exit(1);
-// verify one late chunk serves wav
-const lastRes = mockRes();
-await audioRoute.handler(mockReq(chunkStarts[chunkStarts.length - 1]), lastRes);
-const lastBytes = Buffer.isBuffer(lastRes.body) ? lastRes.body : Buffer.from(lastRes.body ?? '');
-console.log(`late chunk audio -> ${lastRes.head.c} ${lastBytes.length} bytes, head=${lastBytes.slice(0, 4).toString()}`);
-if (!(lastBytes.length > 1000 && lastBytes.slice(0, 4).toString() === 'RIFF')) process.exit(1);
-
-process.exit(0);
+// One-off real end-to-end: plugin Host -> real rvc-server (azusa-test) chain.
+//
+// [DEPRECATED in favor of tests/rvc-server-live.mjs] This one-off test hardcodes
+// Windows paths (E:/AI/.../azusa-test.pth) and is not portable. The standard,
+// environment-aware live scenario + boundary suite is `tests/rvc-server-live.mjs`
+// (npm run test:live). This file is kept for Windows reference only.
+
+// Verifies Edge base synth + real RVC conversion + audio route serving.
+import * as plugin from '../lib/index.mjs';
+
+const routes = [];
+const ctx = {
+  get(name) {
+    if (name === 'webServer') {
+      return {
+        register(route) {
+          routes.push(route);
+          return () => {
+            const i = routes.indexOf(route);
+            if (i >= 0) routes.splice(i, 1);
+          };
+        }
+      };
+    }
+    return undefined;
+  },
+  effect() {}
+};
+plugin.apply(ctx);
+
+const speakRoute = routes.find((r) => r.kind === 'exact' && r.path === '/dsh-tts-api/speak');
+const audioRoute = routes.find((r) => r.kind === 'prefix' && r.path === '/dsh-tts-audio');
+
+function mockReq(url, body) {
+  const chunks = body === undefined ? [] : [body];
+  return {
+    url,
+    [Symbol.asyncIterator]() {
+      let i = 0;
+      return {
+        next: () => (i < chunks.length ? Promise.resolve({ value: chunks[i++], done: false }) : Promise.resolve({ done: true }))
+      };
+    }
+  };
+}
+function mockRes() {
+  return { headersSent: false, head: null, body: null, writeHead(c, h) { this.head = { c, h }; }, end(b) { this.body = b; } };
+}
+
+const RVC_DIR = 'E:/AI/RVC20240604Nvidia/RVC20240604Nvidia';
+const custom = {
+  baseUrl: 'http://127.0.0.1:4892',
+  model: `${RVC_DIR}/assets/weights/azusa-test.pth`,
+  index: `${RVC_DIR}/assets/indices/azusa-test_IVF3317_Flat_nprobe_1_azusa-test_v2.index`,
+  baseVoice: 'zh-CN-YunyangNeural',
+  f0Method: 'rmvpe',
+  indexRate: 0.75
+};
+
+const t0 = Date.now();
+const res = mockRes();
+try {
+  await speakRoute.handler(
+    mockReq('/dsh-tts-api/speak', JSON.stringify({ text: '这是通过插件链路转换出的 azusa 音色，用来验证端到端流程。', provider: 'rvc', custom })),
+    res
+  );
+} catch (e) {
+  console.error('speak handler threw:', e);
+  process.exit(1);
+}
+console.log('res.head:', JSON.stringify(res.head));
+console.log('res.body type:', typeof res.body, res.body === null ? 'null' : String(res.body).slice(0, 200));
+if (!res.body) process.exit(1);
+const parsed = JSON.parse(res.body);
+console.log(`speak -> ${res.head.c} ${parsed.url ?? parsed.error}  (${((Date.now() - t0) / 1000).toFixed(1)}s)`);
+if (!parsed.url) process.exit(1);
+
+const ares = mockRes();
+await audioRoute.handler(mockReq(parsed.url), ares);
+const bytes = Buffer.isBuffer(ares.body) ? ares.body : Buffer.from(ares.body ?? '');
+console.log(`audio -> ${ares.head.c} ${bytes.length} bytes, head=${bytes.slice(0, 4).toString()}`);
+if (!(bytes.length > 1000 && bytes.slice(0, 4).toString() === 'RIFF')) process.exit(1);
+
+// ---- adaptive chunked progressive playback (long text) ----
+const nextRoute = routes.find((r) => r.kind === 'exact' && r.path === '/dsh-tts-api/rvc-next');
+if (!nextRoute) {
+  console.error('rvc-next route missing');
+  process.exit(1);
+}
+const longText = '这是一段用来验证自适应分块渐进播放的长文本，每一块都会先由 Edge 合成，再交给本地 RVC 服务转换，播放的同时后台继续合成后面的段落，从而做到长文朗读不卡顿。'.repeat(3);
+const t1 = Date.now();
+const longRes = mockRes();
+await speakRoute.handler(
+  mockReq('/dsh-tts-api/speak', JSON.stringify({ text: longText, provider: 'rvc', custom })),
+  longRes
+);
+const longParsed = JSON.parse(longRes.body);
+console.log(`long speak -> ${longRes.head.c} jobId=${longParsed.jobId ?? ''} chunks=${longParsed.chunks?.length ?? 0} total=${longParsed.total ?? 0} ratio=${longParsed.ratio ?? 'n/a'} chunkSec=${longParsed.chunkSec ?? 'n/a'} (${((Date.now() - t1) / 1000).toFixed(1)}s)`);
+if (!longParsed.jobId || !Array.isArray(longParsed.chunks) || longParsed.chunks.length < 2) process.exit(1);
+let fetched = longParsed.chunks.length;
+let more = true;
+const chunkStarts = [];
+while (more) {
+  const nr = mockRes();
+  await nextRoute.handler(mockReq(`/dsh-tts-api/rvc-next?job=${longParsed.jobId}`), nr);
+  const np = JSON.parse(nr.body);
+  if (np && np.url) {
+    fetched++;
+    chunkStarts.push(np.url);
+  }
+  more = !!(np && np.more);
+}
+console.log(`rvc-next drained: fetched=${fetched} total=${longParsed.total} (${((Date.now() - t1) / 1000).toFixed(1)}s)`);
+if (fetched !== longParsed.total) process.exit(1);
+// verify one late chunk serves wav
+const lastRes = mockRes();
+await audioRoute.handler(mockReq(chunkStarts[chunkStarts.length - 1]), lastRes);
+const lastBytes = Buffer.isBuffer(lastRes.body) ? lastRes.body : Buffer.from(lastRes.body ?? '');
+console.log(`late chunk audio -> ${lastRes.head.c} ${lastBytes.length} bytes, head=${lastBytes.slice(0, 4).toString()}`);
+if (!(lastBytes.length > 1000 && lastBytes.slice(0, 4).toString() === 'RIFF')) process.exit(1);
+
+process.exit(0);

package/tests/i18n-keys.mjs

@@ -1,82 +1,82 @@
-// i18n regression: every t("key") used in lib/client.js must exist in both zh
-// and en dictionaries; both dictionaries must be identical in key sets; and
-// no CJK UI literal may remain outside the dictionary.
-import { readFileSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import path from 'node:path';
-
-const client = readFileSync(path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', 'lib', 'client.js'), 'utf8');
-const results = [];
-function check(name, ok, detail) { results.push({ name, ok, detail }); console.log(`${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ' — ' + detail : ''}`); }
-
-function extractDict(lang) {
-  const lineMarker = `          ${lang}: {`;
-  const start = client.indexOf(lineMarker);
-  if (start < 0) throw new Error('no dict.' + lang);
-  const bodyStart = client.indexOf('{', start);
-  let i = bodyStart, depth = 0;
-  for (; i < client.length; i++) {
-    if (client[i] === '{') depth++;
-    else if (client[i] === '}') { depth--; if (depth === 0) break; }
-  }
-  const block = client.slice(bodyStart, i + 1);
-  const re = /"([^"]+)":\s*"((?:[^"\\]|\\.)*)"/g;
-  const out = {};
-  let m;
-  while ((m = re.exec(block))) out[m[1]] = m[2];
-  return out;
-}
-let zh, en, zhKeys, enKeys;
-try {
-  zh = extractDict('zh'); en = extractDict('en');
-  zhKeys = new Set(Object.keys(zh)); enKeys = new Set(Object.keys(en));
-  check('i18n dictionaries exist & non-empty', zhKeys.size > 0 && enKeys.size > 0, `zh=${zhKeys.size} en=${enKeys.size}`);
-  const missingEn = [...zhKeys].filter(k => !enKeys.has(k));
-  const missingZh = [...enKeys].filter(k => !zhKeys.has(k));
-  check('zh and en have identical key sets', missingEn.length === 0 && missingZh.length === 0,
-    missingEn.length ? 'en missing: ' + missingEn.join(',') : (missingZh.length ? 'zh missing: ' + missingZh.join(',') : undefined));
-} catch (e) {
-  check('i18n dictionaries parse', false, String(e.message));
-  zhKeys = new Set(); enKeys = new Set();
-}
-
-// every real t("key") usage (word-boundary t call) must be defined in both
-const used = new Set();
-const tRe = /(^|[^A-Za-z0-9_$.])t\(\s*"([^"]+)"\s*(?:\)|,)/g;
-let mm;
-while ((mm = tRe.exec(client))) used.add(mm[2]);
-const missingDef = [...used].filter(k => !zhKeys.has(k) || !enKeys.has(k));
-check('all t("key") usages have zh+en definitions', missingDef.length === 0, missingDef.length ? 'missing: ' + missingDef.join(',') : `${used.size} keys used`);
-
-// no CJK literal remains outside the dictionary (UI fully localized)
-const i18nEnd = client.lastIndexOf('// ------------------------------------------------------------ /i18n');
-const render = client.slice(i18nEnd + 1);
-const cjkRe = /"[^"\n]*[\u4e00-\u9fff][^"\n]*"/g;
-const cjk = [];
-let c;
-while ((c = cjkRe.exec(render))) {
-  const lineStart = render.lastIndexOf('\n', c.index) + 1;
-  const line = render.slice(lineStart, c.index);
-  if (!line.trim().startsWith('//')) cjk.push(c[0]);
-}
-check('no CJK UI literal left outside dictionary', cjk.length === 0, cjk.length ? cjk.slice(0, 10).join(' | ') : undefined);
-
-// dictionary has no dead keys (excluding voice.*/baseVoice.* data labels and lang labels used only in the switcher)
-// host.* keys are resolved DYNAMICALLY (hostErrText(t(i18n.code)) and
-// t("host.phase." + phaseKey)) so they won't appear as literal t("host.x")
-// calls; they are part of the host<->client i18n contract. Exclude them here.
-// cloud.usage.* tier keys are likewise dynamic (t("cloud.usage." + tier)).
-const dead = [...zhKeys].filter(k =>
-  used.has(k) ? false
-  : /^voice\.|^baseVoice\.|^host\.|^cloud\.usage\.(standard|wavenet|neural2|chirp3)$/.test(k) ? false
-  : true);
-check('dictionary has no dead keys (excluding voice/baseVoice/host data)', dead.length === 0, dead.length ? 'dead: ' + dead.join(',') : undefined);
-// host.* keys form a complete bi-dictionary set (already covered by the
-// identical-key-sets check); also ensure the handful the client references
-// statically are present.
-const hostStatic = ["host.phase.model", "host.phase.index", "host.phase.prepare"];
-check('host.* phase keys present in both langs', hostStatic.every(k => zhKeys.has(k) && enKeys.has(k)));
-
-const failed = results.filter(r => !r.ok);
-console.log(`\n${results.length - failed.length}/${results.length} i18n checks passed`);
-process.exit(failed.length === 0 ? 0 : 1);
+// i18n regression: every t("key") used in lib/client.js must exist in both zh
+// and en dictionaries; both dictionaries must be identical in key sets; and
+// no CJK UI literal may remain outside the dictionary.
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+
+const client = readFileSync(path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', 'lib', 'client.js'), 'utf8');
+const results = [];
+function check(name, ok, detail) { results.push({ name, ok, detail }); console.log(`${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ' — ' + detail : ''}`); }
+
+function extractDict(lang) {
+  const lineMarker = `          ${lang}: {`;
+  const start = client.indexOf(lineMarker);
+  if (start < 0) throw new Error('no dict.' + lang);
+  const bodyStart = client.indexOf('{', start);
+  let i = bodyStart, depth = 0;
+  for (; i < client.length; i++) {
+    if (client[i] === '{') depth++;
+    else if (client[i] === '}') { depth--; if (depth === 0) break; }
+  }
+  const block = client.slice(bodyStart, i + 1);
+  const re = /"([^"]+)":\s*"((?:[^"\\]|\\.)*)"/g;
+  const out = {};
+  let m;
+  while ((m = re.exec(block))) out[m[1]] = m[2];
+  return out;
+}
+let zh, en, zhKeys, enKeys;
+try {
+  zh = extractDict('zh'); en = extractDict('en');
+  zhKeys = new Set(Object.keys(zh)); enKeys = new Set(Object.keys(en));
+  check('i18n dictionaries exist & non-empty', zhKeys.size > 0 && enKeys.size > 0, `zh=${zhKeys.size} en=${enKeys.size}`);
+  const missingEn = [...zhKeys].filter(k => !enKeys.has(k));
+  const missingZh = [...enKeys].filter(k => !zhKeys.has(k));
+  check('zh and en have identical key sets', missingEn.length === 0 && missingZh.length === 0,
+    missingEn.length ? 'en missing: ' + missingEn.join(',') : (missingZh.length ? 'zh missing: ' + missingZh.join(',') : undefined));
+} catch (e) {
+  check('i18n dictionaries parse', false, String(e.message));
+  zhKeys = new Set(); enKeys = new Set();
+}
+
+// every real t("key") usage (word-boundary t call) must be defined in both
+const used = new Set();
+const tRe = /(^|[^A-Za-z0-9_$.])t\(\s*"([^"]+)"\s*(?:\)|,)/g;
+let mm;
+while ((mm = tRe.exec(client))) used.add(mm[2]);
+const missingDef = [...used].filter(k => !zhKeys.has(k) || !enKeys.has(k));
+check('all t("key") usages have zh+en definitions', missingDef.length === 0, missingDef.length ? 'missing: ' + missingDef.join(',') : `${used.size} keys used`);
+
+// no CJK literal remains outside the dictionary (UI fully localized)
+const i18nEnd = client.lastIndexOf('// ------------------------------------------------------------ /i18n');
+const render = client.slice(i18nEnd + 1);
+const cjkRe = /"[^"\n]*[\u4e00-\u9fff][^"\n]*"/g;
+const cjk = [];
+let c;
+while ((c = cjkRe.exec(render))) {
+  const lineStart = render.lastIndexOf('\n', c.index) + 1;
+  const line = render.slice(lineStart, c.index);
+  if (!line.trim().startsWith('//')) cjk.push(c[0]);
+}
+check('no CJK UI literal left outside dictionary', cjk.length === 0, cjk.length ? cjk.slice(0, 10).join(' | ') : undefined);
+
+// dictionary has no dead keys (excluding voice.*/baseVoice.* data labels and lang labels used only in the switcher)
+// host.* keys are resolved DYNAMICALLY (hostErrText(t(i18n.code)) and
+// t("host.phase." + phaseKey)) so they won't appear as literal t("host.x")
+// calls; they are part of the host<->client i18n contract. Exclude them here.
+// cloud.usage.* tier keys are likewise dynamic (t("cloud.usage." + tier)).
+const dead = [...zhKeys].filter(k =>
+  used.has(k) ? false
+  : /^voice\.|^baseVoice\.|^host\.|^cloud\.usage\.(standard|wavenet|neural2|chirp3)$/.test(k) ? false
+  : true);
+check('dictionary has no dead keys (excluding voice/baseVoice/host data)', dead.length === 0, dead.length ? 'dead: ' + dead.join(',') : undefined);
+// host.* keys form a complete bi-dictionary set (already covered by the
+// identical-key-sets check); also ensure the handful the client references
+// statically are present.
+const hostStatic = ["host.phase.model", "host.phase.index", "host.phase.prepare"];
+check('host.* phase keys present in both langs', hostStatic.every(k => zhKeys.has(k) && enKeys.has(k)));
+
+const failed = results.filter(r => !r.ok);
+console.log(`\n${results.length - failed.length}/${results.length} i18n checks passed`);
+process.exit(failed.length === 0 ? 0 : 1);

package/tests/package-runtime-patch.mjs

@@ -1,88 +1,88 @@
-// Boundary test for tools/package-runtime.py's macOS-only PyAV patch helper
-// (patch_infer_for_pyav): it must rewrite av.open("rb"/"wb") -> "r"/"w" in the
-// packaged infer/lib/audio.py on darwin, but leave a normal Python `open(
-// file, "rb")` (a real file open) untouched. Verified end-to-end too by
-//   node tests/rvc-server-live.mjs  (live /convert)
-// Run: node tests/package-runtime-patch.mjs
-import { execFileSync } from 'node:child_process';
-import { mkdtempSync, writeFileSync, readFileSync, rmSync, mkdirSync } from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const results = [];
-function check(name, ok, detail) {
-  results.push({ name, ok, detail });
-  console.log(`${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ' — ' + detail : ''}`);
-}
-
-const repo = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-const pkg = path.join(repo, 'tools', 'package-runtime.py');
-// Run the driver with python3 when available, else fall back to `python` and
-// then to the Windows `py -3` launcher. Windows installs often only ship
-// `python`, and a bare `python`/`python3` may be a dead Microsoft Store stub
-// that exits 9009, so the `py` launcher is the reliable last resort.
-function runPython(driverPath) {
-  const tries = [
-    ['python3', []],
-    ['python', []],
-    ['py', ['-3']]
-  ];
-  for (const [cmd, pre] of tries) {
-    try {
-      return execFileSync(cmd, [...pre, driverPath], { encoding: 'utf8' });
-    } catch (e) {
-      if (cmd === 'py') throw e; // give up after the last fallback
-    }
-  }
-}
-// sample = the unpatched (as-released) audio.py
-const sample = [
-  'import av',
-  'import numpy as np',
-  'def wav2(i, o, format):',
-  '    inp = av.open(i, "rb")',
-  '    out = av.open(o, "wb", format=format)',
-  '    return inp, out',
-  'def audio2(i, o, format, sr):',
-  '    inp = av.open(i, "rb")',
-  '    out = av.open(o, "wb", format=format)',
-  '    return inp, out',
-  'def load_audio(file, sr):',
-  '    with open(file, "rb") as f:',
-  '        pass',
-  ''
-].join('\n');
-
-const dir = mkdtempSync(path.join(os.tmpdir(), 'dsh-tts-pyav-'));
-try {
-  const libDir = path.join(dir, 'infer', 'lib');
-  mkdirSync(libDir, { recursive: true });
-  const audioPath = path.join(libDir, 'audio.py');
-  writeFileSync(audioPath, sample);
-
-  const driver = path.join(dir, 'driver.py');
-  writeFileSync(driver, `
-import importlib.util
-spec = importlib.util.spec_from_file_location("prt", ${JSON.stringify(pkg)})
-m = importlib.util.module_from_spec(spec)
-spec.loader.exec_module(m)
-m.patch_infer_for_pyav(${JSON.stringify(path.join(dir, 'infer'))})
-`);
-  runPython(driver);
-
-  const out = readFileSync(audioPath, 'utf8');
-  check('darwin patch replaces av.open rb/wb', !/av\.open\([^)]*"(rb|wb)"/.test(out), out.split('\n').filter(l => l.includes('av.open')).join(' | '));
-  check('darwin patch keeps Python open(file,"rb")', out.includes('with open(file, "rb") as f:'));
-  check('darwin patch converts to r/w', out.includes('av.open(i, "r")') && out.includes('av.open(o, "w", format=format)'));
-
-  // idempotency: running twice changes nothing
-  runPython(driver);
-  check('patch idempotent (second run unchanged)', readFileSync(audioPath, 'utf8') === out);
-} finally {
-  rmSync(dir, { recursive: true, force: true });
-}
-
-const failed = results.filter(r => !r.ok);
-console.log(`\n${results.length - failed.length}/${results.length} patch checks passed`);
-process.exit(failed.length === 0 ? 0 : 1);
+// Boundary test for tools/package-runtime.py's macOS-only PyAV patch helper
+// (patch_infer_for_pyav): it must rewrite av.open("rb"/"wb") -> "r"/"w" in the
+// packaged infer/lib/audio.py on darwin, but leave a normal Python `open(
+// file, "rb")` (a real file open) untouched. Verified end-to-end too by
+//   node tests/rvc-server-live.mjs  (live /convert)
+// Run: node tests/package-runtime-patch.mjs
+import { execFileSync } from 'node:child_process';
+import { mkdtempSync, writeFileSync, readFileSync, rmSync, mkdirSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const results = [];
+function check(name, ok, detail) {
+  results.push({ name, ok, detail });
+  console.log(`${ok ? 'PASS' : 'FAIL'}  ${name}${detail ? ' — ' + detail : ''}`);
+}
+
+const repo = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const pkg = path.join(repo, 'tools', 'package-runtime.py');
+// Run the driver with python3 when available, else fall back to `python` and
+// then to the Windows `py -3` launcher. Windows installs often only ship
+// `python`, and a bare `python`/`python3` may be a dead Microsoft Store stub
+// that exits 9009, so the `py` launcher is the reliable last resort.
+function runPython(driverPath) {
+  const tries = [
+    ['python3', []],
+    ['python', []],
+    ['py', ['-3']]
+  ];
+  for (const [cmd, pre] of tries) {
+    try {
+      return execFileSync(cmd, [...pre, driverPath], { encoding: 'utf8' });
+    } catch (e) {
+      if (cmd === 'py') throw e; // give up after the last fallback
+    }
+  }
+}
+// sample = the unpatched (as-released) audio.py
+const sample = [
+  'import av',
+  'import numpy as np',
+  'def wav2(i, o, format):',
+  '    inp = av.open(i, "rb")',
+  '    out = av.open(o, "wb", format=format)',
+  '    return inp, out',
+  'def audio2(i, o, format, sr):',
+  '    inp = av.open(i, "rb")',
+  '    out = av.open(o, "wb", format=format)',
+  '    return inp, out',
+  'def load_audio(file, sr):',
+  '    with open(file, "rb") as f:',
+  '        pass',
+  ''
+].join('\n');
+
+const dir = mkdtempSync(path.join(os.tmpdir(), 'dsh-tts-pyav-'));
+try {
+  const libDir = path.join(dir, 'infer', 'lib');
+  mkdirSync(libDir, { recursive: true });
+  const audioPath = path.join(libDir, 'audio.py');
+  writeFileSync(audioPath, sample);
+
+  const driver = path.join(dir, 'driver.py');
+  writeFileSync(driver, `
+import importlib.util
+spec = importlib.util.spec_from_file_location("prt", ${JSON.stringify(pkg)})
+m = importlib.util.module_from_spec(spec)
+spec.loader.exec_module(m)
+m.patch_infer_for_pyav(${JSON.stringify(path.join(dir, 'infer'))})
+`);
+  runPython(driver);
+
+  const out = readFileSync(audioPath, 'utf8');
+  check('darwin patch replaces av.open rb/wb', !/av\.open\([^)]*"(rb|wb)"/.test(out), out.split('\n').filter(l => l.includes('av.open')).join(' | '));
+  check('darwin patch keeps Python open(file,"rb")', out.includes('with open(file, "rb") as f:'));
+  check('darwin patch converts to r/w', out.includes('av.open(i, "r")') && out.includes('av.open(o, "w", format=format)'));
+
+  // idempotency: running twice changes nothing
+  runPython(driver);
+  check('patch idempotent (second run unchanged)', readFileSync(audioPath, 'utf8') === out);
+} finally {
+  rmSync(dir, { recursive: true, force: true });
+}
+
+const failed = results.filter(r => !r.ok);
+console.log(`\n${results.length - failed.length}/${results.length} patch checks passed`);
+process.exit(failed.length === 0 ? 0 : 1);