botrun-horse 2.30.0 → 2.34.0

package/botrun-c/.claude/skills/HTML/347/224/237/346/210/220/346/212/200/350/203/275/scripts/finalize-project.mjs

@@ -1,162 +0,0 @@
-#!/usr/bin/env node
-/**
- * finalize-project.mjs - 完成 HTML 專案並產生預覽連結
- *
- * 用法：node finalize-project.mjs --project <projectId>
- *
- * 功能：
- * - 自動掃描專案目錄中的所有檔案
- * - 更新 manifest.json 的檔案列表
- * - 輸出預覽連結（可直接在瀏覽器開啟）
- *
- * URL 格式：/api/html-preview/{hashedUserId}/{token}
- * - hashedUserId = sha256(userId + secret).slice(0, 8)
- */
-import { readFileSync, writeFileSync, existsSync, readdirSync, statSync } from 'fs';
-import { join, relative } from 'path';
-import { parseArgs } from 'util';
-import { createHash } from 'crypto';
-
-/**
- * 產生 hashed userId（8 字元）
- * 必須與 api/src/routes/html-preview.ts 中的 hashUserId 函數保持一致
- */
-function hashUserId(userId) {
-  const secret = process.env.HTML_PREVIEW_SECRET || 'botrun-html-preview-2024';
-  return createHash('sha256')
-    .update(userId + secret)
-    .digest('hex')
-    .substring(0, 8);
-}
-
-// 解析命令列參數
-const { values } = parseArgs({
-  options: {
-    project: { type: 'string', short: 'p' },
-  },
-  strict: true,
-});
-
-const projectId = values.project;
-
-if (!projectId) {
-  console.error('錯誤：必須提供 --project 參數');
-  console.error('用法：node finalize-project.mjs --project <projectId>');
-  process.exit(1);
-}
-
-// 取得使用者工作目錄
-// DATA_ROOT = /mnt/data（資料根目錄）
-// USER_ID = 使用者 ID
-// 完整路徑 = /mnt/data/{userId}/projects/default/html-projects
-const dataRoot = process.env.DATA_ROOT || join(process.cwd(), 'data');
-const userId = process.env.USER_ID;
-
-if (!userId) {
-  console.error('錯誤：缺少 USER_ID 環境變數');
-  process.exit(1);
-}
-
-// 專案路徑：/mnt/data/{userId}/projects/default/html-projects/{projectId}
-const projectsRoot = join(dataRoot, userId, 'projects', 'default', 'html-projects');
-const projectPath = join(projectsRoot, projectId);
-const manifestPath = join(projectPath, 'manifest.json');
-
-// 檢查專案是否存在
-if (!existsSync(projectPath)) {
-  console.error(`錯誤：專案不存在: ${projectId}`);
-  process.exit(1);
-}
-
-// 檢查 index.html 是否存在
-const indexPath = join(projectPath, 'index.html');
-if (!existsSync(indexPath)) {
-  console.error('錯誤：專案缺少 index.html');
-  console.error('請先使用 Write 工具建立 index.html');
-  process.exit(1);
-}
-
-// 讀取並更新 manifest
-let manifest;
-try {
-  manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
-} catch (error) {
-  console.error('錯誤：無法讀取 manifest.json');
-  process.exit(1);
-}
-
-// 自動掃描專案目錄，收集所有檔案
-const allowedExtensions = ['.html', '.htm', '.css', '.js', '.mjs', '.json', '.txt', '.svg', '.png', '.jpg', '.jpeg', '.gif', '.ico', '.woff', '.woff2', '.ttf'];
-
-function scanDirectory(dir, baseDir) {
-  const files = [];
-  const entries = readdirSync(dir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    const fullPath = join(dir, entry.name);
-    const relativePath = relative(baseDir, fullPath);
-
-    if (entry.isDirectory()) {
-      // 遞迴掃描子目錄
-      files.push(...scanDirectory(fullPath, baseDir));
-    } else if (entry.isFile()) {
-      // 排除 manifest.json
-      if (entry.name === 'manifest.json') continue;
-
-      // 檢查副檔名
-      const ext = entry.name.substring(entry.name.lastIndexOf('.')).toLowerCase();
-      if (allowedExtensions.includes(ext)) {
-        files.push(relativePath);
-      }
-    }
-  }
-
-  return files;
-}
-
-// 掃描並更新檔案列表
-const scannedFiles = scanDirectory(projectPath, projectPath);
-manifest.files = scannedFiles;
-
-// 更新狀態為已完成
-manifest.status = 'completed';
-manifest.completedAt = new Date().toISOString();
-
-writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), 'utf-8');
-
-// 取得 API 基礎 URL
-const apiBaseUrl = process.env.API_BASE_URL || '';
-
-// 輸出預覽資訊
-console.log('');
-console.log('═══════════════════════════════════════════════════════');
-console.log(`✅ HTML 專案完成！`);
-console.log('═══════════════════════════════════════════════════════');
-console.log('');
-console.log(`📦 專案名稱: ${manifest.name}`);
-console.log(`📝 描述: ${manifest.description || '無'}`);
-console.log(`📁 檔案數量: ${manifest.files.length}`);
-console.log(`   ${manifest.files.join(', ')}`);
-console.log('');
-
-// 產生 hashed userId
-const hashedId = hashUserId(userId);
-
-// 輸出特殊格式，讓前端可以偵測並渲染為可點擊連結
-// 格式：<!-- html-preview:hashedUserId/projectId -->
-// 前端會將此標記轉換為安全的 iframe 或新分頁連結
-console.log('🔗 預覽連結：');
-console.log('');
-console.log(`<!-- html-preview:${hashedId}/${projectId} -->`);
-console.log('');
-
-// 同時輸出完整 URL 供使用者參考
-if (apiBaseUrl) {
-  console.log(`📎 完整 URL: ${apiBaseUrl}/api/html-preview/${hashedId}/${projectId}/`);
-} else {
-  console.log(`📎 相對路徑: /api/html-preview/${hashedId}/${projectId}/`);
-}
-console.log('');
-console.log('💡 提示：點擊上方連結可在新分頁安全預覽網頁');
-console.log('');
-console.log('═══════════════════════════════════════════════════════');

