dsh-line-bot 0.10.1 → 0.10.2

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 0.10.2
+
+- 修正 Windows 一鍵配置語音環境：改為直接使用解壓後的 `crispasr.exe`（與 `openblas.dll` 同資料夾），不再只複製 exe 導致缺少 DLL、`--version` 失敗。
+- 安裝時會實際執行 `crispasr.exe --version` 驗證，失敗時回報缺少 DLL 的細節。
+- 修正面板卡在「讀取中」：語音環境偵測改為快取＋只用檔案檢查，`/api/line-bot/status` 不再因 MLX 匯入檢查被阻塞（先前每次可能卡 30 秒以上）。
+
 ## 0.10.1
 
 - 語音：自然語言語氣（instruct）改用 CosyVoice GGUF；MLX 的 instruct 模式會把語氣指令一起念出來，已避免。

package/TROUBLESHOOTING.md

@@ -38,6 +38,11 @@ npx dsh-line-bot doctor --fix   # 安全修復：重連 tunnel、重設 webhook
 - 合成約需 20–40 秒；reply token 過期時會自動改用 push。日誌看 `語音回覆`、`語音合成失敗`。
 - 模型只有在語言上下文有語音提示時才會加 `[[voice]]`；可先用「測試 Agent 回覆」確認。
 
