botrun-horse 2.29.1 → 2.30.0

package/botrun-c/.claude/skills/DOCX/351/226/261/350/256/200/346/212/200/350/203/275/SKILL.md

@@ -0,0 +1,103 @@
+---
+name: DOCX閱讀技能
+description: 將 DOCX 文件轉換為 Markdown 格式並閱讀內容。當使用者需要「讀取 DOCX」、「閱讀 Word 文件」、「轉換 DOCX」、「DOCX 內容」時使用。使用 mammoth.js 進行高品質轉換。(v1.0.0)
+allowed-tools: Bash,Read
+---
+
+# DOCX 閱讀技能（v1.0.0）
+
+## 功能說明
+
+將 DOCX 文件轉換為 Markdown 格式，方便 AI 閱讀和分析：
+
+| 功能 | 說明 |
+|------|------|
+| **DOCX 轉 Markdown** | 使用 mammoth.js 高品質轉換 |
+| **保留格式** | 標題、段落、列表、表格 |
+| **批次處理** | 支援轉換多個檔案 |
+
+## 觸發條件
+
+- 使用者需要閱讀 DOCX/Word 文件
+- 檔案副檔名為 `.docx`
+- Google Drive 同步的 DOCX 需要轉換
+
+---
+
+## 執行流程
+
+### Step 1：轉換單一 DOCX 檔案
+
+```bash
+node $OFFICIAL_SKILLS_DIR/DOCX閱讀技能/scripts/docx-to-markdown.mjs \
+  --input "/path/to/file.docx" \
+  --output "/path/to/output.md"
+```
+
+**參數說明：**
+- `--input` - DOCX 檔案路徑（必填）
+- `--output` - 輸出 Markdown 路徑（選填，預設同目錄）
+
+### Step 2：讀取轉換後的 Markdown
+
+使用 Read 工具讀取轉換後的 `.md` 檔案。
+
+---
+
+## 腳本參考
+
+### docx-to-markdown.mjs
+
+```bash
+# 基本用法
+node $OFFICIAL_SKILLS_DIR/DOCX閱讀技能/scripts/docx-to-markdown.mjs \
+  --input "/mnt/data/user/file.docx"
+
+# 指定輸出路徑
+node $OFFICIAL_SKILLS_DIR/DOCX閱讀技能/scripts/docx-to-markdown.mjs \
+  --input "/mnt/data/user/file.docx" \
+  --output "/mnt/data/user/file.md"
+
+# 直接輸出到 stdout（不存檔）
+node $OFFICIAL_SKILLS_DIR/DOCX閱讀技能/scripts/docx-to-markdown.mjs \
+  --input "/mnt/data/user/file.docx" \
+  --stdout
+```
+
+**輸出格式：**
+```json
+{
+  "success": true,
+  "input": "/path/to/input.docx",
+  "output": "/path/to/output.md",
+  "size": 1234,
+  "preview": "前 500 字預覽..."
+}
+```
+
+---
+
+## 範例對話
+
+**使用者：** 幫我讀取 gdrive 裡的 DOCX 檔案
+
+**AI：** 好的，讓我先將 DOCX 轉換為 Markdown 格式。
+
+```bash
+node $OFFICIAL_SKILLS_DIR/DOCX閱讀技能/scripts/docx-to-markdown.mjs \
+  --input "/tmp/$USER_ID/gdrive/folderId/original/file.docx" \
+  --output "/tmp/$USER_ID/gdrive/folderId/converted/file.md"
+```
+
+轉換成功！讓我讀取內容：
+
+（使用 Read 工具讀取 .md 檔案）
+
+---
+
+## 技術細節
+
+- **轉換引擎**：mammoth.js（純 JavaScript）
+- **輸出格式**：Markdown（GitHub Flavored）
+- **支援元素**：標題、段落、粗體、斜體、列表、表格、超連結
+- **限制**：複雜圖表可能無法完美轉換

