@oxiaom/adoremix 1.0.18 → 1.0.20

package/bin/adoremix.js

@@ -2,9 +2,12 @@
 'use strict';
 
 const cli = require('../src/cli');
-cli.run(process.argv.slice(2)).then((code) => {
-  process.exit(code || 0);
-}).catch((err) => {
+// 注意：不能在 run() resolve 后强制 process.exit —— 前台模式 `adoremix start`
+// spawn 出的二进制是 active handle，node 会自然挂起等待它运行（Ctrl+C 退出）。
+// 无脑 process.exit 会把 node 杀掉，二进制成孤儿后收 SIGHUP 被终止，表现为"启动即退"。
+// 普通命令（version/install/config 等）action 完成后事件循环空了会自然退出，
+// 退出码由各命令自己设 process.exitCode（doctor/doctor --fix 等已设）。
+cli.run(process.argv.slice(2)).catch((err) => {
   const logger = require('../src/logger');
   logger.error('未捕获的错误：', err);
   process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxiaom/adoremix",
-  "version": "1.0.18",
+  "version": "1.0.20",
   "description": "AdoreMix broadcast server - cross-platform installer, runner and service manager",
   "bin": {
     "adoremix": "./bin/adoremix.js"
@@ -14,7 +14,9 @@
     "@oxiaom/adoremix-win32-x64": "^1.0.0",
     "@oxiaom/adoremix-linux-x64": "^1.0.0",
     "@oxiaom/adoremix-linux-arm64": "^1.0.0",
-    "@oxiaom/adoremix-linux-arm": "^1.0.0"
+    "@oxiaom/adoremix-linux-arm": "^1.0.0",
+    "@oxiaom/adoremix-darwin-x64": "^1.0.0",
+    "@oxiaom/adoremix-darwin-arm64": "^1.0.0"
   },
   "dependencies": {
     "commander": "^12.1.0",

package/src/cli.js

@@ -308,15 +308,38 @@ function buildProgram() {
     .option('--file <path>', '指定日志文件')
     .option('-n, --lines <n>', '初始打印行数', parseInt, 50)
     .action((opts) => {
-      const wp = paths.workdirPaths(resolveWorkdir(opts.workdir));
-      const file = opts.file || wp.logfile;
+      const workdir = resolveWorkdir(opts.workdir);
+      const wp = paths.workdirPaths(workdir);
       const fs = require('fs');
       const { spawn } = require('child_process');
-      if (!fs.existsSync(file)) {
-        logger.warn(`日志文件不存在 ${file}`);
+      // 默认日志文件：选最近更新的。
+      //   systemd 模式 → logs/svc.log（unit 模板 StandardOutput=append 写这里）
+      //   前台/daemon 模式 → var/app.log（spawn 重定向）
+      // 用户可用 --file 覆盖。
+      let file = opts.file;
+      if (!file) {
+        const candidates = [
+          path.join(workdir, 'logs', 'svc.err'),   // systemd 模式：二进制实时输出（stderr，更新最频繁）
+          path.join(workdir, 'logs', 'svc.log'),   // systemd 模式：node logger（stdout）
+          wp.logfile                                 // 前台/daemon 模式：var/app.log
+        ];
+        let bestMtime = 0;
+        for (const f of candidates) {
+          try {
+            const m = fs.statSync(f).mtimeMs;
+            if (m > bestMtime) { bestMtime = m; file = f; }
+          } catch (e) {}
+        }
+      }
+      if (!file || !fs.existsSync(file)) {
+        logger.warn(`日志文件不存在（找了 logs/svc.err、logs/svc.log、${wp.logfile}）`);
+        logger.log('提示：systemd 模式也可用 journalctl -u adoremix -f');
         process.exitCode = 1;
         return;
       }
+      if (file !== wp.logfile && !opts.file) {
+        logger.log(`（自动选中 ${path.relative(workdir, file)}，--file 可指定其他）`);
+      }
       if (!opts.follow) {
         const tail = spawn(process.platform === 'win32' ? 'more' : 'tail', process.platform === 'win32' ? [file] : ['-n', String(opts.lines), file], { stdio: 'inherit' });
         tail.on('exit', (c) => process.exit(c || 0));

package/src/doctor.js

@@ -26,6 +26,57 @@ const LIB_TO_PKG = {
   'libkrb5.so.3': 'libkrb5-3'
 };
 
+// ICU 70 兜底：
+// AdoreMix 二进制在 Ubuntu 22.04（ICU 70）编译，链接 libicui18n.so.70 / libicuuc.so.70 / libicudata.so.70。
+// Debian 12 / 树莓派 OS / Armbian 等 apt 源里只有 libicu72，没有 libicu70，跨发行版运行会缺库。
+// 这三个 .so 都由同一个包 libicu70 提供，从 Ubuntu 官方源下载对应架构 .deb 装上即可（与系统 libicu72 共存，不冲突）。
+const ICU70_LIBS = ['libicui18n.so.70', 'libicuuc.so.70', 'libicudata.so.70'];
+const ICU70_DEB_SOURCES = {
+  // node arch → [deb arch, Ubuntu 源根]
+  arm64: ['arm64', 'http://ports.ubuntu.com/ubuntu-ports'],   // 非 amd64 架构走 ports
+  arm: ['armhf', 'http://ports.ubuntu.com/ubuntu-ports'],     // armv7 / armhf（树莓派 32 位、老款盒子）
+  x64: ['amd64', 'http://archive.ubuntu.com/ubuntu']
+};
+
+function getIcu70DebInfo() {
+  const src = ICU70_DEB_SOURCES[process.arch];
+  if (!src) return null;
+  const [debArch, base] = src;
+  return {
+    debArch,
+    url: `${base}/pool/main/i/icu/libicu70_70.1-2_${debArch}.deb`,
+    tmpPath: '/tmp/adoremix-libicu70.deb'
+  };
+}
+
+function tryFixIcu70() {
+  const info = getIcu70DebInfo();
+  if (!info) {
+    logger.warn(`  ICU 70 兜底暂不支持架构 ${process.arch}，请手动安装 libicu70`);
+    return false;
+  }
+  logger.info(`==> ICU 70 兜底：从 Ubuntu 官方源下载 libicu70 (${info.debArch})`);
+  logger.log(`    ${info.url}`);
+  try {
+    execSync(`wget -q -O ${info.tmpPath} '${info.url}'`, { stdio: 'inherit' });
+    const size = fs.statSync(info.tmpPath).size;
+    if (size < 100000) {
+      logger.error(`下载失败（文件 ${size} 字节，可能 URL 失效或网络不通）`);
+      try { fs.unlinkSync(info.tmpPath); } catch (e) {}
+      return false;
+    }
+    logger.info(`==> dpkg -i libicu70_70.1-2_${info.debArch}.deb (${(size / 1024 / 1024).toFixed(1)} MB)`);
+    execSync(`dpkg -i ${info.tmpPath}`, { stdio: 'inherit' });
+    try { fs.unlinkSync(info.tmpPath); } catch (e) {}
+    return true;
+  } catch (e) {
+    logger.error(`ICU 70 安装失败：${(e.message || '').split('\n')[0]}`);
+    logger.warn(`  可能需要 root，手动执行：`);
+    logger.warn(`  wget -O /tmp/libicu70.deb '${info.url}' && sudo dpkg -i /tmp/libicu70.deb`);
+    return false;
+  }
+}
+
 function runDoctor(workdir, opts) {
   opts = opts || {};
   logger.log('=== AdoreMix 健康检查 ===');
@@ -93,38 +144,69 @@ function runDoctor(workdir, opts) {
         logger.ok(`✓ 动态库依赖完整`);
       } else {
         logger.error(`❌ 缺动态库：${missing.join(', ')}`);
+        // 分类：apt 可装 / ICU 70 跨发行版兜底 / 完全未知
         const pkgs = [];
+        const icu70 = [];
         const unknown = [];
         for (const lib of missing) {
-          const pkg = LIB_TO_PKG[lib];
-          if (pkg) pkgs.push(pkg);
+          if (ICU70_LIBS.includes(lib)) icu70.push(lib);
+          else if (LIB_TO_PKG[lib]) pkgs.push(LIB_TO_PKG[lib]);
           else unknown.push(lib);
         }
         const allPkgs = [...new Set(pkgs)];
+
+        // 1) apt 可装的库
+        let aptSolved = allPkgs.length === 0;
         if (allPkgs.length > 0) {
           const cmd = `apt-get install -y ${allPkgs.join(' ')}`;
           logger.log(`  建议命令（root 用户）：${cmd}`);
-          if (unknown.length > 0) {
-            logger.warn(`  未知库（无 apt 映射）：${unknown.join(', ')}`);
-          }
-          issues.push({
-            type: 'libs',
-            severity: 'error',
-            msg: missing.join(', '),
-            fixCmd: cmd,
-            pkgs: allPkgs
-          });
           if (opts.fix) {
             logger.info(`==> 自动修复：执行 ${cmd}`);
             try {
               execSync(cmd, { stdio: 'inherit', cwd: workdir });
               logger.ok('✓ 缺库已安装');
+              aptSolved = true;
             } catch (e) {
               logger.error(`修复失败：${e.message}`);
               logger.warn('可能需要 sudo：手动执行 sudo ' + cmd);
             }
           }
         }
+
+        // 2) ICU 70 跨发行版兜底（Debian 12 / 树莓派 OS / Armbian 等无 libicu70）
+        let icuSolved = icu70.length === 0;
+        if (icu70.length > 0) {
+          const icuMsg = `ICU 70 缺失（${icu70.join(', ')}）— 二进制在 Ubuntu 22.04 编译，Debian 12 等需补 libicu70`;
+          if (opts.fix) {
+            if (tryFixIcu70()) {
+              logger.ok('✓ libicu70 已安装（ICU 70 兜底）');
+              icuSolved = true;
+            } else {
+              issues.push({ type: 'icu70', severity: 'error', msg: icuMsg });
+            }
+          } else {
+            logger.warn(`  ${icuMsg}`);
+            logger.log(`    自动修复：adoremix doctor --fix（从 Ubuntu 官方源下载 libicu70 .deb）`);
+            issues.push({ type: 'icu70', severity: 'error', msg: icuMsg });
+          }
+        }
+
+        // 3) 未解决的记 issue
+        if (!aptSolved) {
+          issues.push({
+            type: 'libs',
+            severity: 'error',
+            msg: missing.join(', '),
+            fixCmd: `apt-get install -y ${allPkgs.join(' ')}`,
+            pkgs: allPkgs
+          });
+        }
+
+        // 4) 完全未知的库
+        if (unknown.length > 0) {
+          logger.warn(`  未知库（无 apt 映射，需手动排查）：${unknown.join(', ')}`);
+          issues.push({ type: 'libs-unknown', severity: 'error', msg: unknown.join(', ') });
+        }
       }
     } catch (e) {
       logger.warn(`⚠  ldd 检查失败（非 Linux 或权限问题）：${e.message.split('\n')[0]}`);

package/src/paths.js

@@ -9,7 +9,9 @@ const PLATFORM_PKG = {
   'win32_x64': '@oxiaom/adoremix-win32-x64',
   'linux_x64': '@oxiaom/adoremix-linux-x64',
   'linux_arm64': '@oxiaom/adoremix-linux-arm64',
-  'linux_arm': '@oxiaom/adoremix-linux-arm'
+  'linux_arm': '@oxiaom/adoremix-linux-arm',
+  'darwin_x64': '@oxiaom/adoremix-darwin-x64',
+  'darwin_arm64': '@oxiaom/adoremix-darwin-arm64'
 }[PLATFORM_KEY];
 
 let _native = null;
@@ -19,7 +21,7 @@ function loadNative() {
   if (_native) return _native;
   if (_loadError) throw _loadError;
   if (!PLATFORM_PKG) {
-    _loadError = new Error(`不支持的平台：${PLATFORM_KEY}。当前支持 win32-x64 / linux-x64 / linux-arm64 / linux-arm。`);
+    _loadError = new Error(`不支持的平台：${PLATFORM_KEY}。当前支持 win32-x64 / linux-x64 / linux-arm64 / linux-arm / darwin-x64 / darwin-arm64。`);
     throw _loadError;
   }
   try {

package/src/tts-deps.js

@@ -18,6 +18,10 @@ const { execSync, execFileSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
 
+// 二进制调外部命令 lame 把 TTS 生成的音频转码成 mp3（源码 cmd = "lame -S"），
+// 所有 provider 都需要，缺失时 node tts.js 生成 .txt 但 lame 转码 mp3 失败。
+const TRANSCODE_TOOLS = [{ name: 'lame', cmd: 'lame' }];
+
 const PROVIDER_DEPENDENCIES = {
   xf: {
     nodeModules: ['crypto-js', 'ws', 'log4node'],
@@ -28,14 +32,14 @@ const PROVIDER_DEPENDENCIES = {
     ],
     systemPkgs: [],
     pipPkgs: [],
-    executables: []
+    executables: TRANSCODE_TOOLS
   },
   minimax: {
     nodeModules: [],  // 用 Node 内置 https
     creds: [{ key: 'TTS.minimax_token', name: 'token' }],
     systemPkgs: [],
     pipPkgs: [],
-    executables: []
+    executables: TRANSCODE_TOOLS
   },
   edge: {
     nodeModules: [],
@@ -45,7 +49,7 @@ const PROVIDER_DEPENDENCIES = {
       { name: 'ffmpeg', cmd: 'ffmpeg' }
     ],
     pipPkgs: [{ pkg: 'edge-tts', import: 'edge_tts' }],
-    executables: [{ name: 'ffmpeg', cmd: 'ffmpeg' }]
+    executables: [{ name: 'ffmpeg', cmd: 'ffmpeg' }, ...TRANSCODE_TOOLS]
   }
 };
 
@@ -76,6 +80,27 @@ function pythonHasModule(pyCmd, modName) {
   } catch (e) { return false; }
 }
 
+// python3 自带 pip 吗（Debian/Armbian 精简系统默认不带，要 apt install python3-pip）
+function pythonHasPip(pyCmd) {
+  if (!pyCmd) return false;
+  try {
+    execFileSync(pyCmd, ['-m', 'pip', '--version'], { stdio: 'pipe' });
+    return true;
+  } catch (e) { return false; }
+}
+
+// 是否 PEP 668 externally-managed（Debian 12 / Ubuntu 23.04+ 默认禁止往系统 Python 装 pip 包）
+// 这种环境 pip install 会报 externally-managed-environment，需加 --break-system-packages
+function isExternallyManaged(pyCmd) {
+  if (!pyCmd) return false;
+  try {
+    const out = execFileSync(pyCmd, ['-c',
+      'import sysconfig,os;print(os.path.exists(os.path.join(sysconfig.get_path("stdlib"),"EXTERNALLY-MANAGED")))'
+    ], { stdio: 'pipe', encoding: 'utf8' });
+    return String(out).trim() === 'True';
+  } catch (e) { return false; }
+}
+
 function nodeModuleInstalled(workdir, modName) {
   try {
     require.resolve(modName, { paths: [workdir] });
@@ -134,8 +159,13 @@ function checkDeps(workdir, providerName, cfg) {
     }
   }
 
-  // 2. Node 模块
-  for (const mod of deps.nodeModules) {
+  // 2. Node 模块（provider 自己的 + dispatcher 公共依赖）
+  // dispatcher tts.js 所有 provider 都走，它 require ini 读 config，
+  // 缺失时二进制调 node tts.js 直接 MODULE_NOT_FOUND（TTS 全挂）。
+  // 常见于 --skip-npm-install 安装或 npm install 失败的场景。
+  const DISPATCHER_NODE_DEPS = ['ini'];
+  const allNodeMods = [...new Set([...deps.nodeModules, ...DISPATCHER_NODE_DEPS])];
+  for (const mod of allNodeMods) {
     if (!nodeModuleInstalled(workdir, mod)) {
       issues.push({
         severity: 'error',
@@ -166,12 +196,13 @@ function checkDeps(workdir, providerName, cfg) {
   }
 
   // 4. 系统可执行
-  for (const exe of deps.execubles || deps.systemPkgs) {
+  for (const exe of deps.executables || deps.systemPkgs) {
     if (exe.cmd && !which(exe.cmd)) {
       // 推断 apt 包名
       let aptPkg = '';
       if (exe.name === 'python3') aptPkg = 'python3 python3-pip';
       else if (exe.name === 'ffmpeg') aptPkg = 'ffmpeg';
+      else if (exe.name === 'lame') aptPkg = 'lame';
       const pkgMgr = detectAptLike();
       issues.push({
         severity: 'error',
@@ -214,13 +245,38 @@ function fixDeps(workdir, issues, opts) {
     if (!issue.autoFixable) continue;
     try {
       if (issue.fixType === 'npm') {
-        execSync(`npm install ${issue.fixArgs.mod} --no-audit --no-fund`, {
+        // 国内默认 npm 源慢/易失败，走 npmmirror（ADOREMIX_NPM_REGISTRY 可覆盖，留空用官方源）
+        const registry = process.env.ADOREMIX_NPM_REGISTRY !== undefined
+          ? process.env.ADOREMIX_NPM_REGISTRY
+          : 'https://registry.npmmirror.com';
+        const regFlag = registry ? ` --registry ${registry}` : '';
+        execSync(`npm install ${issue.fixArgs.mod}${regFlag} --no-audit --no-fund`, {
           cwd: issue.fixArgs.cwd,
           stdio: 'inherit'
         });
       } else if (issue.fixType === 'pip') {
         const py = issue.fixArgs.pyCmd || findPythonCmd() || 'python3';
-        execSync(`${sudo}${py} -m pip install ${issue.fixArgs.pkg}`, { stdio: 'inherit' });
+        // 1. 确保 pip 可用（Debian/Armbian 精简系统 python3 自带但 pip 缺失）
+        if (!pythonHasPip(py)) {
+          const pkgMgr = detectAptLike();
+          console.log(`  pip 未安装，先补 python3-pip ...`);
+          if (pkgMgr) {
+            execSync(`${sudo}${pkgMgr} install -y python3-pip`, { stdio: 'inherit' });
+          } else {
+            // 退路：用 Python 自带的 ensurepip 引导
+            execSync(`${sudo}${py} -m ensurepip --upgrade`, { stdio: 'inherit' });
+          }
+        }
+        // 2. PEP 668：Debian 12 / Ubuntu 23.04+ 禁止往系统 Python 装包，需 --break-system-packages
+        const breakFlag = isExternallyManaged(py) ? ' --break-system-packages' : '';
+        if (breakFlag) console.log('  检测到 externally-managed-environment，加 --break-system-packages');
+        // 3. PyPI 镜像：默认用清华（国内默认 PyPI 慢，常因下载损坏导致 hash 校验失败）。
+        //    国外用户可设环境变量 ADOREMIX_PIP_INDEX 覆盖，留空则用官方源。
+        const indexUrl = process.env.ADOREMIX_PIP_INDEX !== undefined
+          ? process.env.ADOREMIX_PIP_INDEX
+          : 'https://pypi.tuna.tsinghua.edu.cn/simple';
+        const indexFlag = indexUrl ? ` -i ${indexUrl}` : '';
+        execSync(`${sudo}${py} -m pip install${breakFlag}${indexFlag} ${issue.fixArgs.pkg}`, { stdio: 'inherit' });
       } else if (issue.fixType === 'system') {
         if (!issue.fixArgs.pkgMgr) throw new Error('包管理器未识别');
         execSync(`${sudo}${issue.fixArgs.pkgMgr} install -y ${issue.fixArgs.aptPkg}`, { stdio: 'inherit' });

package/templates/adoremix.service.tmpl

@@ -1,6 +1,6 @@
 [Unit]
 Description=AdoreMix Broadcast Server
-Documentation=https://github.com/your-org/adoremix
+Documentation=https://github.com/oxiaom/adoremix-npm
 After=network.target mysqld.service redis.service
 
 [Service]
@@ -8,11 +8,15 @@ Type=simple
 User=__USER__
 Group=__GROUP__
 WorkingDirectory=__WORKDIR__
-ExecStart=__NODE__ __CLI__ start --daemon --workdir __WORKDIR__
+# 用前台模式（不加 --daemon）：node 持续运行作为 systemd 主进程，
+# systemd 才能正确跟踪/重启/停止服务。
+# daemon 模式 node 会 unref 后退出，systemd 默认 KillMode=control-group
+# 会把整个 cgroup（含刚 spawn 的二进制）一起杀掉，服务起不来。
+ExecStart=__NODE__ __CLI__ start --workdir __WORKDIR__
 Restart=on-failure
 RestartSec=5
 StandardOutput=append:__WORKDIR__/logs/svc.log
-StandardError=append:__WORKDIR__/logs/svc.err
+StandardError=append:__WORKDIR__/logs/svc.log
 LimitNOFILE=65536
 
 [Install]

package/tts/providers/edge.js

@@ -15,26 +15,38 @@ const path = require('path');
 const os = require('os');
 
 // 短名 → edge-tts voice 全名
+// 注意：edge-tts 的 zh-CN voice 实际只有 8 个（--list-voices 确认）：
+//   女声 XiaoxiaoNeural(晓晓) XiaoyiNeural(晓伊)
+//   男声 YunxiNeural(云希) YunjianNeural(云健) YunxiaNeural(云夏) YunyangNeural(云扬)
+//   方言 liaoning-XiaobeiNeural shaanxi-XiaoniNeural
+// 讯飞/Qt 传的很多短名在 edge 无对应，就近映射到同性别有效 voice；
+// synthesize 另有 fallback 兜底（voice 调用失败回落 XiaoxiaoNeural）。
 const VOICES = {
+  // 直接对应
   xiaoxiao:   'zh-CN-XiaoxiaoNeural',
+  xiaoyi:     'zh-CN-XiaoyiNeural',
   yunxi:      'zh-CN-YunxiNeural',
   yunjian:    'zh-CN-YunjianNeural',
-  xiaoyi:     'zh-CN-XiaoyiNeural',
   yunxia:     'zh-CN-YunxiaNeural',
-  xiaochen:   'zh-CN-XiaochenNeural',
-  xiaohan:    'zh-CN-XiaohanNeural',
-  xiaomeng:   'zh-CN-XiaomengNeural',
-  xiaomo:     'zh-CN-XiaomoNeural',
-  xiaoqiu:    'zh-CN-XiaoqiuNeural',
-  xiaorui:    'zh-CN-XiaoruiNeural',
-  xiaoshuang: 'zh-CN-XiaoshuangNeural',
-  xiaoxuan:   'zh-CN-XiaoxuanNeural',
-  xiaoyan:    'zh-CN-XiaoyanNeural',
-  xiaoyou:    'zh-CN-XiaoyouNeural',
-  yunfeng:    'zh-CN-YunfengNeural',
-  yunhao:     'zh-CN-YunhaoNeural',
-  yunxiang:   'zh-CN-YunxiangNeural',
-  yunyang:    'zh-CN-YunyangNeural'
+  yunyang:    'zh-CN-YunyangNeural',
+  // edge 无对应，就近映射（女声→晓晓/晓伊，男声→云希/云健）
+  xiaoyan:    'zh-CN-XiaoxiaoNeural',
+  xiaochen:   'zh-CN-XiaoxiaoNeural',
+  xiaohan:    'zh-CN-XiaoxiaoNeural',
+  xiaomeng:   'zh-CN-XiaoyiNeural',
+  xiaomo:     'zh-CN-XiaoyiNeural',
+  xiaoqiu:    'zh-CN-XiaoxiaoNeural',
+  xiaorui:    'zh-CN-XiaoxiaoNeural',
+  xiaoshuang: 'zh-CN-XiaoyiNeural',
+  xiaoxuan:   'zh-CN-XiaoxiaoNeural',
+  xiaoyou:    'zh-CN-XiaoyiNeural',
+  yunfeng:    'zh-CN-YunxiNeural',
+  yunhao:     'zh-CN-YunxiNeural',
+  yunxiang:   'zh-CN-YunjianNeural',
+  // 讯飞原生发音人（Qt/WebUI 可能直接传讯飞名 aisxxx）→ 就近映射到 edge 有效 voice
+  aisjiuxu:   'zh-CN-YunxiNeural',   // 许久（男）→ 云希
+  aisbabyxu:  'zh-CN-YunxiaNeural',  // 男童 → 云夏
+  aisxuxin:   'zh-CN-YunxiNeural'    // 晓旭（男）→ 云希
 };
 
 function findPython() {
@@ -77,7 +89,8 @@ function synthesize({ text, voice, volume, speed, outFile }, creds) {
     }
 
     const py = findPython();
-    const voiceId = VOICES[voice] || creds.edge_voice_override || 'zh-CN-XiaoxiaoNeural';
+    const DEFAULT_VOICE = 'zh-CN-XiaoxiaoNeural';
+    const wantedVoice = VOICES[voice] || creds.edge_voice_override || DEFAULT_VOICE;
 
     // edge-tts rate/volume 是百分比字符串，如 "+50%" / "-20%"
     const sp = parseInt(speed) || 50;
@@ -91,8 +104,8 @@ function synthesize({ text, voice, volume, speed, outFile }, creds) {
     const txtFile = path.join(tmpDir, `adoremix-edge-${Date.now()}.txt`);
     fs.writeFileSync(txtFile, text);
 
-    try {
-      // 用 python -m edge_tts 调用（避免命令找不到）
+    // 跑一次 edge-tts（指定 voice），voice 无效/网络抖动时回落默认 voice 重试
+    function runEdge(voiceId) {
       execFileSync(py, [
         '-m', 'edge_tts',
         '--voice', voiceId,
@@ -101,9 +114,23 @@ function synthesize({ text, voice, volume, speed, outFile }, creds) {
         '-f', txtFile,
         '--write-media', webmFile
       ], { stdio: 'pipe' });
+      if (!fs.existsSync(webmFile) || fs.statSync(webmFile).size === 0) {
+        throw new Error('edge-tts 未生成音频（voice 可能无效或网络问题）');
+      }
+    }
 
-      if (!fs.existsSync(webmFile)) {
-        throw new Error('edge-tts 未生成音频');
+    let usedVoice = wantedVoice;
+    try {
+      try {
+        runEdge(wantedVoice);
+      } catch (e) {
+        // voice 在 edge-tts 不存在（微软列表动态变化）或网络抖动 → 回落默认 voice 重试一次
+        if (wantedVoice !== DEFAULT_VOICE) {
+          usedVoice = DEFAULT_VOICE;
+          runEdge(DEFAULT_VOICE);
+        } else {
+          throw e;
+        }
       }
 
       // 2. ffmpeg 转 mp3
@@ -118,7 +145,7 @@ function synthesize({ text, voice, volume, speed, outFile }, creds) {
       // 3. 清理临时
       try { fs.unlinkSync(webmFile); fs.unlinkSync(txtFile); } catch (e) {}
 
-      resolve({ outFile, provider: 'edge', voice: voiceId });
+      resolve({ outFile, provider: 'edge', voice: usedVoice });
     } catch (e) {
       try { fs.unlinkSync(webmFile); fs.unlinkSync(txtFile); } catch (_) {}
       reject(new Error('edge-tts 失败: ' + e.message));