botrun-horse 2.29.2 → 2.30.0

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

@@ -0,0 +1,315 @@
+#!/usr/bin/env node
+/**
+ * PDF 壓縮腳本 - 使用 Ghostscript 智慧壓縮 PDF
+ *
+ * Usage: node pdf-compress.mjs "file.pdf" [--mode ebook|printer|screen]
+ *
+ * 壓縮模式：
+ * - ebook (預設)：150 DPI，適合掃描/圖片文件，壓縮率 60-80%
+ * - printer：300 DPI，適合文字文件，保留品質，壓縮率 30-50%
+ * - screen：72 DPI，最激進壓縮，壓縮率 80-95%
+ *
+ * 特性：
+ * - 智慧回退：若壓縮後變大，保留原檔
+ * - 保留超連結：使用 -dPrinted=false
+ * - PDF 1.4 相容性：最大相容性
+ */
+
+import { execSync } from 'child_process';
+import { existsSync, statSync, unlinkSync, renameSync, copyFileSync } from 'fs';
+import { basename, dirname, resolve, isAbsolute, join } from 'path';
+
+// ============================================================================
+// 配置
+// ============================================================================
+
+const WORKING_DIR = process.env.WORKING_DIR || process.cwd();
+
+// Ghostscript 壓縮模式設定
+const COMPRESSION_MODES = {
+  ebook: {
+    name: 'ebook',
+    description: '適合掃描/圖片文件（150 DPI）',
+    dpi: 150,
+    expectedRatio: '60-80%',
+    gsOptions: '-dPDFSETTINGS=/ebook'
+  },
+  printer: {
+    name: 'printer',
+    description: '適合文字文件，保留品質（300 DPI）',
+    dpi: 300,
+    expectedRatio: '30-50%',
+    gsOptions: '-dPDFSETTINGS=/printer'
+  },
+  screen: {
+    name: 'screen',
+    description: '最激進壓縮，適合網頁瀏覽（72 DPI）',
+    dpi: 72,
+    expectedRatio: '80-95%',
+    gsOptions: '-dPDFSETTINGS=/screen'
+  }
+};
+
+// ============================================================================
+// 日誌
+// ============================================================================
+
+function log(...args) {
+  console.error('[PDF-Compress]', ...args);
+}
+
+// ============================================================================
+// 執行命令
+// ============================================================================
+
+function execCommand(command, timeout = 120000) {
+  try {
+    const result = execSync(command, {
+      encoding: 'utf-8',
+      timeout,
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+    return { success: true, output: result.trim() };
+  } catch (error) {
+    return { success: false, error: error.message, output: '' };
+  }
+}
+
+// ============================================================================
+// 路徑驗證
+// ============================================================================
+
+function validatePath(filePath) {
+  const absolutePath = isAbsolute(filePath) ? filePath : resolve(WORKING_DIR, filePath);
+
+  if (!existsSync(absolutePath)) {
+    return { valid: false, error: `檔案不存在: ${filePath}` };
+  }
+
+  const stats = statSync(absolutePath);
+  if (!stats.isFile()) {
+    return { valid: false, error: `不是檔案: ${filePath}` };
+  }
+
+  if (!absolutePath.toLowerCase().endsWith('.pdf')) {
+    return { valid: false, error: `不是 PDF 檔案: ${filePath}` };
+  }
+
+  return { valid: true, absolutePath, sizeBytes: stats.size };
+}
+
+// ============================================================================
+// 壓縮函數
+// ============================================================================
+
+function compressPdf(inputPath, outputPath, mode) {
+  const modeConfig = COMPRESSION_MODES[mode] || COMPRESSION_MODES.ebook;
+
+  log(`使用 ${modeConfig.name} 模式壓縮 (${modeConfig.description})`);
+
+  // Ghostscript 壓縮命令
+  // -dPrinted=false: 保留超連結
+  // -dCompatibilityLevel=1.4: 最大相容性
+  // -dNOPAUSE -dBATCH -dSAFER -dQUIET: 非互動模式
+  const gsCommand = [
+    'gs',
+    '-sDEVICE=pdfwrite',
+    '-dNOPAUSE',
+    '-dBATCH',
+    '-dSAFER',
+    '-dQUIET',
+    modeConfig.gsOptions,
+    '-dCompatibilityLevel=1.4',
+    '-dPrinted=false', // 保留超連結
+    '-dEmbedAllFonts=true',
+    '-dSubsetFonts=true',
+    `-sOutputFile="${outputPath}"`,
+    `"${inputPath}"`
+  ].join(' ');
+
+  log(`執行: ${gsCommand}`);
+
+  const startTime = Date.now();
+  const result = execCommand(gsCommand);
+  const duration = Date.now() - startTime;
+
+  if (!result.success) {
+    return {
+      success: false,
+      error: `Ghostscript 執行失敗: ${result.error}`
+    };
+  }
+
+  // 檢查輸出檔案
+  if (!existsSync(outputPath)) {
+    return {
+      success: false,
+      error: '壓縮後檔案不存在'
+    };
+  }
+
+  const outputStats = statSync(outputPath);
+
+  return {
+    success: true,
+    outputPath,
+    outputSize: outputStats.size,
+    duration
+  };
+}
+
+// ============================================================================
+// 主壓縮函數
+// ============================================================================
+
+async function compress(pdfPath, options = {}) {
+  const { mode = 'ebook', outputPath: customOutputPath } = options;
+
+  log(`壓縮中: ${pdfPath}`);
+  log(`模式: ${mode}`);
+
+  // 驗證路徑
+  const validation = validatePath(pdfPath);
+  if (!validation.valid) {
+    return {
+      success: false,
+      error: validation.error
+    };
+  }
+
+  const { absolutePath, sizeBytes: originalSize } = validation;
+  const fileName = basename(absolutePath);
+  const fileDir = dirname(absolutePath);
+
+  // 檢查 Ghostscript 是否可用
+  const gsCheck = execCommand('which gs 2>/dev/null');
+  if (!gsCheck.success || !gsCheck.output) {
+    return {
+      success: false,
+      error: '未安裝 Ghostscript (gs)，請先安裝：brew install ghostscript'
+    };
+  }
+
+  // 決定輸出路徑
+  const tempPath = join(fileDir, `temp_compressed_${Date.now()}.pdf`);
+  const finalOutputPath = customOutputPath ||
+    join(fileDir, fileName.replace('.pdf', '_compressed.pdf'));
+
+  // 執行壓縮
+  const compressResult = compressPdf(absolutePath, tempPath, mode);
+
+  if (!compressResult.success) {
+    // 清理臨時檔案
+    if (existsSync(tempPath)) {
+      unlinkSync(tempPath);
+    }
+    return compressResult;
+  }
+
+  const compressedSize = compressResult.outputSize;
+  const compressionRatio = Math.round((1 - compressedSize / originalSize) * 1000) / 10;
+
+  // 智慧回退：若壓縮後變大或幾乎沒變，保留原檔
+  if (compressedSize >= originalSize * 0.95) {
+    log(`壓縮無效（${compressionRatio}%），保留原檔`);
+    unlinkSync(tempPath);
+
+    // 如果需要輸出，複製原檔
+    if (customOutputPath) {
+      copyFileSync(absolutePath, finalOutputPath);
+    }
+
+    return {
+      success: true,
+      compressed: false,
+      reason: '壓縮無效，保留原檔',
+      originalFile: absolutePath,
+      originalSize,
+      originalSizeMB: Math.round(originalSize / 1024 / 1024 * 100) / 100,
+      outputFile: customOutputPath ? finalOutputPath : absolutePath,
+      outputSize: originalSize,
+      outputSizeMB: Math.round(originalSize / 1024 / 1024 * 100) / 100,
+      compressionRatio: 0,
+      mode
+    };
+  }
+
+  // 壓縮成功，移動檔案
+  renameSync(tempPath, finalOutputPath);
+
+  log(`壓縮成功: ${compressionRatio}% 縮減`);
+  log(`原始大小: ${Math.round(originalSize / 1024 / 1024 * 100) / 100} MB`);
+  log(`壓縮後: ${Math.round(compressedSize / 1024 / 1024 * 100) / 100} MB`);
+
+  return {
+    success: true,
+    compressed: true,
+    originalFile: absolutePath,
+    originalSize,
+    originalSizeMB: Math.round(originalSize / 1024 / 1024 * 100) / 100,
+    outputFile: finalOutputPath,
+    outputSize: compressedSize,
+    outputSizeMB: Math.round(compressedSize / 1024 / 1024 * 100) / 100,
+    compressionRatio,
+    mode,
+    duration: compressResult.duration
+  };
+}
+
+// ============================================================================
+// Main
+// ============================================================================
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0) {
+    console.error('Usage: node pdf-compress.mjs "file.pdf" [--mode ebook|printer|screen]');
+    console.error('');
+    console.error('壓縮模式：');
+    console.error('  ebook   - 適合掃描/圖片文件（150 DPI，壓縮率 60-80%）');
+    console.error('  printer - 適合文字文件，保留品質（300 DPI，壓縮率 30-50%）');
+    console.error('  screen  - 最激進壓縮（72 DPI，壓縮率 80-95%）');
+    console.error('');
+    console.error('選項：');
+    console.error('  --mode <mode>   壓縮模式（預設：ebook）');
+    console.error('  --output <path> 輸出路徑（預設：原檔名_compressed.pdf）');
+    process.exit(1);
+  }
+
+  // 解析參數
+  let pdfPath = null;
+  let mode = 'ebook';
+  let outputPath = null;
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--mode' && args[i + 1]) {
+      mode = args[++i];
+    } else if (args[i] === '--output' && args[i + 1]) {
+      outputPath = args[++i];
+    } else if (!args[i].startsWith('--')) {
+      pdfPath = args[i];
+    }
+  }
+
+  if (!pdfPath) {
+    console.error('錯誤：請提供 PDF 檔案路徑');
+    process.exit(1);
+  }
+
+  if (!COMPRESSION_MODES[mode]) {
+    console.error(`錯誤：無效的壓縮模式 "${mode}"，可用：ebook, printer, screen`);
+    process.exit(1);
+  }
+
+  const result = await compress(pdfPath, { mode, outputPath });
+
+  // 輸出 JSON 結果（stdout）
+  console.log(JSON.stringify(result, null, 2));
+
+  if (!result.success) {
+    process.exit(1);
+  }
+}
+
+main();

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

