新增錯誤排查與支援文件，提供常見問題解決方案；新增開發與貢獻指南，說明專案結構與開發流程；新增授權說明文件，詳述AGPL-3.0授權條款及第三方元件使用情況。

2026-01-25 16:09:58 +08:00 · 2026-01-25 16:09:58 +08:00 · caecb2e001
commit caecb2e001
parent 11d751250b
13 changed files with 3269 additions and 369 deletions
--- a/docs/04-功能總覽.md
+++ b/docs/04-功能總覽.md
@ -0,0 +1,370 @@
+# 功能總覽
+
+ConvertX-CN 內建 25+ 種轉換引擎，支援 1000+ 種檔案格式轉換。
+
+---
+
+## 目錄
+
+- [轉換引擎總覽](#轉換引擎總覽)
+- [影音轉換](#影音轉換)
+- [圖片處理](#圖片處理)
+- [文件轉換](#文件轉換)
+- [PDF 進階處理](#pdf-進階處理)
+- [OCR 文字辨識](#ocr-文字辨識)
+- [電子書轉換](#電子書轉換)
+- [其他轉換器](#其他轉換器)
+
+---
+
+## 轉換引擎總覽
+
+| 轉換器 | 用途 | 輸入格式數 | 輸出格式數 |
+|--------|------|-----------|-----------|
+| FFmpeg | 影音 | 472 | 199 |
+| ImageMagick | 圖片 | 253 | 183 |
+| GraphicsMagick | 圖片 | 167 | 130 |
+| Vips | 高效圖片處理 | 45 | 23 |
+| LibreOffice | 文件 | 41 | 22 |
+| Pandoc | 文件 | 43 | 65 |
+| Calibre | 電子書 | 31 | 21 |
+| Inkscape | 向量圖形 | 7 | 17 |
+| PDFMathTranslate | PDF 翻譯 | 1 | 15 |
+| BabelDOC | PDF 翻譯/轉換 | 1 | 45 |
+| MinerU | PDF → MD | 7 | 2 |
+| OCRmyPDF | PDF OCR | 1 | 8 |
+| Assimp | 3D 模型 | 77 | 23 |
+
+---
+
+## 影音轉換
+
+### FFmpeg
+
+最強大的影音轉換工具，支援幾乎所有影音格式。
+
+**支援格式**：
+
+| 類型 | 輸入 | 輸出 |
+|------|------|------|
+| 影片 | MP4, MKV, AVI, MOV, WebM, FLV 等 65+ | MP4, MKV, WebM, AVI 等 50+ |
+| 音訊 | MP3, FLAC, WAV, AAC, OGG 等 120+ | MP3, FLAC, WAV, AAC 等 85+ |
+| 字幕 | SRT, ASS, VTT 等 25+ | SRT, ASS, VTT 等 12+ |
+
+**使用範例**：
+
+```
+輸入：video.mov (500 MB)
+輸出：video.mp4 (200 MB, H.264 編碼)
+```
+
+```
+輸入：audio.flac (50 MB)
+輸出：audio.mp3 (8 MB, 320kbps)
+```
+
+**GPU 加速設定**：
+
+```yaml
+environment:
+  - FFMPEG_ARGS=-hwaccel cuda
+  - FFMPEG_OUTPUT_ARGS=-c:v h264_nvenc
+```
+
+---
+
+## 圖片處理
+
+### ImageMagick
+
+通用圖片處理工具，支援 250+ 種格式。
+
+**支援格式**：
+
+| 類型 | 格式範例 |
+|------|---------|
+| 常見格式 | PNG, JPEG, GIF, WebP, AVIF, HEIC |
+| RAW 相機 | CR2, CR3, NEF, ARW, DNG |
+| 向量/文件 | PDF, PSD, AI, EPS, SVG |
+| 科學格式 | FITS, EXR, DPX |
+
+**使用範例**：
+
+```
+輸入：photo.heic (iPhone 照片)
+輸出：photo.jpg (JPEG 格式，相容性更好)
+```
+
+```
+輸入：screenshot.png (4 MB)
+輸出：screenshot.webp (800 KB, 壓縮率更高)
+```
+
+### Vips
+
+高效能圖片處理工具，適合大圖處理。
+
+**特點**：
+- 記憶體使用效率高
+- 處理速度快
+- 適合批次處理
+
+---
+
+## 文件轉換
+
+### LibreOffice
+
+Office 文件轉換引擎。
+
+**支援格式**：
+
+| 輸入 | 輸出 |
+|------|------|
+| DOC, DOCX, ODT | PDF, HTML, TXT |
+| XLS, XLSX, ODS | PDF, CSV, HTML |
+| PPT, PPTX, ODP | PDF, PNG, SVG |
+
+**使用範例**：
+
+```
+輸入：report.docx (Word 文件)
+輸出：report.pdf (PDF 文件，保留排版)
+```
+
+```
+輸入：data.xlsx (Excel 試算表)
+輸出：data.csv (CSV 純文字)
+```
+
+### Pandoc
+
+萬用文件轉換器，支援 Markdown、LaTeX、HTML 等。
+
+**支援格式**：
+
+| 類型 | 格式 |
+|------|------|
+| 標記語言 | Markdown, reStructuredText, AsciiDoc |
+| 網頁 | HTML, EPUB |
+| 排版 | LaTeX, PDF, DOCX |
+| 純文字 | TXT, RTF |
+
+**使用範例**：
+
+```
+輸入：README.md (Markdown)
+輸出：README.pdf (排版精美的 PDF)
+```
+
+```
+輸入：thesis.tex (LaTeX)
+輸出：thesis.docx (Word 文件)
+```
+
+---
+
+## PDF 進階處理
+
+### PDFMathTranslate
+
+翻譯 PDF 並**保留數學公式與排版**。
+
+**特點**：
+- 保留原始排版
+- 保留數學公式
+- 保留圖表位置
+- 支援多種翻譯引擎
+
+**支援語言**：
+- 英文 ↔ 中文
+- 英文 ↔ 日文
+- 其他語言組合
+
+**使用範例**：
+
+```
+輸入：paper.pdf (英文學術論文，含數學公式)
+輸出：paper_zh.pdf (中文翻譯，公式保留)
+```
+
+### BabelDOC
+
+進階 PDF 翻譯與轉換引擎。
+
+**特點**：
+- 高品質翻譯
+- 支援複雜排版
+- 多格式輸出
+
+**使用範例**：
+
+```
+輸入：manual.pdf (英文使用手冊)
+輸出：manual_translated.pdf (繁體中文版)
+```
+
+### MinerU
+
+**PDF 轉 Markdown**，智能擷取內容。
+
+**特點**：
+- 智能識別表格
+- 保留公式（轉為 LaTeX）
+- 擷取圖片
+- 保持結構層次
+
+**使用範例**：
+
+```
+輸入：textbook.pdf (教科書 PDF)
+輸出：textbook.md (Markdown 格式)
+        └── images/ (擷取的圖片)
+```
+
+輸出內容範例：
+
+```markdown
+# 第一章 緒論
+
+## 1.1 背景
+
+根據研究顯示...
+
+| 項目 | 數值 | 說明 |
+|------|------|------|
+| A    | 100  | 描述 |
+| B    | 200  | 描述 |
+
+公式如下：
+
+$$E = mc^2$$
+```
+
+---
+
+## OCR 文字辨識
+
+### OCRmyPDF
+
+為 PDF 添加 OCR 文字層，讓掃描 PDF 可搜尋。
+
+**特點**：
+- 保留原始 PDF 外觀
+- 添加隱藏文字層
+- 支援多語言辨識
+
+**支援語言（一般版）**：
+
+| 語言 | 代碼 |
+|------|------|
+| 繁體中文 | `chi_tra` |
+| 簡體中文 | `chi_sim` |
+| 英文 | `eng` |
+| 日文 | `jpn` |
+| 韓文 | `kor` |
+| 法文 | `fra` |
+| 德文 | `deu` |
+
+**Full 版支援 65 種語言**。
+
+**使用範例**：
+
+```
+輸入：scan.pdf (掃描版 PDF，無法選取文字)
+輸出：scan_ocr.pdf (可搜尋、可複製的 PDF)
+```
+
+---
+
+## 電子書轉換
+
+### Calibre
+
+電子書格式轉換器。
+
+**支援格式**：
+
+| 輸入 | 輸出 |
+|------|------|
+| EPUB, MOBI, AZW3 | EPUB, MOBI, PDF |
+| PDF, TXT, HTML | AZW3, DOCX, TXT |
+| CBZ, CBR (漫畫) | PDF, EPUB |
+
+**使用範例**：
+
+```
+輸入：book.epub (EPUB 電子書)
+輸出：book.mobi (Kindle 格式)
+```
+
+```
+輸入：comic.cbz (漫畫壓縮檔)
+輸出：comic.pdf (PDF 格式)
+```
+
+---
+
+## 其他轉換器
+
+### Inkscape
+
+向量圖形編輯與轉換。
+
+| 輸入 | 輸出 |
+|------|------|
+| SVG, AI, EPS | PNG, PDF, EPS |
+| PDF | SVG |
+
+### Assimp
+
+3D 模型格式轉換。
+
+| 輸入 | 輸出 |
+|------|------|
+| FBX, OBJ, GLTF | OBJ, STL, GLTF |
+| 3DS, DAE | FBX, PLY |
+
+### Potrace / VTracer
+
+點陣圖轉向量圖。
+
+```
+輸入：logo.png (點陣圖)
+輸出：logo.svg (向量圖，可無限放大)
+```
+
+### Dasel
+
+資料檔案格式轉換。
+
+| 輸入/輸出 |
+|-----------|
+| JSON, YAML, TOML, XML, CSV |
+
+```
+輸入：config.yaml
+輸出：config.json
+```
+
+---
+
+## 功能比較表
+
+| 功能 | Lite 版 | 一般版 | Full 版 |
+|------|---------|--------|---------|
+| FFmpeg 影音 | ✅ | ✅ | ✅ |
+| ImageMagick 圖片 | ✅ | ✅ | ✅ |
+| LibreOffice 文件 | ✅ | ✅ | ✅ |
+| Pandoc 文件 | ✅ | ✅ | ✅ |
+| Calibre 電子書 | ✅ | ✅ | ✅ |
+| OCRmyPDF (7語言) | ❌ | ✅ | ✅ |
+| OCRmyPDF (65語言) | ❌ | ❌ | ✅ |
+| PDFMathTranslate | ❌ | ✅ | ✅ |
+| BabelDOC | ❌ | ✅ | ✅ |
+| MinerU | ❌ | ✅ | ✅ |
+| 完整 TexLive | ❌ | ❌ | ✅ |
+
+---
+
+[⬆️ 回到頂部](#功能總覽) | [📚 回到目錄](00-專案總覽.md)