speakdrill 0.2.6 → 0.2.11

package/README.md

@@ -4,7 +4,7 @@
 
 Rust 實作，含 CLI、TUI 與原生 GUI（egui，不是 Electron / Tauri webview）。
 
-> 目前只支援 **Windows x64**（相依 VoiceMeeter）。
+> 目前只支援 **Windows x64**。可選用 **VB-CABLE**（零設定、自動安裝）或 **VoiceMeeter**（Banana/Potato）。
 
 ## 安裝
 
@@ -28,10 +28,11 @@ speakdrill doctor
 ## 快速開始
 
 ```bash
-speakdrill init                  # 偵測裝置、寫設定、設 VoiceMeeter 路由、拉音量
+speakdrill init                  # 偵測裝置、寫設定、自動安裝 VB-CABLE 或設 VoiceMeeter 路由、拉音量
+speakdrill setup                 # 自動完成 per-app 麥克風綁定（原本需手動在 ms-settings:apps-volume 設定）
 speakdrill doctor                # 檢查環境
-speakdrill                      # 終端機介面（預設）
-speakdrill list                 # 列出課程
+speakdrill                       # 終端機介面（預設）
+speakdrill list                  # 列出課程
 speakdrill-gui                   # 原生 GUI
 speakdrill run  --lesson <ID> --course <ID>
 speakdrill batch --code <CODE> --limit 5
@@ -40,12 +41,12 @@ speakdrill reset                 # 還原音訊路由
 
 ## 前置需求
 
-1. **VoiceMeeter**（Banana 或 Potato）
+1. **VB-CABLE**（推薦，零設定）或 **VoiceMeeter**（Banana / Potato）
+   - `speakdrill init --install-driver` 會自動下載並安裝 VB-CABLE（需管理員權限）
+   - 已安裝 VoiceMeeter 者可直接使用，`init` 會偵測並設定路由
 2. **不需要額外裝 TTS**：`speakdrill init` 自動下載 Piper
-3. 目標 App 需開啟 debug port：
-   `--remote-debugging-port=9222 --remote-allow-origins=*`
-4. 在 `ms-settings:apps-volume` 把目標 App 的**輸入裝置**設成 `Voicemeeter Out B1`
-   （這步只能用介面做，Windows 會產生綁定 GUID）
+3. **MyET 的 debug port**：TUI 啟動時會自動檢查 port 9222，沒連上就自動啟動 MyET（帶 `--remote-debugging-port=9222 --remote-allow-origins=*`）；也可以在 TUI 裡按 `m` 手動啟動
+4. **per-app 麥克風綁定**：`speakdrill setup` 會自動完成（原本需手動在 `ms-settings:apps-volume` 設定），VB-CABLE 時會綁定 `CABLE Output (VB-Audio Virtual Cable)`，VoiceMeeter 時綁定 `Voicemeeter Out B1`
 
 ## 文件
 
@@ -53,4 +54,4 @@ speakdrill reset                 # 還原音訊路由
 
 ## 授權
 
-MIT
+MIT

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "speakdrill",
-  "version": "0.2.6",
-  "description": "口說課程自動化練習：TTS 產生示範語音、逐句驅動課程演練、輸出分數報告（Rust，含 TUI / 原生 GUI）",
+  "version": "0.2.11",
+  "description": "\u53e3\u8aaa\u8ab2\u7a0b\u81ea\u52d5\u5316\u7df4\u7fd2\uff1aTTS \u7522\u751f\u793a\u7bc4\u8a9e\u97f3\u3001\u9010\u53e5\u9a45\u52d5\u8ab2\u7a0b\u6f14\u7df4\u3001\u8f38\u51fa\u5206\u6578\u5831\u544a\uff08Rust\uff0c\u542b TUI / \u539f\u751f GUI\uff09",
   "keywords": [
     "speaking",
     "shadowing",
     "drill",
     "tts",
     "voicemeeter",
+    "vb-cable",
     "english",
     "cli",
     "tui",
@@ -25,7 +26,8 @@
     "speakdrill-gui": "bin/speakdrill-gui.js"
   },
   "files": [
-    "bin/",
+    "bin/speakdrill.js",
+    "bin/speakdrill-gui.js",
     "scripts/",
     "README.md",
     "LICENSE"
@@ -42,10 +44,4 @@
   "cpu": [
     "x64"
   ]
-}
-
-
-
-
-
-
+}

package/scripts/install.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 /**
- * 安裝時下載對應平台的原生二進位。
+ * speakdrill 安裝腳本：從 GitHub Releases 下載預編譯執行檔。
  *
- * 環境變數：
- *   SPEAKDRILL_SKIP_DOWNLOAD=1   跳過下載（本機開發用，會直接用 target/ 的執行檔）
- *   SPEAKDRILL_VERSION           指定版本（預設讀 package.json）
+ * 停用下載：
+ *   SPEAKDRILL_SKIP_DOWNLOAD=1   跳過下載（可改讀 target/ 的本機 build）
+ *   SPEAKDRILL_VERSION           覆寫版本（預設讀 package.json）
  *   SPEAKDRILL_REPO              覆寫 GitHub repo（預設 thumb2086/speakdrill）
  */
 const fs = require('fs');
@@ -17,14 +17,12 @@ const VERSION = process.env.SPEAKDRILL_VERSION || pkg.version;
 const REPO = process.env.SPEAKDRILL_REPO || 'thumb2086/speakdrill';
 
 if (process.env.SPEAKDRILL_SKIP_DOWNLOAD === '1') {
-  console.log('[speakdrill] SPEAKDRILL_SKIP_DOWNLOAD=1，跳過下載');
+  console.log('[speakdrill] SPEAKDRILL_SKIP_DOWNLOAD=1；跳過下載');
   process.exit(0);
 }
 
 if (process.platform !== 'win32') {
-  console.log(
-    `[speakdrill] 目前只支援 Windows（需要 VoiceMeeter）。你的平台是 ${process.platform}，跳過安裝。`
-  );
+  console.log(`[speakdrill] 目前僅支援 Windows（VB-CABLE / VoiceMeeter）；本平台為 ${process.platform}，跳過安裝`);
   process.exit(0);
 }
 
@@ -39,7 +37,7 @@ const url = `https://github.com/${REPO}/releases/download/${tag}/${asset}`;
 function download(u, dest) {
   return new Promise((resolve, reject) => {
     const go = (u2, depth = 0) => {
-      if (depth > 5) return reject(new Error('太多重新導向'));
+      if (depth > 5) return reject(new Error('too many redirects'));
       https
         .get(u2, { headers: { 'User-Agent': 'speakdrill-installer' } }, (res) => {
           if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
@@ -60,16 +58,25 @@ function download(u, dest) {
   });
 }
 
+function ensure(outDir) {
+  for (const exe of exes) {
+    const p = path.join(outDir, exe);
+    if (!fs.existsSync(p)) {
+      throw new Error(`安裝後找不到 ${exe}（解壓或下載失敗）`);
+    }
+  }
+}
+
+function rmrf(p) {
+  if (fs.existsSync(p)) fs.rmSync(p, { recursive: true, force: true });
+}
+
 (async () => {
+  // 每次安裝都重新下載並解壓，避免沿用舊 exe 造成版本錯位
+  rmrf(outDir);
   fs.mkdirSync(outDir, { recursive: true });
   const archive = path.join(outDir, asset);
 
-  const existing = path.join(outDir, exes[0]);
-  if (fs.existsSync(existing)) {
-    console.log(`[speakdrill] 已存在 ${existing}`);
-    return;
-  }
-
   console.log(`[speakdrill] 下載 ${url}`);
   try {
     await download(url, archive);
@@ -80,10 +87,11 @@ function download(u, dest) {
       { stdio: 'inherit' }
     );
     fs.unlinkSync(archive);
-    console.log(`[speakdrill] 安裝完成 → ${outDir}`);
+    ensure(outDir);
+    console.log(`[speakdrill] 安裝完成：${outDir}`);
   } catch (e) {
-    console.error(`[speakdrill] 下載失敗：${e.message}`);
-    console.error('[speakdrill] 可改用手動安裝，或設定 SPEAKDRILL_SKIP_DOWNLOAD=1 使用本機建置');
-    process.exit(0); // 不讓 npm install 整個失敗
+    console.error(`[speakdrill] 下載/解壓失敗：${e.message}`);
+    console.error('[speakdrill] 可改用 SPEAKDRILL_SKIP_DOWNLOAD=1 略過下載');
+    process.exit(1);
   }
-})();
+})();