botrun-horse 2.31.0 → 2.34.0

package/parallel-dag-todo-list/imagen-module.md

@@ -0,0 +1,51 @@
+# DAG Todo: modules/imagen — Gemini 繪圖模組
+
+## 依賴圖（→ 表示依賴）
+
+```
+[T1] imagen-client.mjs  ──→ (無依賴，核心 library)
+[T2] test/imagen/*.test.mjs ──→ T1
+[T3] command.mjs (CLI) ──→ T1
+[T4] server.mjs (Hono API) ──→ T1
+[T5] index.mjs (模組註冊) ──→ T3, T4
+[T6] npm install hono ──→ (無依賴)
+[T7] 整合測試 + CLI 驗證 ──→ T2, T3, T4, T5, T6
+[T8] bump + commit ──→ T7
+```
+
+## 任務清單
+
+| ID | 任務 | 狀態 | 依賴 |
+|----|------|------|------|
+| T1 | `modules/imagen/imagen-client.mjs` — 核心繪圖 library（生成/編輯/多輪 session） | **done** | — |
+| T2 | `test/imagen/*.test.mjs` — BDD/TDD 測試（17 pass / 0 fail） | **done** | T1 |
+| T3 | `modules/imagen/command.mjs` — CLI 指令（bh imagen generate/edit/serve） | **done** | T1 |
+| T4 | `modules/imagen/server.mjs` — Hono API 伺服器 | **done** | T1 |
+| T5 | `modules/imagen/index.mjs` — 模組自動註冊 | **done** | T3, T4 |
+| T6 | `npm install hono @hono/node-server` | **done** | — |
+| T7 | 整合測試 + CLI 驗證（17 test pass, help 正常） | **done** | T2-T6 |
+| T8 | bump version + commit（v2.34.0, 839ffd5） | **done** | T7 |
+
+## 架構設計
+
+```
+modules/imagen/
+  index.mjs            ← { name, schema, handler } 自動註冊
+  command.mjs           ← CLI: bh imagen generate|edit|serve
+  server.mjs            ← Hono API: POST /api/imagen/generate, /api/imagen/edit
+  imagen-client.mjs     ← 核心：generateImage(), editImage(), createSession()
+```
+
+## API 規格
+
+### CLI
+- `bh imagen generate "一隻貓坐在月亮上"` → 輸出 PNG 檔案
+- `bh imagen generate "prompt" --model=gemini-3-pro-image-preview --size=512px --aspect=16:9`
+- `bh imagen edit input.png "把背景換成海灘"` → 輸出編輯後 PNG
+- `bh imagen serve --port=3000` → 啟動 Hono API
+
+### Hono API
+- `POST /api/imagen/generate` — `{ prompt, model?, size?, aspect? }` → PNG
+- `POST /api/imagen/edit` — `{ prompt, image(base64), model? }` → PNG
+- `POST /api/imagen/session` — `{ sessionId?, prompt, image?(base64) }` → `{ sessionId, image(base64) }`
+- `GET /health` → `{ status: "ok" }`

package/bin/commands/schema.mjs