@@ -0,0 +1,275 @@
+#!/usr/bin/env node
+/**
+ * PDF 切割腳本 - 使用 qpdf 將 PDF 分割成單頁
+ *
+ * Usage: node pdf-split.mjs "file.pdf" [--output-dir <dir>]
+ *
+ * 輸出：
+ * - 每頁一個 PDF 檔案：page-001.pdf, page-002.pdf, ...
+ * - 頁碼保留在檔名中，便於後續定位
+ *
+ * 特性：
+ * - 使用 qpdf --split-pages，無損切割
+ * - 自動建立輸出目錄
+ * - 支援大檔案（300+ 頁）
+ */
+
+import { execSync } from 'child_process';
+import { existsSync, statSync, mkdirSync, readdirSync, renameSync } from 'fs';
+import { basename, dirname, resolve, isAbsolute, join } from 'path';
+
+// ============================================================================
+// 配置
+// ============================================================================
+
+const WORKING_DIR = process.env.WORKING_DIR || process.cwd();
+
+// ============================================================================
+// 日誌
+// ============================================================================
+
+function log(...args) {
+  console.error('[PDF-Split]', ...args);
+}
+
+// ============================================================================
+// 執行命令
+// ============================================================================
+
+function execCommand(command, timeout = 300000) {
+  try {
+    const result = execSync(command, {
+      encoding: 'utf-8',
+      timeout,
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+    return { success: true, output: result.trim() };
+  } catch (error) {
+    // qpdf exit code 3 = warnings but operation succeeded
+    if (error.status === 3 || (error.stderr && error.stderr.includes('operation succeeded'))) {
+      return { success: true, output: '', warning: true };
+    }
+    return { success: false, error: error.message, output: '' };
+  }
+}
+
+// ============================================================================
+// 路徑驗證
+// ============================================================================
+
+function validatePath(filePath) {
+  const absolutePath = isAbsolute(filePath) ? filePath : resolve(WORKING_DIR, filePath);
+
+  if (!existsSync(absolutePath)) {
+    return { valid: false, error: `檔案不存在: ${filePath}` };
+  }
+
+  const stats = statSync(absolutePath);
+  if (!stats.isFile()) {
+    return { valid: false, error: `不是檔案: ${filePath}` };
+  }
+
+  if (!absolutePath.toLowerCase().endsWith('.pdf')) {
+    return { valid: false, error: `不是 PDF 檔案: ${filePath}` };
+  }
+
+  return { valid: true, absolutePath, sizeBytes: stats.size };
+}
+
+// ============================================================================
+// 取得頁數
+// ============================================================================
+
+function getPageCount(pdfPath) {
+  const result = execCommand(`qpdf --show-npages "${pdfPath}" 2>/dev/null`);
+  if (result.success && result.output) {
+    return parseInt(result.output, 10) || 0;
+  }
+
+  // 備用：使用 pdfinfo
+  const pdfInfoResult = execCommand(`pdfinfo "${pdfPath}" 2>/dev/null | grep -i "^Pages:" | awk '{print $2}'`);
+  if (pdfInfoResult.success && pdfInfoResult.output) {
+    return parseInt(pdfInfoResult.output, 10) || 0;
+  }
+
+  return 0;
+}
+
+// ============================================================================
+// 切割函數
+// ============================================================================
+
+async function splitPdf(pdfPath, options = {}) {
+  const { outputDir: customOutputDir } = options;
+
+  log(`切割中: ${pdfPath}`);
+
+  // 驗證路徑
+  const validation = validatePath(pdfPath);
+  if (!validation.valid) {
+    return {
+      success: false,
+      error: validation.error
+    };
+  }
+
+  const { absolutePath, sizeBytes } = validation;
+  const fileName = basename(absolutePath, '.pdf');
+  const fileDir = dirname(absolutePath);
+
+  // 檢查 qpdf 是否可用
+  const qpdfCheck = execCommand('which qpdf 2>/dev/null');
+  if (!qpdfCheck.success || !qpdfCheck.output) {
+    return {
+      success: false,
+      error: '未安裝 qpdf，請先安裝：brew install qpdf'
+    };
+  }
+
+  // 取得頁數
+  const pageCount = getPageCount(absolutePath);
+  if (pageCount === 0) {
+    return {
+      success: false,
+      error: '無法取得頁數，可能不是有效的 PDF'
+    };
+  }
+
+  log(`總頁數: ${pageCount}`);
+
+  // 決定輸出目錄
+  const outputDir = customOutputDir || join(fileDir, `${fileName}_pages`);
+
+  // 建立輸出目錄
+  if (!existsSync(outputDir)) {
+    mkdirSync(outputDir, { recursive: true });
+    log(`建立目錄: ${outputDir}`);
+  }
+
+  // 使用 qpdf --split-pages 切割
+  // qpdf 輸出格式：{pattern}-{page}.pdf，例如 page-1.pdf, page-2.pdf
+  // 我們使用 page- 前綴，讓 qpdf 產生 page-1.pdf, page-2.pdf, ...
+  const outputPattern = join(outputDir, 'page.pdf');
+  const splitCommand = `qpdf --split-pages "${absolutePath}" "${outputPattern}"`;
+
+  log(`執行: ${splitCommand}`);
+
+  const startTime = Date.now();
+  const splitResult = execCommand(splitCommand);
+  const duration = Date.now() - startTime;
+
+  if (!splitResult.success) {
+    return {
+      success: false,
+      error: `qpdf 切割失敗: ${splitResult.error}`
+    };
+  }
+
+  // 列出產生的檔案並重新命名為 page-001.pdf 格式
+  let files = readdirSync(outputDir)
+    .filter(f => f.startsWith('page') && f.endsWith('.pdf'))
+    .sort((a, b) => {
+      // 提取數字進行排序
+      const numA = parseInt(a.match(/\d+/)?.[0] || '0', 10);
+      const numB = parseInt(b.match(/\d+/)?.[0] || '0', 10);
+      return numA - numB;
+    });
+
+  // 重新命名為統一格式 page-001.pdf, page-002.pdf, ...
+  const renamedFiles = [];
+  for (let i = 0; i < files.length; i++) {
+    const oldPath = join(outputDir, files[i]);
+    const newName = `page-${String(i + 1).padStart(3, '0')}.pdf`;
+    const newPath = join(outputDir, newName);
+
+    if (oldPath !== newPath) {
+      renameSync(oldPath, newPath);
+    }
+    renamedFiles.push(newName);
+  }
+  files = renamedFiles;
+
+  if (files.length === 0) {
+    return {
+      success: false,
+      error: '切割後沒有產生任何檔案'
+    };
+  }
+
+  // 計算總輸出大小
+  let totalOutputSize = 0;
+  for (const file of files) {
+    const filePath = join(outputDir, file);
+    totalOutputSize += statSync(filePath).size;
+  }
+
+  log(`切割完成: ${files.length} 頁`);
+  log(`耗時: ${duration}ms`);
+
+  return {
+    success: true,
+    inputFile: absolutePath,
+    inputSize: sizeBytes,
+    inputSizeMB: Math.round(sizeBytes / 1024 / 1024 * 100) / 100,
+    outputDir,
+    pageCount: files.length,
+    files: files.map(f => join(outputDir, f)),
+    fileNames: files,
+    totalOutputSize,
+    totalOutputSizeMB: Math.round(totalOutputSize / 1024 / 1024 * 100) / 100,
+    duration,
+    // 提供頁碼範圍資訊，便於後續查詢
+    pageRange: {
+      first: 'page-001.pdf',
+      last: files[files.length - 1],
+      pattern: 'page-XXX.pdf (XXX = 001-' + String(files.length).padStart(3, '0') + ')'
+    }
+  };
+}
+
+// ============================================================================
+// Main
+// ============================================================================
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0) {
+    console.error('Usage: node pdf-split.mjs "file.pdf" [--output-dir <dir>]');
+    console.error('');
+    console.error('將 PDF 分割成單頁檔案：');
+    console.error('  輸出格式：page-001.pdf, page-002.pdf, ...');
+    console.error('');
+    console.error('選項：');
+    console.error('  --output-dir <dir>  輸出目錄（預設：{檔名}_pages/）');
+    process.exit(1);
+  }
+
+  // 解析參數
+  let pdfPath = null;
+  let outputDir = null;
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--output-dir' && args[i + 1]) {
+      outputDir = args[++i];
+    } else if (!args[i].startsWith('--')) {
+      pdfPath = args[i];
+    }
+  }
+
+  if (!pdfPath) {
+    console.error('錯誤：請提供 PDF 檔案路徑');
+    process.exit(1);
+  }
+
+  const result = await splitPdf(pdfPath, { outputDir });
+
+  // 輸出 JSON 結果（stdout）
+  console.log(JSON.stringify(result, null, 2));
+
+  if (!result.success) {
+    process.exit(1);
+  }
+}
+
+main();