playlist-admin 2.15.17 → 2.15.18

package/README.md

@@ -1,100 +1,100 @@
-# playlist-admin
-
-A Flutter desktop app for Spotify-native music library management: browse the
-Spotify home feed, search & stream, playlist sync, batch downloads, and stats.
-
-## Features
-
-- **Spotify 原生整合** — 個人化主頁 / 搜尋串流 / 你的歌單（內部 GQL API，WebView 登入）
-- **串流播放** — Spotify 搜尋 → yt-dlp 解析 → ffmpeg VBR 0 轉碼 → 本地 HTTP 串流（可選快取 cache\stream\）
-- **原生下載** — yt-dlp 256k Opus → mp3 VBR 0（`preferredquality: 0`），批量一鍵補全
-- **播放清單同步** — Spotify embed API 抓取 → m3u8 + 自動下載缺漏曲目
-- **工作列媒體控制器** — SMTC 進度條 + 拖動 seek + 播放/暫停/上下首
-- **播放佇列** — 拖曳排序 / 移除 / 跳轉 / play next，重啟還原（cache\queue.json）
-- **播放統計** — 50%/4min scrobble 規則 → Top 曲目 / 聆聽分鐘 / 最近播放
-- **下載統計** — 每輪下載成功率紀錄（cache\downloads_log.json）
-- **Sleep timer / Crossfade / 全域熱鍵**（Space、←/→ seek、N/P 切歌）
-- **Podcast + RAG** — RSS 下載、Groq 轉錄、Ollama chroma 問答
-- **Discord RPC** — 現播歌曲 + 封面
-- **一起聽（Jam）** — 免費版 Spotify Jam：開房間（免註冊/免外部伺服器），
-  同一個 Wi-Fi 下大家加入，共享播放佇列、即時同步播放進度、投票跳歌、
-  聊天室。手機（Android/iOS）也能加入房主一起聽。
-
-## 資料夾結構（`Music\playlist-admin\`）
-
-```
-music\        ← 唯一音樂庫（mp3）
-playlists\    ← m3u8
-lyrics\       ← LRC
-podcasts\     ← 播客音檔
-cache\spotify ← Spotify 快取 / snapshot / session
-cache\podcast ← 播客處理快取 / chroma_db
-cache\lufs    ← LUFS 快取
-cache\stream  ← 串流快取
-cache\thumbnails
-exports\      ← USB 匯出
-logs\         ← 日誌
-tools\        ← bridge 腳本
-config.json   ← 設定
-```
-
-## Build
-
-```bash
-flutter pub get
-flutter build windows --release   # 桌面版
-flutter build apk --release       # Android（手機版）
-flutter build ios --release       # iOS（需 macOS + Xcode）
-```
-
-## 一起聽（Jam）
-
-在側邊欄選「一起聽」：
-
-1. **建立房間** — 輸入暱稱 →「建立新房間」。房主端會自動開啟
-   WebSocket + 音訊串流伺服器，並顯示房主位址（`IP:埠口`）與 6 位房間代碼。
-2. **加入房間** — 對方輸入房主位址 + 房間代碼 + 暱稱即可加入
-   （手機/桌機皆可；手機需與房主連同一個 Wi-Fi）。
-3. 任何人都能**搜尋 Spotify 加歌**（房主需先在本機「搜尋」頁登入 Spotify）、
-   **投票**（上下箭頭排序）、**投票跳歌**（達半數跳過）、**聊天**。
-   播放進度由房主掌控，成員每幾秒做 drift 校正，確保同步。
-
-技術重點：
-
-- 房主是「伺服器」：`lib/services/jam_service.dart` 用 `dart:io` 自架
-  HttpServer + WebSocket，成員連 `ws://<ip>:<port>/jam/ws`。
-- 歌曲來源：本機音樂庫（`local`，`/jam/audio` 支援 Range 串流）或
-  Spotify 搜尋後由 yt-dlp 串流（`stream`，走既有的 `StreamServer`）。
-- 成員端透過 `PlayerController.playJamUrl()` 播放房主提供的 URL，
-  `jamFollowMode` 讓播放/暫停/上下首/seek 指令自動轉送給房主。
-- 手機相容：Windows 專用程式碼（win32 單一實例、SMTC、WebView 登入）
-  都已加平台守衛；Android/iOS 已加入 `flutter create` 平台資料夾與
-  網路權限（INTERNET / cleartext / 本地網路描述）。
-
-## CLI
-
-```bash
-playlist-admin pipeline [--step N]     # 全管線（抓取→下載→修剪→整理→LUFS）
-playlist-admin podcast                 # Podcast 管線
-playlist-admin status                  # 狀態
-playlist-admin favorite list|toggle    # 我的最愛
-playlist-admin rag build|query         # Podcast RAG
-```
-
-## Release
-
-Push a `v*` tag to trigger GitHub Actions:
-
-```bash
-git tag v2.9.0
-git push origin v2.9.0
-```
-
-## Dependencies
-
-- `http` + `html` — Spotify embed API
-- `crypto` — TOTP（Spotify token）
-- `webview_windows`（vendor）— 登入 cookie 擷取
-- `audioplayers` — 播放
-- `fl_chart` — 圖表
+# playlist-admin
+
+A Flutter desktop app for Spotify-native music library management: browse the
+Spotify home feed, search & stream, playlist sync, batch downloads, and stats.
+
+## Features
+
+- **Spotify 原生整合** — 個人化主頁 / 搜尋串流 / 你的歌單（內部 GQL API，WebView 登入）
+- **串流播放** — Spotify 搜尋 → yt-dlp 解析 → ffmpeg VBR 0 轉碼 → 本地 HTTP 串流（可選快取 cache\stream\）
+- **原生下載** — yt-dlp 256k Opus → mp3 VBR 0（`preferredquality: 0`），批量一鍵補全
+- **播放清單同步** — Spotify embed API 抓取 → m3u8 + 自動下載缺漏曲目
+- **工作列媒體控制器** — SMTC 進度條 + 拖動 seek + 播放/暫停/上下首
+- **播放佇列** — 拖曳排序 / 移除 / 跳轉 / play next，重啟還原（cache\queue.json）
+- **播放統計** — 50%/4min scrobble 規則 → Top 曲目 / 聆聽分鐘 / 最近播放
+- **下載統計** — 每輪下載成功率紀錄（cache\downloads_log.json）
+- **Sleep timer / Crossfade / 全域熱鍵**（Space、←/→ seek、N/P 切歌）
+- **Podcast + RAG** — RSS 下載、Groq 轉錄、Ollama chroma 問答
+- **Discord RPC** — 現播歌曲 + 封面
+- **一起聽（Jam）** — 免費版 Spotify Jam：開房間（免註冊/免外部伺服器），
+  同一個 Wi-Fi 下大家加入，共享播放佇列、即時同步播放進度、投票跳歌、
+  聊天室。手機（Android/iOS）也能加入房主一起聽。
+
+## 資料夾結構（`Music\playlist-admin\`）
+
+```
+music\        ← 唯一音樂庫（mp3）
+playlists\    ← m3u8
+lyrics\       ← LRC
+podcasts\     ← 播客音檔
+cache\spotify ← Spotify 快取 / snapshot / session
+cache\podcast ← 播客處理快取 / chroma_db
+cache\lufs    ← LUFS 快取
+cache\stream  ← 串流快取
+cache\thumbnails
+exports\      ← USB 匯出
+logs\         ← 日誌
+tools\        ← bridge 腳本
+config.json   ← 設定
+```
+
+## Build
+
+```bash
+flutter pub get
+flutter build windows --release   # 桌面版
+flutter build apk --release       # Android（手機版）
+flutter build ios --release       # iOS（需 macOS + Xcode）
+```
+
+## 一起聽（Jam）
+
+在側邊欄選「一起聽」：
+
+1. **建立房間** — 輸入暱稱 →「建立新房間」。房主端會自動開啟
+   WebSocket + 音訊串流伺服器，並顯示房主位址（`IP:埠口`）與 6 位房間代碼。
+2. **加入房間** — 對方輸入房主位址 + 房間代碼 + 暱稱即可加入
+   （手機/桌機皆可；手機需與房主連同一個 Wi-Fi）。
+3. 任何人都能**搜尋 Spotify 加歌**（房主需先在本機「搜尋」頁登入 Spotify）、
+   **投票**（上下箭頭排序）、**投票跳歌**（達半數跳過）、**聊天**。
+   播放進度由房主掌控，成員每幾秒做 drift 校正，確保同步。
+
+技術重點：
+
+- 房主是「伺服器」：`lib/services/jam_service.dart` 用 `dart:io` 自架
+  HttpServer + WebSocket，成員連 `ws://<ip>:<port>/jam/ws`。
+- 歌曲來源：本機音樂庫（`local`，`/jam/audio` 支援 Range 串流）或
+  Spotify 搜尋後由 yt-dlp 串流（`stream`，走既有的 `StreamServer`）。
+- 成員端透過 `PlayerController.playJamUrl()` 播放房主提供的 URL，
+  `jamFollowMode` 讓播放/暫停/上下首/seek 指令自動轉送給房主。
+- 手機相容：Windows 專用程式碼（win32 單一實例、SMTC、WebView 登入）
+  都已加平台守衛；Android/iOS 已加入 `flutter create` 平台資料夾與
+  網路權限（INTERNET / cleartext / 本地網路描述）。
+
+## CLI
+
+```bash
+playlist-admin pipeline [--step N]     # 全管線（抓取→下載→修剪→整理→LUFS）
+playlist-admin podcast                 # Podcast 管線
+playlist-admin status                  # 狀態
+playlist-admin favorite list|toggle    # 我的最愛
+playlist-admin rag build|query         # Podcast RAG
+```
+
+## Release
+
+Push a `v*` tag to trigger GitHub Actions:
+
+```bash
+git tag v2.9.0
+git push origin v2.9.0
+```
+
+## Dependencies
+
+- `http` + `html` — Spotify embed API
+- `crypto` — TOTP（Spotify token）
+- `webview_windows`（vendor）— 登入 cookie 擷取
+- `audioplayers` — 播放
+- `fl_chart` — 圖表
 - `flutter_discord_rpc` — Discord presence

