botrun-horse 2.29.2 → 2.30.0

package/botrun-c/.claude/skills//350/252/236/351/237/263/350/275/211/346/226/207/345/255/227/346/212/200/350/203/275/scripts/transcribe.mjs

@@ -0,0 +1,294 @@
+#!/usr/bin/env node
+// 音訊轉錄腳本 - 使用 NCHC Whisper API
+// Usage: node transcribe.mjs "audio-file.mp3"
+// 環境變數: TAIDE_API_KEY, WORKING_DIR
+
+import { readFileSync, existsSync, mkdirSync, unlinkSync, readdirSync, rmdirSync } from 'fs';
+import { join, dirname, basename, extname, isAbsolute, relative, resolve } from 'path';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+
+const execAsync = promisify(exec);
+
+// ============================================================================
+// 常數配置
+// ============================================================================
+
+const TAIDE_API_KEY = process.env.TAIDE_API_KEY;
+const TAIDE_BASE_URL = process.env.TAIDE_BASE_URL || 'https://portal.genai.nchc.org.tw/api/v1';
+const WHISPER_MODEL = 'Whisper-Large-V3';
+const MAX_PARALLEL = 100;
+const CHUNK_DURATION_SECONDS = 60;
+const WORKING_DIR = process.env.WORKING_DIR || process.cwd();
+
+// ============================================================================
+// 日誌工具
+// ============================================================================
+
+function log(...args) {
+  console.error('[Audio-Transcribe]', ...args);
+}
+
+// ============================================================================
+// 路徑驗證
+// ============================================================================
+
+function validateAndResolvePath(filePath) {
+  try {
+    const absolutePath = isAbsolute(filePath)
+      ? filePath
+      : resolve(WORKING_DIR, filePath);
+
+    const relativePath = relative(WORKING_DIR, absolutePath);
+    if (relativePath.startsWith('..')) {
+      return { valid: false, error: `路徑遍歷偵測: ${filePath}` };
+    }
+
+    if (!existsSync(absolutePath)) {
+      return { valid: false, error: `檔案不存在: ${absolutePath}` };
+    }
+
+    return { valid: true, resolvedPath: absolutePath };
+  } catch (error) {
+    return { valid: false, error: `無效路徑: ${error}` };
+  }
+}
+
+// ============================================================================
+// FFmpeg 音訊處理
+// ============================================================================
+
+async function getAudioDuration(filePath) {
+  try {
+    const { stdout } = await execAsync(
+      `ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "${filePath}"`
+    );
+    return parseFloat(stdout.trim());
+  } catch (error) {
+    throw new Error(`取得音訊時長失敗: ${error}`);
+  }
+}
+
+async function splitAudioFile(filePath, outputDir) {
+  try {
+    if (!existsSync(outputDir)) {
+      mkdirSync(outputDir, { recursive: true });
+    }
+
+    const totalDuration = await getAudioDuration(filePath);
+    log(`音訊時長: ${totalDuration.toFixed(2)}s`);
+
+    const numChunks = Math.ceil(totalDuration / CHUNK_DURATION_SECONDS);
+    log(`切割為 ${numChunks} 段（每段 ${CHUNK_DURATION_SECONDS}s）`);
+
+    const ext = extname(filePath);
+    const baseFileName = basename(filePath, ext);
+    const outputPattern = join(outputDir, `${baseFileName}_chunk_%03d${ext}`);
+
+    const ffmpegCmd = [
+      'ffmpeg', '-y',
+      '-i', `"${filePath}"`,
+      '-f', 'segment',
+      '-segment_time', CHUNK_DURATION_SECONDS.toString(),
+      '-c', 'copy',
+      '-reset_timestamps', '1',
+      `"${outputPattern}"`
+    ].join(' ');
+
+    await execAsync(ffmpegCmd);
+
+    const files = readdirSync(outputDir)
+      .filter(f => f.startsWith(`${baseFileName}_chunk_`) && f.endsWith(ext))
+      .sort();
+
+    const chunkPaths = files.map(f => join(outputDir, f));
+    log(`切割完成: ${chunkPaths.length} 個檔案`);
+
+    return { chunkPaths, totalDuration };
+  } catch (error) {
+    throw new Error(`切割音訊失敗: ${error}`);
+  }
+}
+
+// ============================================================================
+// NCHC Whisper 轉錄
+// ============================================================================
+
+async function transcribeAudioFile(filePath) {
+  if (!TAIDE_API_KEY) {
+    throw new Error('TAIDE_API_KEY 未設定');
+  }
+
+  try {
+    log(`轉錄中: ${basename(filePath)}`);
+
+    const fileBuffer = readFileSync(filePath);
+    const formData = new FormData();
+    const blob = new Blob([fileBuffer]);
+    formData.append('file', blob, basename(filePath));
+    formData.append('model', WHISPER_MODEL);
+
+    const response = await fetch(`${TAIDE_BASE_URL}/audio/transcriptions`, {
+      method: 'POST',
+      headers: {
+        'Authorization': `Bearer ${TAIDE_API_KEY}`,
+      },
+      body: formData,
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`API 錯誤 (${response.status}): ${errorText}`);
+    }
+
+    const result = await response.json();
+    return result.text || '';
+  } catch (error) {
+    log(`轉錄失敗 ${basename(filePath)}:`, error);
+    throw error;
+  }
+}
+
+async function transcribeChunksInParallel(chunkPaths, maxParallel = MAX_PARALLEL) {
+  const results = new Array(chunkPaths.length);
+  const queue = chunkPaths.map((path, index) => ({ path, index }));
+  let completed = 0;
+  let failed = 0;
+
+  log(`開始平行轉錄（最多 ${maxParallel} 並發）`);
+
+  async function worker() {
+    while (queue.length > 0) {
+      const item = queue.shift();
+      if (!item) break;
+
+      const { path, index } = item;
+      try {
+        const text = await transcribeAudioFile(path);
+        results[index] = text;
+        completed++;
+        log(`進度: ${completed}/${chunkPaths.length}`);
+      } catch (error) {
+        failed++;
+        results[index] = `[轉錄失敗: ${basename(path)}]`;
+      }
+    }
+  }
+
+  const workers = Array.from(
+    { length: Math.min(maxParallel, chunkPaths.length) },
+    () => worker()
+  );
+
+  await Promise.all(workers);
+  log(`轉錄完成: ${completed} 成功, ${failed} 失敗`);
+  return results;
+}
+
+// ============================================================================
+// 清理臨時檔案
+// ============================================================================
+
+function cleanupChunks(chunkPaths, tempDir) {
+  for (const path of chunkPaths) {
+    try {
+      if (existsSync(path)) {
+        unlinkSync(path);
+      }
+    } catch {
+      // ignore
+    }
+  }
+
+  if (tempDir && existsSync(tempDir)) {
+    try {
+      rmdirSync(tempDir);
+    } catch {
+      // ignore
+    }
+  }
+}
+
+// ============================================================================
+// Main
+// ============================================================================
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0) {
+    console.error('❌ 請提供音訊檔案路徑');
+    console.error('');
+    console.error('Usage: node transcribe.mjs "audio-file.mp3"');
+    console.error('');
+    console.error('環境變數:');
+    console.error('  TAIDE_API_KEY  - 國網中心 API 金鑰（必須）');
+    console.error('  WORKING_DIR    - 工作目錄（預設: process.cwd()）');
+    process.exit(1);
+  }
+
+  const filePath = args[0];
+
+  // 檢查 API Key
+  if (!TAIDE_API_KEY) {
+    console.error('❌ TAIDE_API_KEY 環境變數未設定');
+    process.exit(1);
+  }
+
+  // 驗證路徑
+  const validation = validateAndResolvePath(filePath);
+  if (!validation.valid) {
+    console.error(`❌ ${validation.error}`);
+    process.exit(1);
+  }
+
+  const resolvedPath = validation.resolvedPath;
+
+  // 建立臨時目錄
+  const fileName = basename(resolvedPath, extname(resolvedPath));
+  const uniqueId = `${fileName}_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+  const tempDir = join('/tmp', `.audio-chunks-${uniqueId}`);
+
+  try {
+    // 切割音訊
+    const { chunkPaths, totalDuration } = await splitAudioFile(resolvedPath, tempDir);
+
+    // 平行轉錄
+    const transcripts = await transcribeChunksInParallel(chunkPaths);
+
+    // 清理
+    cleanupChunks(chunkPaths, tempDir);
+
+    // 組合結果
+    const finalText = transcripts
+      .map((text, index) => {
+        const startTime = index * CHUNK_DURATION_SECONDS;
+        const minutes = Math.floor(startTime / 60);
+        const seconds = startTime % 60;
+        const timestamp = `[${String(minutes).padStart(2, '0')}:${String(seconds).padStart(2, '0')}]`;
+        return `${timestamp} ${text}`;
+      })
+      .join('\n\n');
+
+    // 輸出結果
+    console.log(`## 轉錄結果\n`);
+    console.log(`**統計資訊：**`);
+    console.log(`- 總時長: ${(totalDuration / 60).toFixed(2)} 分鐘`);
+    console.log(`- 切割段數: ${chunkPaths.length}`);
+    console.log(`- 總字數: ${finalText.length} 字元\n`);
+    console.log(`**轉錄內容：**\n`);
+    console.log(finalText);
+
+  } catch (error) {
+    // 清理（即使失敗也要清理）
+    if (existsSync(tempDir)) {
+      const chunks = readdirSync(tempDir).map(f => join(tempDir, f));
+      cleanupChunks(chunks, tempDir);
+    }
+
+    console.error(`\n❌ 轉錄失敗：${error.message}`);
+    process.exit(1);
+  }
+}
+
+main();

