@oxiaom/adoremix 1.0.8 → 1.0.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxiaom/adoremix",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "AdoreMix broadcast server - cross-platform installer, runner and service manager",
   "bin": {
     "adoremix": "./bin/adoremix.js"
@@ -37,7 +37,8 @@
   "files": [
     "bin",
     "src",
-    "templates"
+    "templates",
+    "tts"
   ],
   "keywords": [
     "adoremix",

package/src/doctor.js

@@ -162,6 +162,31 @@ function runDoctor(workdir, opts) {
     logger.log(`○ 服务未运行（adoremix start 启动）`);
   }
 
+  // 8. TTS provider 依赖检查
+  logger.log('');
+  logger.log('=== TTS Provider 检查 ===');
+  const cfg = require('./config');
+  const cfgObj = cfg.readConfig(workdir) || {};
+  const ttsDeps = require('./tts-deps');
+  const providerName = (cfgObj.TTS && cfgObj.TTS.provider) || 'xf';
+  logger.log(`当前 provider: ${providerName}`);
+  const ttsResult = ttsDeps.checkDeps(workdir, providerName, cfgObj);
+  if (ttsResult.issues.length === 0) {
+    logger.ok(`✓ ${providerName} provider 所有依赖就绪`);
+  } else {
+    for (const iss of ttsResult.issues) {
+      const mark = iss.severity === 'error' ? '❌' : '⚠';
+      logger.log(`  ${mark} ${iss.msg}`);
+      if (iss.fixCmd) logger.log(`     修复：${iss.fixCmd}`);
+      if (iss.autoFixable) issues.push({ type: 'tts', severity: iss.severity, msg: iss.msg, fixCmd: iss.fixCmd });
+    }
+    if (opts.fix) {
+      logger.info('==> 自动修复 TTS 依赖...');
+      const r = ttsDeps.fixDeps(workdir, ttsResult.issues, { sudo: process.getuid && process.getuid() === 0 });
+      logger.ok(`✓ 修复 ${r.fixed} 项，失败 ${r.failed} 项`);
+    }
+  }
+
   return reportAndExit(issues, opts);
 }
 

package/src/tts-deps.js

@@ -0,0 +1,253 @@
+'use strict';
+
+/**
+ * TTS provider 依赖检查（最硬核版）
+ *
+ * 检查每个 provider 需要的所有东西：
+ *   xf:     crypto-js, ws, log4node (Node 包) + appid/apiSecret/apiKey (凭证)
+ *   minimax: token (凭证) - Node 内置 https，无外部依赖
+ *   edge:   python3, edge-tts (pip 包), ffmpeg (系统) - 完全免费但依赖多
+ *
+ * 用法：
+ *   const issues = checkDeps(workdir);
+ *   // issues: [{severity, msg, fixCmd, autoFixable}]
+ *   if (opts.fix) fixDeps(workdir, issues);
+ */
+
+const { execSync, execFileSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const PROVIDER_DEPENDENCIES = {
+  xf: {
+    nodeModules: ['crypto-js', 'ws', 'log4node'],
+    creds: [
+      { key: 'TTS.xf_appid', name: 'appid' },
+      { key: 'TTS.xf_apiSecret', name: 'apiSecret' },
+      { key: 'TTS.xf_apiKey', name: 'apiKey' }
+    ],
+    systemPkgs: [],
+    pipPkgs: [],
+    executables: []
+  },
+  minimax: {
+    nodeModules: [],  // 用 Node 内置 https
+    creds: [{ key: 'TTS.minimax_token', name: 'token' }],
+    systemPkgs: [],
+    pipPkgs: [],
+    executables: []
+  },
+  edge: {
+    nodeModules: [],
+    creds: [],
+    systemPkgs: [
+      { name: 'python3', cmd: 'python3', altCmd: 'python' },
+      { name: 'ffmpeg', cmd: 'ffmpeg' }
+    ],
+    pipPkgs: [{ pkg: 'edge-tts', import: 'edge_tts' }],
+    executables: [{ name: 'ffmpeg', cmd: 'ffmpeg' }]
+  }
+};
+
+function which(cmd) {
+  try {
+    execSync(`command -v ${cmd} 2>/dev/null || which ${cmd} 2>/dev/null`, { stdio: 'pipe' });
+    return true;
+  } catch (e) { return false; }
+}
+
+function findPythonCmd() {
+  for (const c of ['python3', 'python']) {
+    if (which(c)) {
+      try {
+        const v = execSync(`${c} --version`, { stdio: 'pipe', encoding: 'utf8' });
+        if (/Python 3\./.test(v)) return c;
+      } catch (e) {}
+    }
+  }
+  return null;
+}
+
+function pythonHasModule(pyCmd, modName) {
+  if (!pyCmd) return false;
+  try {
+    execFileSync(pyCmd, ['-c', `import ${modName}`], { stdio: 'pipe' });
+    return true;
+  } catch (e) { return false; }
+}
+
+function nodeModuleInstalled(workdir, modName) {
+  try {
+    require.resolve(modName, { paths: [workdir] });
+    return true;
+  } catch (e) { return false; }
+}
+
+function getCredValue(cfg, dottedKey) {
+  const parts = dottedKey.split('.');
+  let cur = cfg;
+  for (const p of parts) {
+    if (cur == null || typeof cur !== 'object') return undefined;
+    cur = cur[p];
+  }
+  return cur;
+}
+
+function detectAptLike() {
+  if (which('apt-get')) return 'apt-get';
+  if (which('apt')) return 'apt';
+  if (which('yum')) return 'yum';
+  if (which('dnf')) return 'dnf';
+  if (which('apk')) return 'apk';
+  return null;
+}
+
+/**
+ * 检查指定 provider 的所有依赖
+ * @returns {issues: Array, provider: string}
+ */
+function checkDeps(workdir, providerName, cfg) {
+  const issues = [];
+  providerName = providerName || (cfg && cfg.TTS && cfg.TTS.provider) || 'xf';
+  const deps = PROVIDER_DEPENDENCIES[providerName];
+  if (!deps) {
+    return { issues: [{ severity: 'error', msg: `未知 provider: ${providerName}`, autoFixable: false }], provider: providerName };
+  }
+
+  // 1. 凭证
+  for (const c of deps.creds) {
+    const val = getCredValue(cfg, c.key);
+    if (!val) {
+      issues.push({
+        severity: 'error',
+        category: 'cred',
+        msg: `${providerName} 缺凭证 ${c.name}（${c.key}）`,
+        fixCmd: `adoremix config set ${c.key} <your_${c.name}>`,
+        autoFixable: false
+      });
+    }
+  }
+
+  // 2. Node 模块
+  for (const mod of deps.nodeModules) {
+    if (!nodeModuleInstalled(workdir, mod)) {
+      issues.push({
+        severity: 'error',
+        category: 'node_module',
+        msg: `Node 包未安装: ${mod}`,
+        fixCmd: `cd ${workdir} && npm install ${mod}`,
+        autoFixable: true,
+        fixType: 'npm',
+        fixArgs: { cwd: workdir, mod }
+      });
+    }
+  }
+
+  // 3. pip 包
+  const pyCmd = findPythonCmd();
+  for (const pip of deps.pipPkgs) {
+    if (!pythonHasModule(pyCmd, pip.import)) {
+      issues.push({
+        severity: 'error',
+        category: 'pip',
+        msg: `Python 包未安装: ${pip.pkg}`,
+        fixCmd: 'pip3 install ' + pip.pkg,
+        autoFixable: true,
+        fixType: 'pip',
+        fixArgs: { pkg: pip.pkg, pyCmd }
+      });
+    }
+  }
+
+  // 4. 系统可执行
+  for (const exe of deps.execubles || 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';
+      const pkgMgr = detectAptLike();
+      issues.push({
+        severity: 'error',
+        category: 'system',
+        msg: `系统命令未找到: ${exe.name}`,
+        fixCmd: aptPkg && pkgMgr ? `sudo ${pkgMgr} install -y ${aptPkg}` : '',
+        autoFixable: !!(aptPkg && pkgMgr),
+        fixType: 'system',
+        fixArgs: { pkgMgr, aptPkg }
+      });
+    }
+  }
+
+  // python3 特殊处理（如果 edge 需要 python3 但只装了 python）
+  if (providerName === 'edge' && !pyCmd) {
+    const pkgMgr = detectAptLike();
+    issues.push({
+      severity: 'error',
+      category: 'system',
+      msg: '需要 python3（未找到 Python 3.x）',
+      fixCmd: pkgMgr ? `sudo ${pkgMgr} install -y python3 python3-pip` : '',
+      autoFixable: !!pkgMgr,
+      fixType: 'system',
+      fixArgs: { pkgMgr, aptPkg: 'python3 python3-pip' }
+    });
+  }
+
+  return { issues, provider: providerName };
+}
+
+/**
+ * 自动修复（仅 autoFixable=true 的）
+ */
+function fixDeps(workdir, issues, opts) {
+  opts = opts || {};
+  const sudo = opts.sudo ? 'sudo ' : '';
+  let fixed = 0;
+  let failed = 0;
+  for (const issue of issues) {
+    if (!issue.autoFixable) continue;
+    try {
+      if (issue.fixType === 'npm') {
+        execSync(`npm install ${issue.fixArgs.mod} --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' });
+      } else if (issue.fixType === 'system') {
+        if (!issue.fixArgs.pkgMgr) throw new Error('包管理器未识别');
+        execSync(`${sudo}${issue.fixArgs.pkgMgr} install -y ${issue.fixArgs.aptPkg}`, { stdio: 'inherit' });
+      }
+      fixed++;
+    } catch (e) {
+      console.error(`  ✗ 修复失败 [${issue.msg}]: ${e.message.split('\n')[0]}`);
+      failed++;
+    }
+  }
+  return { fixed, failed };
+}
+
+/**
+ * 列出所有 provider 的依赖（用于 adoremix tts deps 不带 provider 时）
+ */
+function listAllProviders(workdir, cfg) {
+  const result = {};
+  for (const name of Object.keys(PROVIDER_DEPENDENCIES)) {
+    const r = checkDeps(workdir, name, cfg);
+    result[name] = {
+      issues: r.issues,
+      ok: r.issues.length === 0
+    };
+  }
+  return result;
+}
+
+module.exports = {
+  PROVIDER_DEPENDENCIES,
+  checkDeps,
+  fixDeps,
+  listAllProviders,
+  which,
+  findPythonCmd
+};

package/tts/providers/edge.js

@@ -0,0 +1,136 @@
+'use strict';
+
+/**
+ * Edge TTS provider（免费）
+ * 调用方式：python edge-tts 包 + ffmpeg 转 mp3
+ * 凭证：不需要（免费）
+ *
+ * 依赖：python3 + pip install edge-tts + ffmpeg
+ * 自动检测：adoremix tts deps
+ */
+
+const { execFileSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// 短名 → edge-tts voice 全名
+const VOICES = {
+  xiaoxiao:   'zh-CN-XiaoxiaoNeural',
+  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'
+};
+
+function findPython() {
+  for (const cmd of ['python3', 'python']) {
+    try {
+      execFileSync(cmd, ['--version'], { stdio: 'pipe' });
+      return cmd;
+    } catch (e) {}
+  }
+  return null;
+}
+
+function checkDeps() {
+  const issues = [];
+  const py = findPython();
+  if (!py) {
+    issues.push({ msg: '未找到 python3/python', fix: 'apt-get install -y python3 python3-pip' });
+    return issues;
+  }
+  // 检查 edge-tts 包
+  try {
+    execFileSync(py, ['-c', 'import edge_tts'], { stdio: 'pipe' });
+  } catch (e) {
+    issues.push({ msg: 'python 缺 edge-tts 包', fix: 'pip3 install edge-tts' });
+  }
+  // 检查 ffmpeg
+  try {
+    execFileSync('ffmpeg', ['-version'], { stdio: 'pipe' });
+  } catch (e) {
+    issues.push({ msg: '未找到 ffmpeg', fix: 'apt-get install -y ffmpeg' });
+  }
+  return issues;
+}
+
+function synthesize({ text, voice, volume, speed, outFile }, creds) {
+  return new Promise((resolve, reject) => {
+    const issues = checkDeps();
+    if (issues.length > 0) {
+      return reject(new Error('edge-tts 依赖缺失:\n  ' + issues.map(i => i.msg + ' (修复: ' + i.fix + ')').join('\n  ')));
+    }
+
+    const py = findPython();
+    const voiceId = VOICES[voice] || creds.edge_voice_override || 'zh-CN-XiaoxiaoNeural';
+
+    // edge-tts rate/volume 是百分比字符串，如 "+50%" / "-20%"
+    const sp = parseInt(speed) || 50;
+    const vo = parseInt(volume) || 50;
+    const rateStr = `${sp - 50 >= 0 ? '+' : ''}${sp - 50}%`;
+    const volStr = `${vo - 50 >= 0 ? '+' : ''}${vo - 50}%`;
+
+    // 1. edge-tts 生成 webm（临时文件）
+    const tmpDir = os.tmpdir();
+    const webmFile = path.join(tmpDir, `adoremix-edge-${Date.now()}.webm`);
+    const txtFile = path.join(tmpDir, `adoremix-edge-${Date.now()}.txt`);
+    fs.writeFileSync(txtFile, text);
+
+    try {
+      // 用 python -m edge_tts 调用（避免命令找不到）
+      execFileSync(py, [
+        '-m', 'edge_tts',
+        '--voice', voiceId,
+        '--rate', rateStr,
+        '--volume', volStr,
+        '-f', txtFile,
+        '--write-media', webmFile
+      ], { stdio: 'pipe' });
+
+      if (!fs.existsSync(webmFile)) {
+        throw new Error('edge-tts 未生成音频');
+      }
+
+      // 2. ffmpeg 转 mp3
+      execFileSync('ffmpeg', [
+        '-y', '-i', webmFile,
+        '-acodec', 'libmp3lame',
+        '-ab', '128k',
+        '-ar', '22050',
+        outFile
+      ], { stdio: 'pipe' });
+
+      // 3. 清理临时
+      try { fs.unlinkSync(webmFile); fs.unlinkSync(txtFile); } catch (e) {}
+
+      resolve({ outFile, provider: 'edge', voice: voiceId });
+    } catch (e) {
+      try { fs.unlinkSync(webmFile); fs.unlinkSync(txtFile); } catch (_) {}
+      reject(new Error('edge-tts 失败: ' + e.message));
+    }
+  });
+}
+
+module.exports = {
+  name: 'edge',
+  description: 'Microsoft Edge TTS（免费，需 python3 + edge-tts + ffmpeg）',
+  voices: VOICES,
+  requiredCreds: [],
+  checkDeps,
+  synthesize
+};

package/tts/providers/minimax.js

@@ -0,0 +1,124 @@
+'use strict';
+
+/**
+ * MiniMax TTS provider
+ * 调用方式：HTTP POST https://api.minimaxi.com/v1/t2a_v2
+ * 凭证：API token（包月几十元）
+ * 返回：JSON 里 data.audio 是 hex 编码的 mp3
+ *
+ * 不依赖 python，纯 Node 实现。
+ */
+
+const https = require('https');
+const fs = require('fs');
+
+const API_URL = 'https://api.minimaxi.com/v1/t2a_v2';
+
+// 短名 → minimax voice_id（基于 demo 提供的映射表）
+const VOICES = {
+  xiaoxiao:   'female-tianmei',
+  yunxi:      'male-qn-jingying',
+  yunjian:    'male-qn-jingying',
+  xiaoyi:     'female-shaonv',
+  yunxia:     'female-shaonv',
+  xiaochen:   'female-chengshu',
+  xiaohan:    'female-yujie',
+  xiaomeng:   'female-shaonv',
+  xiaomo:     'female-chengshu',
+  xiaoqiu:    'female-tianmei-jingpin',
+  xiaorui:    'female-shaonv-jingpin',
+  xiaoshuang: 'female-yujie-jingpin',
+  xiaoxuan:   'female-chengshu-jingpin',
+  xiaoyan:    'female-sharon',
+  xiaoyou:    'female-shaonv',
+  yunfeng:    'male-qn-badao',
+  yunhao:     'male-qn-badao',
+  yunxiang:   'male-qn-jingying',
+  yunyang:    'male-qn-qingse',
+  // minimax 自有音色（直接透传）
+  'male-qn-qingse': 'male-qn-qingse',
+  'male-qn-daxuesheng': 'male-qn-daxuesheng',
+  'male-qn-badao': 'male-qn-badao',
+  'female-shaonv': 'female-shaonv',
+  'female-yujie': 'female-yujie',
+  'female-chengshu': 'female-chengshu',
+  'female-tianmei': 'female-tianmei',
+  'female-sharon': 'female-sharon'
+};
+
+function synthesize({ text, voice, volume, speed, outFile }, creds) {
+  return new Promise((resolve, reject) => {
+    const token = creds.minimax_token;
+    if (!token) return reject(new Error('MiniMax TTS 缺凭证：minimax_token'));
+
+    const voiceId = VOICES[voice] || 'female-tianmei';
+
+    // volume/speed 在 0-100 范围，minimax 用 0-2 范围的 speed，0-100 的 vol
+    const speedNorm = Math.max(0.5, Math.min(2, (parseInt(speed) || 50) / 50));
+    const volNorm = parseInt(volume) || 50;
+
+    const body = JSON.stringify({
+      model: 'speech-2.8-hd',
+      text,
+      stream: false,
+      voice_setting: {
+        voice_id: voiceId,
+        speed: speedNorm,
+        vol: volNorm,
+        pitch: 0,
+        emotion: 'happy'
+      },
+      audio_setting: {
+        sample_rate: 32000,
+        bitrate: 128000,
+        format: 'mp3',
+        channel: 1
+      },
+      subtitle_enable: false
+    });
+
+    const url = new URL(API_URL);
+    const req = https.request({
+      hostname: url.hostname,
+      path: url.pathname,
+      method: 'POST',
+      headers: {
+        'Authorization': `Bearer ${token}`,
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(body)
+      }
+    }, (res) => {
+      let data = '';
+      res.on('data', (c) => data += c);
+      res.on('end', () => {
+        let result;
+        try { result = JSON.parse(data); }
+        catch (e) { return reject(new Error('MiniMax 返回非 JSON: ' + data.slice(0, 200))); }
+        if (result.base_resp && result.base_resp.status_code !== 0) {
+          return reject(new Error('MiniMax API 错误: ' + result.base_resp.status_msg));
+        }
+        const audioHex = result.data && result.data.audio;
+        if (!audioHex) return reject(new Error('MiniMax 返回无 audio 字段'));
+        try {
+          const audioData = Buffer.from(audioHex, 'hex');
+          fs.writeFileSync(outFile, audioData);
+          resolve({ outFile, provider: 'minimax', voice: voiceId });
+        } catch (e) {
+          reject(new Error('写入 mp3 失败: ' + e.message));
+        }
+      });
+    });
+
+    req.on('error', (e) => reject(new Error('MiniMax 网络错误: ' + e.message)));
+    req.write(body);
+    req.end();
+  });
+}
+
+module.exports = {
+  name: 'minimax',
+  description: 'MiniMax TTS（HTTP API，包月几十元）',
+  voices: VOICES,
+  requiredCreds: ['minimax_token'],
+  synthesize
+};

package/tts/providers/xf.js

@@ -0,0 +1,96 @@
+'use strict';
+
+/**
+ * 讯飞 TTS provider
+ * 调用方式：WebSocket wss://tts-api.xfyun.cn/v2/tts
+ * 凭证：appid + apiSecret + apiKey（一年 4000 元）
+ * 返回：直接 mp3 流（不需要 lame 转码）
+ */
+
+const CryptoJS = require('crypto-js');
+const WebSocket = require('ws');
+const fs = require('fs');
+
+// 讯飞 vcn（voice name）跟标准短名 1:1 映射（讯飞有自己的 vcn 名）
+// 这里用标准短名直接传给讯飞（讯飞接受任意 vcn，无效会用默认）
+// 如果用户的讯飞账号有自定义 vcn，可以在 config.ini 配 xf_voice_override
+const VOICES = {
+  xiaoxiao: 'xiaoxiao', yunxi: 'yunxi', yunjian: 'yunjian',
+  xiaoyi: 'xiaoyi', yunxia: 'yunxia', xiaochen: 'xiaochen',
+  xiaohan: 'xiaohan', xiaomeng: 'xiaomeng', xiaomo: 'xiaomo',
+  xiaoqiu: 'xiaoqiu', xiaorui: 'xiaorui', xiaoshuang: 'xiaoshuang',
+  xiaoxuan: 'xiaoxuan', xiaoyan: 'xiaoyan', xiaoyou: 'xiaoyou',
+  yunfeng: 'yunfeng', yunhao: 'yunhao', yunxiang: 'yunxiang', yunyang: 'yunyang'
+};
+
+function synthesize({ text, voice, volume, speed, outFile }, creds) {
+  return new Promise((resolve, reject) => {
+    const appid = creds.xf_appid;
+    const apiSecret = creds.xf_apiSecret;
+    const apiKey = creds.xf_apiKey;
+    if (!appid || !apiSecret || !apiKey) {
+      return reject(new Error('讯飞 TTS 缺凭证：xf_appid / xf_apiSecret / xf_apiKey'));
+    }
+
+    const vcn = VOICES[voice] || creds.xf_voice_override || 'xiaoxiao';
+    const host = 'tts-api.xfyun.cn';
+    const hostUrl = `wss://${host}/v2/tts`;
+
+    const date = new Date().toUTCString();
+    const signatureOrigin = `host: ${host}\ndate: ${date}\nGET /v2/tts HTTP/1.1`;
+    const signatureSha = CryptoJS.HmacSHA256(signatureOrigin, apiSecret);
+    const signature = CryptoJS.enc.Base64.stringify(signatureSha);
+    const authorizationOrigin = `api_key="${apiKey}", algorithm="hmac-sha256", headers="host date request-line", signature="${signature}"`;
+    const authStr = CryptoJS.enc.Base64.stringify(CryptoJS.enc.Utf8.parse(authorizationOrigin));
+    const wssUrl = `${hostUrl}?authorization=${authStr}&date=${date}&host=${host}`;
+
+    const ws = new WebSocket(wssUrl);
+    let receivedAny = false;
+
+    ws.on('open', () => {
+      const frame = {
+        common: { app_id: appid },
+        business: {
+          aue: 'lame', sfl: 1,
+          volume: parseInt(volume) || 50,
+          speed: parseInt(speed) || 50,
+          vcn, tte: 'UTF8'
+        },
+        data: { text: Buffer.from(text).toString('base64'), status: 2 }
+      };
+      ws.send(JSON.stringify(frame));
+      if (fs.existsSync(outFile)) fs.unlinkSync(outFile);
+    });
+
+    ws.on('message', (data) => {
+      let res;
+      try { res = JSON.parse(data); } catch (e) { return; }
+      if (res.code !== 0) {
+        ws.close();
+        reject(new Error(`讯飞错误 ${res.code}: ${res.message}`));
+        return;
+      }
+      const audioBuf = Buffer.from(res.data.audio, 'base64');
+      fs.appendFileSync(outFile, audioBuf);
+      receivedAny = true;
+      if (res.data.status === 2) {
+        ws.close();
+      }
+    });
+
+    ws.on('close', () => {
+      if (!receivedAny) return reject(new Error('讯飞未返回音频'));
+      resolve({ outFile, provider: 'xf', voice: vcn });
+    });
+
+    ws.on('error', (err) => reject(new Error('讯飞 WebSocket 错误: ' + err.message)));
+  });
+}
+
+module.exports = {
+  name: 'xf',
+  description: '讯飞在线 TTS（WebSocket，年费约 4000 元）',
+  voices: VOICES,
+  requiredCreds: ['xf_appid', 'xf_apiSecret', 'xf_apiKey'],
+  synthesize
+};

package/tts/tts-wrapper.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+'use strict';
+
+// 顶层 tts.js wrapper（Qt 调用入口）
+// Qt 调：node tts.js <vol> <speed> <voice> <mp3> <txt> [appid] [apiSecret] [apiKey]
+// 这里转发给 adoremix-tts/ 目录的 dispatcher
+
+const path = require('path');
+const dispatcherPath = path.join(__dirname, 'adoremix-tts', 'tts.js');
+const fs = require('fs');
+
+if (!fs.existsSync(dispatcherPath)) {
+  console.error('[tts] 错误：adoremix-tts/ 目录不存在，请重新运行 adoremix install');
+  process.exit(1);
+}
+
+// 让 dispatcher 看到正确的 argv（保留 Qt 传入的所有参数）
+process.argv[1] = dispatcherPath;
+require(dispatcherPath);

package/tts/tts.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * AdoreMix TTS dispatcher
+ *
+ * Qt/C++ 调用方式（不变）：
+ *   node tts.js <volume> <speed> <voice_short> <mp3_out> <txt_path> [appid] [apiSecret] [apiKey]
+ *
+ * 根据 config.ini [TTS].provider 调用对应实现：
+ *   - xf:     讯飞 WebSocket（原 tts.js 逻辑，需 appid/apiSecret/apiKey）
+ *   - minimax: MiniMax HTTP API（需 token）
+ *   - edge:   python edge-tts（免费，需 python3 + ffmpeg）
+ *
+ * 凭证优先从 config.ini 读，命令行 appid/apiSecret/apiKey 兼容旧调用（仅 xf）。
+ */
+
+const fs = require('fs');
+const path = require('path');
+const ini = require('ini');
+
+const PROVIDERS = {
+  xf: require('./providers/xf'),
+  minimax: require('./providers/minimax'),
+  edge: require('./providers/edge')
+};
+
+function log(...args) { console.log('[tts]', ...args); }
+function err(...args) { console.error('[tts ERR]', ...args); }
+
+async function main() {
+  const arg = process.argv.slice(2);
+  if (arg.length < 5) {
+    err('用法: node tts.js <volume> <speed> <voice> <mp3_out> <txt_path> [appid] [apiSecret] [apiKey]');
+    process.exit(1);
+  }
+
+  const [volume, speed, voice, mp3Name, txtPath, appidArg, apiSecretArg, apiKeyArg] = arg;
+
+  // 读文本（Qt 写的 utf-8 文本）
+  let text;
+  try { text = fs.readFileSync(txtPath, 'utf-8'); }
+  catch (e) { err(`读文本失败: ${txtPath} - ${e.message}`); process.exit(2); }
+
+  // 读 config.ini 找 provider
+  const cfgPath = path.join(process.cwd(), 'config.ini');
+  let ttsSection = {};
+  if (fs.existsSync(cfgPath)) {
+    try {
+      const cfg = ini.parse(fs.readFileSync(cfgPath, 'utf-8'));
+      ttsSection = cfg.TTS || {};
+    } catch (e) { err(`config.ini 解析失败: ${e.message}`); }
+  }
+  const providerName = (ttsSection.provider || 'xf').toLowerCase();
+  const provider = PROVIDERS[providerName];
+  if (!provider) {
+    err(`未知 provider: ${providerName}（可选: xf / minimax / edge）`);
+    process.exit(3);
+  }
+
+  // 输出路径（Qt 传的是文件名，实际写到 ./tty/ 下）
+  const ttyDir = path.join(process.cwd(), 'tty');
+  if (!fs.existsSync(ttyDir)) fs.mkdirSync(ttyDir, { recursive: true });
+  const outFile = path.join(ttyDir, mp3Name);
+
+  // 凭证：优先 config.ini，命令行参数兼容旧版 xf
+  // 兼容 Qt 已有字段：Settings.ttsxfAPPID / ttsxfAPISecret / ttsxfAPIKey
+  const settings = cfg.Settings || {};
+  const creds = {
+    xf_appid: ttsSection.xf_appid || settings.ttsxfAPPID || appidArg || '',
+    xf_apiSecret: ttsSection.xf_apiSecret || settings.ttsxfAPISecret || apiSecretArg || '',
+    xf_apiKey: ttsSection.xf_apiKey || settings.ttsxfAPIKey || apiKeyArg || '',
+    xf_voice_override: ttsSection.xf_voice_override || '',
+    minimax_token: ttsSection.minimax_token || '',
+    edge_voice_override: ttsSection.edge_voice_override || ''
+  };
+
+  log(`provider=${providerName} voice=${voice} text=${text.length}字 → ${mp3Name}`);
+
+  try {
+    const result = await provider.synthesize(
+      { text, voice, volume, speed, outFile },
+      creds
+    );
+    log(`✓ ${result.provider} 生成成功: ${result.outFile} (voice=${result.voice})`);
+  } catch (e) {
+    err(`${providerName} 失败: ${e.message}`);
+    process.exit(4);
+  }
+}
+
+main().catch(e => { err(e.message); process.exit(99); });

package/tts/voice-mapping.js

@@ -0,0 +1,37 @@
+'use strict';
+
+/**
+ * 统一 voice 短名表（前端 UI 用这套）
+ *
+ * Qt 调 tts.js 时传的 voice 参数用这里的短名（如 xiaoxiao/yunxi）。
+ * 每个 provider 在自己的 voices 字典里把短名映射到平台真实 voice_id。
+ *
+ * 短名以 edge-tts 风格命名（小写拼音），是 UI 蓝本。
+ */
+
+// 标准短名（前端 UI 应该只展示这些）
+const STANDARD_VOICES = [
+  { short: 'xiaoxiao',   desc: '晓晓 - 女声，自然亲切' },
+  { short: 'yunxi',      desc: '云希 - 男声，年轻活力' },
+  { short: 'yunjian',    desc: '云健 - 男声，成熟稳重' },
+  { short: 'xiaoyi',     desc: '晓伊 - 女声，温柔甜美' },
+  { short: 'yunxia',     desc: '云夏 - 男童声' },
+  { short: 'xiaochen',   desc: '晓辰 - 女声，新闻播报' },
+  { short: 'xiaohan',    desc: '晓涵 - 女声，温暖' },
+  { short: 'xiaomeng',   desc: '晓梦 - 女声，活泼' },
+  { short: 'xiaomo',     desc: '晓墨 - 女声，知性' },
+  { short: 'xiaoqiu',    desc: '晓秋 - 女声，温和' },
+  { short: 'xiaorui',    desc: '晓睿 - 女童声' },
+  { short: 'xiaoshuang', desc: '晓双 - 女童声' },
+  { short: 'xiaoxuan',   desc: '晓萱 - 女声' },
+  { short: 'xiaoyan',    desc: '晓妍 - 女声' },
+  { short: 'xiaoyou',    desc: '悠悠 - 女童声' },
+  { short: 'yunfeng',    desc: '云枫 - 男声' },
+  { short: 'yunhao',     desc: '云皓 - 男声' },
+  { short: 'yunxiang',   desc: '云翔 - 男声' },
+  { short: 'yunyang',    desc: '云扬 - 男声' }
+];
+
+const DEFAULT_VOICE = 'xiaoxiao';
+
+module.exports = { STANDARD_VOICES, DEFAULT_VOICE };