package/botrun-c/.claude/skills/PDF/346/212/200/350/203/275/SKILL.md

@@ -1,206 +0,0 @@
----
-name: PDF技能
-description: 智慧 PDF 閱讀助理。當使用者輸入本技能的完整名稱（「PDF技能」），即代表要求 AI 載入並啟動本技能。當使用者說「PDF」、「讀取 PDF」、「分析 PDF」、「PDF 技能」、「翻到第 X 頁」、「查看目錄」、「照片」、「圖片」、「圖表」、「圖像」、「多模態」、「多模態分析」、「多模態閱讀」或上傳 PDF 後提問時使用。根據檔案大小自動選擇策略：小檔案（<5MB）支援直接多模態閱讀；大檔案（≥5MB）自動切割+轉文字+智慧搜尋。(v5.1121.1500)
-allowed-tools: Bash
----
-
-# 📄 PDF 技能（v2.0 智慧決策樹版）
-
-## 功能說明
-
-根據 PDF 檔案特徵自動選擇最佳處理策略：
-
-| 類型 | 特徵 | 處理策略 |
-|------|------|----------|
-| **A 型** | < 5MB，小型文件 | 直接多模態閱讀 |
-| **B 型** | ≥ 5MB，文字為主 | 壓縮 → 切割 → 純文字搜尋 |
-| **C 型** | ≥ 5MB，掃描/圖表為主 | 激進壓縮 → 切割 → 多模態閱讀 |
-| **D 型** | > 300 頁，超大文件 | 壓縮 → 切割 → 建索引 → 智慧搜尋 |
-
-## 觸發條件
-
-- 使用者上傳 PDF 檔案
-- 提到「PDF」、「讀取 PDF」、「分析 PDF」、「翻到第 X 頁」
-- 詢問「照片」、「圖片」、「圖表」、「圖像」、「多模態」
-
----
-
-## 執行流程
-
-### Step 1：分析 PDF
-
-執行分析腳本取得檔案特徵：
-
-```bash
-node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-analyze.mjs "檔案路徑"
-```
-
-**輸出 JSON 包含：**
-- `analysis.sizeBytes` - 檔案大小
-- `analysis.pages` - 頁數
-- `analysis.avgCharsPerPage` - 平均每頁文字數
-- `classification.type` - 分類（A/B/C/D）
-- `classification.recommendation` - 處理建議
-
----
-
-### Step 2：分類判斷（決策樹）
-
-根據分析結果判斷文件類型：
-
-```
-                    sizeBytes < 5MB?
-                         │
-                    ┌────┴────┐
-                   YES       NO
-                    │         │
-                    ▼         ▼
-                 ┌─────┐   pages > 300?
-                 │ A型 │        │
-                 │直接讀│   ┌────┴────┐
-                 └─────┘  YES       NO
-                          │         │
-                          ▼         ▼
-                      ┌─────┐   avgCharsPerPage > 1000?
-                      │ D型 │        │
-                      │超大 │   ┌────┴────┐
-                      └─────┘  YES       NO
-                               │         │
-                               ▼         ▼
-                           ┌─────┐   ┌─────┐
-                           │ B型 │   │ C型 │
-                           │純文字│   │掃描 │
-                           └─────┘   └─────┘
-```
-
----
-
-### Step 3：詢問使用者意圖（B/C/D 型）
-
-若為大檔案（B/C/D 型），詢問使用者偏好：
-
-> 「這是一份 **{pages}** 頁的 **{類型描述}** 文件（{sizeMB} MB），您希望：」
-> 1. **快速搜尋** - 純文字模式，搜尋特定內容
-> 2. **詳細閱讀** - 多模態模式，查看圖表圖片
-> 3. **全面分析** - 混合模式，文字+視覺
-
----
-
-### Step 4：執行前處理
-
-根據類型執行對應處理：
-
-#### A 型：直接使用
-無需前處理，直接進入問答階段。
-
-#### B 型：純文字文件
-```bash
-# 1. 保守壓縮（保留文字品質）
-node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-compress.mjs "檔案路徑" --mode printer
-
-# 2. 切割成單頁
-node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-split.mjs "壓縮後檔案"
-
-# 3. 批次轉文字
-node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-to-text.mjs "切割目錄/"
-```
-
-#### C 型：掃描/圖表文件
-```bash
-# 1. 激進壓縮（大幅縮小圖片）
-node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-compress.mjs "檔案路徑" --mode ebook
-
-# 2. 切割成單頁
-node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-split.mjs "壓縮後檔案"
-
-# 3. 批次轉文字（用於搜尋定位）
-node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-to-text.mjs "切割目錄/"
-```
-
-#### D 型：超大文件
-```bash
-# 同 B/C 型處理，額外建立索引
-# 執行前三步驟後，記錄章節/頁碼對應關係
-```
-
----
-
-### Step 5：問答階段
-
-#### A 型查詢：直接多模態
-```bash
-# 使用多模態閱讀技能直接讀取整份 PDF
-node $OFFICIAL_SKILLS_DIR/多模態閱讀技能/scripts/multimodal-read.mjs "檔案路徑" --prompt "使用者問題"
-```
-
-#### B/C/D 型查詢策略
-
-| 使用者意圖 | 查詢方式 |
-|------------|----------|
-| **快速搜尋** | `rg "關鍵字" *.txt` → 讀取相關 TXT |
-| **詳細閱讀** | `rg` 定位頁碼 → 多模態讀取對應 PDF 分頁 |
-| **全面分析** | 先搜 TXT 定位 → 再讀 PDF 分頁補充視覺資訊 |
-
-#### 特殊查詢處理
-
-| 查詢類型 | 處理方式 |
-|----------|----------|
-| 「第 X 頁」 | 直接讀取 `page-XXX.pdf`（多模態） |
-| 「圖表/圖片」 | 強制多模態模式 |
-| 「目錄/大綱」 | 讀取前 5 頁 PDF + 搜尋「目錄」「contents」 |
-| 「全文搜尋 Y」 | `rg "Y" *.txt`，列出所有匹配頁碼 |
-
----
-
-## 腳本參考
-
-### pdf-analyze.mjs
-```bash
-node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-analyze.mjs "file.pdf"
-# 輸出：JSON 分析結果，包含分類建議
-```
-
-### pdf-compress.mjs
-```bash
-node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-compress.mjs "file.pdf" --mode ebook
-# 模式：ebook（激進）、printer（保守）、screen（最激進）
-# 輸出：壓縮後檔案路徑、壓縮率
-```
-
-### pdf-split.mjs
-```bash
-node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-split.mjs "file.pdf"
-# 輸出：page-001.pdf, page-002.pdf, ... 在 {檔名}_pages/ 目錄
-```
-
-### pdf-to-text.mjs
-```bash
-node $OFFICIAL_SKILLS_DIR/PDF技能/scripts/pdf-to-text.mjs "pages_dir/"
-# 輸出：page-001.txt, page-002.txt, ... 在同目錄
-```
-
----
-
-## 核心原則
-
-- ✅ **先分析再處理**：用 pdf-analyze 判斷類型
-- ✅ **智慧壓縮**：B 型用 printer，C 型用 ebook
-- ✅ **保留頁碼**：切割後檔名包含頁碼（page-XXX）
-- ✅ **平行讀取**：一次讀取 5-10 個相關檔案
-- ✅ **使用者互動**：大檔案詢問偏好
-- ❌ **禁止**：直接讀取 > 5MB 的完整 PDF
-- ❌ **禁止**：逐個讀取檔案（效率低）
-
----
-
-## 檢查前處理狀態
-
-執行前先檢查是否已有處理過的檔案：
-
-```bash
-# 檢查是否已有切割檔案
-ls {檔名}_pages/page-*.pdf 2>/dev/null | head -5
-ls {檔名}_pages/page-*.txt 2>/dev/null | head -5
-```
-
-若已存在，跳過前處理，直接進入問答階段。

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

