# ConvertX-CN Lite 版

ConvertX-CN Lite 是專為一般使用者設計的輕量版本，提供快速部署與較小的 Docker Image 體積。

---

## 📦 什麼是 Lite 版？

| 特性           | Full 版                      | Lite 版                  |
| -------------- | ---------------------------- | ------------------------ |
| **Image 大小** | 約 8-12 GB                   | 約 1.2-1.5 GB            |
| **部署時間**   | 較長（需下載大型模型）       | 快速                     |
| **記憶體需求** | 較高（AI 模型）              | 較低                     |
| **適用場景**   | 進階使用者、需要 AI/OCR/翻譯 | 一般使用者、基本轉檔需求 |

---

## ✅ Lite 版包含的功能

### 核心功能

- ✅ **多語言 UI**：完整 i18n 介面（65 種語言）
- ✅ **檔案上傳/轉檔/下載**：完整流程支援
- ✅ **轉檔進度與錯誤提示**

### 轉換引擎

| 引擎               | 功能說明           | 支援格式                                     |
| ------------------ | ------------------ | -------------------------------------------- |
| **LibreOffice**    | 文件轉檔           | DOC, DOCX, XLS, XLSX, PPT, PPTX, ODT, PDF... |
| **GraphicsMagick** | 圖片轉檔           | PNG, JPG, GIF, WEBP, BMP, TIFF...            |
| **FFmpeg**         | 影音轉檔（精簡版） | MP4, MP3, WAV, AVI, MKV, MOV...              |
| **Pandoc**         | 文件格式轉換       | Markdown, HTML, DOCX, LaTeX, EPUB...         |

### PDF 功能

| 功能             | 說明                                            |
| ---------------- | ----------------------------------------------- |
| **PDF/A 轉換**   | 使用 Ghostscript 轉換為 PDF/A-1b、PDF/A-2b      |
| **PDF 防修改**   | 使用 qpdf 設定權限保護                          |
| **PDF 數位簽章** | 使用 PFX/PKCS#12 憑證簽章（單一簽章，不含 LTV） |

---

## ❌ Lite 版未包含的功能

以下功能僅在 Full 版中提供：

| 功能類別            | 功能說明                       |
| ------------------- | ------------------------------ |
| **向量圖轉換**      | Inkscape（SVG, PDF, PNG, EPS） |
| **高效能圖片**      | VIPS（大型圖片處理）           |
| **OCR**             | Tesseract OCR 文字辨識         |
| **PDF 翻譯**        | PDFMathTranslate、BabelDOC     |
| **PDF 轉 Markdown** | MinerU 智能擷取                |
| **AI 模型**         | YOLO、VLM 等深度學習模型       |
| **電子書**          | Calibre（ePub、MOBI 轉換）     |
| **CAD/3D**          | assimp、OpenCascade            |
| **PDF/A 驗證**      | veraPDF                        |
| **長期驗證**        | LTV、OCSP、CRL、TSA            |
| **完整 TexLive**    | 進階 LaTeX 排版                |

---

## 🚀 快速開始

### Docker Run

```bash
docker run -d \
  --name convertx-cn-lite \
  --restart unless-stopped \
  -p 3000:3000 \
  -v ./data:/app/data \
  -e TZ=Asia/Taipei \
  -e JWT_SECRET=你的隨機字串至少32字元 \
  convertx/convertx-cn:latest-lite
```

### Docker Compose

```yaml
services:
  convertx:
    image: convertx/convertx-cn:latest-lite
    container_name: convertx-cn-lite
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./data:/app/data
    environment:
      - TZ=Asia/Taipei
      - JWT_SECRET=你的隨機字串至少32字元
```

```bash
docker compose up -d
```

---

## 🏷️ Image Tag 說明

| Tag                                | 說明              |
| ---------------------------------- | ----------------- |
| `convertx/convertx-cn:latest`      | Full 版最新穩定版 |
| `convertx/convertx-cn:latest-lite` | Lite 版最新穩定版 |
| `convertx/convertx-cn:0.1.15`      | Full 版指定版本   |
| `convertx/convertx-cn:0.1.15-lite` | Lite 版指定版本   |

---

## 🔧 自行擴充 Lite 版功能

如果您使用 Lite 版但需要部分進階功能，可以透過 Docker Compose 擴充。

### 方法 1：使用 Docker Compose Override

建立 `docker-compose.override.yml`：

```yaml
# docker-compose.override.yml
# 在 Lite 版基礎上擴充功能

services:
  convertx:
    # 使用自定義 Dockerfile 擴充
    build:
      context: .
      dockerfile: Dockerfile.lite.custom
```

建立 `Dockerfile.lite.custom`：

