arona-agent 1.0.8 → 1.1.0

package/README.md

@@ -19,6 +19,9 @@ npm i -g arona-agent
 
 # 首次运行自动进入初始化向导
 arona
+
+# 或着如果想先上手玩玩
+npx arona-agent
 ```
 
 ---
@@ -37,6 +40,9 @@ arona --no-voice
 
 # 补全/重新克隆某角色音色
 arona voice add [<角色名>]   # 不带角色名则进入 TUI 选择未补全的角色
+
+# 环境自检
+arona doctor
 ```
 
 ---

package/README_en.md

@@ -17,6 +17,9 @@ npm i -g arona-agent
 
 # First run auto-starts the setup wizard, then launches ARONA
 arona
+
+# Quick Start
+npx arona-agent
 ```
 
 ---
@@ -35,6 +38,9 @@ arona --no-voice
 
 # Clone/re-clone a character's voice
 arona voice add [<character-name>]   # omit the name to enter the TUI for missing voices
+
+# Environment health check
+arona doctor
 ```
 
 ---

package/bin/arona.mjs

@@ -14,8 +14,9 @@ const args = process.argv.slice(2);
 
 const isSetup = args[0] === 'setup';
 const isVoice = args[0] === 'voice';
-const target = isSetup ? 'src/setup.ts' : isVoice ? 'src/voice_cli.ts' : 'src/index.ts';
-const passArgs = (isSetup || isVoice) ? args.slice(1) : args;
+const isDoctor = args[0] === 'doctor';
+const target = isSetup ? 'src/setup.ts' : isVoice ? 'src/voice_cli.ts' : isDoctor ? 'src/doctor.ts' : 'src/index.ts';
+const passArgs = (isSetup || isVoice || isDoctor) ? args.slice(1) : args;
 
 // tsx ships a CLI binary alongside the package. We prefer the local install.
 const tsxBin = process.platform === 'win32'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arona-agent",
-  "version": "1.0.8",
+  "version": "1.1.0",
   "description": "Terminal AI Agent with desktop pet Arona — eye-tracking pupils, voice cloning, Computer Use, TTS/STT, MCP.",
   "license": "MIT",
   "type": "module",

package/python/oss_upload.py

@@ -17,8 +17,22 @@ stdout:
 
 import json
 import os
+import socket
 import sys
 
+# ---- IPv4 优先解析（同 tts_say.py / voice_clone.py）----
+# macOS 家宽坑：有全局 IPv6 但出口路由不通，python 无 Happy Eyeballs →
+# getaddrinfo v6 在前，每次请求先卡满 v6 超时再回落 v4。重排 AF_INET 在前根治。
+_orig_getaddrinfo = socket.getaddrinfo
+
+
+def _ipv4_first_getaddrinfo(*args, **kwargs):
+    res = _orig_getaddrinfo(*args, **kwargs)
+    return sorted(res, key=lambda r: 0 if r[0] == socket.AF_INET else 1)
+
+
+socket.getaddrinfo = _ipv4_first_getaddrinfo
+
 
 def fail(msg):
     print(json.dumps({"error": msg}))

package/python/voice_clone.py

@@ -16,9 +16,32 @@ All logging goes to stderr so stdout stays clean JSON.
 import json
 import os
 import re
+import socket
 import sys
 import time
 
+from _i18n import t
+
+# ---- IPv4 优先解析（同 tts_say.py）----
+# macOS 家宽坑：系统有全局 IPv6 地址但出口路由不通，python 无 Happy Eyeballs，
+# getaddrinfo 返回 v6 在前 → 每次请求先卡满 v6 超时才回落 v4（上传/轮询多请求叠加=分钟级卡死，
+# 表现为"正在克隆"卡住；开代理可用是因为代理直连 127.0.0.1 恰好绕开 v6）。
+# 重排 AF_INET 在前根治；IPv4 不可用时仍按序回落 IPv6。
+_orig_getaddrinfo = socket.getaddrinfo
+
+
+def _ipv4_first_getaddrinfo(*args, **kwargs):
+    res = _orig_getaddrinfo(*args, **kwargs)
+    return sorted(res, key=lambda r: 0 if r[0] == socket.AF_INET else 1)
+
+
+socket.getaddrinfo = _ipv4_first_getaddrinfo
+
+
+def log(msg_zh, msg_en):
+    # 阶段诊断只走 stderr：Node 侧 --verbose 会逐行转发实时可见，stdout 保持纯 JSON。
+    print(f"[voice_clone] {t(msg_zh, msg_en)}", file=sys.stderr, flush=True)
+
 
 def fail(msg):
     print(json.dumps({"error": msg}))
