Elijah/convertor
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
convertor/docs/00-專案總覽.md
Your Name 394dcbec1a Refactor documentation for improved clarity and consistency 
- 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.
2026-01-25 16:10:07 +08:00

7.3 KiB
Raw Blame History

專案總覽

ConvertX-CN 是一個開箱即用的全功能檔案轉換服務，基於 C4illin/ConvertX 衍生開發，專注於中文使用者體驗優化與進階 PDF 處理能力。

目錄

專案定位與目標

🎯 核心目標

  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-快速開始 5 分鐘內完成部署
02-部署指南 詳細部署設定
03-環境變數與設定 所有可用設定
04-功能總覽 轉換功能詳細說明
05-API文件 REST & GraphQL API
06-錯誤排查與支援 常見問題解決
07-開發與貢獻指南 開發者指南
08-授權說明 AGPL-3.0 授權

⬆️ 回到頂部