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: 修正只觸發一般版發布

.github/workflows/docker-build-lite.yml

@@ -0,0 +1,346 @@
+# ============================================================
+# Docker Build & Push - Lite 版（自動觸發）
+# ============================================================
+# 說明：當 Git tag 符合 vX.Y.Z-lite 格式時自動觸發 Lite 版 build
+# 範例：v0.1.15-lite, v1.0.0-lite
+# ============================================================
+
+name: Docker Build Lite (Auto Tag)
+
+on:
+  push:
+    tags:
+      - "v*.*.*-lite"
+
+env:
+  # Docker Hub 映像庫
+  DOCKER_IMAGE: convertx/convertx-cn
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  # ========================================
+  # Build job - 為每個平台建構 Docker image
+  # ========================================
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - linux/amd64
+          - linux/arm64
+
+    permissions:
+      contents: write
+      packages: write
+      attestations: write
+      id-token: write
+
+    runs-on: ${{ matrix.platform == 'linux/amd64' && 'ubuntu-24.04' || matrix.platform == 'linux/arm64' && 'ubuntu-24.04-arm' }}
+
+    name: Build Lite image for ${{ matrix.platform }}
+
+    steps:
+      - name: Prepare environment for current platform
+        id: prepare
+        run: |
+          platform=${{ matrix.platform }}
+          echo "PLATFORM_PAIR=${platform//\//-}" >> $GITHUB_ENV
+
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      # ========================================
+      # 從 tag 提取版本號
+      # ========================================
+      - name: Extract version from tag
+        id: version
+        run: |
+          # 從 tag 中提取版本號（例如 v0.1.15-lite -> 0.1.15-lite）
+          TAG="${{ github.ref_name }}"
+          VERSION="${TAG#v}"
+          echo "VERSION=${VERSION}" >> $GITHUB_OUTPUT
+          echo "TAG=${TAG}" >> $GITHUB_OUTPUT
+          echo "📦 版本: ${VERSION}"
+
+      # ========================================
+      # 清理磁碟空間
+      # ========================================
+      - name: Free disk space (aggressive)
+        run: |
+          echo "🧹 Aggressive disk cleanup for Lite builds..."
+          echo "========================================"
+          echo "📊 初始磁碟空間："
+          df -h /
+          echo "========================================"
+
+          # 移除大型預裝軟體
+          sudo rm -rf /usr/share/dotnet || true
+          sudo rm -rf /usr/local/lib/android || true
+          sudo rm -rf /opt/ghc || true
+          sudo rm -rf /opt/hostedtoolcache/CodeQL || true
+          sudo rm -rf /usr/local/share/boost || true
+          sudo rm -rf /usr/share/swift || true
+          sudo rm -rf /opt/hostedtoolcache || true
+          sudo rm -rf /usr/share/az_* || true
+          sudo rm -rf /opt/az || true
+          sudo rm -rf /usr/lib/google-cloud-sdk || true
+          sudo rm -rf /usr/local/share/powershell || true
+          sudo rm -rf /usr/share/miniconda || true
+
+          # 清理系統 cache
+          sudo apt-get clean || true
+          sudo apt-get autoremove -y || true
+          sudo rm -rf /var/lib/apt/lists/* || true
+
+          # 清理 Docker cache
+          docker system prune -af --volumes || true
+          sudo rm -rf /var/lib/docker/buildkit || true
+
+          echo "========================================"
+          echo "📊 清理後磁碟空間："
+          df -h /
+          echo "========================================"
+
+      - name: downcase REPO
+        run: |
+          echo "REPO=${GITHUB_REPOSITORY@L}" >> "${GITHUB_ENV}"
+
+      - name: Docker meta
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: |
+            ghcr.io/${{ env.REPO }}
+            ${{ env.DOCKER_IMAGE }}
+          tags: |
+            type=semver,pattern={{version}}-lite
+            type=raw,value=latest-lite,enable={{is_default_branch}}
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+        with:
+          platforms: ${{ matrix.platform }}
+          driver-opts: |
+            image=moby/buildkit:latest
+            network=host
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      # ========================================
+      # Build Lite image
+      # ========================================
+      - name: Build and push by digest
+        id: build
+        uses: docker/build-push-action@v6
+        env:
+          DOCKER_BUILDKIT: 1
+        with:
+          context: .
+          file: Dockerfile.lite
+          platforms: ${{ matrix.platform }}
+          labels: ${{ steps.meta.outputs.labels }}
+          annotations: ${{ steps.meta.outputs.annotations }}
+          outputs: type=image,name=ghcr.io/${{ env.REPO }},push-by-digest=true,name-canonical=true,oci-mediatypes=true,compression=zstd,compression-level=3
+          push: true
+          cache-from: type=registry,ref=ghcr.io/${{ env.REPO }}:buildcache-lite-${{ env.PLATFORM_PAIR }}
+          cache-to: type=registry,ref=ghcr.io/${{ env.REPO }}:buildcache-lite-${{ env.PLATFORM_PAIR }},mode=max,compression=zstd
+          build-args: |
+            BUILDKIT_INLINE_CACHE=1
+
+      - name: Export digest
+        run: |
+          mkdir -p /tmp/digests
+          digest="${{ steps.build.outputs.digest }}"
+          touch "/tmp/digests/${digest#sha256:}"
+
+      - name: Upload digest
+        uses: actions/upload-artifact@v4
+        with:
+          name: digests-lite-${{ env.PLATFORM_PAIR }}
+          path: /tmp/digests/*
+          if-no-files-found: error
+          retention-days: 1
+
+  # ========================================
+  # Merge job - 合併多架構 manifest
+  # ========================================
+  merge:
+    name: Merge Lite Docker manifests
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+      packages: write
+      attestations: write
+      id-token: write
+
+    needs:
+      - build
+
+    steps:
+      - name: Download digests
+        uses: actions/download-artifact@v4
+        with:
+          path: /tmp/digests
+          pattern: digests-lite-*
+          merge-multiple: true
+
+      - name: Extract version from tag
+        id: version
+        run: |
+          TAG="${{ github.ref_name }}"
+          VERSION="${TAG#v}"
+          echo "VERSION=${VERSION}" >> $GITHUB_OUTPUT
+          echo "TAG=${TAG}" >> $GITHUB_OUTPUT
+
+      - name: downcase REPO
+        run: |
+          echo "REPO=${GITHUB_REPOSITORY@L}" >> "${GITHUB_ENV}"
+
+      - name: Docker meta
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: |
+            ghcr.io/${{ env.REPO }}
+            ${{ env.DOCKER_IMAGE }}
+          tags: |
+            type=raw,value=${{ steps.version.outputs.VERSION }}
+            type=raw,value=latest-lite
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Get execution timestamp
+        id: timestamp
+        run: |
+          echo "timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")" >> $GITHUB_OUTPUT
+
+      - name: Create manifest list and push
+        working-directory: /tmp/digests
+        run: |
+          docker buildx imagetools create \
+            $(jq -cr '.tags | map("-t " + .) | join(" ")' <<< "$DOCKER_METADATA_OUTPUT_JSON") \
+            --annotation='index:org.opencontainers.image.description=ConvertX-CN Lite - 輕量版檔案轉換服務' \
+            --annotation='index:org.opencontainers.image.created=${{ steps.timestamp.outputs.timestamp }}' \
+            --annotation='index:org.opencontainers.image.url=${{ github.event.repository.url }}' \
+            --annotation='index:org.opencontainers.image.source=${{ github.event.repository.url }}' \
+            $(printf 'ghcr.io/${{ env.REPO }}@sha256:%s ' *)
+
+      - name: Inspect image
+        run: |
+          docker buildx imagetools inspect '${{ env.DOCKER_IMAGE }}:${{ steps.version.outputs.VERSION }}'
+
+      # ========================================
+      # 建立 GitHub Release
+      # ========================================
+      - name: Checkout for changelog
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Generate Changelog
+        id: changelog
+        run: |
+          echo "========================================"
+          echo "📝 生成 Changelog"
+          echo "========================================"
+
+          # 取得前一個 tag
+          PREVIOUS_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
+
+          if [ -z "$PREVIOUS_TAG" ]; then
+            echo "📋 無前一個 tag，取得所有 commits..."
+            CHANGELOG=$(git log --pretty=format:"- %s (%h)" HEAD)
+          else
+            echo "📋 取得 ${PREVIOUS_TAG} 到 HEAD 的 commits..."
+            CHANGELOG=$(git log --pretty=format:"- %s (%h)" ${PREVIOUS_TAG}..HEAD)
+          fi
+
+          # 建立 changelog 檔案
+          echo "## ConvertX-CN Lite 版本" > changelog.txt
+          echo "" >> changelog.txt
+          echo "這是 ConvertX-CN 的輕量版本，適合一般使用者與快速部署。" >> changelog.txt
+          echo "" >> changelog.txt
+          echo "### 變更記錄" >> changelog.txt
+          echo "" >> changelog.txt
+          echo "$CHANGELOG" >> changelog.txt
+          echo "" >> changelog.txt
+          echo "### 使用方式" >> changelog.txt
+          echo "" >> changelog.txt
+          echo "\`\`\`bash" >> changelog.txt
+          echo "docker pull ${{ env.DOCKER_IMAGE }}:${{ steps.version.outputs.VERSION }}" >> changelog.txt
+          echo "\`\`\`" >> changelog.txt
+          echo "" >> changelog.txt
+          echo "Full Changelog: https://github.com/${{ github.repository }}/compare/${PREVIOUS_TAG}...${{ steps.version.outputs.TAG }}" >> changelog.txt
+
+          echo ""
+          echo "✅ Changelog 已生成"
+          cat changelog.txt
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ steps.version.outputs.TAG }}
+          name: ${{ steps.version.outputs.TAG }} (Lite)
+          body_path: changelog.txt
+          draft: false
+          prerelease: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      # ========================================
+      # 完成摘要
+      # ========================================
+      - name: Build Summary
+        run: |
+          echo "========================================"
+          echo "✅ ConvertX-CN Lite Build 完成！"
+          echo "========================================"
+          echo ""
+          echo "🏷️ 版本: ${{ steps.version.outputs.VERSION }}"
+          echo "📦 版本類型: Lite 版（輕量版）"
+          echo ""
+          echo "📦 映像資訊："
+          echo "  - ${{ env.DOCKER_IMAGE }}:${{ steps.version.outputs.VERSION }}"
+          echo "  - ${{ env.DOCKER_IMAGE }}:latest-lite"
+          echo "  - ghcr.io/${{ env.REPO }}:${{ steps.version.outputs.VERSION }}"
+          echo ""
+          echo "🏗️ 支援的架構："
+          echo "  - linux/amd64"
+          echo "  - linux/arm64"
+          echo ""
+          echo "📝 使用方式："
+          echo "  docker pull ${{ env.DOCKER_IMAGE }}:${{ steps.version.outputs.VERSION }}"
+          echo "  docker pull ${{ env.DOCKER_IMAGE }}:latest-lite"
+          echo ""
+          echo "========================================"
+          echo "🎉 Lite 版本發布成功！"
+          echo "========================================"

.github/workflows/docker-build-remote.yml

@@ -8,14 +8,24 @@
 name: Docker Build & Push (Remote Host via Tailscale)
 
 on:
-  # 手動觸發，支援輸入 image tag
+  # 手動觸發，支援輸入 image tag 與 build target
   workflow_dispatch:
     inputs:
       image_tag:
-        description: "Docker Image Tag（例如：0.1.12.test）"
+        description: "📦 版本號（例如：0.1.15、0.1.15-lite、0.1.15.test）"
         required: true
-        default: "0.1.12.test"
+        default: ""
         type: string
+      build_target:
+        description: "🎯 Build 目標版本（auto = 自動從版本號偵測）"
+        required: true
+        default: "auto"
+        type: choice
+        options:
+          - auto
+          - standard
+          - full
+          - lite
 
 # ============================================================
 # 環境變數設定
@@ -41,6 +51,111 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
+      # ========================================
+      # Step 0: 解析版本快捷選項
+      # 說明：根據 version_preset 自動設定 IMAGE_TAG 和 BUILD_TARGET
+      # ========================================
+      - name: 🔧 解析版本設定
+        id: parse_version
+        run: |
+          echo "========================================"
+          echo "🔧 解析版本設定"
+          echo "========================================"
+          
+          INPUT_TAG="${{ github.event.inputs.image_tag }}"
+          BUILD_TARGET_INPUT="${{ github.event.inputs.build_target }}"
+          
+          echo "輸入參數："
+          echo "  image_tag: ${INPUT_TAG}"
+          echo "  build_target: ${BUILD_TARGET_INPUT}"
+          echo ""
+          
+          # 驗證版本號不為空
+          if [ -z "${INPUT_TAG}" ]; then
+            echo "❌ 錯誤：必須填寫版本號"
+            exit 1
+          fi
+          
+          # ========================================
+          # 判斷 build target（auto 時根據 tag 自動判斷）
+          # ========================================
+          if [ "${BUILD_TARGET_INPUT}" = "auto" ]; then
+            if [[ "${INPUT_TAG}" == *"-lite"* ]]; then
+              FINAL_BUILD_TARGET="lite"
+              echo "🔍 自動偵測：版本號含 '-lite'，選擇 Lite 版"
+            elif [[ "${INPUT_TAG}" == *"-full"* ]]; then
+              FINAL_BUILD_TARGET="full"
+              echo "🔍 自動偵測：版本號含 '-full'，選擇 Full 版"
+            else
+              FINAL_BUILD_TARGET="standard"
+              echo "🔍 自動偵測：標準版本號，選擇一般版"
+            fi
+          else
+            FINAL_BUILD_TARGET="${BUILD_TARGET_INPUT}"
+          fi
+          
+          # ========================================
+          # 根據 build target 決定最終 tag
+          # ========================================
+          # 移除可能的後綴以獲取基礎版本號
+          BASE_TAG="${INPUT_TAG%-lite}"
+          BASE_TAG="${BASE_TAG%-full}"
+          
+          case "${FINAL_BUILD_TARGET}" in
+            "lite")
+              FINAL_TAG="${BASE_TAG}-lite"
+              DOCKERFILE="Dockerfile.lite"
+              LATEST_TAG="latest-lite"
+              EDITION="Lite 版（輕量版）"
+              ;;
+            "full")
+              FINAL_TAG="${BASE_TAG}-full"
+              DOCKERFILE="Dockerfile.full"
+              LATEST_TAG="latest-full"
+              EDITION="Full 版（擴充版）"
+              ;;
+            *)
+              FINAL_TAG="${BASE_TAG}"
+              DOCKERFILE="Dockerfile"
+              LATEST_TAG="latest"
+              EDITION="一般版（標準版）"
+              ;;
+          esac
+          
+          # ========================================
+          # 判斷是否為正式版本（決定是否更新 latest）
+          # 正式版本格式：純數字+點號（如 0.1.15、0.1.15.1）
+          # 測試版本格式：含有 test/dev/alpha/beta 或其他非數字字元
+          # ========================================
+          if [[ "${BASE_TAG}" =~ ^[0-9]+(\.[0-9]+)+$ ]]; then
+            IS_OFFICIAL="true"
+            echo "✅ 正式版本：將同時更新 ${LATEST_TAG}"
+          else
+            IS_OFFICIAL="false"
+            echo "⚠️ 測試版本：不更新 ${LATEST_TAG}"
+          fi
+          
+          echo ""
+          echo "========================================"
+          echo "📋 最終設定："
+          echo "========================================"
+          echo "  版本號: ${FINAL_TAG}"
+          echo "  Build 目標: ${FINAL_BUILD_TARGET}"
+          echo "  Dockerfile: ${DOCKERFILE}"
+          echo "  版本類型: ${EDITION}"
+          echo "  Latest Tag: ${LATEST_TAG}"
+          echo "  正式版本: ${IS_OFFICIAL}"
+          echo "========================================"
+          
+          # 輸出到 GITHUB_OUTPUT
+          echo "image_tag=${FINAL_TAG}" >> $GITHUB_OUTPUT
+          echo "base_tag=${BASE_TAG}" >> $GITHUB_OUTPUT
+          echo "build_target=${FINAL_BUILD_TARGET}" >> $GITHUB_OUTPUT
+          echo "dockerfile=${DOCKERFILE}" >> $GITHUB_OUTPUT
+          echo "latest_tag=${LATEST_TAG}" >> $GITHUB_OUTPUT
+          echo "edition=${EDITION}" >> $GITHUB_OUTPUT
+          echo "is_official=${IS_OFFICIAL}" >> $GITHUB_OUTPUT
+
       # ========================================
       # Step 1: Checkout repository
       # 說明：檢出程式碼（雖然 build 在遠端，但需要 workflow 完整性）
@@ -300,22 +415,31 @@ jobs:
       # ========================================
       # Step 10: Multi-Arch Docker Build
       # 說明：使用 buildx 同時建構 amd64 和 arm64
+      # 支援 full/lite 版本選擇
       # ========================================
       - name: 🔨 Multi-Arch Docker Build
         run: |
           echo "========================================"
           echo "🔨 開始 Multi-Arch Docker Build"
           echo "========================================"
-          echo "版本: v${{ github.event.inputs.image_tag }}"
-          echo "映像名稱: ${{ env.DOCKER_IMAGE_REPO }}:${{ github.event.inputs.image_tag }}"
           
-          # 判斷是否為正式版本（純數字+點號，支援任意段數如 0.1.10 或 0.1.10.1）
+          # 使用 parse_version 步驟的輸出
-          IMAGE_TAG="${{ github.event.inputs.image_tag }}"
+          FINAL_TAG="${{ steps.parse_version.outputs.image_tag }}"
-          if [[ "$IMAGE_TAG" =~ ^[0-9]+(\.[0-9]+)+$ ]]; then
+          DOCKERFILE="${{ steps.parse_version.outputs.dockerfile }}"
-            echo "✅ 正式版本，將同時標記 latest"
+          LATEST_TAG="${{ steps.parse_version.outputs.latest_tag }}"
+          IS_OFFICIAL="${{ steps.parse_version.outputs.is_official }}"
+          EDITION="${{ steps.parse_version.outputs.edition }}"
+          
+          echo "🔹 Build 目標: ${EDITION}"
+          echo "🔹 使用 Dockerfile: ${DOCKERFILE}"
+          echo "🔹 版本: v${FINAL_TAG}"
+          echo "🔹 映像名稱: ${{ env.DOCKER_IMAGE_REPO }}:${FINAL_TAG}"
+          
+          if [ "${IS_OFFICIAL}" = "true" ]; then
+            echo "✅ 正式版本，將同時標記 ${LATEST_TAG}"
             ADD_LATEST="true"
           else
-            echo "⚠️ 測試版本，不標記 latest"
+            echo "⚠️ 測試版本，不標記 ${LATEST_TAG}"
             ADD_LATEST="false"
           fi
 
@@ -327,10 +451,11 @@ jobs:
 
           WORKDIR="${{ env.REMOTE_WORKDIR }}"
           PROJECT="${{ env.PROJECT_NAME }}"
-          IMAGE="${{ env.DOCKER_IMAGE_REPO }}:${{ github.event.inputs.image_tag }}"
+          IMAGE="${{ env.DOCKER_IMAGE_REPO }}:${FINAL_TAG}"
-          IMAGE_LATEST="${{ env.DOCKER_IMAGE_REPO }}:latest"
+          IMAGE_LATEST="${{ env.DOCKER_IMAGE_REPO }}:${LATEST_TAG}"
           BUILDER_NAME="multiarch-builder-${{ github.run_id }}"
           ADD_LATEST="${ADD_LATEST}"
+          DOCKERFILE="${DOCKERFILE}"
 
           echo "📂 進入專案目錄..."
           cd "\${WORKDIR}/\${PROJECT}"
@@ -339,6 +464,7 @@ jobs:
           echo ""
           echo "🔨 執行 Multi-Arch Docker buildx..."
           echo "映像標籤: \${IMAGE}"
+          echo "Dockerfile: \${DOCKERFILE}"
           echo "目標平台: linux/amd64, linux/arm64"
           echo ""
 
@@ -347,7 +473,7 @@ jobs:
 
           # 根據版本類型決定是否加入 latest tag
           if [ "\${ADD_LATEST}" = "true" ]; then
-            echo "📌 同時標記 latest"
+            echo "📌 同時標記 \${IMAGE_LATEST}"
             BUILD_TAGS="-t \${IMAGE} -t \${IMAGE_LATEST}"
           else
             echo "📌 僅標記版本號（測試版本）"
@@ -355,10 +481,11 @@ jobs:
           fi
 
           # Multi-arch build（只建構，不推送）
-          if ! docker buildx build \
+          if ! docker buildx build \\
-            --platform linux/amd64,linux/arm64 \
+            --platform linux/amd64,linux/arm64 \\
-            \${BUILD_TAGS} \
+            -f \${DOCKERFILE} \\
-            --progress=plain \
+            \${BUILD_TAGS} \\
+            --progress=plain \\
             . 2>&1; then
             
             echo ""
@@ -394,22 +521,30 @@ jobs:
       # ========================================
       # Step 11: Docker Push 到 Docker Hub
       # 說明：推送建構好的映像到 Docker Hub
+      # 支援 standard/full/lite 版本選擇
       # ========================================
       - name: 📤 Docker Push 到 Docker Hub
         run: |
           echo "========================================"
           echo "📤 推送映像到 Docker Hub"
           echo "========================================"
-          echo "版本: v${{ github.event.inputs.image_tag }}"
-          echo "映像: ${{ env.DOCKER_IMAGE_REPO }}:${{ github.event.inputs.image_tag }}"
           
-          # 判斷是否為正式版本（純數字+點號，支援任意段數如 0.1.10 或 0.1.10.1）
+          # 使用 parse_version 步驟的輸出
-          IMAGE_TAG="${{ github.event.inputs.image_tag }}"
+          FINAL_TAG="${{ steps.parse_version.outputs.image_tag }}"
-          if [[ "$IMAGE_TAG" =~ ^[0-9]+(\.[0-9]+)+$ ]]; then
+          DOCKERFILE="${{ steps.parse_version.outputs.dockerfile }}"
-            echo "✅ 正式版本，將同時推送 latest"
+          LATEST_TAG="${{ steps.parse_version.outputs.latest_tag }}"
+          IS_OFFICIAL="${{ steps.parse_version.outputs.is_official }}"
+          EDITION="${{ steps.parse_version.outputs.edition }}"
+          
+          echo "🔹 Push 目標: ${EDITION}"
+          echo "🔹 版本: v${FINAL_TAG}"
+          echo "🔹 映像: ${{ env.DOCKER_IMAGE_REPO }}:${FINAL_TAG}"
+          
+          if [ "${IS_OFFICIAL}" = "true" ]; then
+            echo "✅ 正式版本，將同時推送 ${LATEST_TAG}"
             ADD_LATEST="true"
           else
-            echo "⚠️ 測試版本，不推送 latest"
+            echo "⚠️ 測試版本，不推送 ${LATEST_TAG}"
             ADD_LATEST="false"
           fi
           echo ""
@@ -431,10 +566,11 @@ jobs:
 
           WORKDIR="${{ env.REMOTE_WORKDIR }}"
           PROJECT="${{ env.PROJECT_NAME }}"
-          IMAGE="${{ env.DOCKER_IMAGE_REPO }}:${{ github.event.inputs.image_tag }}"
+          IMAGE="${{ env.DOCKER_IMAGE_REPO }}:${FINAL_TAG}"
-          IMAGE_LATEST="${{ env.DOCKER_IMAGE_REPO }}:latest"
+          IMAGE_LATEST="${{ env.DOCKER_IMAGE_REPO }}:${LATEST_TAG}"
           BUILDER_NAME="multiarch-builder-${{ github.run_id }}"
           ADD_LATEST="${ADD_LATEST}"
+          DOCKERFILE="${DOCKERFILE}"
 
           echo "📂 進入專案目錄..."
           cd "\${WORKDIR}/\${PROJECT}"
@@ -442,6 +578,7 @@ jobs:
           echo ""
           echo "📤 執行 Docker Push..."
           echo "映像標籤: \${IMAGE}"
+          echo "Dockerfile: \${DOCKERFILE}"
 
           # 確保使用正確的 builder
           docker buildx use "\${BUILDER_NAME}"
@@ -451,7 +588,7 @@ jobs:
             echo "同時推送: \${IMAGE_LATEST}"
             BUILD_TAGS="-t \${IMAGE} -t \${IMAGE_LATEST}"
           else
-            echo "（測試版本，不推送 latest）"
+            echo "（測試版本，不推送 ${LATEST_TAG}）"
             BUILD_TAGS="-t \${IMAGE}"
           fi
           echo ""
@@ -459,6 +596,7 @@ jobs:
           # 使用 buildx build --push 來推送 multi-arch 映像
           if ! docker buildx build \
             --platform linux/amd64,linux/arm64 \
+            -f \${DOCKERFILE} \
             \${BUILD_TAGS} \
             --push \
             --progress=plain \
@@ -496,25 +634,31 @@ jobs:
       # ========================================
       # Step 13: 驗證 Docker Hub 映像
       # 說明：確認映像已成功推送並檢查架構
+      # 支援 standard/full/lite 版本
       # ========================================
       - name: ✅ 驗證 Docker Hub 映像
         run: |
           echo "========================================"
           echo "✅ 驗證 Docker Hub 映像"
           echo "========================================"
-          echo "版本: v${{ github.event.inputs.image_tag }}"
+          
-          echo "映像: ${{ env.DOCKER_IMAGE_REPO }}:${{ github.event.inputs.image_tag }}"
+          FINAL_TAG="${{ steps.parse_version.outputs.image_tag }}"
+          EDITION="${{ steps.parse_version.outputs.edition }}"
+          
+          echo "🔹 版本類型: ${EDITION}"
+          echo "🔹 版本: v${FINAL_TAG}"
+          echo "🔹 映像: ${{ env.DOCKER_IMAGE_REPO }}:${FINAL_TAG}"
           echo ""
 
-          tailscale ssh ${{ secrets.SSH_USER }}@${{ secrets.SSH_HOST }} << 'REMOTE_EOF'
+          tailscale ssh ${{ secrets.SSH_USER }}@${{ secrets.SSH_HOST }} << REMOTE_EOF
           set -e
 
-          IMAGE="${{ env.DOCKER_IMAGE_REPO }}:${{ github.event.inputs.image_tag }}"
+          IMAGE="${{ env.DOCKER_IMAGE_REPO }}:${FINAL_TAG}"
 
           echo "📋 檢查映像 manifest（顯示支援的架構）..."
           echo ""
 
-          docker buildx imagetools inspect "${IMAGE}"
+          docker buildx imagetools inspect "\${IMAGE}"
 
           echo ""
           echo "✅ 映像驗證完成"
@@ -585,6 +729,7 @@ jobs:
       # ========================================
       # Step 16: 顯示完成摘要
       # 說明：顯示本次 build 的摘要資訊
+      # 支援 standard/full/lite 版本
       # ========================================
       - name: 📋 Build 完成摘要
         run: |
@@ -592,15 +737,24 @@ jobs:
           echo "✅ Multi-Arch Docker Build & Push 完成！"
           echo "========================================"
           echo ""
-          echo "🏷️ 版本: v${{ github.event.inputs.image_tag }}"
+          
+          # 使用 parse_version 步驟的輸出
+          FINAL_TAG="${{ steps.parse_version.outputs.image_tag }}"
+          BASE_TAG="${{ steps.parse_version.outputs.base_tag }}"
+          DOCKERFILE="${{ steps.parse_version.outputs.dockerfile }}"
+          LATEST_TAG="${{ steps.parse_version.outputs.latest_tag }}"
+          IS_OFFICIAL="${{ steps.parse_version.outputs.is_official }}"
+          EDITION="${{ steps.parse_version.outputs.edition }}"
+          
+          echo "🏷️ 版本: v${FINAL_TAG}"
+          echo "📦 版本類型: ${EDITION}"
           echo ""
           echo "📦 映像資訊："
-          echo "  - 版本標籤: ${{ env.DOCKER_IMAGE_REPO }}:${{ github.event.inputs.image_tag }}"
+          echo "  - 版本標籤: ${{ env.DOCKER_IMAGE_REPO }}:${FINAL_TAG}"
 
-          # 判斷是否為正式版本（純數字+點號）
+          # 判斷是否為正式版本
-          IMAGE_TAG="${{ github.event.inputs.image_tag }}"
+          if [ "${IS_OFFICIAL}" = "true" ]; then
-          if [[ "$IMAGE_TAG" =~ ^[0-9]+(\.[0-9]+)+$ ]]; then
+            echo "  - Latest 標籤: ${{ env.DOCKER_IMAGE_REPO }}:${LATEST_TAG} ✅"
-            echo "  - Latest 標籤: ${{ env.DOCKER_IMAGE_REPO }}:latest ✅"
           else
             echo "  - Latest 標籤: （測試版本，未更新）"
           fi
@@ -615,11 +769,12 @@ jobs:
           echo "  - 遠端主機: ${{ secrets.SSH_HOST }}"
           echo "  - 工作目錄: ${{ env.REMOTE_WORKDIR }}"
           echo "  - 專案名稱: ${{ env.PROJECT_NAME }}"
+          echo "  - Dockerfile: ${DOCKERFILE}"
           echo ""
           echo "📝 使用方式："
-          echo "  docker pull ${{ env.DOCKER_IMAGE_REPO }}:${{ github.event.inputs.image_tag }}"
+          echo "  docker pull ${{ env.DOCKER_IMAGE_REPO }}:${FINAL_TAG}"
-          if [[ "$IMAGE_TAG" =~ ^[0-9]+(\.[0-9]+)+$ ]]; then
+          if [ "${IS_OFFICIAL}" = "true" ]; then
-            echo "  docker pull ${{ env.DOCKER_IMAGE_REPO }}:latest"
+            echo "  docker pull ${{ env.DOCKER_IMAGE_REPO }}:${LATEST_TAG}"
           fi
           echo ""
           echo "========================================"
@@ -631,7 +786,7 @@ jobs:
       # 說明：從 git log 生成變更記錄（與 release.yml 邏輯一致）
       # ========================================
       - name: 📝 Generate Changelog
-        if: ${{ !contains(github.event.inputs.image_tag, 'test') && !contains(github.event.inputs.image_tag, 'dev') && !contains(github.event.inputs.image_tag, 'alpha') && !contains(github.event.inputs.image_tag, 'beta') }}
+        if: ${{ !contains(steps.parse_version.outputs.image_tag, 'test') && !contains(steps.parse_version.outputs.image_tag, 'dev') && !contains(steps.parse_version.outputs.image_tag, 'alpha') && !contains(steps.parse_version.outputs.image_tag, 'beta') }}
         id: changelog
         run: |
           echo "========================================"
@@ -671,12 +826,12 @@ jobs:
       # 注意：如果 Release 已存在會失敗，使用 continue-on-error 跳過
       # ========================================
       - name: 📦 Create GitHub Release
-        if: ${{ !contains(github.event.inputs.image_tag, 'test') && !contains(github.event.inputs.image_tag, 'dev') && !contains(github.event.inputs.image_tag, 'alpha') && !contains(github.event.inputs.image_tag, 'beta') }}
+        if: ${{ !contains(steps.parse_version.outputs.image_tag, 'test') && !contains(steps.parse_version.outputs.image_tag, 'dev') && !contains(steps.parse_version.outputs.image_tag, 'alpha') && !contains(steps.parse_version.outputs.image_tag, 'beta') }}
         continue-on-error: true
         uses: softprops/action-gh-release@v2
         with:
-          tag_name: v${{ github.event.inputs.image_tag }}
+          tag_name: v${{ steps.parse_version.outputs.image_tag }}
-          name: v${{ github.event.inputs.image_tag }}
+          name: v${{ steps.parse_version.outputs.image_tag }}
           body_path: changelog.txt
           draft: false
           prerelease: false
@@ -692,13 +847,13 @@ jobs:
           echo "========================================"
           echo "🔄 更新遠端 ConvertX-CN 服務"
           echo "========================================"
-          echo "版本: v${{ github.event.inputs.image_tag }}"
+          echo "版本: v${{ steps.parse_version.outputs.image_tag }}"
           echo ""
 
           tailscale ssh ${{ secrets.SSH_USER }}@${{ secrets.SSH_HOST }} << REMOTE_EOF
           set -e
 
-          IMAGE_TAG="v${{ github.event.inputs.image_tag }}"
+          IMAGE_TAG="v${{ steps.parse_version.outputs.image_tag }}"
 
           # 1. 進入專案資料夾
           cd /home/bioailab/miniconda3/lid/app/convertx-cn

.github/workflows/release.yml

@@ -1,14 +1,16 @@
-name: Release
+name: Release (一般版)
 
 on:
   push:
     tags:
-      - "v*.*.*"
+      # 只匹配一般版 tag（不含 -lite）
+      - "v[0-9]*.[0-9]*.[0-9]*"
+      - "!v*-lite"
   # 允許手動觸發
   workflow_dispatch:
     inputs:
       tag:
-        description: "Tag to release (e.g., v0.1.13)"
+        description: "Tag to release (e.g., v0.1.15) - 一般版"
         required: true
         type: string
 

Dockerfile.full

@@ -1,11 +1,17 @@
 # ==============================================================================
 # ConvertX-CN Full 擴充版 Dockerfile
-# 版本：v0.1.6
+# 版本：v0.1.15
 # ==============================================================================
 #
-# ⚠️  重要說明：
+# 📦 Image 說明：
-#     此 Dockerfile 必須基於 ConvertX-CN 官方 Image
+#   - 基於 ConvertX-CN 官方 Image（一般版）進行擴充
-#     用途：為進階使用者提供擴充功能的範本
+#   - 適合需要更多語言 OCR 或完整 TexLive 的進階使用者
+#   - ⚠️ 體積較大（可能超過 10GB）
+#
+# 🎯 適用場景：
+#   - 需要 65 種 OCR 語言全支援
+#   - 需要完整 TexLive（特殊 LaTeX 套件）
+#   - 多語言企業環境
 #
 # 📦 使用方式：
 #   1. 確保已有 convertx/convertx-cn:latest 或自行 build
@@ -14,12 +20,12 @@
 #
 # ⚠️ 風險提示：
 #   - 每個擴充功能都會增加 Image 大小
-#   - 全部啟用可能使 Image 超過 10GB
+#   - 全部啟用可能使 Image 超過 15GB
 #   - 請依實際需求選擇性啟用
 #
 # ==============================================================================
 
-# 基於 ConvertX-CN 官方 Image
+# 基於 ConvertX-CN 官方 Image（一般版）
 FROM convertx/convertx-cn:latest
 
 # ==============================================================================
@@ -27,6 +33,7 @@ FROM convertx/convertx-cn:latest
 # ==============================================================================
 # 說明：完整 LaTeX 支援，適合需要特殊 LaTeX 套件的使用者
 # 風險：Image 體積大幅增加
+# ℹ️ 一般版已內建：texlive-base, texlive-latex-base, texlive-xetex, texlive-lang-cjk
 # ------------------------------------------------------------------------------
 # RUN apt-get update && apt-get install -y --no-install-recommends \
 #   texlive-full \
@@ -41,6 +48,7 @@ FROM convertx/convertx-cn:latest
 #   - 全部語言：約 +2GB
 #
 # 💡 建議：僅安裝實際需要的語言
+# ℹ️ 一般版已內建：eng, chi-tra, chi-sim, jpn, kor, deu, fra
 # ------------------------------------------------------------------------------
 
 # --- 歐洲語言（西歐）---
@@ -203,23 +211,15 @@ FROM convertx/convertx-cn:latest
 # ==============================================================================
 # 🔧 進階轉換工具
 # ==============================================================================
-
+# ℹ️ 一般版已內建：OpenCV, libavcodec-extra
-# --- OpenCV（電腦視覺相關轉換）---
+# 以下工具在一般版中已包含，無需額外安裝
-# 約 +200MB
+# ------------------------------------------------------------------------------
-# RUN apt-get update && apt-get install -y --no-install-recommends \
-#   python3-opencv \
-#   && apt-get clean && rm -rf /var/lib/apt/lists/*
-
-# --- 額外影片編解碼器 ---
-# 約 +50MB
-# RUN apt-get update && apt-get install -y --no-install-recommends \
-#   libavcodec-extra \
-#   && apt-get clean && rm -rf /var/lib/apt/lists/*
 
 # ==============================================================================
 # 🌐 額外 Locale 設定
 # ==============================================================================
 # 如需更多語言的 locale 支援，取消以下註解
+# ℹ️ 一般版已內建：en_US, zh_TW, zh_CN, ja_JP, ko_KR, de_DE, fr_FR
 # ------------------------------------------------------------------------------
 # RUN sed -i 's/# es_ES.UTF-8 UTF-8/es_ES.UTF-8 UTF-8/' /etc/locale.gen && \
 #   sed -i 's/# it_IT.UTF-8 UTF-8/it_IT.UTF-8 UTF-8/' /etc/locale.gen && \
@@ -234,6 +234,15 @@ FROM convertx/convertx-cn:latest
 # 📋 擴充功能總覽
 # ==============================================================================
 #
+# ℹ️ 一般版已內建功能：
+#   - 核心轉換：LibreOffice, FFmpeg, ImageMagick, Pandoc, Inkscape
+#   - OCR：Tesseract（7 種語言）
+#   - PDF 翻譯：PDFMathTranslate, BabelDOC
+#   - PDF 轉 MD：MinerU
+#   - 字型：Noto CJK, Liberation, 標楷體
+#   - TexLive：基礎 + CJK + 德法
+#   - OpenCV, libavcodec-extra
+#
 # | 功能                    | 預估大小  | 風險等級 |
 # |-------------------------|----------|----------|
 # | 完整 TexLive            | +3GB     | 高       |

Dockerfile.lite

@@ -0,0 +1,335 @@
+# ==============================================================================
+# ConvertX-CN Lite 版 Docker Image
+# 版本：v0.1.15-lite
+# ==============================================================================
+#
+# 📦 Image 說明：
+#   - ConvertX-CN 輕量版，適合一般使用者與快速部署
+#   - 體積顯著小於一般版（目標 < 1.5 GB vs 8-12 GB）
+#   - 保留日常最常用的轉檔功能，移除 AI/OCR/翻譯等進階功能
+#   - ⚠️ 無 AI 模型、無 OCR、無 PDF 翻譯功能
+#
+# 🎯 適用場景：
+#   - 個人/小型團隊的基本轉檔需求
+#   - 資源受限的環境（如 VPS、NAS、樹莓派）
+#   - 不需要 OCR/AI/翻譯功能的使用者
+#
+# ✅ Lite 版包含功能（日常最常用）：
+#   - LibreOffice（文件轉檔：DOC/DOCX/XLS/PPT → PDF）
+#   - GraphicsMagick（圖片轉檔：PNG/JPG/GIF/WEBP）
+#   - FFmpeg（影音轉檔：MP4/MP3/AVI/MKV）
+#   - Pandoc（文件格式：Markdown/HTML/DOCX）
+#   - Ghostscript + qpdf（PDF 處理）
+#   - PDF 數位簽章（PFX/PKCS#12）
+#   - 精簡版 UI（僅英文、簡體中文、繁體中文）
+#
+# ❌ Lite 版不包含：
+#   - PDFMathTranslate / BabelDOC（PDF 翻譯）
+#   - MinerU（PDF 轉 Markdown）
+#   - OCR / Tesseract
+#   - AI 模型 / VLM / YOLO
+#   - Calibre（電子書轉換）
+#   - ImageMagick / Inkscape / VIPS
+#   - CAD / 3D / assimp
+#   - TexLive（LaTeX）
+#
+# 📊 Image 大小：目標 < 1.5 GB
+#
+# ==============================================================================
+
+FROM debian:bookworm-slim AS base
+LABEL org.opencontainers.image.source="https://github.com/pi-docket/ConvertX-CN"
+LABEL org.opencontainers.image.description="ConvertX-CN Lite - 輕量版檔案轉換服務"
+LABEL org.opencontainers.image.version="lite"
+WORKDIR /app
+
+# 配置 APT 重試機制（解決 Multi-Arch Build 時的網路不穩定問題）
+RUN echo 'Acquire::Retries "5";' > /etc/apt/apt.conf.d/80-retries \
+  && echo 'Acquire::http::Timeout "120";' >> /etc/apt/apt.conf.d/80-retries \
+  && echo 'Acquire::https::Timeout "120";' >> /etc/apt/apt.conf.d/80-retries \
+  && echo 'Acquire::ftp::Timeout "120";' >> /etc/apt/apt.conf.d/80-retries \
+  && echo 'DPkg::Lock::Timeout "120";' >> /etc/apt/apt.conf.d/80-retries
+
+# install bun
+RUN apt-get update && apt-get install -y --no-install-recommends \
+  curl \
+  unzip \
+  ca-certificates \
+  && rm -rf /var/lib/apt/lists/*
+
+# if architecture is arm64, use the arm64 version of bun
+RUN ARCH=$(uname -m) && \
+  if [ "$ARCH" = "aarch64" ]; then \
+  curl -fsSL -o bun-linux-aarch64.zip https://github.com/oven-sh/bun/releases/download/bun-v1.3.6/bun-linux-aarch64.zip; \
+  else \
+  curl -fsSL -o bun-linux-x64-baseline.zip https://github.com/oven-sh/bun/releases/download/bun-v1.3.6/bun-linux-x64-baseline.zip; \
+  fi
+
+RUN unzip -j bun-linux-*.zip -d /usr/local/bin && \
+  rm bun-linux-*.zip && \
+  chmod +x /usr/local/bin/bun
+
+# install dependencies into temp directory
+# this will cache them and speed up future builds
+FROM base AS install
+RUN mkdir -p /temp/dev
+COPY package.json bun.lock /temp/dev/
+RUN cd /temp/dev && bun install --frozen-lockfile
+
+# install with --production (exclude devDependencies)
+RUN mkdir -p /temp/prod
+COPY package.json bun.lock /temp/prod/
+RUN cd /temp/prod && bun install --frozen-lockfile --production
+
+FROM base AS prerelease
+WORKDIR /app
+COPY --from=install /temp/dev/node_modules node_modules
+COPY . .
+
+# ENV NODE_ENV=production
+RUN bun run build
+
+# ==============================================================================
+# Release Stage - Lite 版本
+# ==============================================================================
+FROM base AS release
+
+# ==============================================================================
+# 依賴安裝（Lite 版 - 極簡安裝）
+# ==============================================================================
+#
+# ✅ 保留工具（日常最常用）：
+#   - LibreOffice（文件轉檔 - 最重要）
+#   - GraphicsMagick（圖片轉檔 - 輕量替代 ImageMagick）
+#   - FFmpeg（影音轉檔）
+#   - Pandoc（Markdown/HTML/DOCX 轉換）
+#   - Ghostscript + qpdf（PDF 處理）
+#   - poppler-utils（PDF 工具）
+#   - potrace（點陣圖轉向量）
+#
+# ❌ 移除工具（減少體積）：
+#   - Tesseract / OCR（約 +200MB）
+#   - Calibre（約 +500MB）
+#   - TexLive（約 +1GB）
+#   - ImageMagick（用 GraphicsMagick 替代）
+#   - Inkscape（約 +300MB）
+#   - VIPS（約 +100MB）
+#   - Python AI 套件
+#   - assimp / CAD 工具
+#
+# ==============================================================================
+
+# 配置 APT 重試機制
+RUN echo 'Acquire::Retries "5";' > /etc/apt/apt.conf.d/80-retries \
+  && echo 'Acquire::http::Timeout "120";' >> /etc/apt/apt.conf.d/80-retries \
+  && echo 'Acquire::https::Timeout "120";' >> /etc/apt/apt.conf.d/80-retries \
+  && echo 'Acquire::ftp::Timeout "120";' >> /etc/apt/apt.conf.d/80-retries \
+  && echo 'APT::Get::Assume-Yes "true";' >> /etc/apt/apt.conf.d/80-retries \
+  && echo 'DPkg::Lock::Timeout "120";' >> /etc/apt/apt.conf.d/80-retries
+
+# 階段 1：基礎系統工具
+RUN echo "" && \
+  echo "========================================" && \
+  echo "📦 階段 1/7：安裝基礎系統工具" && \
+  echo "========================================" && \
+  apt-get update --fix-missing && apt-get install -y --no-install-recommends \
+  locales \
+  ca-certificates \
+  curl \
+  openssl \
+  && rm -rf /var/lib/apt/lists/* && \
+  echo "✅ 階段 1/7 完成：基礎系統工具已安裝"
+
+# 階段 2：核心轉換工具
+RUN echo "" && \
+  echo "========================================" && \
+  echo "📦 階段 2/6：安裝核心轉換工具" && \
+  echo "========================================" && \
+  apt-get update --fix-missing && apt-get install -y --no-install-recommends \
+  ghostscript \
+  graphicsmagick \
+  poppler-utils \
+  potrace \
+  qpdf \
+  && rm -rf /var/lib/apt/lists/* && \
+  echo "✅ 階段 2/6 完成：核心轉換工具已安裝"
+
+# 階段 2.1：安裝 dasel（從 GitHub 下載二進位檔案）
+RUN echo "" && \
+  echo "   🔧 階段 2.1：安裝 dasel..." && \
+  ARCH=$(uname -m) && \
+  if [ "$ARCH" = "aarch64" ]; then \
+  DASEL_ARCH="linux_arm64"; \
+  else \
+  DASEL_ARCH="linux_amd64"; \
+  fi && \
+  curl -sSLf "https://github.com/TomWright/dasel/releases/download/v2.8.1/dasel_${DASEL_ARCH}" -o /usr/local/bin/dasel && \
+  chmod +x /usr/local/bin/dasel && \
+  echo "   ✅ dasel 安裝完成"
+
+# 階段 2.2：安裝 resvg（從 GitHub 下載二進位檔案）
+RUN echo "" && \
+  echo "   🔧 階段 2.2：安裝 resvg..." && \
+  ARCH=$(uname -m) && \
+  if [ "$ARCH" = "aarch64" ]; then \
+  echo "   ⚠️ resvg 沒有 ARM64 預編譯版本，跳過安裝"; \
+  else \
+  curl -sSLf "https://github.com/linebender/resvg/releases/download/v0.44.0/resvg-linux-x86_64.tar.gz" -o /tmp/resvg.tar.gz && \
+  tar -xzf /tmp/resvg.tar.gz -C /tmp/ && \
+  mv /tmp/resvg /usr/local/bin/resvg && \
+  chmod +x /usr/local/bin/resvg && \
+  rm -rf /tmp/resvg.tar.gz && \
+  echo "   ✅ resvg 安裝完成"; \
+  fi
+
+# 階段 3：影音處理工具（FFmpeg 精簡版）
+RUN echo "" && \
+  echo "========================================" && \
+  echo "📦 階段 3/7：安裝影音處理工具（精簡版）" && \
+  echo "========================================" && \
+  apt-get update --fix-missing && apt-get install -y --no-install-recommends \
+  ffmpeg \
+  && rm -rf /var/lib/apt/lists/* && \
+  echo "✅ 階段 3/7 完成：FFmpeg 已安裝"
+
+# 階段 4：Headless 支援（LibreOffice 需要）
+# 注意：Lite 版移除 Inkscape 和 VIPS 以減少體積
+# GraphicsMagick 已在階段 2 安裝
+RUN echo "" && \
+  echo "========================================" && \
+  echo "📦 階段 4/6：安裝 Headless 支援" && \
+  echo "========================================" && \
+  apt-get update --fix-missing && apt-get install -y --no-install-recommends \
+  xauth \
+  xvfb \
+  && rm -rf /var/lib/apt/lists/* && \
+  echo "✅ 階段 4/6 完成：Headless 支援已安裝"
+
+# 階段 5：文件處理工具（Pandoc）
+RUN echo "" && \
+  echo "========================================" && \
+  echo "📦 階段 5/6：安裝文件處理工具" && \
+  echo "========================================" && \
+  apt-get update --fix-missing && apt-get install -y --no-install-recommends \
+  libemail-outlook-message-perl \
+  pandoc \
+  && rm -rf /var/lib/apt/lists/* && \
+  echo "✅ 階段 5/6 完成：Pandoc 已安裝"
+
+# 階段 6：LibreOffice（核心文件轉檔引擎 + 基本字型）
+# 使用完整 libreoffice 以確保所有轉檔功能正常
+RUN echo "" && \
+  echo "========================================" && \
+  echo "📦 階段 6/6：安裝 LibreOffice + 字型" && \
+  echo "========================================" && \
+  apt-get update --fix-missing && apt-get install -y --no-install-recommends \
+  libreoffice \
+  fonts-noto-cjk \
+  fonts-liberation \
+  && rm -rf /var/lib/apt/lists/* && \
+  echo "✅ 階段 6/6 完成：LibreOffice + 字型已安裝"
+
+# ==============================================================================
+# ✅ APT 套件安裝完成
+# ==============================================================================
+
+# ==============================================================================
+# 🔐 PDF Packager 預設簽章憑證 + Python（合併以減少 layer）
+# ==============================================================================
+ENV PATH="/root/.local/bin:${PATH}"
+ENV PIP_NO_CACHE_DIR=1
+ENV PDF_SIGN_P12_PATH="/app/certs/default.p12"
+ENV PDF_SIGN_P12_PASSWORD=""
+ENV PDF_SIGN_REASON="ConvertX-CN Lite PDF Packager"
+ENV PDF_SIGN_LOCATION="Taiwan"
+ENV PDF_SIGN_CONTACT="convertx-cn@localhost"
+
+RUN echo "" && \
+  echo "========================================" && \
+  echo "🔐 安裝 Python + 產生簽章憑證" && \
+  echo "========================================" && \
+  apt-get update --fix-missing && apt-get install -y --no-install-recommends \
+  python3 \
+  python3-pip \
+  && rm -rf /var/lib/apt/lists/* && \
+  pip3 install --no-cache-dir --break-system-packages endesive && \
+  mkdir -p /app/certs && \
+  openssl req -x509 -newkey rsa:2048 \
+  -keyout /tmp/key.pem -out /tmp/cert.pem \
+  -days 3650 -nodes \
+  -subj "/CN=PDF Packager Default/O=ConvertX-CN Lite/C=TW" && \
+  openssl pkcs12 -export \
+  -inkey /tmp/key.pem -in /tmp/cert.pem \
+  -out /app/certs/default.p12 \
+  -passout pass: && \
+  rm -f /tmp/key.pem /tmp/cert.pem && \
+  chmod 644 /app/certs/default.p12 && \
+  echo "✅ Python + PDF 簽章已安裝"
+
+# ==============================================================================
+# 最終清理 + Locale 設定 + 自訂字型（合併以減少 layer）
+# ==============================================================================
+RUN rm -rf /usr/share/doc/* \
+  && rm -rf /usr/share/man/* \
+  && rm -rf /usr/share/info/* \
+  && sed -i 's/# en_US.UTF-8 UTF-8/en_US.UTF-8 UTF-8/' /etc/locale.gen \
+  && sed -i 's/# zh_TW.UTF-8 UTF-8/zh_TW.UTF-8 UTF-8/' /etc/locale.gen \
+  && sed -i 's/# zh_CN.UTF-8 UTF-8/zh_CN.UTF-8 UTF-8/' /etc/locale.gen \
+  && locale-gen
+
+# 安裝自訂字型（標楷體等台灣常用字型）
+RUN mkdir -p /usr/share/fonts/truetype/custom
+COPY fonts/ /usr/share/fonts/truetype/custom/
+RUN fc-cache -fv
+
+# ==============================================================================
+# Install VTracer binary（向量追蹤工具）
+# ==============================================================================
+RUN ARCH=$(uname -m) && \
+  if [ "$ARCH" = "aarch64" ]; then \
+  VTRACER_ASSET="vtracer-aarch64-unknown-linux-musl.tar.gz"; \
+  else \
+  VTRACER_ASSET="vtracer-x86_64-unknown-linux-musl.tar.gz"; \
+  fi && \
+  curl -L -o /tmp/vtracer.tar.gz "https://github.com/visioncortex/vtracer/releases/download/0.6.4/${VTRACER_ASSET}" && \
+  tar -xzf /tmp/vtracer.tar.gz -C /tmp/ && \
+  mv /tmp/vtracer /usr/local/bin/vtracer && \
+  chmod +x /usr/local/bin/vtracer && \
+  rm /tmp/vtracer.tar.gz
+
+COPY --from=install /temp/prod/node_modules node_modules
+COPY --from=prerelease /app/public/ /app/public/
+COPY --from=prerelease /app/dist /app/dist
+
+RUN mkdir data
+
+EXPOSE 3000/tcp
+
+# ==============================================================================
+# 🔧 環境變數總覽（Lite 版）
+# ==============================================================================
+
+# ------------------------------------------------------------------------------
+# 1️⃣ 系統 Locale（支援中文避免亂碼）
+# ------------------------------------------------------------------------------
+ENV LANG=zh_TW.UTF-8
+ENV LC_ALL=zh_TW.UTF-8
+
+# ------------------------------------------------------------------------------
+# 2️⃣ Headless 環境設定
+# ------------------------------------------------------------------------------
+ENV QT_QPA_PLATFORM="offscreen"
+ENV DISPLAY=":99"
+
+# ------------------------------------------------------------------------------
+# 3️⃣ 應用程式設定
+# ------------------------------------------------------------------------------
+ENV PANDOC_PDF_ENGINE=pdflatex
+ENV NODE_ENV=production
+
+# ------------------------------------------------------------------------------
+# 4️⃣ Lite 版標識
+# ------------------------------------------------------------------------------
+ENV CONVERTX_EDITION="lite"
+
+ENTRYPOINT [ "bun", "run", "dist/src/index.js" ]

README.md

@@ -149,6 +149,33 @@ docker compose up -d
 
 ---
 
+## 🎯 版本選擇：Full vs Lite
+
+ConvertX-CN 提供兩個版本，滿足不同需求：
+
+| 特性 | Full 版 | Lite 版 |
+|------|---------|---------|
+| **Image 大小** | 約 8-12 GB | 約 1.5-2.5 GB |
+| **部署速度** | 較慢 | 快速 |
+| **適用對象** | 進階使用者 | 一般使用者 |
+| **OCR/AI/翻譯** | ✅ | ❌ |
+| **基本轉檔** | ✅ | ✅ |
+
+### Lite 版快速啟動
+
+```bash
+docker run -d \
+  --name convertx-cn-lite \
+  -p 3000:3000 \
+  -v ./data:/app/data \
+  -e JWT_SECRET=你的隨機字串至少32字元 \
+  convertx/convertx-cn:latest-lite
+```
+
+> 📖 詳細說明請參閱 [Lite 版部署指南](docs/部署指南/Docker-Lite.md)
+
+---
+
 ## 📄 License Overview
 
 **This is a Mixed License / Source-Available Project.**

docs/說明文件.md

@@ -36,8 +36,9 @@
 ### 部署
 
 | 文件                                   | 說明                        |
-| ------------------------------------- | --------------------------- |
+| -------------------------------------- | --------------------------- |
-| [Docker 部署](部署指南/Docker部署.md) | Docker Run & Docker Compose |
+| [Docker 部署](部署指南/Docker.md)      | Docker Run & Docker Compose |
+| [Lite 版部署](部署指南/Docker-Lite.md) | 輕量版（較小 Image）        |
 | [反向代理](部署指南/反向代理.md)       | Nginx / Traefik / Caddy     |
 | [範例配置](範例配置/說明文件.md)       | 可直接使用的配置檔          |
 

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)

docs/部署指南/Docker.md

@@ -2,6 +2,8 @@
 
 本文件說明如何使用 Docker 部署 ConvertX-CN。
 
+> 💡 **Lite 版**：如果您只需要基本轉檔功能，可以使用 [Lite 版](Docker-Lite.md)，Image 體積更小、部署更快。
+
 ---
 
 ## Docker Image 版本
@@ -9,18 +11,38 @@
 ### 官方預建版（推薦）
 
 | Tag                                | 說明                 |
-| ----------------------------- | ---------- |
+| ---------------------------------- | -------------------- |
-| `convertx/convertx-cn:latest` | 最新穩定版 |
+| `convertx/convertx-cn:latest`      | Full 版最新穩定版    |
-| `convertx/convertx-cn:v0.1.x` | 指定版本號 |
+| `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）