feat: 新增 Lite 版 v0.1.15-lite

- Dockerfile.lite: 輕量版，僅保留英/簡/繁語言 - 移除 Inkscape/VIPS/ImageMagick 以減小體積 (< 1.5 GB) - docker-build-lite.yml: 自動觸發 Lite 版發布 - docker-build-remote.yml: 改進交互邏輯，支援 standard/full/lite 版本 - release.yml: 修正只觸發一般版發布
2026-01-24 15:47:04 +08:00 · 2026-01-24 15:47:04 +08:00 · 1b8cae30a0
commit 1b8cae30a0
parent 506340ecda
9 changed files with 1222 additions and 81 deletions
--- a/docs/部署指南/Docker-Lite.md
+++ b/docs/部署指南/Docker-Lite.md
@ -0,0 +1,244 @@
+# 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)
--- a/docs/部署指南/Docker.md
+++ b/docs/部署指南/Docker.md
@ -2,25 +2,47 @@

 本文件說明如何使用 Docker 部署 ConvertX-CN。

+> 💡 **Lite 版**：如果您只需要基本轉檔功能，可以使用 [Lite 版](Docker-Lite.md)，Image 體積更小、部署更快。
+
 ---

 ## Docker Image 版本

 ### 官方預建版（推薦）

-| Tag                           | 說明       |
-| ----------------------------- | ---------- |
-| `convertx/convertx-cn:latest` | 最新穩定版 |
-| `convertx/convertx-cn:v0.1.x` | 指定版本號 |
+| Tag                                | 說明                 |
+| ---------------------------------- | -------------------- |
+| `convertx/convertx-cn:latest`      | Full 版最新穩定版    |
+| `convertx/convertx-cn:latest-lite` | Lite 版最新穩定版    |
+| `convertx/convertx-cn:v0.1.x`      | Full 版指定版本號    |
+| `convertx/convertx-cn:v0.1.x-lite` | Lite 版指定版本號    |
+
+### Full 版（預設）
+
+**Image 大小：約 8-12 GB**

 **內建功能：**

 - ✅ 核心轉換工具（FFmpeg、LibreOffice、ImageMagick 等）
 - ✅ OCR 支援：英文、繁/簡中文、日文、韓文、德文、法文
+- ✅ PDF 翻譯：PDFMathTranslate、BabelDOC
+- ✅ PDF 轉 Markdown：MinerU
 - ✅ 字型：Noto CJK、Liberation、自訂中文字型
 - ✅ TexLive（支援 CJK/德/法）

-**Image 大小：約 4-6 GB**
+### Lite 版（輕量版）
+
+**Image 大小：約 1.5-2.5 GB**
+
+**內建功能：**
+
+- ✅ 核心轉換工具（FFmpeg、LibreOffice、GraphicsMagick）
+- ✅ 文件轉換（Pandoc）
+- ✅ PDF/A 轉換、PDF 防修改、PDF 數位簽章
+- ✅ 基本 CJK 字型
+- ❌ 不含 OCR、AI 翻譯、MinerU、Calibre
+
+> 📖 Lite 版詳細說明請參閱 [Lite 版部署指南](Docker-Lite.md)

 ### 完整版（自行 Build）