@@ -52,29 +75,39 @@ def main():
 
     # 1. Upload audio to DashScope hosted OSS
     try:
+        log(f"上传音频 {os.path.basename(audio_file)} 到 DashScope 托管 OSS...",
+            f"Uploading {os.path.basename(audio_file)} to DashScope OSS...")
         resp = Files.upload(file_path=audio_file, purpose="voice_clone")
         file_id = resp.output["uploaded_files"][0]["file_id"]
+        log(f"上传完成 file_id={file_id}", f"Upload complete file_id={file_id}")
     except Exception as e:
         fail(f"Upload failed: {e}")
 
     # 2. Get the Alibaba Cloud internal URL (must use internal address)
     try:
+        log("获取 OSS 内部地址...", "Getting OSS internal URL...")
         oss_url = Files.get(file_id).output["url"]
+        log("OSS 内部地址获取成功", "OSS internal URL acquired")
     except Exception as e:
         fail(f"Failed to get OSS URL: {e}")
 
     # 3. Submit voice cloning
     try:
+        log(f"提交音色克隆（model={target_model}，prefix={prefix}）...",
+            f"Submitting voice creation (model={target_model}, prefix={prefix})...")
         svc = VoiceEnrollmentService()
         voice_id = svc.create_voice(target_model=target_model, prefix=prefix, url=oss_url)
+        log(f"已提交，voice_id={voice_id}", f"Submitted, voice_id={voice_id}")
     except Exception as e:
         fail(f"create_voice failed: {e}")
 
     # 4. Wait for voice to be ready (max 5 minutes)
     try:
-        for _ in range(30):
+        for i in range(30):
             info = svc.query_voice(voice_id=voice_id)
             status = info.get("status")
+            log(f"查询克隆状态：{status}（第 {i + 1}/30 次，每 10s）",
+                f"Voice status: {status} ({i + 1}/30, every 10s)")
             if status == "OK":
                 break
             if status == "UNDEPLOYED":
@@ -87,10 +120,12 @@ def main():
 
     # 5. Delete the uploaded file (best-effort cleanup)
     try:
+        log("删除已上传文件（尽力清理）...", "Deleting uploaded file (best-effort)...")
         Files.delete(file_id)
     except Exception:
         pass  # Cleanup is best-effort
 
+    log(f"音色克隆完成 voice_id={voice_id}", f"Voice clone complete voice_id={voice_id}")
     print(json.dumps({"voice_id": voice_id}))
 
 

package/src/doctor.ts