@@ -1,19 +0,0 @@
-{
-  "name": "pdf-skill-scripts",
-  "version": "1.0.0",
-  "description": "PDF 技能腳本集：分析、壓縮、切割、轉文字",
-  "type": "module",
-  "scripts": {
-    "test": "node test-pdf-scripts.mjs",
-    "analyze": "node pdf-analyze.mjs",
-    "compress": "node pdf-compress.mjs",
-    "split": "node pdf-split.mjs",
-    "to-text": "node pdf-to-text.mjs"
-  },
-  "keywords": ["pdf", "compress", "split", "ghostscript", "qpdf"],
-  "author": "Botrun",
-  "license": "MIT",
-  "dependencies": {
-    "glob": "^11.0.0"
-  }
-}

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

@@ -1,309 +0,0 @@
-#!/usr/bin/env node
-/**
- * PDF 分析腳本 - 分析 PDF 特徵並分類
- *
- * Usage: node pdf-analyze.mjs "file.pdf"
- *
- * 輸出 JSON 包含：
- * - 基本資訊（頁數、大小）
- * - 文字密度分析
- * - 圖片密度分析
- * - 自動分類（A/B/C/D 型）
- *
- * 分類標準：
- * - A 型：< 5MB，小型文件，直接多模態閱讀
- * - B 型：≥ 5MB，文字密度高，純文字處理
- * - C 型：≥ 5MB，圖片密度高，掃描/圖表文件
- * - D 型：> 300 頁，超大文件，需要索引
- */
-
-import { execSync } from 'child_process';
-import { existsSync, statSync } from 'fs';
-import { basename, resolve, isAbsolute } from 'path';
-
-// ============================================================================
-// 配置
-// ============================================================================
-
-const WORKING_DIR = process.env.WORKING_DIR || process.cwd();
-const SIZE_THRESHOLD = 5 * 1024 * 1024; // 5MB
-const PAGE_THRESHOLD = 300; // 超大文件閾值
-const TEXT_DENSITY_THRESHOLD = 1000; // 字元/頁，低於此為掃描文件
-
-// ============================================================================
-// 日誌
-// ============================================================================
-
-function log(...args) {
-  console.error('[PDF-Analyze]', ...args);
-}
-
-// ============================================================================
-// 執行命令
-// ============================================================================
-
-function execCommand(command) {
-  try {
-    const result = execSync(command, {
-      encoding: 'utf-8',
-      timeout: 30000,
-      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 };
-}
-
-// ============================================================================
-// PDF 分析函數
-// ============================================================================
-
-function getPageCount(pdfPath) {
-  // 使用 pdfinfo 取得頁數
-  const result = execCommand(`pdfinfo "${pdfPath}" 2>/dev/null | grep -i "^Pages:" | awk '{print $2}'`);
-  if (result.success && result.output) {
-    return parseInt(result.output, 10) || 0;
-  }
-
-  // 備用：使用 qpdf
-  const qpdfResult = execCommand(`qpdf --show-npages "${pdfPath}" 2>/dev/null`);
-  if (qpdfResult.success && qpdfResult.output) {
-    return parseInt(qpdfResult.output, 10) || 0;
-  }
-
-  return 0;
-}
-
-function getTextCharCount(pdfPath) {
-  // 使用 pdftotext 提取文字並計算字元數
-  const result = execCommand(`pdftotext "${pdfPath}" - 2>/dev/null | wc -c`);
-  if (result.success && result.output) {
-    return parseInt(result.output.trim(), 10) || 0;
-  }
-  return 0;
-}
-
-function getImageCount(pdfPath) {
-  // 使用 pdfimages -list 計算圖片數量
-  const result = execCommand(`pdfimages -list "${pdfPath}" 2>/dev/null | tail -n +3 | wc -l`);
-  if (result.success && result.output) {
-    return parseInt(result.output.trim(), 10) || 0;
-  }
-  return 0;
-}
-
-function checkToolsAvailable() {
-  const tools = ['pdfinfo', 'pdftotext', 'pdfimages', 'qpdf', 'gs'];
-  const available = {};
-
-  for (const tool of tools) {
-    const result = execCommand(`which ${tool} 2>/dev/null`);
-    available[tool] = result.success && result.output.length > 0;
-  }
-
-  return available;
-}
-
-// ============================================================================
-// 分類邏輯
-// ============================================================================
-
-function classifyPdf(analysis) {
-  const { sizeBytes, pages, avgCharsPerPage, avgImagesPerPage } = analysis;
-
-  // A 型：小檔案 (< 5MB)
-  if (sizeBytes < SIZE_THRESHOLD) {
-    return {
-      type: 'A',
-      name: '小型文件',
-      description: '可直接多模態閱讀',
-      recommendation: {
-        compress: false,
-        split: false,
-        toText: false,
-        queryMode: 'multimodal'
-      }
-    };
-  }
-
-  // D 型：超大文件 (> 300 頁)
-  if (pages > PAGE_THRESHOLD) {
-    return {
-      type: 'D',
-      name: '超大文件',
-      description: '需要索引和分塊處理',
-      recommendation: {
-        compress: true,
-        compressMode: 'printer', // 保守壓縮
-        split: true,
-        toText: true,
-        buildIndex: true,
-        queryMode: 'hybrid'
-      }
-    };
-  }
-
-  // B 型：文字密度高
-  if (avgCharsPerPage >= TEXT_DENSITY_THRESHOLD) {
-    return {
-      type: 'B',
-      name: '純文字文件',
-      description: '文字為主，適合純文字搜尋',
-      recommendation: {
-        compress: true,
-        compressMode: 'printer', // 保守壓縮，保留文字品質
-        split: true,
-        toText: true,
-        queryMode: 'text'
-      }
-    };
-  }
-
-  // C 型：圖片/掃描文件
-  return {
-    type: 'C',
-    name: '掃描/圖表文件',
-    description: '圖片為主，需要多模態閱讀',
-    recommendation: {
-      compress: true,
-      compressMode: 'ebook', // 激進壓縮
-      split: true,
-      toText: true, // 仍然轉文字以供搜尋定位
-      queryMode: 'multimodal'
-    }
-  };
-}
-
-// ============================================================================
-// 主分析函數
-// ============================================================================
-
-async function analyzePdf(pdfPath) {
-  log(`分析中: ${pdfPath}`);
-
-  // 驗證路徑
-  const validation = validatePath(pdfPath);
-  if (!validation.valid) {
-    return {
-      success: false,
-      error: validation.error
-    };
-  }
-
-  const { absolutePath, sizeBytes } = validation;
-  const fileName = basename(absolutePath);
-
-  // 檢查工具可用性
-  const tools = checkToolsAvailable();
-  log('可用工具:', tools);
-
-  if (!tools.pdfinfo && !tools.qpdf) {
-    return {
-      success: false,
-      error: '缺少必要工具: pdfinfo 或 qpdf'
-    };
-  }
-
-  // 取得基本資訊
-  const pages = getPageCount(absolutePath);
-  if (pages === 0) {
-    return {
-      success: false,
-      error: '無法取得頁數，可能不是有效的 PDF'
-    };
-  }
-
-  // 取得文字和圖片資訊
-  const textChars = getTextCharCount(absolutePath);
-  const imageCount = getImageCount(absolutePath);
-
-  // 計算密度指標
-  const avgCharsPerPage = Math.round(textChars / pages);
-  const avgImagesPerPage = Math.round((imageCount / pages) * 100) / 100;
-  const bytesPerPage = Math.round(sizeBytes / pages);
-
-  // 組裝分析結果
-  const analysis = {
-    file: fileName,
-    path: absolutePath,
-    sizeBytes,
-    sizeMB: Math.round(sizeBytes / 1024 / 1024 * 100) / 100,
-    pages,
-    textChars,
-    imageCount,
-    avgCharsPerPage,
-    avgImagesPerPage,
-    bytesPerPage,
-    bytesPerPageKB: Math.round(bytesPerPage / 1024 * 100) / 100
-  };
-
-  // 分類
-  const classification = classifyPdf(analysis);
-
-  // 輸出結果
-  const result = {
-    success: true,
-    analysis,
-    classification,
-    tools
-  };
-
-  log(`分析完成: ${classification.type} 型 (${classification.name})`);
-
-  return result;
-}
-
-// ============================================================================
-// Main
-// ============================================================================
-
-async function main() {
-  const args = process.argv.slice(2);
-
-  if (args.length === 0) {
-    console.error('Usage: node pdf-analyze.mjs "file.pdf"');
-    console.error('');
-    console.error('分析 PDF 檔案特徵並分類：');
-    console.error('  A 型：< 5MB，小型文件');
-    console.error('  B 型：≥ 5MB，文字為主');
-    console.error('  C 型：≥ 5MB，圖片/掃描為主');
-    console.error('  D 型：> 300 頁，超大文件');
-    process.exit(1);
-  }
-
-  const pdfPath = args[0];
-  const result = await analyzePdf(pdfPath);
-
-  // 輸出 JSON 結果（stdout）
-  console.log(JSON.stringify(result, null, 2));
-
-  if (!result.success) {
-    process.exit(1);
-  }
-}
-
-main();