@@ -1,254 +0,0 @@
-// bin/commands/schema.mjs — 所有指令的結構化 schema（AI/LLM 友善）
-// 集中管理：方便 AI agent 讀取完整指令清單
-
-export const COMMANDS = {
-  doc: {
-    name: 'doc',
-    description: '文件處理（拆頁、轉文字、入庫）— 支援 PDF 與 Office 全系列',
-    requires_sqlite: false,
-    subcommands: {
-      split: '通用 PDF 拆頁（每頁輸出為獨立 PDF）',
-      text: 'PDF 轉純文字（保留頁碼與排版，不需先拆頁）',
-      ingest: 'PDF/Office 入庫流水線（轉文字 → SQLite FTS5）[需 --experimental-sqlite]',
-    },
-    options: {
-      '--project=<名稱>': { type: 'string', default: 'nstc', description: '專案名稱' },
-      '--dir=<路徑>': { type: 'string', description: '掃描單一目錄內所有文件' },
-      '--dirs=<路徑1,路徑2>': { type: 'string', description: '掃描多個目錄（逗號分隔）' },
-      '--outdir=<路徑>': { type: 'string', description: '拆頁輸出目錄（split 指令用）' },
-      '--split-pdf': { type: 'boolean', default: false, description: '[ingest] 同時拆頁成獨立 PDF' },
-      '--recursive': { type: 'boolean', default: false, description: '遞迴掃描子目錄' },
-      '--force': { type: 'boolean', default: false, description: '強制重新入庫（忽略斷點續作紀錄）' },
-      '--concurrency=N': { type: 'integer', default: 5, description: '平行處理數' },
-      '--quiet': { type: 'boolean', default: false, description: '靜默模式（不輸出進度到 stderr，GNU parallel 友善）' },
-      '--print0': { type: 'boolean', default: false, description: 'NUL 分隔路徑輸出（與 xargs -0 相容）' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-    },
-    examples: [
-      'bh doc split file1.pdf file2.pdf --project=nstc',
-      'bh doc text --dir=projects/nstc/output/pdfs',
-      'node --experimental-sqlite bin/bh.mjs doc ingest --dir=projects/nstc/pdfs --project=nstc',
-      'node --experimental-sqlite bin/bh.mjs doc ingest --dirs=pdfs/,docs/ --project=nstc --recursive',
-      'node --experimental-sqlite bin/bh.mjs doc ingest file.docx report.xlsx --project=nstc',
-      'node --experimental-sqlite bin/bh.mjs doc ingest --dir=pdfs/ --force --split-pdf --project=nstc',
-      'ls pdfs/*.pdf | node --experimental-sqlite bin/bh.mjs doc ingest --project=nstc',
-      'find . -name "*.pdf" -print0 | xargs -0 -P 4 node bin/bh.mjs doc text --quiet',
-    ],
-  },
-  writing: {
-    name: 'writing',
-    description: '公文撰寫（生成 PDF）',
-    requires_sqlite: false,
-    subcommands: {
-      generate: '平行生成 PDF 文件（DAG 依賴感知批次處理）',
-    },
-    options: {
-      '--project=<名稱>': { type: 'string', default: 'nstc', description: '專案名稱' },
-      '--concurrency=N': { type: 'integer', default: 10, description: '平行並發數' },
-      '--ids=1,2,3': { type: 'string', description: '指定文件 ID（逗號分隔）' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-    },
-    examples: [
-      'bh writing generate --project=nstc',
-      'bh writing generate --project=nstc --ids=1,2,3',
-    ],
-  },
-  dag: {
-    name: 'dag',
-    description: 'DAG 依賴追蹤管理',
-    requires_sqlite: false,
-    subcommands: {
-      init: '初始化 DAG 狀態',
-      status: '顯示整體 DAG 進度摘要',
-      ready: '列出目前可執行的任務',
-      list: '列出所有任務及其狀態',
-    },
-    options: {
-      '--project=<名稱>': { type: 'string', default: 'nstc', description: '專案名稱' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-    },
-    examples: [
-      'bh dag init --project=nstc',
-      'bh dag status --project=nstc',
-      'bh dag ready --format=json --project=nstc',
-    ],
-  },
-  search: {
-    name: 'search',
-    description: 'FTS5 trigram 全文檢索',
-    requires_sqlite: true,
-    subcommands: { query: '搜尋關鍵字' },
-    options: {
-      '--project=<名稱>': { type: 'string', default: 'nstc', description: '專案名稱' },
-      '--db=<DB路徑>': { type: 'string', description: 'SQLite 資料庫路徑' },
-      '--limit=N': { type: 'integer', description: '限制結果數量' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-    },
-    examples: ['bh search query "研究計畫" --project=nstc'],
-  },
-  db: {
-    name: 'db',
-    description: 'SQLite 資料庫管理',
-    requires_sqlite: true,
-    subcommands: {
-      stats: '顯示 DB 統計',
-      docs: '列出所有文件 metadata',
-      'pages <doc_id>': '列出指定文件的所有頁面',
-    },
-    options: {
-      '--project=<名稱>': { type: 'string', default: 'nstc', description: '專案名稱' },
-      '--db=<DB路徑>': { type: 'string', description: 'SQLite 路徑' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-    },
-    examples: ['bh db stats --project=nstc', 'bh db docs --format=json --project=nstc'],
-  },
-  gemini: {
-    name: 'gemini',
-    description: 'Gemini 3 Flash Preview AI 提問（thinking + grounding + url context）',
-    requires_sqlite: false,
-    subcommands: { ask: '向 Gemini 提問（預設啟用深度思考、搜尋接地、URL 擷取）' },
-    options: {
-      '--project=<名稱>': { type: 'string', default: 'nstc', description: '專案名稱' },
-      '--provider=<名稱>': { type: 'string', default: 'auto', description: 'LLM provider (auto|gemini|gemini-api)' },
-      '--thinking=<等級>': { type: 'string', default: 'MEDIUM', description: '思考等級 (NONE|MINIMAL|LOW|MEDIUM|HIGH)' },
-      '--system-prompt=<文字>': { type: 'string', default: '', description: '系統提示詞' },
-      '--no-grounding': { type: 'boolean', default: false, description: '停用 Google Search 接地' },
-      '--no-url-context': { type: 'boolean', default: false, description: '停用 URL 內容擷取' },
-      '--no-stream': { type: 'boolean', default: false, description: '停用串流（等待完整回應）' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-    },
-    examples: [
-      'bh gemini ask "量子糾纏的原理是什麼？"',
-      'bh gemini ask "2026 台灣經濟預測" --format=json',
-      'echo "解釋 AI" | bh gemini ask',
-    ],
-  },
-  nchc: {
-    name: 'nchc',
-    description: '國網 GenAI AI 提問（Mistral 系列，OpenAI 相容介面）',
-    requires_sqlite: false,
-    subcommands: {
-      ask: '向國網 GenAI 提問（支援串流輸出）',
-      agent: '啟動 Agentic AI 代理（工具呼叫、多輪對話）',
-      code: '啟動 Agentic Coding 代理（@opencode-ai/sdk + 675B，需 opencode CLI）',
-      models: '列出可用模型',
-    },
-    options: {
-      '--model=<名稱>': { type: 'string', default: 'Mistral-Large-3-675B-Instruct-2512', description: '模型名稱' },
-      '--system-prompt=<文字>': { type: 'string', default: '', description: '系統提示詞' },
-      '--max-tokens=N': { type: 'integer', default: 8192, description: '最大輸出 tokens' },
-      '--temperature=N': { type: 'number', default: 0.7, description: '溫度（0.0~1.0）' },
-      '--no-stream': { type: 'boolean', default: false, description: '停用串流' },
-      '--max-turns=N': { type: 'integer', default: 20, description: '[agent] 最大迴圈次數' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-    },
-    examples: [
-      'bh nchc ask "台灣半導體產業分析"',
-      'bh nchc agent "列出 lib/ 目錄下所有 .mjs 檔案並說明架構"',
-      'bh nchc models',
-    ],
-  },
-  openrouter: {
-    name: 'openrouter',
-    description: 'OpenRouter AI 提問（400+ 模型，支援網路搜尋）',
-    requires_sqlite: false,
-    subcommands: {
-      ask: '向 OpenRouter 任意模型提問（支援串流 + 網路搜尋）',
-      models: '列出常用模型（含網路搜尋支援說明）',
-    },
-    options: {
-      '--model=<名稱>': { type: 'string', default: 'openai/gpt-4o-mini', description: '模型名稱（任意 OpenRouter 模型 ID，可加 :online 後綴）' },
-      '--web-search': { type: 'boolean', default: false, description: '啟用網路搜尋（plugins: web，適用所有模型）' },
-      '--max-results=N': { type: 'integer', default: 5, description: '搜尋最大結果數（--web-search 時有效）' },
-      '--system-prompt=<文字>': { type: 'string', default: '', description: '系統提示詞' },
-      '--max-tokens=N': { type: 'integer', default: 8192, description: '最大輸出 tokens' },
-      '--temperature=N': { type: 'number', default: 0.7, description: '溫度（0.0~2.0）' },
-      '--no-stream': { type: 'boolean', default: false, description: '停用串流（等待完整回應）' },
-      '--quiet': { type: 'boolean', default: false, description: '靜默模式（不輸出進度到 stderr，GNU parallel 友善）' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式（json 含 sources、usage、perf，適合 Agentic AI）' },
-    },
-    examples: [
-      'bh openrouter ask "台灣今日重要新聞" --web-search',
-      'bh openrouter ask "分析 React vs Vue" --model=anthropic/claude-sonnet-4-6',
-      'bh openrouter ask "最新 AI 研究" --model=perplexity/sonar-pro --format=json',
-      'echo "解釋量子糾纏" | bh openrouter ask --model=openai/gpt-4o',
-      'bh openrouter ask "整理今天新聞" --web-search --quiet --format=json | jq .text',
-      'bh openrouter models',
-    ],
-  },
-  legal: {
-    name: 'legal',
-    description: '法律查詢（AI Router + 兩步驟提示工程 + SQLite 快取）[需 --experimental-sqlite]',
-    requires_sqlite: true,
-    subcommands: {
-      ask: '法律問題查詢（Mistral 14B 路由 → 快取命中或 Gemini Pro 搜尋法規 → 法律分析）',
-      cache: '快取管理（list: 列出快取, stats: 統計）',
-    },
-    options: {
-      '--project=<名稱>': { type: 'string', default: 'legal-cache', description: '專案名稱（決定 SQLite 路徑）' },
-      '--skip-cache': { type: 'boolean', default: false, description: '強制跳過快取，直接呼叫大模型' },
-      '--skip-save': { type: 'boolean', default: false, description: '不將結果存入快取' },
-      '--limit=N': { type: 'integer', default: 20, description: '[cache list] 顯示筆數上限' },
-      '--quiet': { type: 'boolean', default: false, description: '靜默模式（不輸出進度到 stderr）' },
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-    },
-    examples: [
-      'node --experimental-sqlite bin/bh.mjs legal ask "房東可以隨意趕走我嗎？"',
-      'node --experimental-sqlite bin/bh.mjs legal ask "勞工被無故解雇有哪些保護？" --format=json',
-      'echo "我的房東說要漲租金，我有辦法拒絕嗎？" | node --experimental-sqlite bin/bh.mjs legal ask',
-      'node --experimental-sqlite bin/bh.mjs legal cache list --project=legal-cache',
-      'node --experimental-sqlite bin/bh.mjs legal cache stats',
-      'node --experimental-sqlite bin/bh.mjs legal ask "問題" --skip-cache --project=legal-cache',
-    ],
-  },
-  skill: {
-    name: 'skill',
-    description: '技能管理（無參數=全列出，帶關鍵字=模糊搜尋）— 零框架技能系列',
-    requires_sqlite: false,
-    subcommands: {
-      '(無)': '列出所有技能（依系列分組）',
-      '<關鍵字>': '模糊搜尋技能（加權全文比對）',
-      list: '列出所有技能（同無參數）',
-      show: '顯示指定技能全文（支援智慧 fallback 搜尋）',
-      search: '模糊搜尋技能（同 <關鍵字>）',
-    },
-    options: {
-      '--format=json|text': { type: 'string', default: 'text', description: '輸出格式' },
-      '--quiet': { type: 'boolean', default: false, description: '靜默模式' },
-    },
-    examples: [
-      'bh skill                         # 列出全部技能',
-      'bh skill 零幻覺                   # 模糊搜尋「零幻覺」',
-      'bh skill show botrun-horse-coding',
-      'bh skill show botrun-horse-coding | pbcopy',
-      'bh skill show botrun-horse-coding --format=json',
-      'bh skill search 換位思考',
-      'bh skill show 切片               # 智慧 fallback：slug 不存在 → 自動搜尋',
-    ],
-  },
-  portal: {
-    name: 'portal',
-    description: '智慧入口（預留）',
-    requires_sqlite: false,
-    subcommands: { status: '顯示入口狀態' },
-    options: {},
-    examples: ['bh portal status'],
-  },
-  ocr: {
-    name: 'ocr',
-    description: 'OCR 辨識（預留）',
-    requires_sqlite: false,
-    subcommands: { scan: '掃描文件' },
-    options: {},
-    examples: ['bh ocr scan file.pdf'],
-  },
-  commands: {
-    name: 'commands',
-    description: '列出所有指令的結構化 schema（AI/LLM 友善）',
-    requires_sqlite: false,
-    options: {
-      '--format=json|text': { type: 'string', default: 'json', description: '輸出格式' },
-    },
-    examples: ['bh commands', "bh commands --format=json | jq 'keys'"],
-  },
-};

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

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

@@ -1,206 +0,0 @@
-#!/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();