```dockerfile
# Dockerfile.lite.custom
# 基於 Lite 版擴充

FROM convertx/convertx-cn:latest-lite

# 範例：新增 Tesseract OCR
RUN apt-get update && apt-get install -y --no-install-recommends \
  tesseract-ocr \
  tesseract-ocr-eng \
  tesseract-ocr-chi-tra \
  && rm -rf /var/lib/apt/lists/*

# 範例：新增 Calibre
# RUN apt-get update && apt-get install -y --no-install-recommends \
#   calibre \
#   && rm -rf /var/lib/apt/lists/*
```

### 方法 2：直接使用 Full 版

如果需要完整功能，建議直接使用 Full 版：

```yaml
services:
  convertx:
    image: convertx/convertx-cn:latest # Full 版
```

### ⚠️ 重要提醒

- Lite 版**本身不包含** OCR、AI、翻譯等進階功能
- 自行擴充會增加 Image 大小與維護成本
- 如需完整功能，建議直接使用 Full 版

---

## 📊 Lite vs Full 功能對照表

| 功能類別  | 功能                         | Lite | Full |
| --------- | ---------------------------- | :--: | :--: |
| **UI**    | 多語言介面（65 語言）        |  ✅  |  ✅  |
| **UI**    | 深色/淺色主題                |  ✅  |  ✅  |
| **轉檔**  | 文件轉檔（LibreOffice）      |  ✅  |  ✅  |
| **轉檔**  | 圖片轉檔（GraphicsMagick）   |  ✅  |  ✅  |
| **轉檔**  | 圖片轉檔（ImageMagick）      |  ❌  |  ✅  |
| **轉檔**  | 影音轉檔（FFmpeg）           |  ✅  |  ✅  |
| **轉檔**  | 文件格式（Pandoc）           |  ✅  |  ✅  |
| **轉檔**  | 向量圖（Inkscape）           |  ❌  |  ✅  |
| **轉檔**  | 高效能圖片（VIPS）           |  ❌  |  ✅  |
| **轉檔**  | 電子書（Calibre）            |  ❌  |  ✅  |
| **轉檔**  | CAD/3D（assimp）             |  ❌  |  ✅  |
| **PDF**   | PDF/A 轉換                   |  ✅  |  ✅  |
| **PDF**   | PDF 防修改                   |  ✅  |  ✅  |
| **PDF**   | PDF 數位簽章                 |  ✅  |  ✅  |
| **PDF**   | PDF/A 驗證（veraPDF）        |  ❌  |  ✅  |
| **PDF**   | 長期驗證（LTV）              |  ❌  |  ✅  |
| **OCR**   | 文字辨識（Tesseract）        |  ❌  |  ✅  |
| **OCR**   | ocrmypdf                     |  ❌  |  ✅  |
| **AI**    | PDF 翻譯（PDFMathTranslate） |  ❌  |  ✅  |
| **AI**    | PDF 翻譯（BabelDOC）         |  ❌  |  ✅  |
| **AI**    | PDF 轉 Markdown（MinerU）    |  ❌  |  ✅  |
| **字型**  | 基本 CJK 字型                |  ✅  |  ✅  |
| **字型**  | 完整 Noto 字型集             |  ❌  |  ✅  |
| **LaTeX** | 基本 LaTeX                   |  ❌  |  ✅  |
| **LaTeX** | 完整 TexLive CJK             |  ❌  |  ✅  |

---

## 💡 選擇建議

### 適合使用 Lite 版的情境

- 🔹 僅需要基本的文件/圖片/影音轉檔
- 🔹 伺服器資源有限（VPS、NAS）
- 🔹 需要快速部署
- 🔹 不需要 OCR、AI、翻譯功能

### 適合使用 Full 版的情境

- 🔹 需要 OCR 文字辨識
- 🔹 需要 PDF 翻譯功能
- 🔹 需要 MinerU PDF 轉 Markdown
- 🔹 需要電子書轉換（ePub、MOBI）
- 🔹 需要 CAD/3D 檔案處理
- 🔹 需要進階 PDF/A 驗證

---

## 📝 版本更新

Lite 版與 Full 版使用相同的版本號規則，但 tag 不同：

```bash
# 更新 Lite 版
docker compose pull
docker compose up -d

# 或指定版本
docker pull convertx/convertx-cn:0.2.0-lite
```

---

## 🔗 相關連結

- [Docker Hub](https://hub.docker.com/r/convertx/convertx-cn)
- [GitHub Repository](https://github.com/pi-docket/ConvertX-CN)
- [Full 版部署指南](Docker.md)
- [環境變數說明](../配置設定/環境變數.md)