394dcbec1a
- Updated tables for service ports, environment variables, HTTP status codes, and error codes to enhance readability. - Streamlined JavaScript examples for file conversion and added comments for better understanding. - Enhanced troubleshooting section with clearer formatting and additional explanations. - Improved licensing section with detailed requirements and third-party component licenses. - Organized the document structure for better navigation and accessibility.
154 lines
7.3 KiB
Markdown
154 lines
7.3 KiB
Markdown
# 專案總覽
|
||
|
||
ConvertX-CN 是一個**開箱即用的全功能檔案轉換服務**，基於 [C4illin/ConvertX](https://github.com/C4illin/ConvertX) 衍生開發，專注於**中文使用者體驗優化**與**進階 PDF 處理能力**。
|
||
|
||
---
|
||
|
||
## 目錄
|
||
|
||
- [專案定位與目標](#專案定位與目標)
|
||
- [ConvertX-CN 與原始 ConvertX 的差異](#convertx-cn-與原始-convertx-的差異)
|
||
- [支援格式總覽](#支援格式總覽)
|
||
- [版本選擇](#版本選擇)
|
||
- [相關文件](#相關文件)
|
||
|
||
---
|
||
|
||
## 專案定位與目標
|
||
|
||
### 🎯 核心目標
|
||
|
||
1. **開箱即用**：一個 Docker 命令，5 分鐘內完成部署
|
||
2. **中文優化**：內建中日韓字型與 OCR，告別亂碼問題
|
||
3. **全格式支援**：文件、圖片、影音、電子書，一站式轉換
|
||
4. **PDF 進階處理**：翻譯（保留公式）、智能擷取（保留表格、圖片）
|
||
|
||
### 🌟 專案特色
|
||
|
||
| 特色 | 說明 |
|
||
| ----------------- | --------------------------------------- |
|
||
| 📁 **1000+ 格式** | 文件、圖片、影音、電子書一次搞定 |
|
||
| 🔧 **25+ 引擎** | LibreOffice、FFmpeg、Pandoc 全到位 |
|
||
| 🈶 **中文優化** | 內建中日韓字型與 OCR，告別亂碼 |
|
||
| 🌐 **65 種語言** | 跨國團隊無障礙使用 |
|
||
| 📊 **PDF 翻譯** | PDFMathTranslate + BabelDOC 雙引擎 |
|
||
| 📄 **PDF 轉 MD** | MinerU 智能擷取（保留表格、公式、圖片） |
|
||
|
||
---
|
||
|
||
## ConvertX-CN 與原始 ConvertX 的差異
|
||
|
||
| 項目 | 原始 ConvertX | ConvertX-CN |
|
||
| --------------- | ------------- | ---------------------------------- |
|
||
| **語言支援** | 英文介面為主 | 65 種語言介面，中文優化 |
|
||
| **字型支援** | 基本字型 | 內建中日韓完整字型集 |
|
||
| **OCR 語言** | 需手動安裝 | 預裝 7 種常用語言（Full 版 65 種） |
|
||
| **PDF 翻譯** | ❌ 不支援 | ✅ PDFMathTranslate + BabelDOC |
|
||
| **PDF 轉 MD** | ❌ 不支援 | ✅ MinerU 智能擷取 |
|
||
| **BabelDOC** | ❌ 不支援 | ✅ 進階 PDF 處理 |
|
||
| **Docker 大小** | 較小 | 較大（功能更完整） |
|
||
| **維護者** | C4illin | pi-docket |
|
||
|
||
### 新增功能清單
|
||
|
||
- ✅ **PDFMathTranslate**：翻譯 PDF 並保留數學公式與排版
|
||
- ✅ **BabelDOC**：進階 PDF 翻譯與轉換
|
||
- ✅ **MinerU**：PDF 轉 Markdown（智能擷取表格、公式、圖片）
|
||
- ✅ **OCRmyPDF**：PDF OCR 文字辨識
|
||
- ✅ **完整 CJK 字型**：思源黑體、思源宋體
|
||
- ✅ **65 種介面語言**：自動偵測或手動切換
|
||
|
||
---
|
||
|
||
## 支援格式總覽
|
||
|
||
### 按類型分類
|
||
|
||
| 類型 | 轉換器 | 支援格式數 |
|
||
| --------------- | -------------------------------------------- | ---------- |
|
||
| 🎬 **影音** | FFmpeg | 400+ |
|
||
| 🖼️ **圖片** | ImageMagick, GraphicsMagick, Vips | 300+ |
|
||
| 📄 **文件** | LibreOffice, Pandoc | 160+ |
|
||
| 📚 **電子書** | Calibre | 50+ |
|
||
| ✏️ **向量圖** | Inkscape, Potrace, VTracer | 40+ |
|
||
| 📊 **PDF 處理** | PDFMathTranslate, BabelDOC, MinerU, OCRmyPDF | 30+ |
|
||
| 🎮 **3D 模型** | Assimp | 100+ |
|
||
| 📋 **資料檔案** | Dasel | 10+ |
|
||
|
||
### 完整轉換器列表
|
||
|
||
| 轉換器 | 用途 | 輸入格式 | 輸出格式 |
|
||
| ---------------- | ------------ | -------- | -------- |
|
||
| FFmpeg | 影音 | 472 | 199 |
|
||
| ImageMagick | 圖片 | 253 | 183 |
|
||
| GraphicsMagick | 圖片 | 167 | 130 |
|
||
| Vips | 高效圖片處理 | 45 | 23 |
|
||
| LibreOffice | 文件 | 41 | 22 |
|
||
| Pandoc | 文件 | 43 | 65 |
|
||
| Calibre | 電子書 | 31 | 21 |
|
||
| Inkscape | 向量圖形 | 7 | 17 |
|
||
| libjxl | JPEG XL | 11 | 11 |
|
||
| libheif | HEIF/HEIC | 11 | 3 |
|
||
| Assimp | 3D 模型 | 77 | 23 |
|
||
| Potrace | 點陣轉向量 | 4 | 11 |
|
||
| VTracer | 點陣轉向量 | 8 | 1 |
|
||
| resvg | SVG 渲染 | 1 | 1 |
|
||
| XeLaTeX | LaTeX | 2 | 1 |
|
||
| dvisvgm | 向量圖形 | 4 | 2 |
|
||
| Dasel | 資料檔案 | 5 | 4 |
|
||
| msgconvert | Outlook | 1 | 1 |
|
||
| VCF to CSV | 聯絡人 | 1 | 1 |
|
||
| Markitdown | 文件轉 MD | 6 | 1 |
|
||
| MinerU | PDF → MD | 7 | 2 |
|
||
| PDFMathTranslate | PDF 翻譯 | 1 | 15 |
|
||
| BabelDOC | PDF 翻譯 | 1 | 45 |
|
||
| OCRmyPDF | PDF OCR | 1 | 8 |
|
||
| deark | 解包/解析 | 100+ | 1 |
|
||
|
||
---
|
||
|
||
## 版本選擇
|
||
|
||
ConvertX-CN 提供三個版本，滿足不同需求：
|
||
|
||
| 特性 | Lite 版 | 一般版（推薦） | Full 版 |
|
||
| ----------------- | ---------- | -------------- | ----------- |
|
||
| **Image 大小** | ~3 GB | ~7 GB | ~15 GB |
|
||
| **部署速度** | 最快 | 中等 | 較慢 |
|
||
| **適用對象** | 輕量使用者 | 一般使用者 | 進階/多語言 |
|
||
| **基本轉檔** | ✅ | ✅ | ✅ |
|
||
| **OCR（7語言）** | ❌ | ✅ | ✅ |
|
||
| **PDF 翻譯** | ❌ | ✅ | ✅ |
|
||
| **MinerU AI** | ❌ | ✅ | ✅ |
|
||
| **OCR（65語言）** | ❌ | ❌ | ✅ |
|
||
| **完整 TexLive** | ❌ | ❌ | ✅ |
|
||
|
||
### Docker Tag 說明
|
||
|
||
| Tag | 說明 |
|
||
| ------------- | ----------------- |
|
||
| `latest` | 一般版最新穩定版 |
|
||
| `latest-lite` | Lite 版最新穩定版 |
|
||
| `latest-full` | Full 版最新穩定版 |
|
||
| `0.1.16` | 一般版指定版本 |
|
||
| `0.1.16-lite` | Lite 版指定版本 |
|
||
| `0.1.16-full` | Full 版指定版本 |
|
||
|
||
---
|
||
|
||
## 相關文件
|
||
|
||
| 文件 | 說明 |
|
||
| ----------------------------------------- | ------------------ |
|
||
| [01-快速開始](01-快速開始.md) | 5 分鐘內完成部署 |
|
||
| [02-部署指南](02-部署指南.md) | 詳細部署設定 |
|
||
| [03-環境變數與設定](03-環境變數與設定.md) | 所有可用設定 |
|
||
| [04-功能總覽](04-功能總覽.md) | 轉換功能詳細說明 |
|
||
| [05-API文件](05-API文件.md) | REST & GraphQL API |
|
||
| [06-錯誤排查與支援](06-錯誤排查與支援.md) | 常見問題解決 |
|
||
| [07-開發與貢獻指南](07-開發與貢獻指南.md) | 開發者指南 |
|
||
| [08-授權說明](08-授權說明.md) | AGPL-3.0 授權 |
|
||
|
||
---
|
||
|
||
[⬆️ 回到頂部](#專案總覽)
|