botrun-horse 2.29.2 → 2.30.0

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

@@ -0,0 +1,491 @@
+#!/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

@@ -0,0 +1,76 @@
+---
+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*