playlist-admin 2.15.67 → 2.15.69

package/cli/index.js

@@ -11,10 +11,16 @@ import { fileURLToPath } from 'node:url';
 
 const HELP = `playlist-admin CLI
 
-  Runs the same engine as the GUI app (shared Dart code). Requires a built
-  release: flutter build windows --release
+  Runs the same engine as the GUI app (shared Dart code).
 
 Usage:
+  playlist-admin -v | --version | version   Show CLI + GUI 版本，並檢查有沒有新版
+  playlist-admin -h | --help | help         顯示這份說明
+  playlist-admin update| upgrade             更新 CLI（npm）並提示 GUI 更新方式
+  playlist-admin where                      顯示根目錄 / exe / 資料夾位置
+  playlist-admin doctor [--fast] [--verbose] [--no-stt]
+                                         音訊庫健康檢查（覆蓋率/損毀/品質/語言/額度）
+
   playlist-admin pipeline [--step N]     Run full pipeline (or from step N)
   playlist-admin podcast                 Run podcast pipeline
   playlist-admin status                  Show status
@@ -44,9 +50,40 @@ function projectRoot() {
   while (true) {
     if (fs.existsSync(path.join(dir, 'pubspec.yaml'))) return dir;
     const parent = path.dirname(dir);
-    if (parent === dir) return null;
+    if (parent === dir) break;
     dir = parent;
   }
+  // 從 npm 全域包呼叫時 cwd 向上找不到 pubspec.yaml（npm 包不含 Dart 引擎），
+  // 這時要找 GUI 的安裝目錄——它才是真正持有 playlist-admin.exe 的地方。
+  // 沒有這段 fallback 的話，使用者每次都得手動設 PA_ROOT 才能跑任何命令。
+  return installedRoot();
+}
+
+/// GUI 安裝目錄候選（依序找第一個真的持有 exe 的）。
+///
+/// 安裝版（Inno Setup）的 exe 在**目錄根層**，開發版在 build/windows/...，
+/// 兩種都要認，否則只有開發者能從 npm 呼叫 CLI。
+function installedRoot() {
+  const home = process.env.USERPROFILE || process.env.HOME || '';
+  const localAppData = process.env.LOCALAPPDATA || '';
+  const programFiles = process.env.ProgramFiles || 'C:\\Program Files';
+  const programFilesX86 =
+    process.env['ProgramFiles(x86)'] || 'C:\\Program Files (x86)';
+  const dirs = [];
+  if (localAppData) {
+    dirs.push(path.join(localAppData, 'Programs', 'playlist-admin'));
+    dirs.push(path.join(localAppData, 'playlist-admin'));
+  }
+  if (home) {
+    dirs.push(path.join(home, 'playlist-admin'));
+    dirs.push(path.join(home, 'Desktop', 'playlist-admin'));
+  }
+  dirs.push(path.join(programFiles, 'playlist-admin'));
+  dirs.push(path.join(programFilesX86, 'playlist-admin'));
+  for (const d of dirs) {
+    if (exePath(d)) return d;
+  }
+  return null;
 }
 
 /// npm 包自身目錄（全域 npm i -g 時，cwd 向上找不到 pubspec，
@@ -60,7 +97,11 @@ function packageRoot() {
 }
 
 function exePath(root) {
+  if (!root) return null;
   const candidates = [
+    // 安裝版（Inno Setup 打包）：exe 直接在安裝目錄根層
+    path.join(root, 'playlist-admin.exe'),
+    // 開發版：flutter build windows --release 的輸出
     path.join(root, 'build', 'windows', 'x64', 'runner', 'Release', 'playlist-admin.exe'),
     path.join(root, 'build', 'windows', 'x64', 'runner', 'Debug', 'playlist-admin.exe'),
     path.join(root, 'build', 'windows', 'arm64', 'runner', 'Release', 'playlist-admin.exe'),
@@ -243,12 +284,86 @@ function runSkill(args) {
   process.exit(1);
 }
 
+/// npm 包自身的版本（package.json）。CI 由 git tag 填入。
+function packageVersion() {
+  try {
+    const pkg = path.join(packageRoot() || '', 'package.json');
+    return JSON.parse(fs.readFileSync(pkg, 'utf8')).version || '?';
+  } catch {
+    return '?';
+  }
+}
+
+/// GUI 引擎（playlist-admin.exe）的版本。
+/// exe 的 Windows VersionInfo 沒被 CI 改（仍是 pubspec 的 3.0.0-beta.1），
+/// 所以直接問引擎自己——它知道 build 時注入的 APP_VERSION。
+function guiVersion(exe) {
+  if (!exe || !fs.existsSync(exe)) return null;
+  const r = spawnSync(exe, [], {
+    env: { ...process.env, PA_CLI_ARGS: '["version"]' },
+    encoding: 'utf8',
+    windowsHide: true,
+    timeout: 30000,
+  });
+  const out = (r.stdout || '').trim();
+  const m = out.match(/Engine\s+(\S+)/);
+  if (m) return m[1];
+  // 引擎起不來就退回修改時間，至少讓使用者看得出新舊
+  try {
+    const mt = fs.statSync(exe).mtime.toISOString().slice(0, 16).replace('T', ' ');
+    return `(exe 最後修改 ${mt})`;
+  } catch {
+    return null;
+  }
+}
+
+function cmdVersion() {
+  const cli = packageVersion();
+  const root = installedRoot() || projectRoot();
+  const exe = exePath(root);
+  const gv = guiVersion(exe);
+  console.log(`CLI ${cli}`);
+  console.log(gv ? `GUI ${gv}  (${exe})` : 'GUI （找不到安裝中的 GUI）');
+  if (gv && !gv.startsWith('(') && gv !== cli) {
+    console.log('⚠️  CLI 與 GUI 版本不一致 → 先更新 GUI 再用 CLI');
+  }
+  const latest = runQuiet('npm', ['view', 'playlist-admin', 'version']);
+  if (latest && latest !== cli) {
+    console.log(`最新 ${latest}  →  npm i -g playlist-admin@latest`);
+  }
+}
+
+function runQuiet(cmd, cmdArgs) {
+  try {
+    const r = spawnSync(cmd, cmdArgs, { encoding: 'utf8', windowsHide: true });
+    return (r.stdout || '').trim().split('\n').pop();
+  } catch {
+    return null;
+  }
+}
+
 async function main() {
   const args = process.argv.slice(2);
   if (args.length === 0) {
     console.log(HELP);
     return;
   }
+  // 標準旗標
+  if (args[0] === '-h' || args[0] === '--help' || args[0] === 'help') {
+    console.log(HELP);
+    return;
+  }
+  if (args[0] === '-v' || args[0] === '--version' || args[0] === 'version') {
+    cmdVersion();
+    return;
+  }
+  if (args[0] === '--doctor') {
+    args[0] = 'doctor';
+  }
+  if (args[0] === 'update' || args[0] === 'upgrade') {
+    cmdUpdate();
+    return;
+  }
   if (args[0] === 'rag') {
     runRag(args.slice(1));
     return;
@@ -261,6 +376,13 @@ async function main() {
     runSkill(args.slice(1));
     return;
   }
+  if (args[0] === 'where' || args[0] === 'doctor-env') {
+    const root = installedRoot() || projectRoot();
+    console.log(`根目錄: ${root || '(找不到)'}`);
+    console.log(`exe    : ${exePath(root) || '(找不到)'}`);
+    console.log(`資料   : ${path.join(root || '?', 'data')}`);
+    return;
+  }
 
   const root = projectRoot();
   if (!root) {
@@ -277,6 +399,24 @@ async function main() {
   forward(exe, args);
 }
 
+/// 更新 CLI 與 GUI。
+function cmdUpdate() {
+  console.log('更新 CLI (npm)...');
+  const r = spawnSync('npm', ['install', '-g', 'playlist-admin@latest'], {
+    stdio: 'inherit',
+    windowsHide: true,
+  });
+  if (r.status !== 0) {
+    console.error('npm 更新失敗，試試用系統管理員權限重跑');
+    process.exit(1);
+  }
+  console.log('');
+  console.log('更新 GUI...');
+  console.log('GUI 是獨立安裝檔，請下載最新的 Setup 執行檔：');
+  console.log('  https://github.com/thumb2086/playlist-admin/releases/latest');
+  console.log('（或直接在 app 設定頁按「檢查更新」）');
+}
+
 main().catch((e) => {
   console.error(e);
   process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playlist-admin",
-  "version": "2.15.67",
+  "version": "2.15.69",
   "description": "playlist-admin CLI - pipeline, podcast, music + podcast RAG + study RAG (PDF 試題/課本)",
   "type": "module",
   "bin": {