playlist-admin 2.15.36 → 2.15.38

package/.opencode/skills/podcast-knowledge/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: podcast-knowledge
+description: Use when the user asks a question about podcast transcripts, study materials, exam questions, or course content. Covers both podcast RAG (rag/query.py) and study RAG (rag/study_query.py). Trigger on words like podcast, 逐字稿, 節目, 試題, 課程, 齒輪, 螺栓, 機件原理, 機械力學, 統測, 四技二專, RAG.
+---
+
+# 知識檢索（Podcast + Study RAG）
+
+兩個 ChromaDB collection，同一個 DB：
+- **podcasts**：RSS podcast 逐字稿（`rag/query.py`）
+- **study**：PDF 試題/課本 + 課程影片逐字稿（`rag/study_query.py`）
+
+## 流程
+
+1. 確認 Ollama 在跑：`Test-NetConnection localhost -Port 11434`
+2. 判斷查詢類型：
+   - **Podcast 相關**（「某集講什麼」「節目有沒有提到」）→ 用 `rag/query.py`
+   - **試題/課程相關**（「某題怎麼解」「齒輪有哪些」「機件原理」）→ 用 `rag/study_query.py`
+3. 查詢（在專案根目錄執行）：
+
+   **Podcast：**
+   ```
+   python rag/query.py "<問題>" --json --no-full --topk 8
+   playlist-admin rag query "<問題>" --no-full --topk 8
+   ```
+
+   **Study：**
+   ```
+   python rag/study_query.py "<問題>" --topk 5
+   python rag/study_query.py "<問題>" --category 機械 --topk 3
+   playlist-admin study query "<問題>" --topk 5
+   ```
+
+4. 依 `similarity`（1.0 最高）挑 2–3 個命中回答。
+5. 用繁體中文回答，列出引用來源。
+
+## Study RAG 特有參數
+
+- `--category <字串>`：只搜特定分類（如「機械力學」「112學年度」「課程/機械群許凱機件原理」）
+- `--answer`：用 Ollama 生成回答（需要 qwen2.5:7b）
+- `--json`：JSON 輸出（含 similarity、category、file、chunk）
+
+## 注意
+
+- 若 collection 不存在：`python rag/study_build.py`（全量 ~15min）或 `playlist-admin study build`
+- Podcast 重建：`playlist-admin rag build` 或 `python rag/build_db.py`
+- 路徑與 DB 從 config.json 自動解析（`rag/_resolve.py`），不要假設路徑
+- 問題保持原意，可直接用使用者原句
+
+## 安裝（opencode v2 全域生效）
+
+本 skill 單一真相來源：repo 內 `.opencode/skills/podcast-knowledge/SKILL.md`。
+npm 包（`playlist-admin`）與 GUI 安裝程式都會附上，裝完後執行：
+
+```
+playlist-admin skill install
+```
+
+會複製到 opencode v2 全域路徑 `~/.config/opencode/skills/podcast-knowledge/SKILL.md`
+（opencode 重啟後生效）。其他位置：`playlist-admin skill list | path`。

package/cli/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { spawn, spawnSync } from 'node:child_process';
 import fs from 'node:fs';
+import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -23,6 +24,9 @@ Usage:
   playlist-admin rag query "問題" [--topk N] [--show 節目] [--json]
   playlist-admin study build [--reset]   Build study RAG (PDF + 課程)
   playlist-admin study query "問題" [--topk N] [--category X] [--json]