package/botrun-c/.claude/skills/DOCX/351/226/261/350/256/200/346/212/200/350/203/275/scripts/docx-to-markdown.mjs

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+
+/**
+ * docx-to-markdown.mjs - 使用 mammoth.js 將 DOCX 轉換為 Markdown
+ *
+ * 使用方式：
+ *   node docx-to-markdown.mjs --input "/path/to/file.docx"
+ *   node docx-to-markdown.mjs --input "/path/to/file.docx" --output "/path/to/output.md"
+ *   node docx-to-markdown.mjs --input "/path/to/file.docx" --stdout
+ *
+ * 依賴：mammoth (npm install mammoth)
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { createRequire } from 'module';
+
+// 動態載入 mammoth（支援不同安裝位置）
+const require = createRequire(import.meta.url);
+let mammoth;
+
+try {
+  // 嘗試從 api/node_modules 載入
+  mammoth = require('mammoth');
+} catch (e1) {
+  try {
+    // 嘗試從專案根目錄載入
+    const projectRoot = process.env.PROJECT_ROOT || '/app';
+    mammoth = require(path.join(projectRoot, 'api', 'node_modules', 'mammoth'));
+  } catch (e2) {
+    console.error(JSON.stringify({
+      error: true,
+      message: 'mammoth 套件未安裝。請執行: pnpm add mammoth',
+      details: e2.message
+    }, null, 2));
+    process.exit(1);
+  }
+}
+
+// 解析命令列參數
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const result = {
+    input: null,
+    output: null,
+    stdout: false
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--input' && args[i + 1]) {
+      result.input = args[i + 1];
+      i++;
+    } else if (args[i] === '--output' && args[i + 1]) {
+      result.output = args[i + 1];
+      i++;
+    } else if (args[i] === '--stdout') {
+      result.stdout = true;
+    }
+  }
+
+  return result;
+}
+
+// 將 HTML 轉換為 Markdown（簡化版）
+function htmlToMarkdown(html) {
+  let md = html;
+
+  // 標題
+  md = md.replace(/<h1[^>]*>(.*?)<\/h1>/gi, '# $1\n\n');
+  md = md.replace(/<h2[^>]*>(.*?)<\/h2>/gi, '## $1\n\n');
+  md = md.replace(/<h3[^>]*>(.*?)<\/h3>/gi, '### $1\n\n');
+  md = md.replace(/<h4[^>]*>(.*?)<\/h4>/gi, '#### $1\n\n');
+  md = md.replace(/<h5[^>]*>(.*?)<\/h5>/gi, '##### $1\n\n');
+  md = md.replace(/<h6[^>]*>(.*?)<\/h6>/gi, '###### $1\n\n');
+
+  // 粗體和斜體
+  md = md.replace(/<strong[^>]*>(.*?)<\/strong>/gi, '**$1**');
+  md = md.replace(/<b[^>]*>(.*?)<\/b>/gi, '**$1**');
+  md = md.replace(/<em[^>]*>(.*?)<\/em>/gi, '*$1*');
+  md = md.replace(/<i[^>]*>(.*?)<\/i>/gi, '*$1*');
+
+  // 連結
+  md = md.replace(/<a[^>]*href="([^"]*)"[^>]*>(.*?)<\/a>/gi, '[$2]($1)');
+
+  // 列表
+  md = md.replace(/<ul[^>]*>/gi, '\n');
+  md = md.replace(/<\/ul>/gi, '\n');
+  md = md.replace(/<ol[^>]*>/gi, '\n');
+  md = md.replace(/<\/ol>/gi, '\n');
+  md = md.replace(/<li[^>]*>(.*?)<\/li>/gi, '- $1\n');
+
+  // 段落
+  md = md.replace(/<p[^>]*>(.*?)<\/p>/gi, '$1\n\n');
+
+  // 換行
+  md = md.replace(/<br\s*\/?>/gi, '\n');
+
+  // 表格（簡化處理）
+  md = md.replace(/<table[^>]*>/gi, '\n');
+  md = md.replace(/<\/table>/gi, '\n');
+  md = md.replace(/<tr[^>]*>/gi, '| ');
+  md = md.replace(/<\/tr>/gi, '\n');
+  md = md.replace(/<td[^>]*>(.*?)<\/td>/gi, '$1 | ');
+  md = md.replace(/<th[^>]*>(.*?)<\/th>/gi, '**$1** | ');
+
+  // 移除其他 HTML 標籤
+  md = md.replace(/<[^>]+>/g, '');
+
+  // 解碼 HTML 實體
+  md = md.replace(/&nbsp;/g, ' ');
+  md = md.replace(/&amp;/g, '&');
+  md = md.replace(/&lt;/g, '<');
+  md = md.replace(/&gt;/g, '>');
+  md = md.replace(/&quot;/g, '"');
+  md = md.replace(/&#39;/g, "'");
+
+  // 清理多餘空行
+  md = md.replace(/\n{3,}/g, '\n\n');
+  md = md.trim();
+
+  return md;
+}
+
+// 主函數
+async function main() {
+  const { input, output, stdout } = parseArgs();
+
+  if (!input) {
+    console.error(JSON.stringify({
+      error: true,
+      message: '請提供輸入檔案路徑。用法: node docx-to-markdown.mjs --input "/path/to/file.docx"'
+    }, null, 2));
+    process.exit(1);
+  }
+
+  // 檢查檔案是否存在
+  if (!fs.existsSync(input)) {
+    console.error(JSON.stringify({
+      error: true,
+      message: `檔案不存在: ${input}`
+    }, null, 2));
+    process.exit(1);
+  }
+
+  // 檢查副檔名
+  const ext = path.extname(input).toLowerCase();
+  if (ext !== '.docx') {
+    console.error(JSON.stringify({
+      error: true,
+      message: `不支援的檔案格式: ${ext}。僅支援 .docx`
+    }, null, 2));
+    process.exit(1);
+  }
+
+  try {
+    // 讀取並轉換 DOCX
+    const result = await mammoth.convertToHtml({ path: input });
+    const html = result.value;
+    const warnings = result.messages;
+
+    // 轉換為 Markdown
+    const markdown = htmlToMarkdown(html);
+
+    // 如果指定 stdout，直接輸出
+    if (stdout) {
+      console.log(markdown);
+      return;
+    }
+
+    // 決定輸出路徑
+    const outputPath = output || input.replace(/\.docx$/i, '.md');
+
+    // 確保輸出目錄存在
+    const outputDir = path.dirname(outputPath);
+    if (!fs.existsSync(outputDir)) {
+      fs.mkdirSync(outputDir, { recursive: true });
+    }
+
+    // 寫入檔案
+    fs.writeFileSync(outputPath, markdown, 'utf-8');
+
+    // 輸出結果
+    const stats = fs.statSync(outputPath);
+    const preview = markdown.substring(0, 500) + (markdown.length > 500 ? '...' : '');
+
+    console.log(JSON.stringify({
+      success: true,
+      input: input,
+      output: outputPath,
+      size: stats.size,
+      characterCount: markdown.length,
+      warnings: warnings.length > 0 ? warnings.map(w => w.message) : [],
+      preview: preview
+    }, null, 2));
+
+  } catch (error) {
+    console.error(JSON.stringify({
+      error: true,
+      message: `轉換失敗: ${error.message}`,
+      stack: error.stack
+    }, null, 2));
+    process.exit(1);
+  }
+}
+
+main();