+### Windows 一鍵配置語音失敗
+- 0.10.2 起會直接使用解壓後的 `crispasr.exe`，它必須和 `openblas.dll` 在同一個資料夾。
+- 若仍失敗，到 `%USERPROFILE%\.dsh\line-bot\tts\crispasr\windows\` 找 `crispasr-windows-x86_64-cpu\crispasr.exe`，手動雙擊或執行 `crispasr.exe --version` 看缺哪個 DLL。
+- 也需要 `ffmpeg` 在 PATH 中。
+
 ### 語音把語氣指令念出來
 - 舊版 MLX 的 instruct 模式會把語氣描述一起念；0.10.1 起 instruct 一律走 CosyVoice GGUF。升級後重新產生一次語音即可，舊音檔不會變。
 

package/lib/host.mjs

@@ -51,7 +51,7 @@ const { createVision } = visionMod
 const { createTts } = ttsMod
 const { chunkText, clip, inQuietWindow, jsonFail, jsonOk, maskSecret, readJsonBody, safeArray, sleep, readJsonSafe } = utilMod
 
-export const VERSION = '0.10.1'
+export const VERSION = '0.10.2'
 
 // 環境變數提供的 Cloudflare API Token（方便用 shell 注入、不用把 token 寫進設定檔）。
 // 設定檔裡的 token 優先；兩者都沒有時才用環境變數。
@@ -2801,7 +2801,7 @@ export async function create({ ctx, config: pluginConfig, logger: upstream }) {
         return { messages: built.messages, parsed: built.parsed }
       }
       case 'voice-detect':
-        return tts.detect()
+        return tts.detect({ force: true, validate: true })
       case 'voice-install': {
         if (tts.status().installing) return { started: false, already: true }
         tts.install()

package/lib/tts.mjs

@@ -94,8 +94,13 @@ export function createTts({ dir, logger, getConfig }) {
     last: null,
     lastError: '',
     installing: false,
+    ggufBinary: '',
   }
 
+  let detectCache = { at: 0, value: null }
+  let refCache = { at: 0, key: '', value: null }
+  let mlxError = ''
+
   function setSetup(phase, message, error = '') {
     state.setup = {
       phase,
@@ -126,6 +131,15 @@ export function createTts({ dir, logger, getConfig }) {
   function referenceInfo() {
     const file = referencePath()
     if (!file) return { path: '', exists: false, seconds: 0 }
+    let stamp = ''
+    try {
+      const st = fs.statSync(file)
+      stamp = `${st.size}:${st.mtimeMs}`
+    } catch {
+      stamp = ''
+    }
+    const key = `${file}|${stamp}`
+    if (refCache.value && refCache.key === key && Date.now() - refCache.at < 60000) return refCache.value
     let seconds = 0
     try {
       const out = execFileSync('ffprobe', ['-v', 'error', '-show_entries', 'format=duration', '-of', 'default=nw=1:nk=1', file], {
@@ -136,7 +150,9 @@ export function createTts({ dir, logger, getConfig }) {
     } catch {
       seconds = 0
     }
-    return { path: file, exists: true, seconds: Math.round(seconds * 100) / 100 }
+    const value = { path: file, exists: true, seconds: Math.round(seconds * 100) / 100 }
+    refCache = { at: Date.now(), key, value }
+    return value
   }
 
   function mlxModelCached() {
@@ -156,8 +172,20 @@ export function createTts({ dir, logger, getConfig }) {
     return false
   }
 
-  let mlxError = ''
-  function mlxReady() {
+  function sitePackages(name) {
+    try {
+      const lib = path.join(paths.mlxVenv, 'lib')
+      for (const dir of fs.readdirSync(lib)) {
+        if (!dir.startsWith('python')) continue
+        if (dirExists(path.join(lib, dir, 'site-packages', name))) return true
+      }
+    } catch {
+      /* ignore */
+    }
+    return false
+  }
+
+  function mlxReady({ validate = false } = {}) {
     if (!fileExists(paths.mlxPython)) {
       mlxError = '找不到 MLX Python 環境'
       return false
@@ -166,8 +194,16 @@ export function createTts({ dir, logger, getConfig }) {
       mlxError = `找不到 MLX 合成腳本：${paths.mlxScript}`
       return false
     }
+    if (!sitePackages('mlx_audio') || !sitePackages('mlx_lm')) {
+      mlxError = 'MLX 套件尚未安裝完成'
+      return false
+    }
+    if (!validate) {
+      mlxError = ''
+      return true
+    }
     try {
-      execFileSync(paths.mlxPython, ['-c', 'import mlx_audio, mlx_lm, librosa'], { stdio: 'ignore', timeout: 30000 })
+      execFileSync(paths.mlxPython, ['-c', 'import mlx_audio, mlx_lm, librosa'], { stdio: 'ignore', timeout: 20000 })
       mlxError = ''
       return true
     } catch (error) {
@@ -176,14 +212,39 @@ export function createTts({ dir, logger, getConfig }) {
     }
   }
 
+  function findCrispExe(dir, depth = 3) {
+    if (depth < 0) return ''
+    let entries = []
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true })
+    } catch {
+      return ''
+    }
+    for (const entry of entries) {
+      if (entry.isFile() && /^crispasr\.exe$/i.test(entry.name)) return path.join(dir, entry.name)
+    }
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue
+      const hit = findCrispExe(path.join(dir, entry.name), depth - 1)
+      if (hit) return hit
+    }
+    return ''
+  }
+
   function ggufBinary() {
-    const candidates = [isWin() ? paths.winCrisp : paths.macCrisp, which('crispasr')]
+    if (state.ggufBinary && fileExists(state.ggufBinary)) return state.ggufBinary
+    if (isWin()) {
+      const found = findCrispExe(paths.winDir)
+      if (found) return found
+    }
+    const candidates = [isWin() ? '' : paths.macCrisp, which('crispasr')]
     return candidates.find((item) => item && fileExists(item)) || ''
   }
 
-  function ggufReady() {
+  function ggufReady({ validate = false } = {}) {
     const bin = ggufBinary()
     if (!bin) return false
+    if (!validate) return true
     try {
       execFileSync(bin, ['--version'], { stdio: 'ignore', timeout: 8000 })
       return true
@@ -192,19 +253,23 @@ export function createTts({ dir, logger, getConfig }) {
     }
   }
 
-  function detect() {
+  function detect({ force = false, validate = false } = {}) {
+    const now = Date.now()
+    if (!force && !validate && detectCache.value && now - detectCache.at < 120000) return detectCache.value
     const platform = process.platform
     const arch = process.arch
     const preferred = platform === 'darwin' && arch === 'arm64' ? 'mlx' : 'gguf'
     const ffmpeg = which('ffmpeg')
     const ref = referenceInfo()
-    return {
+    const mlxOk = mlxReady({ validate })
+    const ggufOk = ggufReady({ validate })
+    const value = {
       platform,
       arch,
       preferred,
       ffmpeg: { path: ffmpeg, ok: !!ffmpeg },
       mlx: {
-        ok: mlxReady(),
+        ok: mlxOk,
         python: fileExists(paths.mlxPython) ? paths.mlxPython : '',
         model: MLX_MODEL,
         modelCached: mlxModelCached(),
@@ -212,14 +277,16 @@ export function createTts({ dir, logger, getConfig }) {
         script: paths.mlxScript,
       },
       gguf: {
-        ok: ggufReady(),
+        ok: ggufOk,
         binary: ggufBinary(),
         backend: GGUF_BACKEND,
       },
       reference: ref,
       setup: state.setup,
-      ready: (mlxReady() || ggufReady()) && !!ref.path,
+      ready: (mlxOk || ggufOk) && !!ref.path,
     }
+    detectCache = { at: now, value }
+    return value
   }
 
   function providerFor(cfg = cfgVoice()) {
@@ -349,18 +416,15 @@ export function createTts({ dir, logger, getConfig }) {
     const zip = path.join(root, 'crispasr-windows.zip')
     await downloadFile(CRISPASR_WIN_URL, zip)
     await run('powershell', ['-NoProfile', '-Command', `Expand-Archive -LiteralPath ${JSON.stringify(zip)} -DestinationPath ${JSON.stringify(paths.winDir)} -Force`], { timeout: 300000 })
-    const found = []
-    for (const name of fs.readdirSync(paths.winDir)) {
-      const full = path.join(paths.winDir, name)
-      if (/crispasr(\.exe)?$/i.test(name)) found.push(full)
-      if (dirExists(full)) {
-        for (const sub of fs.readdirSync(full)) {
-          if (/^crispasr(\.exe)?$/i.test(sub)) found.push(path.join(full, sub))
-        }
-      }
+    const exe = findCrispExe(paths.winDir)
+    if (!exe) throw new Error('解壓縮後找不到 crispasr.exe')
+    try {
+      execFileSync(exe, ['--version'], { encoding: 'utf8', timeout: 15000 })
+    } catch (error) {
+      const detail = String(error?.stderr || error?.message || error).slice(0, 300)
+      throw new Error(`crispasr.exe 無法執行（可能是缺少 DLL）：${detail}`)
     }
-    if (!found[0]) throw new Error('解壓縮後找不到 crispasr.exe')
-    if (found[0] !== paths.winCrisp) fs.copyFileSync(found[0], paths.winCrisp)
+    state.ggufBinary = exe
     return 'gguf'
   }
 
@@ -420,6 +484,13 @@ export function createTts({ dir, logger, getConfig }) {
       setSetup('test', '測試語音合成（instruct 模式會用 GGUF 引擎）')
       await synthesize('主人，語音功能測試成功。', { env, skipConsent: true })
       const finalProvider = providerFor() || provider
+      try {
+        fs.writeFileSync(path.join(root, '.ready'), new Date().toISOString())
+      } catch {
+        /* ignore */
+      }
+      detectCache = { at: 0, value: null }
+      refCache = { at: 0, key: '', value: null }
       setSetup('done', `環境已就緒（${finalProvider === 'mlx' ? 'macOS MLX' : 'CosyVoice GGUF'}）`)
       return { started: true, provider: finalProvider }
     } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-line-bot",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "description": "把 LINE 官方帳號（Messaging API）接進 DeepSeek Harness 的插件：內建 Cloudflare Tunnel、人設選擇（大肥魚或插件自訂）、主動傳訊與完整設定面板。",
   "type": "module",
   "main": "index.js",