botrun-horse 2.30.0 → 2.34.0

package/botrun-c/.claude/skills/PDF/346/212/200/350/203/275/scripts/test-pdf-scripts.mjs

@@ -1,491 +0,0 @@
-#!/usr/bin/env node
-/**
- * PDF 技能腳本測試
- *
- * Usage: node test-pdf-scripts.mjs [--create-test-pdf]
- *
- * 測試項目：
- * 1. 工具可用性檢查（pdfinfo, pdftotext, pdfimages, qpdf, gs）
- * 2. pdf-analyze.mjs 分析功能
- * 3. pdf-compress.mjs 壓縮功能
- * 4. pdf-split.mjs 切割功能
- * 5. pdf-to-text.mjs 轉文字功能
- * 6. 完整流程整合測試
- */
-
-import { execSync, spawn } from 'child_process';
-import { existsSync, statSync, mkdirSync, writeFileSync, unlinkSync, rmSync, readdirSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// ============================================================================
-// 配置
-// ============================================================================
-
-const TEST_DIR = join(__dirname, 'test-output');
-const SCRIPTS = {
-  analyze: join(__dirname, 'pdf-analyze.mjs'),
-  compress: join(__dirname, 'pdf-compress.mjs'),
-  split: join(__dirname, 'pdf-split.mjs'),
-  toText: join(__dirname, 'pdf-to-text.mjs')
-};
-
-// ============================================================================
-// 測試工具
-// ============================================================================
-
-let testsPassed = 0;
-let testsFailed = 0;
-
-function log(msg) {
-  console.log(msg);
-}
-
-function pass(testName) {
-  testsPassed++;
-  log(`  ✅ ${testName}`);
-}
-
-function fail(testName, error) {
-  testsFailed++;
-  log(`  ❌ ${testName}`);
-  if (error) {
-    log(`     Error: ${error}`);
-  }
-}
-
-function execScript(scriptPath, args = []) {
-  try {
-    const result = execSync(`node "${scriptPath}" ${args.join(' ')}`, {
-      encoding: 'utf-8',
-      timeout: 120000,
-      stdio: ['pipe', 'pipe', 'pipe']
-    });
-    return { success: true, output: result, json: tryParseJson(result) };
-  } catch (error) {
-    return { success: false, error: error.message, stderr: error.stderr };
-  }
-}
-
-function tryParseJson(str) {
-  try {
-    return JSON.parse(str);
-  } catch {
-    return null;
-  }
-}
-
-function checkCommand(cmd) {
-  try {
-    execSync(`which ${cmd} 2>/dev/null`, { encoding: 'utf-8' });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-// ============================================================================
-// 測試 1：工具可用性檢查
-// ============================================================================
-
-function testToolsAvailability() {
-  log('\n📋 測試 1：工具可用性檢查');
-
-  const tools = [
-    { name: 'pdfinfo', required: true },
-    { name: 'pdftotext', required: true },
-    { name: 'pdfimages', required: true },
-    { name: 'qpdf', required: true },
-    { name: 'gs', required: true }
-  ];
-
-  let allRequired = true;
-
-  for (const tool of tools) {
-    const available = checkCommand(tool.name);
-    if (available) {
-      pass(`${tool.name} 可用`);
-    } else {
-      if (tool.required) {
-        fail(`${tool.name} 不可用（必要）`);
-        allRequired = false;
-      } else {
-        log(`  ⚠️ ${tool.name} 不可用（選用）`);
-      }
-    }
-  }
-
-  return allRequired;
-}
-
-// ============================================================================
-// 測試 2：腳本檔案存在性
-// ============================================================================
-
-function testScriptsExist() {
-  log('\n📋 測試 2：腳本檔案存在性');
-
-  for (const [name, path] of Object.entries(SCRIPTS)) {
-    if (existsSync(path)) {
-      pass(`${name} 腳本存在: ${path}`);
-    } else {
-      fail(`${name} 腳本不存在: ${path}`);
-    }
-  }
-}
-
-// ============================================================================
-// 測試 3：使用真實 PDF 測試（如果有）
-// ============================================================================
-
-async function testWithRealPdf() {
-  log('\n📋 測試 3：尋找可用的測試 PDF');
-
-  // 嘗試找一個現有的 PDF 檔案
-  const possiblePaths = [
-    join(__dirname, '..', '..', '..', '..', 'data'),
-    join(__dirname, '..', '..', '..', '..', 'uploads'),
-    '/tmp'
-  ];
-
-  let testPdf = null;
-
-  for (const dir of possiblePaths) {
-    if (existsSync(dir)) {
-      try {
-        const files = readdirSync(dir);
-        const pdfFile = files.find(f => f.endsWith('.pdf'));
-        if (pdfFile) {
-          testPdf = join(dir, pdfFile);
-          break;
-        }
-      } catch {
-        // 目錄不可讀，跳過
-      }
-    }
-  }
-
-  if (!testPdf) {
-    log('  ⚠️ 找不到測試用 PDF 檔案，跳過實際測試');
-    log('     請手動測試：node pdf-analyze.mjs "your-file.pdf"');
-    return false;
-  }
-
-  log(`  📄 找到測試 PDF: ${testPdf}`);
-  return testPdf;
-}
-
-// ============================================================================
-// 測試 4：pdf-analyze.mjs
-// ============================================================================
-
-function testAnalyze(pdfPath) {
-  log('\n📋 測試 4：pdf-analyze.mjs');
-
-  if (!pdfPath) {
-    log('  ⚠️ 無測試 PDF，跳過');
-    return null;
-  }
-
-  const result = execScript(SCRIPTS.analyze, [`"${pdfPath}"`]);
-
-  if (!result.success) {
-    fail('執行失敗', result.error);
-    return null;
-  }
-
-  if (!result.json) {
-    fail('輸出不是有效 JSON');
-    return null;
-  }
-
-  if (!result.json.success) {
-    fail('分析失敗', result.json.error);
-    return null;
-  }
-
-  pass('分析成功執行');
-
-  // 驗證輸出結構
-  const { analysis, classification } = result.json;
-
-  if (analysis && typeof analysis.pages === 'number') {
-    pass(`頁數: ${analysis.pages}`);
-  } else {
-    fail('缺少頁數資訊');
-  }
-
-  if (analysis && typeof analysis.sizeBytes === 'number') {
-    pass(`大小: ${(analysis.sizeBytes / 1024 / 1024).toFixed(2)} MB`);
-  } else {
-    fail('缺少大小資訊');
-  }
-
-  if (classification && ['A', 'B', 'C', 'D'].includes(classification.type)) {
-    pass(`分類: ${classification.type} 型 (${classification.name})`);
-  } else {
-    fail('缺少分類資訊');
-  }
-
-  return result.json;
-}
-
-// ============================================================================
-// 測試 5：pdf-compress.mjs
-// ============================================================================
-
-function testCompress(pdfPath, analysisResult) {
-  log('\n📋 測試 5：pdf-compress.mjs');
-
-  if (!pdfPath) {
-    log('  ⚠️ 無測試 PDF，跳過');
-    return null;
-  }
-
-  // 只對 >= 1MB 的檔案測試壓縮
-  const stats = statSync(pdfPath);
-  if (stats.size < 1024 * 1024) {
-    log('  ⚠️ 測試 PDF 太小 (< 1MB)，跳過壓縮測試');
-    return null;
-  }
-
-  // 建立測試輸出目錄
-  if (!existsSync(TEST_DIR)) {
-    mkdirSync(TEST_DIR, { recursive: true });
-  }
-
-  const outputPath = join(TEST_DIR, 'test_compressed.pdf');
-
-  const result = execScript(SCRIPTS.compress, [
-    `"${pdfPath}"`,
-    '--mode', 'ebook',
-    '--output', `"${outputPath}"`
-  ]);
-
-  if (!result.success) {
-    fail('執行失敗', result.error);
-    return null;
-  }
-
-  if (!result.json) {
-    fail('輸出不是有效 JSON');
-    return null;
-  }
-
-  if (!result.json.success) {
-    fail('壓縮失敗', result.json.error);
-    return null;
-  }
-
-  pass('壓縮成功執行');
-
-  if (result.json.compressed) {
-    pass(`壓縮率: ${result.json.compressionRatio}%`);
-    pass(`原始: ${result.json.originalSizeMB} MB → 壓縮後: ${result.json.outputSizeMB} MB`);
-  } else {
-    pass(`壓縮無效，保留原檔（${result.json.reason}）`);
-  }
-
-  return result.json;
-}
-
-// ============================================================================
-// 測試 6：pdf-split.mjs
-// ============================================================================
-
-function testSplit(pdfPath) {
-  log('\n📋 測試 6：pdf-split.mjs');
-
-  if (!pdfPath) {
-    log('  ⚠️ 無測試 PDF，跳過');
-    return null;
-  }
-
-  // 建立測試輸出目錄
-  if (!existsSync(TEST_DIR)) {
-    mkdirSync(TEST_DIR, { recursive: true });
-  }
-
-  const outputDir = join(TEST_DIR, 'test_pages');
-
-  const result = execScript(SCRIPTS.split, [
-    `"${pdfPath}"`,
-    '--output-dir', `"${outputDir}"`
-  ]);
-
-  if (!result.success) {
-    fail('執行失敗', result.error);
-    return null;
-  }
-
-  if (!result.json) {
-    fail('輸出不是有效 JSON');
-    return null;
-  }
-
-  if (!result.json.success) {
-    fail('切割失敗', result.json.error);
-    return null;
-  }
-
-  pass('切割成功執行');
-  pass(`產生 ${result.json.pageCount} 個分頁檔案`);
-
-  // 驗證輸出檔案
-  if (existsSync(outputDir)) {
-    const files = readdirSync(outputDir).filter(f => f.endsWith('.pdf'));
-    if (files.length === result.json.pageCount) {
-      pass('輸出檔案數量正確');
-    } else {
-      fail(`輸出檔案數量不符: 預期 ${result.json.pageCount}，實際 ${files.length}`);
-    }
-  }
-
-  return result.json;
-}
-
-// ============================================================================
-// 測試 7：pdf-to-text.mjs
-// ============================================================================
-
-function testToText(splitResult) {
-  log('\n📋 測試 7：pdf-to-text.mjs');
-
-  if (!splitResult || !splitResult.outputDir) {
-    log('  ⚠️ 無切割輸出，跳過');
-    return null;
-  }
-
-  const result = execScript(SCRIPTS.toText, [`"${splitResult.outputDir}"`]);
-
-  if (!result.success) {
-    fail('執行失敗', result.error);
-    return null;
-  }
-
-  if (!result.json) {
-    fail('輸出不是有效 JSON');
-    return null;
-  }
-
-  if (!result.json.success) {
-    fail('轉文字失敗', result.json.error);
-    return null;
-  }
-
-  pass('批次轉文字成功執行');
-  pass(`處理 ${result.json.totalFiles} 個檔案，成功 ${result.json.successCount}，失敗 ${result.json.failCount}`);
-
-  // 驗證輸出檔案
-  if (existsSync(splitResult.outputDir)) {
-    const txtFiles = readdirSync(splitResult.outputDir).filter(f => f.endsWith('.txt'));
-    if (txtFiles.length > 0) {
-      pass(`產生 ${txtFiles.length} 個文字檔案`);
-    } else {
-      fail('沒有產生文字檔案');
-    }
-  }
-
-  return result.json;
-}
-
-// ============================================================================
-// 測試 8：Help 訊息測試
-// ============================================================================
-
-function testHelpMessages() {
-  log('\n📋 測試 8：Help 訊息');
-
-  for (const [name, path] of Object.entries(SCRIPTS)) {
-    const result = execScript(path, []);
-    // 腳本沒有參數時應該輸出 usage 並 exit 1
-    if (result.stderr || result.error) {
-      pass(`${name} 顯示 usage 訊息`);
-    } else {
-      fail(`${name} 沒有顯示 usage 訊息`);
-    }
-  }
-}
-
-// ============================================================================
-// 清理測試檔案
-// ============================================================================
-
-function cleanup() {
-  log('\n🧹 清理測試檔案');
-
-  if (existsSync(TEST_DIR)) {
-    try {
-      rmSync(TEST_DIR, { recursive: true, force: true });
-      log(`  已刪除: ${TEST_DIR}`);
-    } catch (error) {
-      log(`  ⚠️ 清理失敗: ${error.message}`);
-    }
-  }
-}
-
-// ============================================================================
-// Main
-// ============================================================================
-
-async function main() {
-  log('🧪 PDF 技能腳本測試');
-  log('=' .repeat(50));
-
-  const args = process.argv.slice(2);
-  const skipCleanup = args.includes('--no-cleanup');
-
-  // 測試 1：工具可用性
-  const toolsOk = testToolsAvailability();
-  if (!toolsOk) {
-    log('\n❌ 必要工具不可用，請先安裝：');
-    log('   brew install poppler qpdf ghostscript');
-    process.exit(1);
-  }
-
-  // 測試 2：腳本存在性
-  testScriptsExist();
-
-  // 測試 3：尋找測試 PDF
-  const testPdf = await testWithRealPdf();
-
-  // 測試 4：分析
-  const analysisResult = testAnalyze(testPdf);
-
-  // 測試 5：壓縮
-  const compressResult = testCompress(testPdf, analysisResult);
-
-  // 測試 6：切割
-  const splitResult = testSplit(testPdf);
-
-  // 測試 7：轉文字
-  const toTextResult = testToText(splitResult);
-
-  // 測試 8：Help 訊息
-  testHelpMessages();
-
-  // 清理
-  if (!skipCleanup) {
-    cleanup();
-  }
-
-  // 總結
-  log('\n' + '=' .repeat(50));
-  log(`📊 測試結果: ${testsPassed} 通過, ${testsFailed} 失敗`);
-
-  if (testsFailed > 0) {
-    log('\n❌ 部分測試失敗');
-    process.exit(1);
-  } else {
-    log('\n✅ 所有測試通過！');
-    process.exit(0);
-  }
-}
-
-main().catch(error => {
-  console.error('測試執行錯誤:', error);
-  process.exit(1);
-});

package/botrun-c/.claude/skills/docx-to-markdown/SKILL.md

@@ -1,76 +0,0 @@
----
-name: docx-to-markdown
-description: 將 DOCX 文件轉換為 Markdown 格式。支援批次處理多個檔案。使用於需要將 Word 文件轉為純文字 Markdown 時。
-allowed-tools: Bash
----
-
-# DOCX 轉 Markdown
-
-將 Microsoft Word (.docx) 文件轉換為 Markdown 格式，使用 Pandoc 進行高品質轉換。
-
-## 使用方式
-
-```bash
-uv run $OFFICIAL_SKILLS_DIR/docx-to-markdown/scripts/convert_docx.py \
-  --input <DOCX_PATH> \
-  --output <OUTPUT_DIR>
-```
-
-## 參數說明
-
-| 參數 | 縮寫 | 說明 |
-|------|------|------|
-| `--input` | `-i` | 輸入 DOCX 檔案或目錄（可指定多個） |
-| `--output` | `-o` | 輸出目錄 |
-
-## 使用範例
-
-**單一檔案：**
-```bash
-uv run $OFFICIAL_SKILLS_DIR/docx-to-markdown/scripts/convert_docx.py \
-  -i document.docx \
-  -o output/
-```
-
-**多個檔案：**
-```bash
-uv run $OFFICIAL_SKILLS_DIR/docx-to-markdown/scripts/convert_docx.py \
-  -i file1.docx file2.docx file3.docx \
-  -o output/
-```
-
-**整個目錄：**
-```bash
-uv run $OFFICIAL_SKILLS_DIR/docx-to-markdown/scripts/convert_docx.py \
-  -i documents/ \
-  -o output/
-```
-
-## 輸出說明
-
-- 輸出檔名與原始 DOCX 相同，副檔名改為 `.md`
-- 例如：`report.docx` → `report.md`
-- 所有輸出檔案放在指定的輸出目錄
-
-```
-output/
-├── file1.md
-├── file2.md
-└── file3.md
-```
-
-## 技術說明
-
-- 使用 `pypandoc_binary` 進行轉換（自帶 Pandoc 執行檔）
-- 輸出格式為 `markdown_strict`（標準 Markdown，避免非標準語法）
-- 不自動換行（`--wrap=none`）
-
-## 支援格式
-
-| 輸入格式 | 說明 |
-|---------|------|
-| .docx | Microsoft Word 2007+ 文件 |
-
----
-
-*Version: 1.0*