@@ -0,0 +1,385 @@
+// arona doctor：独立环境自检命令（bin/arona.mjs 路由到本文件，不走 REPL/斜杠命令）。
+// 颜色语义：绿 = 正常；黄 = 可略过（未配置/某功能不可用）；红 = 可能影响使用。
+// 注意：勿 import tts_provider / gpt_sovits_local——后者模块级 setInterval 会让本进程无法退出，
+// GPT-SoVITS 配置在此处直接解析 ttsConfig["gpt-sovits"] 原始字段。
+
+import chalk from "chalk";
+import net from "net";
+import { existsSync } from "fs";
+import { join } from "path";
+import { config, settingsExist, PROJECT_ROOT } from "./config.ts";
+import { t } from "./locale.ts";
+import { AGENT_IDS, getMainAgent } from "./agent_registry.ts";
+import { getVoiceId, getGptSovitsVoice } from "./voices.ts";
+import { spawnCompat } from "./utils/spawn.ts";
+
+type Level = "ok" | "warn" | "fail";
+
+let failCount = 0;
+let warnCount = 0;
+
+function item(level: Level, text: string): void {
+  const mark = level === "ok" ? chalk.green("✓") : level === "warn" ? chalk.yellow("!") : chalk.red("✗");
+  if (level === "warn") warnCount++;
+  if (level === "fail") failCount++;
+  console.log(`  ${mark} ${text}`);
+}
+
+function section(title: string): void {
+  console.log(`\n${chalk.bold(title)}`);
+}
+
+interface ProbeResult {
+  ok: boolean;
+  stdout: string;
+  stderr: string;
+}
+
+/** 运行一个命令并收集输出（超时/启动失败均视为不可用，不抛异常）。 */
+function probe(bin: string, args: string[], timeoutMs: number): Promise<ProbeResult> {
+  return new Promise((resolve) => {
+    let proc;
+    try {
+      proc = spawnCompat(bin, args, { stdio: ["ignore", "pipe", "pipe"] });
+    } catch {
+      resolve({ ok: false, stdout: "", stderr: "spawn failed" });
+      return;
+    }
+    let stdout = "";
+    let stderr = "";
+    let settled = false;
+    const timer = setTimeout(() => {
+      if (!settled) {
+        settled = true;
+        try { proc.kill("SIGKILL"); } catch {}
+        resolve({ ok: false, stdout, stderr: "timeout" });
+      }
+    }, timeoutMs);
+    proc.stdout.on("data", (d) => { stdout += d.toString(); });
+    proc.stderr.on("data", (d) => { stderr += d.toString(); });
+    proc.on("error", (err) => {
+      if (!settled) {
+        settled = true;
+        clearTimeout(timer);
+        resolve({ ok: false, stdout, stderr: err.message });
+      }
+    });
+    proc.on("close", (code) => {
+      if (!settled) {
+        settled = true;
+        clearTimeout(timer);
+        resolve({ ok: code === 0, stdout, stderr });
+      }
+    });
+  });
+}
+
+function tcpReachable(host: string, port: number, timeoutMs = 2000): Promise<boolean> {
+  return new Promise((resolve) => {
+    const socket = new net.Socket();
+    let done = false;
+    const finish = (v: boolean) => {
+      if (!done) {
+        done = true;
+        socket.destroy();
+        resolve(v);
+      }
+    };
+    socket.setTimeout(timeoutMs);
+    socket.once("connect", () => finish(true));
+    socket.once("timeout", () => finish(false));
+    socket.once("error", () => finish(false));
+    socket.connect(port, host);
+  });
+}
+
+/** 主程序 Python 的版本要求：3.12 / 3.13（3.14 起 pydantic-core 不支持）。 */
+const PY_REQUIRE = "3.12 / 3.13";
+
+function pyVersionFrom(out: string): string | null {
+  const m = out.match(/Python\s+(\d+\.\d+(?:\.\d+)?)/);
+  return m ? m[1] : null;
+}
+
+/** 主程序 Python 依赖（requirements.txt）：一次子进程探测全部 import。 */
+const DEPS = ["cua", "websockets", "pyaudio", "numpy", "pynput", "dashscope"] as const;
+
+const DEPS_SCRIPT = [
+  "import json",
+  `mods = ${JSON.stringify([...DEPS])}`,
+  "r = {}",
+  "for m in mods:",
+  "    try:",
+  "        __import__(m)",
+  "        r[m] = 1",
+  "    except Exception:",
+  "        r[m] = 0",
+  "print(json.dumps(r))",
+].join("\n");
+
+interface GsvInfo {
+  mode: "local" | "cloud";
+  baseUrl: string;
+  /** 显式配置的 GPT-SoVITS 专用 Python；空 = 回退主程序 Python。 */
+  pythonPath: string;
+  apiScriptPath: string;
+  gptModelPath: string;
+  sovitsModelPath: string;
+  bertPath: string;
+  cnhubertPath: string;
+}
+
+/** 解析 ttsConfig["gpt-sovits"] 原始字段；无任何有效键 = 暂未配置。 */
+function readGsvConfig(): GsvInfo | null {
+  const raw = config.ttsConfig?.["gpt-sovits"];
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return null;
+  const obj = raw as Record<string, unknown>;
+  const s = (k: string) => (typeof obj[k] === "string" ? (obj[k] as string).trim() : "");
+  const configured = ["mode", "pythonPath", "apiScriptPath", "gptModelPath", "sovitsModelPath", "bertPath", "cnhubertPath", "baseUrl", "apiKey"].some((k) => s(k));
+  if (!configured) return null;
+  return {
+    mode: obj.mode === "cloud" ? "cloud" : "local",
+    baseUrl: s("baseUrl") || "http://127.0.0.1:9880",
+    pythonPath: s("pythonPath"),
+    apiScriptPath: s("apiScriptPath"),
+    gptModelPath: s("gptModelPath"),
+    sovitsModelPath: s("sovitsModelPath"),
+    bertPath: s("bertPath"),
+    cnhubertPath: s("cnhubertPath"),
+  };
+}
+
+function parseBaseUrl(baseUrl: string): { host: string; port: number } {
+  try {
+    const u = new URL(baseUrl);
+    return { host: u.hostname || "127.0.0.1", port: u.port ? Number(u.port) : 9880 };
+  } catch {
+    return { host: "127.0.0.1", port: 9880 };
+  }
+}
+
+async function main(): Promise<void> {
+  console.log(chalk.bold("ARONA doctor"));
+
+  const mainPy = config.pythonPath;
+  const gsv = readGsvConfig();
+  const gsvPy = gsv?.pythonPath || mainPy;
+
+  // 并行探测：主程序 Python 版本 + 依赖；GPT-SoVITS Python 版本 + torch
+  const pyVerP = probe(mainPy, ["--version"], 10000);
+  const pyDepsP = probe(mainPy, ["-c", DEPS_SCRIPT], 60000);
+  let gsvVerP: Promise<ProbeResult> | null = null;
+  let gsvTorchP: Promise<ProbeResult> | null = null;
+  if (gsv) {
+    gsvVerP = probe(gsvPy, ["--version"], 10000);
+    gsvTorchP = probe(gsvPy, ["-c", "import torch;print(torch.__version__)"], 90000);
+  }
+  const [pyVer, pyDeps, gsvVer, gsvTorch] = await Promise.all([pyVerP, pyDepsP, gsvVerP, pyTorch(gsvTorchP)]);
+
+  // ---------------- 核心环境 ----------------
+  section(t("核心环境", "Core"));
+
+  const nodeVer = process.versions.node;
+  const [nodeMajor, nodeMinor] = nodeVer.split(".").map(Number);
+  if (nodeMajor > 22 || (nodeMajor === 22 && nodeMinor >= 19)) {
+    item("ok", `Node.js v${nodeVer}`);
+  } else {
+    item("fail", t(`Node.js v${nodeVer}，需 ≥ 22.19.0`, `Node.js v${nodeVer}, need >= 22.19.0`));
+  }
+
+  if (settingsExist()) {
+    item("ok", t("配置文件 ~/.arona/settings.json", "Config file ~/.arona/settings.json"));
+  } else {
+    item("fail", t("配置文件不存在，请先运行 arona setup", "Config file missing. Run `arona setup` first"));
+  }
+
+  item(
+    config.apiKey ? "ok" : "fail",
+    config.apiKey
+      ? t("LLM API Key 已配置", "LLM API Key configured")
+      : t("LLM API Key 未配置", "LLM API Key not configured"),
+  );
+
+  if (!pyVer.ok) {
+    item("fail", t(`主程序 Python 未找到：${mainPy}`, `Main Python not found: ${mainPy}`));
+  } else {
+    const ver = pyVersionFrom(pyVer.stdout);
+    const mm = ver?.split(".").slice(0, 2).join(".");
+    if (!ver) {
+      item("fail", t("无法获取主程序 Python 版本", "Failed to detect main Python version"));
+    } else if (mm !== "3.12" && mm !== "3.13") {
+      item("fail", t(`主程序 Python ${ver} 版本不受支持，需 ${PY_REQUIRE}`, `Main Python ${ver} unsupported, need ${PY_REQUIRE}`));
+    } else {
+      item("ok", t(`主程序 Python ${ver}`, `Main Python ${ver}`));
+    }
+  }
+
+  if (pyVer.ok) {
+    let missing: string[] | null = null;
+    try {
+      const r = JSON.parse(pyDeps.stdout) as Record<string, unknown>;
+      missing = DEPS.filter((d) => !r[d]);
+    } catch {
+      missing = null;
+    }
+    if (missing === null) {
+      item("warn", t("Python 依赖检查失败", "Python dependency check failed"));
+    } else if (missing.length > 0) {
+      item("warn", t(
+        `缺少 Python 依赖：${missing.join("、")}，运行 pip install -r requirements.txt 补装`,
+        `Missing Python deps: ${missing.join(", ")}. Run pip install -r requirements.txt`,
+      ));
+    } else {
+      item("ok", t("Python 依赖完整", "Python dependencies installed"));
+    }
+  }
+
+  // ---------------- 语音 ----------------
+  if (config.noVoice) {
+    console.log(t("\n语音功能已禁用（--no-voice），跳过语音检查。", "\nVoice disabled (--no-voice), voice checks skipped."));
+  } else {
+    section(t("语音", "Voice"));
+    console.log(`  TTS Provider：${config.ttsProvider === "gpt-sovits" ? "GPT-SoVITS" : t("阿里云百炼", "Aliyun Bailian")}`);
+
+    if (config.ttsProvider === "aliyun") {
+      item(
+        config.ttsApiKey ? "ok" : "warn",
+        config.ttsApiKey
+          ? t("TTS API Key 已配置", "TTS API Key configured")
+          : t("TTS API Key 未配置，语音合成不可用", "TTS API Key not configured, speech synthesis unavailable"),
+      );
+    }
+
+    const mainAgent = getMainAgent();
+    if (config.ttsProvider === "aliyun") {
+      item(
+        getVoiceId(mainAgent) ? "ok" : "warn",
+        getVoiceId(mainAgent)
+          ? t(`当前角色 ${mainAgent} 已配置音色`, `Current agent ${mainAgent} has a cloned voice`)
+          : t(`当前角色 ${mainAgent} 未克隆音色，TTS 静音；arona voice add 可补全`, `Current agent ${mainAgent} has no cloned voice, TTS muted. Run \`arona voice add\``),
+      );
+    }
+
+    // GPT-SoVITS（无论当前 provider 是否为它，配置了就体检）
+    if (!gsv) {
+      item("warn", t("GPT-SoVITS：暂未配置", "GPT-SoVITS: not configured"));
+    } else {
+      if (gsv.pythonPath) {
+        if (!gsvVer?.ok) {
+          item("fail", t(`GPT-SoVITS Python 未找到：${gsv.pythonPath}`, `GPT-SoVITS Python not found: ${gsv.pythonPath}`));
+        } else {
+          const ver = pyVersionFrom(gsvVer.stdout) ?? "";
+          item("ok", t(`GPT-SoVITS Python ${ver}`, `GPT-SoVITS Python ${ver}`));
+        }
+      } else {
+        // 未单独配置专用 Python：按设计回退主程序 Python（是否可用由 torch 检查揭示）
+        if (!pyVer.ok) {
+          item("fail", t("GPT-SoVITS Python 未配置，且主程序 Python 不可用", "GPT-SoVITS Python not configured and main Python unavailable"));
+        } else {
+          item("warn", t(
+            `GPT-SoVITS Python 未单独配置，将使用主程序 Python ${pyVersionFrom(pyVer.stdout) ?? ""}`,
+            `GPT-SoVITS Python not set; falls back to main Python ${pyVersionFrom(pyVer.stdout) ?? ""}`,
+          ));
+        }
+      }
+
+      if (gsvTorch?.ok && gsvTorch.stdout.trim()) {
+        item("ok", t(`PyTorch ${gsvTorch.stdout.trim()}`, `PyTorch ${gsvTorch.stdout.trim()}`));
+      } else {
+        item("warn", t("PyTorch 未安装，GPT-SoVITS 合成不可用", "PyTorch not installed, GPT-SoVITS synthesis unavailable"));
+      }
+
+      if (gsv.mode === "local") {
+        if (!gsv.apiScriptPath) {
+          item("warn", t("api_v2 脚本未配置，无法自动启动本地服务", "api_v2 script not configured, cannot auto-start local server"));
+        } else if (!existsSync(gsv.apiScriptPath)) {
+          item("warn", t(`api_v2 脚本不存在：${gsv.apiScriptPath}`, `api_v2 script not found: ${gsv.apiScriptPath}`));
+        } else {
+          item("ok", t("api_v2 脚本就绪", "api_v2 script ready"));
+        }
+
+        // 配置了但路径失效的权重
+        const badPaths: string[] = [];
+        if (gsv.gptModelPath && !existsSync(gsv.gptModelPath)) badPaths.push("gptModelPath");
+        if (gsv.sovitsModelPath && !existsSync(gsv.sovitsModelPath)) badPaths.push("sovitsModelPath");
+        if (badPaths.length > 0) {
+          item("warn", t(`模型权重路径不存在：${badPaths.join("、")}`, `Model weight path(s) not found: ${badPaths.join(", ")}`));
+        } else {
+          const hasGpt = !!gsv.gptModelPath || AGENT_IDS.some((id) => !!getGptSovitsVoice(id)?.gptWeightsPath?.trim());
+          const hasSovits = !!gsv.sovitsModelPath || AGENT_IDS.some((id) => !!getGptSovitsVoice(id)?.sovitsWeightsPath?.trim());
+          if (hasGpt && hasSovits) {
+            item("ok", t("模型权重已配置", "Model weights configured"));
+          } else {
+            item("warn", t("未配置模型权重，本地合成不可用", "No model weights configured, local synthesis unavailable"));
+          }
+        }
+
+        const bertOk = !!gsv.bertPath && existsSync(gsv.bertPath);
+        const hubOk = !!gsv.cnhubertPath && existsSync(gsv.cnhubertPath);
+        if (bertOk && hubOk) {
+          item("ok", t("BERT / CNHubert 就绪", "BERT / CNHubert ready"));
+        } else {
+          item("warn", t("BERT 或 CNHubert 未配置或不存在，自动启动本地服务需要它们", "BERT or CNHubert missing; both are required to auto-start the local server"));
+        }
+
+        const { host, port } = parseBaseUrl(gsv.baseUrl);
+        const alive = await tcpReachable(host, port);
+        item(
+          alive ? "ok" : "warn",
+          alive
+            ? t(`本地服务运行中 ${host}:${port}`, `Local server running at ${host}:${port}`)
+            : t("本地服务未运行，首次合成时自动启动", "Local server not running; it will auto-start on first synthesis"),
+        );
+      } else {
+        const { host, port } = parseBaseUrl(gsv.baseUrl);
+        const alive = await tcpReachable(host, port, 3000);
+        item(
+          alive ? "ok" : "warn",
+          alive
+            ? t(`云端服务可达 ${gsv.baseUrl}`, `Cloud service reachable at ${gsv.baseUrl}`)
+            : t(`云端服务不可达：${gsv.baseUrl}`, `Cloud service unreachable: ${gsv.baseUrl}`),
+        );
+      }
+    }
+
+    if (config.sttEnabled) {
+      item(
+        config.sttApiKey ? "ok" : "warn",
+        config.sttApiKey
+          ? t("STT API Key 已配置", "STT API Key configured")
+          : t("STT API Key 未配置，语音识别不可用", "STT API Key not configured, speech recognition unavailable"),
+      );
+    }
+  }
+
+  // ---------------- 桌宠 ----------------
+  section(t("桌宠", "Pet"));
+  const electronOk = existsSync(join(PROJECT_ROOT, "node_modules", "electron"));
+  item(
+    electronOk ? "ok" : "fail",
+    electronOk
+      ? t("Electron 已安装", "Electron installed")
+      : t(`Electron 未安装，桌宠不可用；在 ${PROJECT_ROOT} 运行 npm install`, `Electron not installed, pet unavailable. Run npm install in ${PROJECT_ROOT}`),
+  );
+
+  // ---------------- 汇总 ----------------
+  console.log();
+  if (failCount > 0) {
+    console.log(chalk.red(t(`发现 ${failCount} 项可能影响使用的问题`, `${failCount} issue(s) that may affect usage`)));
+  } else if (warnCount > 0) {
+    console.log(chalk.yellow(t(`有 ${warnCount} 项可略过（未配置或功能受限）`, `${warnCount} item(s) skippable (not configured or limited)`)));
+  } else {
+    console.log(chalk.green(t("一切正常", "All checks passed")));
+  }
+  process.exitCode = failCount > 0 ? 1 : 0;
+}
+
+/** 占位透传：让 Promise.all 的元素类型统一（null 探测保持 null）。 */
+function pyTorch(p: Promise<ProbeResult> | null): Promise<ProbeResult | null> {
+  return p ?? Promise.resolve(null);
+}
+
+main().catch((err) => {
+  console.error(chalk.red(t(`doctor 执行失败：`, `doctor failed: `) + (err instanceof Error ? err.message : String(err))));
+  process.exitCode = 1;
+});

package/src/utils/python.ts

@@ -1,6 +1,6 @@
 import type { ChildProcessWithoutNullStreams } from "child_process";
 import { join } from "path";
-import { PYTHON_DIR, config } from "../config.ts";
+import { PYTHON_DIR, config, verbose } from "../config.ts";
 import { t, getLang } from "../locale.ts";
 import { spawnCompat, stripProxyEnv } from "./spawn.ts";
 
@@ -42,6 +42,13 @@ export async function runPython(
     });
     proc.stderr.on("data", (data) => {
       stderr += data.toString();
+      // --verbose：逐行实时转发 python stderr，可见 voice_clone 上传/轮询等阶段进度
+      if (verbose) {
+        for (const line of data.toString().split(/[\r\n]+/)) {
+          const msg = line.trim();
+          if (msg) console.error(`[python:${scriptName}]`, msg);
+        }
+      }
     });
     proc.on("close", (code) => {
       clearTimeout(timer);