package/cli/index.js

@@ -1,128 +1,128 @@
-#!/usr/bin/env node
-import { spawn } from 'node:child_process';
-import fs from 'node:fs';
-import path from 'node:path';
-
-// Thin launcher: the CLI engine lives in the Flutter app binary
-// (lib/cli_main.dart), so GUI and CLI share one implementation.
-// This script just locates the built exe / rag scripts and forwards args.
-
-const HELP = `playlist-admin CLI
-
-  Runs the same engine as the GUI app (shared Dart code). Requires a built
-  release: flutter build windows --release
-
-Usage:
-  playlist-admin pipeline [--step N]     Run full pipeline (or from step N)
-  playlist-admin podcast                 Run podcast pipeline
-  playlist-admin status                  Show status
-  playlist-admin favorite list           List favorite songs
-  playlist-admin favorite toggle <song>  Toggle favorite (我的最愛)
-  playlist-admin rag build [--reset]     Build podcast RAG vector DB
-  playlist-admin rag query "問題" [--topk N] [--show 節目] [--json]
-`;
-
-function projectRoot() {
-  if (process.env.PA_ROOT && fs.existsSync(process.env.PA_ROOT)) {
-    return process.env.PA_ROOT;
-  }
-  // Start from cwd and walk up to find the Flutter project (works whether
-  // invoked locally or from a globally installed npm package).
-  let dir = process.cwd();
-  while (true) {
-    if (fs.existsSync(path.join(dir, 'pubspec.yaml'))) return dir;
-    const parent = path.dirname(dir);
-    if (parent === dir) return null;
-    dir = parent;
-  }
-}
-
-function exePath(root) {
-  const candidates = [
-    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', 'x64', 'runner', 'Release', 'playlist_administrator.exe'),
-  ];
-  return candidates.find((c) => fs.existsSync(c)) || null;
-}
-
-function python() {
-  return process.env.PYTHON || 'python';
-}
-
-function forward(exe, args) {
-  // Deliver CLI args via PA_CLI_ARGS (JSON) — Flutter Dart exposes no
-  // command-line args in release on this SDK (see lib/main.dart).
-  // PA_ROOT lets the Python bridge find rag/ scripts when invoked from the CLI.
-  const root = projectRoot();
-  const child = spawn(exe, [], {
-    stdio: 'inherit',
-    windowsHide: false,
-    env: {
-      ...process.env,
-      PA_CLI_ARGS: JSON.stringify(args),
-      ...(root ? { PA_ROOT: root } : {}),
-    },
-  });
-  child.on('exit', (code) => process.exit(code ?? 1));
-  child.on('error', (e) => {
-    console.error(`無法啟動 ${exe}: ${e.message}`);
-    process.exit(1);
-  });
-}
-
-function forwardPy(args) {
-  // Python scripts take real argv.
-  const child = spawn(python(), args, { stdio: 'inherit', windowsHide: false });
-  child.on('exit', (code) => process.exit(code ?? 1));
-  child.on('error', (e) => {
-    console.error(`無法啟動 python: ${e.message}`);
-    process.exit(1);
-  });
-}
-
-function runRag(args) {
-  const root = projectRoot();
-  if (!root) {
-    console.error('找不到專案根目錄（pubspec.yaml）。請在專案內執行，或設定 PA_ROOT');
-    process.exit(1);
-  }
-  const sub = args[0];
-  const script = path.join(root, 'rag', sub === 'build' ? 'build_db.py' : 'query.py');
-  if (!fs.existsSync(script)) {
-    console.error(`找不到 ${script}`);
-    process.exit(1);
-  }
-  forwardPy([script, ...args.slice(1)]);
-}
-
-async function main() {
-  const args = process.argv.slice(2);
-  if (args.length === 0) {
-    console.log(HELP);
-    return;
-  }
-  if (args[0] === 'rag') {
-    runRag(args.slice(1));
-    return;
-  }
-
-  const root = projectRoot();
-  if (!root) {
-    console.error('找不到專案根目錄（pubspec.yaml）。請在專案內執行，或設定 PA_ROOT');
-    process.exit(1);
-  }
-  const exe = exePath(root);
-  if (!exe) {
-    console.error(`找不到 build 好的 exe。
-請先在專案內執行: flutter build windows --release
-或設定 PA_ROOT=<專案根目錄>`);
-    process.exit(1);
-  }
-  forward(exe, args);
-}
-
-main().catch((e) => {
-  console.error(e);
-  process.exit(1);
-});
+#!/usr/bin/env node
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+
+// Thin launcher: the CLI engine lives in the Flutter app binary
+// (lib/cli_main.dart), so GUI and CLI share one implementation.
+// This script just locates the built exe / rag scripts and forwards args.
+
+const HELP = `playlist-admin CLI
+
+  Runs the same engine as the GUI app (shared Dart code). Requires a built
+  release: flutter build windows --release
+
+Usage:
+  playlist-admin pipeline [--step N]     Run full pipeline (or from step N)
+  playlist-admin podcast                 Run podcast pipeline
+  playlist-admin status                  Show status
+  playlist-admin favorite list           List favorite songs
+  playlist-admin favorite toggle <song>  Toggle favorite (我的最愛)
+  playlist-admin rag build [--reset]     Build podcast RAG vector DB
+  playlist-admin rag query "問題" [--topk N] [--show 節目] [--json]
+`;
+
+function projectRoot() {
+  if (process.env.PA_ROOT && fs.existsSync(process.env.PA_ROOT)) {
+    return process.env.PA_ROOT;
+  }
+  // Start from cwd and walk up to find the Flutter project (works whether
+  // invoked locally or from a globally installed npm package).
+  let dir = process.cwd();
+  while (true) {
+    if (fs.existsSync(path.join(dir, 'pubspec.yaml'))) return dir;
+    const parent = path.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+
+function exePath(root) {
+  const candidates = [
+    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', 'x64', 'runner', 'Release', 'playlist_administrator.exe'),
+  ];
+  return candidates.find((c) => fs.existsSync(c)) || null;
+}
+
+function python() {
+  return process.env.PYTHON || 'python';
+}
+
+function forward(exe, args) {
+  // Deliver CLI args via PA_CLI_ARGS (JSON) — Flutter Dart exposes no
+  // command-line args in release on this SDK (see lib/main.dart).
+  // PA_ROOT lets the Python bridge find rag/ scripts when invoked from the CLI.
+  const root = projectRoot();
+  const child = spawn(exe, [], {
+    stdio: 'inherit',
+    windowsHide: false,
+    env: {
+      ...process.env,
+      PA_CLI_ARGS: JSON.stringify(args),
+      ...(root ? { PA_ROOT: root } : {}),
+    },
+  });
+  child.on('exit', (code) => process.exit(code ?? 1));
+  child.on('error', (e) => {
+    console.error(`無法啟動 ${exe}: ${e.message}`);
+    process.exit(1);
+  });
+}
+
+function forwardPy(args) {
+  // Python scripts take real argv.
+  const child = spawn(python(), args, { stdio: 'inherit', windowsHide: false });
+  child.on('exit', (code) => process.exit(code ?? 1));
+  child.on('error', (e) => {
+    console.error(`無法啟動 python: ${e.message}`);
+    process.exit(1);
+  });
+}
+
+function runRag(args) {
+  const root = projectRoot();
+  if (!root) {
+    console.error('找不到專案根目錄（pubspec.yaml）。請在專案內執行，或設定 PA_ROOT');
+    process.exit(1);
+  }
+  const sub = args[0];
+  const script = path.join(root, 'rag', sub === 'build' ? 'build_db.py' : 'query.py');
+  if (!fs.existsSync(script)) {
+    console.error(`找不到 ${script}`);
+    process.exit(1);
+  }
+  forwardPy([script, ...args.slice(1)]);
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  if (args.length === 0) {
+    console.log(HELP);
+    return;
+  }
+  if (args[0] === 'rag') {
+    runRag(args.slice(1));
+    return;
+  }
+
+  const root = projectRoot();
+  if (!root) {
+    console.error('找不到專案根目錄（pubspec.yaml）。請在專案內執行，或設定 PA_ROOT');
+    process.exit(1);
+  }
+  const exe = exePath(root);
+  if (!exe) {
+    console.error(`找不到 build 好的 exe。
+請先在專案內執行: flutter build windows --release
+或設定 PA_ROOT=<專案根目錄>`);
+    process.exit(1);
+  }
+  forward(exe, args);
+}
+
+main().catch((e) => {
+  console.error(e);
+  process.exit(1);
+});

package/package.json

@@ -1,34 +1,34 @@
-{
-  "name": "playlist-admin",
-  "version": "2.15.17",
-  "description": "playlist-admin CLI - thin launcher for the Flutter app engine (pipeline, podcast) + podcast RAG query",
-  "type": "module",
-  "bin": {
-    "playlist-admin": "./cli/index.js"
-  },
-  "scripts": {
-    "pipeline": "node cli/index.js pipeline",
-    "podcast": "node cli/index.js podcast",
-    "status": "node cli/index.js status",
-    "test": "node cli/index.js status && node cli/index.js rag query \"test\" --topk 1 --json"
-  },
-  "files": [
-    "cli/index.js",
-    "rag/*.py",
-    "rag/README.md"
-  ],
-  "keywords": [
-    "playlist",
-    "spotify",
-    "podcast",
-    "m3u8",
-    "music",
-    "ffmpeg",
-    "spotube"
-  ],
-  "license": "MIT",
-  "engines": {
-    "node": ">=20"
-  },
-  "private": false
-}
+{
+  "name": "playlist-admin",
+  "version": "2.15.18",
+  "description": "playlist-admin CLI - thin launcher for the Flutter app engine (pipeline, podcast) + podcast RAG query",
+  "type": "module",
+  "bin": {
+    "playlist-admin": "./cli/index.js"
+  },
+  "scripts": {
+    "pipeline": "node cli/index.js pipeline",
+    "podcast": "node cli/index.js podcast",
+    "status": "node cli/index.js status",
+    "test": "node cli/index.js status && node cli/index.js rag query \"test\" --topk 1 --json"
+  },
+  "files": [
+    "cli/index.js",
+    "rag/*.py",
+    "rag/README.md"
+  ],
+  "keywords": [
+    "playlist",
+    "spotify",
+    "podcast",
+    "m3u8",
+    "music",
+    "ffmpeg",
+    "spotube"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "private": false
+}

package/rag/README.md

@@ -1,48 +1,48 @@
-# Podcast RAG
-
-對 podcast 逐字稿做本地語意檢索（embeddings + ChromaDB）。
-
-## 前置需求
-
-- 安裝 Ollama：`https://ollama.com/download`
-  ```bash
-  ollama pull bge-m3          # embedding 模型
-  ollama pull qwen2.5:7b      # （選用）本機生成
-  ```
-- Python 套件：
-  ```bash
-  pip install chromadb requests
-  ```
-- 逐字稿：`podcast_downloads/<節目>/*.txt`（podcast pipeline 會自動產生 .txt）
-
-## 指令
-
-CLI（需已 build exe 或直接 python 執行）：
-
-```bash
-playlist-admin rag build            # 增量索引（沒被 index 過的 .txt）
-playlist-admin rag build --reset    # 全部重建
-playlist-admin rag query "2026年台股會一直漲嗎?" --topk 8
-playlist-admin rag query "問題" --json        # JSON 含全文
-playlist-admin rag query "問題" --show 游庭皓  # 只搜指定節目
-```
-
-直接用 Python（路徑從 config.json 自動解析）：
-
-```bash
-python rag/build_db.py
-python rag/query.py "問題"
-python rag/srt_to_text.py            # 把缺 .txt 的 .srt 補轉成 .txt
-```
-
-## Pipeline 整合
-
-podcast pipeline 產生/更新逐字稿後，跑 `playlist-admin rag build`
-即可把新集數加進向量庫（程式會自動跳過已索引的檔名）。
-
-## 檔案
-
-- `build_db.py` — 逐字稿切 chunk → Ollama embeddings → ChromaDB（cosine）
-- `query.py` — 問題 embedding → top-k 片段 → 輸出命中的節目/日期/全文偏移
-- `srt_to_text.py` — srt → 純文字
+# Podcast RAG
+
+對 podcast 逐字稿做本地語意檢索（embeddings + ChromaDB）。
+
+## 前置需求
+
+- 安裝 Ollama：`https://ollama.com/download`
+  ```bash
+  ollama pull bge-m3          # embedding 模型
+  ollama pull qwen2.5:7b      # （選用）本機生成
+  ```
+- Python 套件：
+  ```bash
+  pip install chromadb requests
+  ```
+- 逐字稿：`podcast_downloads/<節目>/*.txt`（podcast pipeline 會自動產生 .txt）
+
+## 指令
+
+CLI（需已 build exe 或直接 python 執行）：
+
+```bash
+playlist-admin rag build            # 增量索引（沒被 index 過的 .txt）
+playlist-admin rag build --reset    # 全部重建
+playlist-admin rag query "2026年台股會一直漲嗎?" --topk 8
+playlist-admin rag query "問題" --json        # JSON 含全文
+playlist-admin rag query "問題" --show 游庭皓  # 只搜指定節目
+```
+
+直接用 Python（路徑從 config.json 自動解析）：
+
+```bash
+python rag/build_db.py
+python rag/query.py "問題"
+python rag/srt_to_text.py            # 把缺 .txt 的 .srt 補轉成 .txt
+```
+
+## Pipeline 整合
+
+podcast pipeline 產生/更新逐字稿後，跑 `playlist-admin rag build`
+即可把新集數加進向量庫（程式會自動跳過已索引的檔名）。
+
+## 檔案
+
+- `build_db.py` — 逐字稿切 chunk → Ollama embeddings → ChromaDB（cosine）
+- `query.py` — 問題 embedding → top-k 片段 → 輸出命中的節目/日期/全文偏移
+- `srt_to_text.py` — srt → 純文字
 - `_resolve.py` — 從 app config 解析 podcast_downloads 與 chroma_db 路徑