+  playlist-admin skill list              List bundled opencode skills
+  playlist-admin skill install [--dir X] Install skill(s) to opencode (~/.config/opencode/skills)
+  playlist-admin skill path [name]       Print installed path of a skill
 `;
 
 function projectRoot() {
@@ -139,6 +143,101 @@ function runStudy(args) {
   forwardPy([script, ...args.slice(1)]);
 }
 
+// --- opencode skill ------------------------------------------------------
+// 單一真相來源：.opencode/skills/<name>/SKILL.md（專案內）
+// 發佈物內位置：npm 包同路徑；GUI 安裝目錄下 skills/<name>/SKILL.md。
+// 安裝目標（opencode v2 官方）：~/.config/opencode/skills/<name>/SKILL.md
+
+function skillBaseDirs() {
+  const dirs = [];
+  for (const r of [projectRoot(), packageRoot()].filter(Boolean)) {
+    for (const sub of ['.opencode/skills', 'skills']) {
+      const d = path.join(r, sub);
+      if (fs.existsSync(d)) dirs.push(d);
+    }
+  }
+  // GUI 安裝目錄（Inno DefaultDirName {autopf}\playlist-admin）
+  const pf = [process.env.ProgramFiles, process.env['ProgramFiles(x86)']].filter(Boolean);
+  for (const p of pf) {
+    const d = path.join(p, 'playlist-admin', 'skills');
+    if (fs.existsSync(d)) dirs.push(d);
+  }
+  return [...new Set(dirs)];
+}
+
+function findSkills() {
+  // [{name, dir}]，同名以前面的來源優先
+  const out = [];
+  const seen = new Set();
+  for (const base of skillBaseDirs()) {
+    let entries = [];
+    try {
+      entries = fs.readdirSync(base, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const e of entries) {
+      if (!e.isDirectory() || seen.has(e.name)) continue;
+      if (!fs.existsSync(path.join(base, e.name, 'SKILL.md'))) continue;
+      seen.add(e.name);
+      out.push({ name: e.name, dir: path.join(base, e.name) });
+    }
+  }
+  return out;
+}
+
+function globalSkillsDir() {
+  return path.join(os.homedir(), '.config', 'opencode', 'skills');
+}
+
+function runSkill(args) {
+  const sub = args[0] || 'list';
+  if (sub === 'list') {
+    const skills = findSkills();
+    if (skills.length === 0) {
+      console.error('找不到內附的 skill（缺 .opencode/skills/ 或 skills/）');
+      process.exit(1);
+    }
+    for (const s of skills) console.log(`${s.name}\t${s.dir}`);
+    return;
+  }
+  if (sub === 'path') {
+    const name = args[1] || 'podcast-knowledge';
+    console.log(path.join(globalSkillsDir(), name, 'SKILL.md'));
+    return;
+  }
+  if (sub === 'install') {
+    // playlist-admin skill install [name] [--dir X]（無 name = 全部）
+    const dirFlag = args.find((a) => a.startsWith('--dir='));
+    const dirIdx = args.indexOf('--dir');
+    const dirVal =
+      dirFlag?.slice('--dir='.length) ||
+      (dirIdx >= 0 && args[dirIdx + 1] ? args[dirIdx + 1] : null);
+    const rest = args.slice(1).filter((a, i, arr) => {
+      if (a.startsWith('--')) return false;
+      const prev = arr[i - 1];
+      if (prev === '--dir') return false; // --dir 的值不是 skill 名
+      return true;
+    });
+    const targetBase = dirVal || globalSkillsDir();
+    const skills = findSkills().filter((s) => rest.length === 0 || rest.includes(s.name));
+    if (skills.length === 0) {
+      console.error(`找不到 skill: ${rest.join(' ') || '(空)'}。先跑 playlist-admin skill list`);
+      process.exit(1);
+    }
+    for (const s of skills) {
+      const dest = path.join(targetBase, s.name);
+      fs.mkdirSync(dest, { recursive: true });
+      fs.cpSync(s.dir, dest, { recursive: true });
+      console.log(`已安裝 ${s.name} -> ${path.join(dest, 'SKILL.md')}`);
+    }
+    console.log('opencode 重啟後生效（全域: ~/.config/opencode/skills/<name>/SKILL.md）');
+    return;
+  }
+  console.error(`未知 skill 子命令: ${sub}\n用法: playlist-admin skill list | install | path`);
+  process.exit(1);
+}
+
 async function main() {
   const args = process.argv.slice(2);
   if (args.length === 0) {
@@ -153,6 +252,10 @@ async function main() {
     runStudy(args.slice(1));
     return;
   }
+  if (args[0] === 'skill') {
+    runSkill(args.slice(1));
+    return;
+  }
 
   const root = projectRoot();
   if (!root) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playlist-admin",
-  "version": "2.15.36",
+  "version": "2.15.38",
   "description": "playlist-admin CLI - pipeline, podcast, music + podcast RAG + study RAG (PDF 試題/課本)",
   "type": "module",
   "bin": {
@@ -15,7 +15,8 @@
   "files": [
     "cli/index.js",
     "rag/*.py",
-    "rag/README.md"
+    "rag/README.md",
+    ".opencode/skills/podcast-knowledge/SKILL.md"
   ],
   "keywords": [
     "playlist",