package/botrun-c/.claude/skills//351/233/266/345/271/273/350/246/272/350/255/211/346/230/216/346/212/200/350/203/275/SKILL.md

@@ -0,0 +1,338 @@
+---
+name: 零幻覺證明技能
+description: 當使用者說「零幻覺」時啟動
+---
+
+嚴格驗證所有引證來源的真實性，包含網址引證、檔案引證、原文引證、頁碼引證等。當使用者輸入本技能的完整名稱（「零幻覺證明技能」），即代表要求 AI 載入並啟動本技能。假定所有內容「有幻覺」，透過上網查證、檔案驗證、交叉比對等方式進行「零幻覺證明」，確保資訊的可驗證性和真實性。當使用者說「零幻覺證明」、「驗證引證」、「查證」、「驗算」、「檢核真實性」或需要驗證引用來源時使用。⚠️ 輸出必須包含完整 URL、完整段落內容，禁止省略任何欄位。(v5.1117.1632)
+
+# 🔍 零幻覺證明技能
+
+**圖示**：🔍
+
+## 功能說明
+提供嚴格的引證驗證和真實性查核功能：
+1. **網址引證驗證**：檢驗 URL 有效性、抓取實際內容、比對引證文字
+2. **檔案引證驗證**：檢驗檔名存在性、原文引證、頁碼引證的準確性
+3. **交叉驗證**：多來源比對、時間戳記驗證、版本一致性檢核
+4. **零幻覺證明**：假定所有內容有幻覺，逐項嚴格驗證後出具證明報告
+
+## 核心原則
+**假定一切皆幻覺，證明才是真實**
+- ❌ 不信任任何未驗證的引證
+- ✅ 所有引證必須逐一驗證
+- ✅ 驗證失敗 = 標記為「無法證明」
+- ✅ 提供完整驗證路徑和證據
+
+## 觸發條件
+- 使用者明確要求「零幻覺證明」、「驗證引證」
+- 使用者說「查證」、「驗算」、「檢核真實性」
+- 使用者提供了需要驗證的引證內容（網址、檔案、頁碼等）
+- 對話內容包含大量引用，需要確保準確性
+
+## 執行流程
+
+### 階段一：拆解引證項目
+分析使用者提供的內容，識別所有需要驗證的項目：
+1. **網址引證**：提取所有 URL
+2. **檔案引證**：提取檔名、路徑
+3. **原文引證**：提取聲稱的引用文字
+4. **頁碼引證**：提取頁碼資訊
+5. **其他引證**：日期、版本號、作者等
+
+### 階段二：逐項驗證
+
+#### 2.1 網址引證驗證
+對於每個 URL：
+1. **可達性測試**：使用 WebFetch 確認 URL 可訪問
+2. **內容抓取**：獲取網頁實際內容
+3. **引文比對**：在實際內容中搜尋聲稱的引證文字
+4. **結果判定**：
+   - ✅ **通過**：找到完全匹配的引證文字
+   - ⚠️ **部分匹配**：找到相似但不完全相同的內容
+   - ❌ **失敗**：未找到引證文字 或 URL 無法訪問
+
+**驗證報告格式**（所有欄位皆為必填，不可省略）：
+```
+🌐 網址引證驗證 #1
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📌 來源 URL（必填）
+https://example.com/article
+
+💬 聲稱引證（必填）
+"AI 將在 2025 年達到新突破"
+
+✅ 驗證結果
+通過
+
+📄 實際內容段落（必填 - 完整段落，不可摘要）
+"根據業界專家分析，AI 將在 2025 年達到新突破，專家預測
+這將改變整個產業格局。多位學者指出，機器學習技術的進步
+將帶來革命性的應用。"
+
+📍 匹配位置（必填）
+第 3 段第 2 行
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+**⚠️ 嚴格要求**：
+- ❌ 禁止省略任何欄位
+- ❌ 禁止用「...」省略段落內容
+- ✅ 必須提供完整可點擊的 URL
+- ✅ 必須提供完整的實際內容段落（至少包含引證文字前後各 1-2 句）
+
+#### 2.2 檔案引證驗證
+對於每個檔案引證：
+1. **檔案存在性**：使用 tree-view 或 secure-rg 確認檔案存在
+2. **原文驗證**：使用 secure-read 讀取檔案內容
+3. **頁碼驗證**：
+   - PDF：使用 pdf-split 的頁碼對應關係
+   - 其他：使用行號或段落標記
+4. **引文比對**：在實際檔案中搜尋引證文字
+5. **結果判定**：同網址驗證標準
+
+**驗證報告格式**（所有欄位皆為必填，不可省略）：
+```
+📄 檔案引證驗證 #1
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📁 檔名（必填）
+/uploads/report.pdf
+
+📖 聲稱頁碼（必填）
+第 23 頁
+
+💬 聲稱引證（必填）
+"市場佔有率達到 45%"
+
+✅ 驗證結果
+通過
+
+📄 實際內容段落（必填 - 完整段落，不可摘要）
+"根據 2024 Q3 財務報告分析，本公司市場佔有率達到 45%，
+較去年同期成長 8 個百分點。這項成長主要來自於新產品線
+的成功推出以及海外市場的拓展。"
+
+📍 實際位置（必填）
+第 23 頁（物理頁碼：page_023.pdf）
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+**⚠️ 嚴格要求**：
+- ❌ 禁止省略任何欄位
+- ❌ 禁止用「...」省略段落內容
+- ✅ 必須提供完整的實際內容段落（至少包含引證文字前後各 1-2 句）
+- ✅ 必須標註實際位置（頁碼、行號等）
+
+#### 2.3 交叉驗證
+當有多個引證來源時：
+1. **一致性檢查**：比對不同來源的相同資訊
+2. **時間序列驗證**：檢查時間戳記的合理性
+3. **版本一致性**：確認引用的版本號正確
+4. **邏輯驗證**：檢查數據、推論的邏輯一致性
+
+### 階段三：出具零幻覺證明報告
+
+**報告結構**（所有欄位必填，包含完整 URL 和段落內容）：
+```
+🔍 零幻覺證明報告
+生成時間: 2025-11-17 15:50:00
+驗證項目總數: 3
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ 驗證通過: 1 項
+⚠️ 部分匹配: 1 項
+❌ 驗證失敗: 1 項
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+【詳細驗證結果】
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+1. ✅ 網址引證驗證 - 通過
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📌 來源 URL
+https://example.com/news/ai-market-2025
+
+💬 聲稱引證
+"AI 市場規模達 500 億美元"
+
+📄 實際內容段落（完整段落）
+"根據市場研究機構最新報告，2025 年全球 AI 市場規模達 500 億美元，
+較 2024 年成長 35%。分析師指出，生成式 AI 的快速普及是主要成長
+動力，預期未來三年將持續保持高速成長態勢。"
+
+📍 匹配位置
+第 2 段第 1 行
+
+✅ 驗證結果：完全匹配
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+2. ⚠️ 網址引證驗證 - 部分匹配
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📌 來源 URL
+https://example.com/stats/user-growth
+
+💬 聲稱引證
+"使用者數量破千萬"
+
+📄 實際內容段落（完整段落）
+"根據官方數據統計，截至 2025 年第三季，平台活躍使用者數量
+接近千萬大關，達到 980 萬人。公司預計年底前可望突破千萬人
+的里程碑，成為業界重要指標。"
+
+📍 匹配位置
+第 1 段第 2 行
+
+⚠️ 驗證結果：部分匹配
+   原文：「接近千萬」
+   聲稱：「破千萬」
+   建議：修正為「接近千萬」或「即將破千萬」
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+3. ❌ 檔案引證驗證 - 失敗
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📁 檔名
+data.xlsx
+
+💬 聲稱引證
+"營收 1000 萬"
+
+📖 聲稱位置
+第 5 行
+
+❌ 驗證結果：失敗
+   問題：檔案不存在或無法訪問
+   建議：提供正確的檔案路徑或上傳檔案
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📊 可信度評分: 33% (1/3 通過)
+建議: 修正或移除 2 項未通過驗證的引證
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+**⚠️ 報告嚴格要求**：
+- ✅ 每項驗證必須包含完整 URL（可點擊）
+- ✅ 每項驗證必須包含完整實際內容段落（不可省略或摘要）
+- ✅ 必須標註匹配位置（段落、行號等）
+- ❌ 禁止使用「在原文找到」這類模糊描述
+- ❌ 禁止省略任何必填欄位
+
+## 使用的 MCP Tools
+
+### 網址驗證工具
+- WebFetch - 抓取網頁內容進行比對
+
+### 檔案驗證工具
+- `mcp__tree-view__list_files` - 確認檔案存在性
+- `mcp__secure-rg__secure_rg_search` - 搜尋檔案中的引證文字
+- `mcp__secure-read__secure_read` - 讀取檔案內容驗證
+- `mcp__pdf-split__split_pdf` - PDF 頁碼對應驗證
+
+### 搜尋驗證工具
+- `mcp__web-search__web_search` - 輔助查證資訊來源
+
+## 驗證標準
+
+### ✅ 通過標準
+- 引證文字在來源中**完全匹配**（允許標點符號差異）
+- 頁碼、位置資訊**精準對應**
+- URL 可正常訪問且內容與聲稱一致
+
+### ⚠️ 部分匹配標準
+- 引證文字在來源中找到**高度相似**的內容（90% 以上相似度）
+- 語義相同但用詞略有差異
+- 位置資訊差異在可接受範圍內（±1 頁）
+
+### ❌ 失敗標準
+- 引證文字在來源中**完全找不到**
+- URL 無法訪問或返回 404
+- 檔案不存在
+- 頁碼、位置資訊明顯錯誤
+- 內容與聲稱完全不符
+
+## 最佳實踐
+
+### 使用者應提供
+1. **明確的引證內容**：完整的引用文字（加引號）
+2. **完整的來源資訊**：
+   - 網址：完整 URL
+   - 檔案：檔名 + 路徑
+   - 位置：頁碼、段落、行號等
+3. **上下文資訊**：幫助定位引證內容
+
+### 技能執行原則
+1. **逐項驗證**：不跳過任何引證項目
+2. **平行處理**：同時驗證多個獨立項目（提高效率）
+3. **詳細記錄**：保留所有驗證路徑和證據
+4. **客觀判定**：嚴格按照標準，不寬鬆處理
+5. **建設性建議**：對失敗項目提供改善方向
+
+## 注意事項
+
+### ⚠️ 輸出格式強制要求（絕對不可違反）
+1. **完整 URL 必填**
+   - ✅ 必須：`https://example.com/article`
+   - ❌ 禁止：省略 URL 或用「來源網址」代替
+
+2. **完整段落內容必填**
+   - ✅ 必須：提供完整段落（引證文字前後各 1-2 句）
+   - ❌ 禁止：「在原文第 2 段找到」
+   - ❌ 禁止：用「...」省略內容
+   - ❌ 禁止：只寫摘要
+
+3. **匹配位置必填**
+   - ✅ 必須：「第 3 段第 2 行」或「page_023.pdf」
+   - ❌ 禁止：省略位置資訊
+
+4. **所有欄位嚴格遵守**
+   - 📌 來源 URL（必填）
+   - 💬 聲稱引證（必填）
+   - 📄 實際內容段落（必填）
+   - 📍 匹配位置（必填）
+   - ✅ 驗證結果（必填）
+
+### 一般執行原則
+- ✅ 假定一切皆幻覺，逐項嚴格驗證
+- ✅ 對於無法驗證的項目，明確標記為「無法證明」
+- ✅ 提供完整的驗證證據和匹配位置
+- ✅ 使用平行驗證提高效率（一次性呼叫多個工具）
+- ❌ 不要因為部分通過就放鬆標準
+- ❌ 不要省略驗證步驟
+- ❌ 不要在報告中隱藏失敗項目
+
+## 範例使用
+
+### 使用者請求
+```
+請用零幻覺證明技能驗證以下引證：
+
+1. 根據 https://example.com/report 所述，"AI 市場在 2024 年達到 500 億美元"
+2. report.pdf 第 23 頁提到 "年成長率為 25%"
+3. 根據 data.csv 第 100 行，"用戶滿意度 4.5 分"
+```
+
+### 技能回應
+```
+🔍 開始執行零幻覺證明驗證...
+
+【階段一】拆解引證項目
+識別到 3 項需要驗證的引證：
+1. 網址引證 (https://example.com/report)
+2. 檔案引證 (report.pdf, 第 23 頁)
+3. 檔案引證 (data.csv, 第 100 行)
+
+【階段二】逐項驗證中...
+[平行驗證網址和檔案]
+
+【階段三】零幻覺證明報告
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ 驗證通過: 2 項
+❌ 驗證失敗: 1 項
+可信度評分: 67% (2/3)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+詳細結果：
+1. ✅ [網址引證] 證明通過
+2. ✅ [檔案引證] 證明通過
+3. ❌ [檔案引證] data.csv 第 100 行不存在（檔案僅有 50 行）
+
+建議：移除或修正第 3 項引證
+```