@oadank/dsh-input-tools 0.3.0 → 0.3.2

package/lib/client.js

@@ -425,6 +425,37 @@ window.__ModuleLoader__.load({
       const [asrInstalling, setAsrInstalling] = useState(false); // 一键安装进行中
       const [asrCmd, setAsrCmd] = useState(null); // 待手动复制的安装命令
       const [vdSamples, setVdSamples] = useState([]); // VoiceDesign 官方示例音频（预生成）
+      // [2026-08-21] 试听失败的错误提示（之前失败静默无反馈）
+      const [previewErr, setPreviewErr] = useState(null);
+      // [2026-08-21] API Key 明文/密文切换（眼睛图标）
+      const [showKeys, setShowKeys] = useState({});
+      // [2026-08-21] 本地 TTS 一键安装命令
+      const [ttsInstalling, setTtsInstalling] = useState(false);
+      const [ttsCmd, setTtsCmd] = useState(null);
+      // [2026-08-21] 密钥输入框 + 眼睛切换（明文/密文），keyName 作 state map 键
+      const secretField = (labelText, keyName, value, onChange, placeholder) => h("label", {
+        style: { display: "flex", flexDirection: "column", gap: "4px", fontSize: "12px", color: "var(--dsw-alias-label-secondary,#9aa3ad)", flex: "1 1 45%", minWidth: "220px" },
+      }, labelText,
+        h("div", { style: { display: "flex", gap: "6px", alignItems: "center" } },
+          h("input", {
+            type: showKeys[keyName] ? "text" : "password",
+            value: value,
+            onChange: onChange,
+            placeholder: placeholder,
+            style: { ...vInput, flex: 1 },
+          }),
+          h("button", {
+            type: "button", "aria-label": showKeys[keyName] ? "隐藏密钥" : "显示密钥", title: showKeys[keyName] ? "隐藏密钥" : "显示密钥",
+            style: {
+              border: "none", borderRadius: "6px", width: "32px", height: "32px", flex: "none",
+              background: "rgba(128,128,128,.12)", color: "inherit", cursor: "pointer", fontSize: "14px",
+              display: "inline-flex", alignItems: "center", justifyContent: "center",
+            },
+            onMouseDown: (e) => e.preventDefault(),
+            onClick: () => setShowKeys((s) => ({ ...s, [keyName]: !s[keyName] })),
+          }, showKeys[keyName] ? "🙈" : "👁"),
+        ),
+      );
 
       useEffect(() => {
         let dead = false;
@@ -516,11 +547,13 @@ window.__ModuleLoader__.load({
       };
 
       // 音色试听：POST /voice-config/preview → 播放返回音频；tag 用于区分多个试听按钮状态；text/cmd/url 可临时指定
+      // [2026-08-21] 失败时显示错误（之前静默无提示，用户填错 API Key 毫无反馈）
       const previewVoice = (engine, voice, context, samplePath, tag, extra) => {
         if (previewRef.current !== null) { previewRef.current.pause(); previewRef.current = null; }
         const curTag = tag ?? engine;
         previewTagRef.current = curTag;
         setPreviewing(curTag);
+        setPreviewErr(null);
         fetch("/voice-config/preview", {
           method: "POST", headers: { "content-type": "application/json" },
           body: JSON.stringify({
@@ -530,7 +563,7 @@ window.__ModuleLoader__.load({
         })
           .then((r) => r.json())
           .then((d) => {
-            if (!d?.ok) { if (previewTagRef.current === curTag) setPreviewing(null); return; }
+            if (!d?.ok) { if (previewTagRef.current === curTag) setPreviewing(null); setPreviewErr(d?.error ?? "试听失败"); return; }
             if (previewTagRef.current !== curTag) return; // 已被「再点=停止」或切换，丢弃
             const audio = new Audio("data:" + d.mediaType + ";base64," + d.data);
             previewRef.current = audio;
@@ -538,7 +571,7 @@ window.__ModuleLoader__.load({
             audio.onerror = () => { if (previewTagRef.current === curTag) setPreviewing(null); };
             audio.play().catch(() => { if (previewTagRef.current === curTag) setPreviewing(null); });
           })
-          .catch(() => { if (previewTagRef.current === curTag) setPreviewing(null); });
+          .catch((e) => { if (previewTagRef.current === curTag) setPreviewing(null); setPreviewErr(String(e?.message ?? e)); });
       };
 
       // [本地改造 2026-08-21] 试听克隆样本的原始音频（用于和克隆合成效果对比还原度）
@@ -647,6 +680,17 @@ window.__ModuleLoader__.load({
           });
         }).catch((e) => { setAsrInstalling(false); setAsrResult({ ok: false, text: String(e) }); });
       };
+      // [2026-08-21] 本地 TTS 一键安装：获取安装命令并显示（与 ASR 同款交互）
+      const installLocalTts = () => {
+        setTtsInstalling(true);
+        setTtsCmd(null);
+        fetch("/tts/install-script").then((r) => r.json()).then((d) => {
+          setTtsInstalling(false);
+          if (!d?.ok) { setTtsCmd(null); setPreviewErr(d?.error ?? "获取安装命令失败"); return; }
+          setTtsCmd(d.command);
+          setPreviewErr(null);
+        }).catch((e) => { setTtsInstalling(false); setPreviewErr(String(e)); });
+      };
 
       // 提示小问号（hover 浮层显示 / 点击固定）；align="right" 时浮层右对齐（向左展开，适合靠左按钮），默认左对齐（向右展开，适合靠右按钮）
       const helpTip = (text, pinned, setPinned, hover, setHover, align, place) => h("span", { style: { position: "relative", display: "inline-flex", alignItems: "center" } },
@@ -690,6 +734,9 @@ window.__ModuleLoader__.load({
         // 分区标题（语音图标已移到各服务商卡片前）
         h("div", { style: { display: "flex", alignItems: "center", gap: "8px", fontSize: "15px", fontWeight: 700, color: "var(--dsw-alias-label-primary,#e6e9ef)" } },
           "语音服务"),
+        // [2026-08-21] 试听失败错误横幅（原来静默无提示）
+        previewErr !== null ? h("div", { style: { fontSize: "12.5px", lineHeight: "1.6", color: "#e5484d", border: "1px solid rgba(229,72,77,.4)", borderRadius: "8px", padding: "8px 10px", background: "rgba(229,72,77,.08)", whiteSpace: "pre-wrap" } },
+          "试听失败：" + previewErr) : null,
         // ⑤ ASR 语音识别（必填项，无开关）
         h("div", { style: { border: "1px solid var(--dsw-alias-border-l1,#333a45)", borderRadius: "10px", padding: "10px 12px", display: "flex", flexDirection: "column", gap: "8px", background: "rgba(128,128,128,.05)" } },
           h("div", { style: { display: "flex", alignItems: "center", gap: "8px" } },
@@ -710,7 +757,7 @@ window.__ModuleLoader__.load({
               (eng.asr.mode ?? "service") === "service" ? vField("本地服务地址", h("input", { value: eng.asr.url ?? "", onChange: (e) => setEngine("asr", { url: e.target.value }, true), placeholder: "http://127.0.0.1:18790", style: vInput })) : null,
               (eng.asr.mode ?? "service") === "cmd" ? vField("本地命令", h("input", { value: eng.asr.cmd ?? "", onChange: (e) => setEngine("asr", { cmd: e.target.value }, true), placeholder: "sherpa-onnx-offline.exe --tokens=... --sense-voice-model=... --num-threads=4", style: vInput })) : null,
               (eng.asr.mode ?? "service") === "api" ? [
-                vField("API Key", h("input", { type: "password", value: eng.asr.apiKey ?? "", onChange: (e) => setEngine("asr", { apiKey: e.target.value }, true), placeholder: "sk-...", style: vInput })),
+                secretField("API Key", "asr", eng.asr.apiKey ?? "", (e) => setEngine("asr", { apiKey: e.target.value }, true), "sk-..."),
                 vField("API 地址", h("input", { value: eng.asr.apiBaseUrl ?? "", onChange: (e) => setEngine("asr", { apiBaseUrl: e.target.value }, true), placeholder: "https://api.openai.com/v1", style: vInput })),
               ] : null,
             ),
@@ -847,13 +894,8 @@ window.__ModuleLoader__.load({
           () => h("div", { style: { display: "flex", flexDirection: "column", gap: "10px" } },
             // [本地改造 2026-08-21] API Key（卡片最上；不再有模型勾选）
             h("div", { style: { display: "flex", flexWrap: "wrap", gap: "10px" } },
-              vField("API Key", h("input", {
-                type: "password",
-                value: eng.xiaomi.apiKey,
-                onChange: (e) => setEngine("xiaomi", { apiKey: e.target.value }, true),
-                placeholder: (eng.xiaomi.apiKey !== "" || meta?.envKeys?.xiaomi) ? "已填写——输入新值可替换" : "MIMO_API_KEY",
-                style: vInput,
-              })),
+              secretField("API Key", "xiaomi", eng.xiaomi.apiKey, (e) => setEngine("xiaomi", { apiKey: e.target.value }, true),
+                (eng.xiaomi.apiKey !== "" || meta?.envKeys?.xiaomi) ? "已填写——输入新值可替换" : "MIMO_API_KEY"),
             ),
             // 语音模型：MiMo-V2.5-TTS（基础 TTS，音色 + 语言风格）
             h("div", { style: { display: "flex", flexDirection: "column", gap: "8px", borderTop: "1px dashed var(--dsw-alias-border-l1,#333a45)", paddingTop: "8px" } },
@@ -945,28 +987,58 @@ window.__ModuleLoader__.load({
         // ③ 本地 TTS（与其他卡片一致：勾选后才显示配置字段）
         vCard(h("span", { style: { display: "inline-flex", alignItems: "center", gap: "6px", flexWrap: "wrap" } },
           ENGINE_LABELS.local,
-          helpTip("本地模型常驻内存（CPU 推理）。填本地命令（每次调用启动进程，较慢）；或填 HTTP 服务地址（推荐，模型常驻一次加载后快）。两者都填时 HTTP 优先；留空则跳过本地引擎。", localTipPinned, setLocalTipPinned, localTipHover, setLocalTipHover, "center"),
+          helpTip("本地模型常驻内存（CPU 推理）。填本地命令（每次调用启动进程，较慢）；或填 HTTP 服务地址（推荐，模型常驻一次加载后快）。两者都填时 HTTP 优先；留空则跳过本地引擎。点「复制安装命令」可一键下载 sherpa-onnx + 中文 MeloTTS 模型 + ffmpeg，并自动生成可用的启动脚本。", localTipPinned, setLocalTipPinned, localTipHover, setLocalTipHover, "center"),
         ), openCards.local, () => toggleCard("local"),
           [
             h("div", { style: { display: "flex", flexWrap: "wrap", gap: "10px" } },
-              vField("本地命令（每次调用启动进程）", h("input", { value: eng.local.cmd ?? "", onChange: (e) => setEngine("local", { cmd: e.target.value }, true), placeholder: "如 melo-tts.exe --text {text} --out {out}", style: vInput })),
+              vField("本地命令（每次调用启动进程）", h("input", { value: eng.local.cmd ?? "", onChange: (e) => setEngine("local", { cmd: e.target.value }, true), placeholder: "如 node <插件目录>\\local-tts.mjs（安装脚本会自动填好）", style: vInput })),
               vField("HTTP 服务地址（常驻模式）", h("input", { value: eng.local.url ?? "", onChange: (e) => setEngine("local", { url: e.target.value }, true), placeholder: "如 http://127.0.0.1:5000/tts（POST {text} 返回音频）", style: vInput })),
             ),
-            h("div", { style: { display: "flex", alignItems: "center", gap: "8px" } },
+            h("div", { style: { display: "flex", alignItems: "center", gap: "8px", flexWrap: "wrap" } },
               previewBtn("local-preview", "试听本地 TTS", () => previewVoice("local", undefined, undefined, undefined, "local-preview", { cmd: eng.local.cmd ?? "", url: eng.local.url ?? "" })),
               h("span", { style: { fontSize: "12px", color: "var(--dsw-alias-label-secondary,#9aa3ad)" } }, "点击试听（用上方填的命令/地址合成）"),
             ),
+            // [2026-08-21] 本地 TTS 一键安装（与 ASR 同款交互）
+            h("div", { style: { display: "flex", alignItems: "center", gap: "10px", flexWrap: "wrap", borderTop: "1px dashed var(--dsw-alias-border-l1,#333a45)", paddingTop: "8px" } },
+              h("button", {
+                type: "button",
+                style: {
+                  border: "none", borderRadius: "999px", padding: "6px 16px", fontSize: "12.5px", fontWeight: 600,
+                  background: ttsInstalling ? "rgba(128,128,128,.15)" : "var(--vk-accent,#4b6fff)",
+                  color: "#fff", cursor: "pointer",
+                },
+                onMouseDown: (e) => e.preventDefault(),
+                onClick: installLocalTts,
+              }, ttsInstalling ? "准备命令…" : "复制安装命令"),
+              h("span", { style: { fontSize: "11.5px", color: "var(--dsw-alias-label-secondary,#9aa3ad)" } },
+                "复制命令后，打开「以管理员身份运行」的 PowerShell 粘贴执行。脚本自动下载 sherpa-onnx（含离线 TTS）+ 中文 MeloTTS 模型 + ffmpeg，并生成 local-tts.mjs 启动脚本"),
+            ),
+            ttsCmd !== null ? h("div", { style: { display: "flex", flexDirection: "column", gap: "4px" } },
+              h("div", { style: { fontSize: "11.5px", color: "var(--dsw-alias-label-secondary,#9aa3ad)" } }, "安装命令（点击选中全部，Ctrl+C 复制）："),
+              h("code", {
+                style: {
+                  display: "block", fontSize: "12px", lineHeight: "1.6", fontFamily: "Consolas, monospace",
+                  color: "var(--dsw-alias-label-primary,#e6e9ef)",
+                  border: "1px solid var(--dsw-alias-border-l1,#333a45)", borderRadius: "8px",
+                  padding: "8px 10px", background: "rgba(128,128,128,.08)",
+                  wordBreak: "break-all", whiteSpace: "pre-wrap", cursor: "text", userSelect: "all",
+                },
+                onMouseDown: (e) => e.preventDefault(),
+                onClick: (e) => {
+                  const sel = window.getSelection();
+                  const range = document.createRange();
+                  range.selectNodeContents(e.currentTarget);
+                  sel.removeAllRanges();
+                  sel.addRange(range);
+                },
+              }, ttsCmd),
+            ) : null,
           ]),
         // ④ 阿里 qwen3-tts
         vCard(ENGINE_LABELS.ali, openCards.ali, () => toggleCard("ali"),
           h("div", { style: { display: "flex", flexWrap: "wrap", gap: "10px" } },
-            vField("API Key", h("input", {
-              type: "password",
-              value: eng.ali.apiKey ?? "",
-              onChange: (e) => setEngine("ali", { apiKey: e.target.value }, true),
-              placeholder: (eng.ali.apiKey !== "" || meta?.envKeys?.ali) ? "已填写——输入新值可替换" : "dashscope API Key",
-              style: vInput,
-            })),
+            secretField("API Key", "ali", eng.ali.apiKey ?? "", (e) => setEngine("ali", { apiKey: e.target.value }, true),
+              (eng.ali.apiKey !== "" || meta?.envKeys?.ali) ? "已填写——输入新值可替换" : "dashscope API Key"),
             vField("音色", voiceSelect("ali", eng.ali.voice ?? "Cherry", meta?.aliVoices, (v) => setEngine("ali", { voice: v }, true))),
           )),
       );

package/lib/index.js

@@ -1010,6 +1010,34 @@ async function apply(ctx) {
           }
         },
       }))
+      // [2026-08-21] 本地 TTS 配置与安装脚本路由（独立 prefix，勿放进 /asr）
+      disposers.push(ctx.webServer.register({
+        kind: 'prefix',
+        path: '/tts',
+        handler: async (req, res) => {
+          const url = new URL(req.url ?? '/', 'http://x')
+          try {
+            if (url.pathname === '/tts/install-script' && req.method === 'GET') {
+              const here = join(fileURLToPath(import.meta.url), '..') // .../lib
+              const scriptPath = join(here, '..', 'scripts', 'install-local-tts.ps1') // .../scripts
+              try {
+                await readFile(scriptPath, 'utf8') // 确认脚本存在
+                return sendJson(res, 200, {
+                  ok: true,
+                  scriptPath,
+                  installDir: join(here, '..', 'sherpa-onnx'),
+                  command: `powershell -ExecutionPolicy Bypass -File "${scriptPath}"`,
+                })
+              } catch {
+                return sendJson(res, 404, { ok: false, error: '安装脚本不存在' })
+              }
+            }
+            return sendJson(res, 404, { ok: false, error: 'not found' })
+          } catch (error) {
+            return sendJson(res, 500, { ok: false, error: error instanceof Error ? error.message : 'unknown' })
+          }
+        },
+      }))
     }
 
     // 1) turn/end 自动语音回复（规则同 api-proxy 原实现）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oadank/dsh-input-tools",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "private": false,
   "type": "module",
   "main": "lib/index.js",
@@ -12,6 +12,7 @@
   },
   "files": [
     "lib",
+    "scripts",
     "README.md",
     "cordis.patch.yml"
   ],

package/scripts/install-asr.ps1

@@ -0,0 +1,202 @@
+# ============================================================
+# dsh-host-voice ASR 一键安装脚本（Windows）
+# 安装内容：
+#   1. sherpa-onnx（含 sherpa-onnx-offline.exe 非流式识别）
+#   2. SenseVoice 中英日韩粤模型（int8）
+#   3. ffmpeg（无则用 winget 安装）
+#   4. 注册 nssm 服务 asr（端口 18790，开机自启）
+#
+# 安装位置：自动放在本插件包目录下的 sherpa-onnx/（脚本位于
+#   <插件包>/scripts/install-asr.ps1，自动推导到 <插件包>/sherpa-onnx）
+#   ——所有人装插件后路径都统一，不会乱。
+# 用法：以管理员身份打开 PowerShell，执行：
+#   powershell -ExecutionPolicy Bypass -File "<插件包>\scripts\install-asr.ps1"
+# 可选参数：-Port 18790（自定义端口）
+# ============================================================
+param(
+  [int]$Port = 18790
+)
+
+$ErrorActionPreference = "Stop"
+$Version = "v1.13.6"
+
+# ---- 0. 自动推导安装目录：脚本在 <插件包>/scripts/，安装到 <插件包>/sherpa-onnx/ ----
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$PluginRoot = Split-Path -Parent $ScriptDir
+$InstallDir = Join-Path $PluginRoot "sherpa-onnx"
+
+Write-Host "==== dsh ASR 一键安装 ====" -ForegroundColor Cyan
+Write-Host "插件包目录: $PluginRoot"
+Write-Host "安装目录:   $InstallDir"
+Write-Host "服务端口:   $Port"
+
+# ---- 0b. 幂等保护：已完整安装则直接退出（不下载、不注册、不碰任何现有配置）----
+$exeExists = Test-Path "$InstallDir\bin\sherpa-onnx-offline.exe"
+$modelExists = Test-Path "$InstallDir\models\sensevoice-int8\model.int8.onnx"
+$serviceHealthy = $false
+try {
+  $r = Invoke-WebRequest -Uri "http://127.0.0.1:$Port/health" -TimeoutSec 3 -UseBasicParsing -ErrorAction Stop
+  $serviceHealthy = ($r.StatusCode -eq 200)
+} catch { }
+
+if ($exeExists -and $modelExists -and $serviceHealthy) {
+  Write-Host "`n检测到本机已完整安装 sherpa-onnx + SenseVoice 模型，且端口 $Port 服务健康。" -ForegroundColor Green
+  Write-Host "无需重复安装，脚本已跳过所有操作（不会改动现有文件和服务）。" -ForegroundColor Green
+  exit 0
+}
+if ($exeExists -and $modelExists) {
+  Write-Host "`n检测到 sherpa-onnx 与模型已存在，但端口 $Port 服务未运行。" -ForegroundColor Yellow
+  Write-Host "将尝试为你注册并启动 nssm 服务（asr）。" -ForegroundColor Yellow
+}
+if ($serviceHealthy) {
+  Write-Host "`n检测到端口 $Port 服务健康，但文件不完整——将补齐缺失文件。" -ForegroundColor Yellow
+}
+
+# ---- 1. 创建目录 ----
+New-Item -ItemType Directory -Force -Path $InstallDir | Out-Null
+New-Item -ItemType Directory -Force -Path "$InstallDir\models" | Out-Null
+New-Item -ItemType Directory -Force -Path "$InstallDir\bin" | Out-Null
+New-Item -ItemType Directory -Force -Path "$InstallDir\tmp" | Out-Null
+
+# ---- 2. 检查 ffmpeg（ASR 转码必需）----
+Write-Host "`n[1/4] 检查 ffmpeg..." -ForegroundColor Yellow
+$ffmpeg = Get-Command ffmpeg -ErrorAction SilentlyContinue
+if (-not $ffmpeg) {
+  Write-Host "  未找到 ffmpeg，尝试 winget 安装（首次安装需同意条款）..." -ForegroundColor Yellow
+  try {
+    winget install --id Gyan.FFmpeg -e --accept-package-agreements --accept-source-agreements
+    $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
+    $ffmpeg = Get-Command ffmpeg -ErrorAction SilentlyContinue
+  } catch {
+    Write-Host "  winget 安装失败，请手动安装 ffmpeg 并加入 PATH" -ForegroundColor Red
+    exit 1
+  }
+}
+Write-Host "  ffmpeg: $($ffmpeg.Source)" -ForegroundColor Green
+
+# ---- 3. 下载 sherpa-onnx ----
+Write-Host "`n[2/4] 下载 sherpa-onnx $Version ..." -ForegroundColor Yellow
+$pkgUrl = "https://github.com/k2-fsa/sherpa-onnx/releases/download/$Version/sherpa-onnx-$Version-win-x64-shared-MD-Release.tar.bz2"
+$pkgFile = "$InstallDir\tmp\sherpa-onnx.tar.bz2"
+if (-not (Test-Path "$InstallDir\bin\sherpa-onnx-offline.exe")) {
+  if (-not (Test-Path $pkgFile)) {
+    Write-Host "  下载 $pkgUrl"
+    Invoke-WebRequest -Uri $pkgUrl -OutFile $pkgFile -UseBasicParsing
+  }
+  Write-Host "  解压..."
+  tar -xjf $pkgFile -C "$InstallDir\tmp"
+  # 解压后目录结构：sherpa-onnx-v1.13.6-win-x64-shared-MD-Release/ 内含 bin/ lib/
+  $extracted = Get-ChildItem "$InstallDir\tmp" -Directory | Where-Object { $_.Name -like "sherpa-onnx-*win*" } | Select-Object -First 1
+  if ($extracted) {
+    Copy-Item "$($extracted.FullName)\bin\*" "$InstallDir\bin\" -Force
+    Copy-Item "$($extracted.FullName)\lib\*" "$InstallDir\lib\" -Force -ErrorAction SilentlyContinue
+    Write-Host "  sherpa-onnx 解压完成" -ForegroundColor Green
+  } else {
+    Write-Host "  解压目录未找到，检查 tmp 目录" -ForegroundColor Red
+    exit 1
+  }
+} else {
+  Write-Host "  sherpa-onnx 已存在，跳过下载" -ForegroundColor Green
+}
+
+# ---- 4. 下载 SenseVoice 模型 ----
+Write-Host "`n[3/4] 下载 SenseVoice int8 模型..." -ForegroundColor Yellow
+$modelDir = "$InstallDir\models\sensevoice-int8"
+$modelUrl = "https://github.com/k2-fsa/sherpa-onnx/releases/download/asr-models/sherpa-onnx-sense-voice-zh-en-ja-ko-yue-int8-2025-09-09.tar.bz2"
+$modelFile = "$InstallDir\tmp\sensevoice.tar.bz2"
+if (-not (Test-Path "$modelDir\model.int8.onnx")) {
+  if (-not (Test-Path $modelFile)) {
+    Write-Host "  下载 $modelUrl"
+    Invoke-WebRequest -Uri $modelUrl -OutFile $modelFile -UseBasicParsing
+  }
+  New-Item -ItemType Directory -Force -Path $modelDir | Out-Null
+  Write-Host "  解压模型..."
+  tar -xjf $modelFile -C $modelDir --strip-components=1
+  Write-Host "  模型解压完成" -ForegroundColor Green
+} else {
+  Write-Host "  模型已存在，跳过下载" -ForegroundColor Green
+}
+
+# ---- 5. 写 ASR 服务脚本 ----
+Write-Host "`n[4/4] 写入 ASR 服务并注册 nssm..." -ForegroundColor Yellow
+# 路径统一用正斜杠，避免 JS 字符串把 \s \b 当转义符
+$exePath = "$InstallDir\bin\sherpa-onnx-offline.exe".Replace('\', '/')
+$modelPath = "$InstallDir\models\sensevoice-int8".Replace('\', '/')
+$serviceScript = @"
+const http = require('node:http');
+const { spawnSync } = require('node:child_process');
+const { existsSync } = require('node:fs');
+const PORT = Number(process.env.ASR_SERVICE_PORT || $Port);
+const SHERPA_BIN = process.env.ASR_SHARPA_BIN || '$exePath';
+const MODEL_DIR = process.env.ASR_MODEL_DIR || '$modelPath';
+const server = http.createServer(async (req, res) => {
+  if (req.method === 'POST' && req.url === '/transcribe') {
+    let body = '';
+    req.on('data', c => body += c);
+    req.on('end', async () => {
+      try {
+        const { audioPath } = JSON.parse(body);
+        if (!audioPath || !existsSync(audioPath)) {
+          res.writeHead(400, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ error: 'invalid audio path' }));
+          return;
+        }
+        const r = spawnSync(SHERPA_BIN, [
+          '--tokens=' + MODEL_DIR + '/tokens.txt',
+          '--sense-voice-model=' + MODEL_DIR + '/model.int8.onnx',
+          '--num-threads=4', audioPath,
+        ], { windowsHide: true, timeout: 30000, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe'] });
+        const all = (r.stdout || '') + '\n' + (r.stderr || '');
+        if (r.status !== 0) {
+          res.writeHead(500, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ error: 'sherpa exit ' + r.status }));
+          return;
+        }
+        const m = all.match(/"text"\s*:\s*"([^"]*)"/);
+        const text = (m && m[1]) ? m[1] : '';
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ text }));
+      } catch (err) {
+        res.writeHead(500, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: String(err && err.message || err) }));
+      }
+    });
+  } else if (req.method === 'GET' && req.url === '/health') {
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ status: 'ok' }));
+  } else {
+    res.writeHead(404); res.end();
+  }
+});
+server.listen(PORT, () => console.log('[ASR] listening on ' + PORT));
+"@
+$serviceFile = "$InstallDir\asr-service.js"
+Set-Content -Path $serviceFile -Value $serviceScript -Encoding UTF8
+
+# ---- 6. 注册 nssm 服务 ----
+$nssm = Get-Command nssm -ErrorAction SilentlyContinue
+if (-not $nssm) {
+  Write-Host "  未找到 nssm，请先安装 nssm（winget install nssm 或从 nssm.cc 下载）" -ForegroundColor Red
+  exit 1
+}
+$nodeExe = (Get-Command node).Source
+nssm stop asr 2>$null | Out-Null
+nssm remove asr confirm 2>$null | Out-Null
+nssm install asr "$nodeExe" "$serviceFile" | Out-Null
+nssm set asr AppDirectory "$InstallDir" | Out-Null
+nssm set asr AppEnvironmentExtra "ASR_SERVICE_PORT=$Port" | Out-Null
+nssm set asr Start SERVICE_AUTO_START | Out-Null
+nssm set asr AppStdout "$InstallDir\asr-stdout.log" | Out-Null
+nssm set asr AppStderr "$InstallDir\asr-stderr.log" | Out-Null
+nssm start asr | Out-Null
+Start-Sleep -Seconds 2
+
+# ---- 7. 验证 ----
+Write-Host "`n==== 安装完成，验证服务 ====" -ForegroundColor Cyan
+try {
+  $health = Invoke-RestMethod -Uri "http://127.0.0.1:$Port/health" -TimeoutSec 5
+  Write-Host "  ASR 服务健康: $($health.status)" -ForegroundColor Green
+} catch {
+  Write-Host "  服务未响应，请查看 $InstallDir\asr-stderr.log" -ForegroundColor Red
+}
+Write-Host "`n请到 dsh 设置 → 语音服务 → ASR，点「检测已安装」自动填入地址 http://127.0.0.1:$Port" -ForegroundColor Cyan

package/scripts/install-local-tts.ps1

@@ -0,0 +1,161 @@
+# ============================================================
+# dsh-input-tools 本地 TTS 一键安装脚本（Windows）
+# 安装内容：
+#   1. sherpa-onnx（含 sherpa-onnx-offline-tts.exe 离线 TTS）
+#   2. 中文 MeloTTS VITS 模型（vits-melo-tts-zh_en）
+#   3. ffmpeg（无则用 winget 安装）
+#   4. 生成 local-tts.mjs 启动脚本（与插件"本地命令"契约一致：
+#      node local-tts.mjs <文本> → stdout 输出 mp3 音频字节）
+#
+# 安装位置：自动放在本插件包目录下的 sherpa-onnx/（脚本位于
+#   <插件包>/scripts/install-local-tts.ps1，自动推导到 <插件包>/sherpa-onnx）
+#   ——与 ASR 安装共用同一目录，两个 exe 一次下载全有。
+# 用法：以管理员身份打开 PowerShell，执行：
+#   powershell -ExecutionPolicy Bypass -File "<插件包>\scripts\install-local-tts.ps1"
+# 装完后到 dsh 设置 → 语音服务 → 本地 TTS，把提示的命令填进「本地命令」。
+# ============================================================
+$ErrorActionPreference = "Stop"
+$Version = "v1.13.6"
+
+# ---- 0. 自动推导安装目录：脚本在 <插件包>/scripts/，安装到 <插件包>/sherpa-onnx/ ----
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$PluginRoot = Split-Path -Parent $ScriptDir
+$InstallDir = Join-Path $PluginRoot "sherpa-onnx"
+
+Write-Host "==== dsh 本地 TTS 一键安装 ====" -ForegroundColor Cyan
+Write-Host "插件包目录: $PluginRoot"
+Write-Host "安装目录:   $InstallDir"
+
+# ---- 0b. 幂等保护：已完整安装则直接退出 ----
+$exeExists = Test-Path "$InstallDir\bin\sherpa-onnx-offline-tts.exe"
+$modelExists = Test-Path "$InstallDir\models\melo\model.onnx"
+if ($exeExists -and $modelExists) {
+  Write-Host "`n检测到本机已完整安装 sherpa-onnx + MeloTTS 模型。" -ForegroundColor Green
+  Write-Host "无需重复下载（local-tts.mjs 仍会确保存在）。" -ForegroundColor Green
+}
+
+# ---- 1. 创建目录 ----
+New-Item -ItemType Directory -Force -Path $InstallDir | Out-Null
+New-Item -ItemType Directory -Force -Path "$InstallDir\models" | Out-Null
+New-Item -ItemType Directory -Force -Path "$InstallDir\bin" | Out-Null
+New-Item -ItemType Directory -Force -Path "$InstallDir\tmp" | Out-Null
+
+# ---- 2. 检查 ffmpeg（合成后放大音量 + 转 mp3 必需）----
+Write-Host "`n[1/3] 检查 ffmpeg..." -ForegroundColor Yellow
+$ffmpeg = Get-Command ffmpeg -ErrorAction SilentlyContinue
+if (-not $ffmpeg) {
+  Write-Host "  未找到 ffmpeg，尝试 winget 安装（首次安装需同意条款）..." -ForegroundColor Yellow
+  try {
+    winget install --id Gyan.FFmpeg -e --accept-package-agreements --accept-source-agreements
+    $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
+    $ffmpeg = Get-Command ffmpeg -ErrorAction SilentlyContinue
+  } catch {
+    Write-Host "  winget 安装失败，请手动安装 ffmpeg 并加入 PATH" -ForegroundColor Red
+    exit 1
+  }
+}
+Write-Host "  ffmpeg: $($ffmpeg.Source)" -ForegroundColor Green
+
+# ---- 3. 下载 sherpa-onnx（与 ASR 共用；含 offline-tts.exe）----
+Write-Host "`n[2/3] 下载 sherpa-onnx $Version ..." -ForegroundColor Yellow
+$pkgUrl = "https://github.com/k2-fsa/sherpa-onnx/releases/download/$Version/sherpa-onnx-$Version-win-x64-shared-MD-Release.tar.bz2"
+$pkgFile = "$InstallDir\tmp\sherpa-onnx.tar.bz2"
+if (-not (Test-Path "$InstallDir\bin\sherpa-onnx-offline-tts.exe")) {
+  if (-not (Test-Path "$InstallDir\bin\sherpa-onnx-offline.exe")) {
+    if (-not (Test-Path $pkgFile)) {
+      Write-Host "  下载 $pkgUrl"
+      Invoke-WebRequest -Uri $pkgUrl -OutFile $pkgFile -UseBasicParsing
+    }
+    Write-Host "  解压..."
+    tar -xjf $pkgFile -C "$InstallDir\tmp"
+    $extracted = Get-ChildItem "$InstallDir\tmp" -Directory | Where-Object { $_.Name -like "sherpa-onnx-*win*" } | Select-Object -First 1
+    if ($extracted) {
+      Copy-Item "$($extracted.FullName)\bin\*" "$InstallDir\bin\" -Force
+      Copy-Item "$($extracted.FullName)\lib\*" "$InstallDir\lib\" -Force -ErrorAction SilentlyContinue
+      Write-Host "  sherpa-onnx 解压完成" -ForegroundColor Green
+    } else {
+      Write-Host "  解压目录未找到，检查 tmp 目录" -ForegroundColor Red
+      exit 1
+    }
+  } else {
+    Write-Host "  检测到已有 sherpa-onnx（ASR 已装），离线 TTS exe 应同在 bin/ 下" -ForegroundColor Yellow
+  }
+} else {
+  Write-Host "  sherpa-onnx 已存在，跳过下载" -ForegroundColor Green
+}
+
+# ---- 4. 下载 MeloTTS 中文模型 ----
+Write-Host "`n[3/3] 下载中文 MeloTTS VITS 模型..." -ForegroundColor Yellow
+$modelDir = "$InstallDir\models\melo"
+$modelUrl = "https://github.com/k2-fsa/sherpa-onnx/releases/download/tts-models/vits-melo-tts-zh_en.tar.bz2"
+$modelFile = "$InstallDir\tmp\melo.tar.bz2"
+if (-not (Test-Path "$modelDir\model.onnx")) {
+  if (-not (Test-Path $modelFile)) {
+    Write-Host "  下载 $modelUrl"
+    Invoke-WebRequest -Uri $modelUrl -OutFile $modelFile -UseBasicParsing
+  }
+  New-Item -ItemType Directory -Force -Path $modelDir | Out-Null
+  Write-Host "  解压模型..."
+  tar -xjf $modelFile -C $modelDir --strip-components=1
+  Write-Host "  模型解压完成" -ForegroundColor Green
+} else {
+  Write-Host "  模型已存在，跳过下载" -ForegroundColor Green
+}
+
+# ---- 5. 写 local-tts.mjs 启动脚本（契约：node local-tts.mjs <文本> → stdout 输出 mp3）----
+# 注意：JS 里含反引号模板字符串，必须用单引号 here-string（@'...'@）字面生成，再替换路径占位符
+Write-Host "`n写入 local-tts.mjs 启动脚本..." -ForegroundColor Yellow
+$exePath = "$InstallDir\bin\sherpa-onnx-offline-tts.exe".Replace('\', '/')
+$basePath = "$InstallDir\models\melo".Replace('\', '/')
+$launcherTemplate = @'
+// local-tts.mjs — 本地 MeloTTS（sherpa-onnx VITS 中文模型）TTS 包装
+// 契约（配合 dsh-input-tools 的"本地命令"）：文本作末参，stdout 输出音频字节（mp3）。
+// 本文件由 install-local-tts.ps1 自动生成，勿手改；重装会重新生成。
+import { execFileSync } from 'node:child_process'
+import { readFileSync, unlinkSync } from 'node:fs'
+import { join } from 'node:path'
+
+const SHERPA = '__SHERPA__'
+const BASE = '__BASE__'
+const text = process.argv.slice(2).join(' ')
+if (!text) {
+  console.error('local-tts: 缺少文本参数')
+  process.exit(1)
+}
+const tmp = join(process.env.TEMP ?? '/tmp', `dsh-local-tts-${process.pid}-${Date.now()}`)
+const wav = `${tmp}.wav`
+const mp3 = `${tmp}.mp3`
+try {
+  execFileSync(SHERPA, [
+    '--vits-model=' + BASE + '/model.onnx',
+    '--vits-tokens=' + BASE + '/tokens.txt',
+    '--vits-lexicon=' + BASE + '/lexicon.txt',
+    '--vits-dict-dir=' + BASE + '/dict',
+    '--vits-length-scale=1.0',
+    '--output-filename=' + wav,
+    text,
+  ], { windowsHide: true, stdio: 'ignore', timeout: 120_000 })
+  // 本地合成音量偏小：ffmpeg 放大 4 倍并转 mp3
+  execFileSync('ffmpeg', ['-y', '-i', wav, '-af', 'volume=4.0', '-c:a', 'libmp3lame', '-b:a', '128k', mp3], {
+    windowsHide: true, stdio: 'ignore', timeout: 60_000,
+  })
+  process.stdout.write(readFileSync(mp3))
+} finally {
+  try { unlinkSync(wav) } catch { /* 忽略 */ }
+  try { unlinkSync(mp3) } catch { /* 忽略 */ }
+}
+'@
+$launcher = $launcherTemplate.Replace('__SHERPA__', $exePath).Replace('__BASE__', $basePath)
+$launcherFile = "$PluginRoot\local-tts.mjs"
+Set-Content -Path $launcherFile -Value $launcher -Encoding UTF8
+Write-Host "  local-tts.mjs: $launcherFile" -ForegroundColor Green
+
+# ---- 6. 完成提示 ----
+Write-Host "`n==== 安装完成 ====" -ForegroundColor Cyan
+$nodeExe = (Get-Command node).Source
+$cmdLine = "$nodeExe `"$launcherFile`""
+Write-Host "请到 dsh 设置 → 语音服务 → 本地 TTS，把下面这行填进「本地命令」："
+Write-Host ""
+Write-Host "  $cmdLine" -ForegroundColor Green
+Write-Host ""
+Write-Host "然后点「试听本地 TTS」验证。若想用常驻 HTTP 模式，可自行加一层服务包装。" -ForegroundColor Cyan