改用 Docker SDK 部署，繞開 HF 免費層級 Gradio SDK 強制 ZeroGPU 的限制

HF 目前的平台政策：免費層級的 Gradio SDK Space 一律跑 ZeroGPU，啟動時
要求偵測到 @spaces.GPU 標記的函式；本專案是純 CPU 應用（scikit-learn／
scipy／matplotlib），沒有這類函式，導致 Gradio SDK 直接啟動失敗
（runtime error: No @spaces.GPU function detected during startup）。

- 新增 Dockerfile：python:3.11-slim 基底，安裝 fonts-noto-cjk（matplotlib
圖表標題與座標軸多為中文，容器內建 Linux 沒有中文字型會變方框；
app_agent.py 的 _find_cjk_font() 候選清單本來就含 Noto Sans CJK
TC／SC，裝了字型套件即可直接吃到，不用改程式碼），pip 安裝
requirements.txt 內容，EXPOSE 7860，CMD 執行 app.py
- 新增 .dockerignore，排除 sessions/、.env、.git 等不該進映像檔的內容
- README.md frontmatter 的 sdk 從 gradio 改成 docker，移除 Docker SDK
用不到的 sdk_version／app_file，改加 app_port: 7860 對應
Dockerfile 的 EXPOSE

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

.dockerignore

@@ -0,0 +1,16 @@
+# 建置映像檔時不需要進容器的東西（跟 .gitignore 邏輯一致，這裡是防呆：
+# 就算有人直接對整個工作目錄 docker build，也不會把執行期產生的資料、
+# 本機密鑰或開發用檔案打進映像檔）
+sessions/
+.git/
+.env
+__pycache__/
+*.pyc
+.venv/
+.gradio/
+.vscode/
+.idea/
+.claude/
+_dev_launch.py
+系統方法論述.md
+系統方法論述.docx

Dockerfile

@@ -0,0 +1,39 @@
+# Hugging Face Space（Docker SDK）用的容器設定。
+#
+# 為什麼不用 Gradio SDK：HF 免費層級的 Gradio SDK Space 現在預設跑在
+# ZeroGPU 上（HF 平台政策），啟動時要求偵測到 @spaces.GPU 標記的函式，
+# 本專案是純 CPU 應用（scikit-learn／scipy／matplotlib，完全不用 GPU），
+# 沒有這種函式，Gradio SDK 會直接啟動失敗。改用 Docker SDK：由這份
+# Dockerfile 自己控制執行環境，不吃 Gradio SDK 的 ZeroGPU 預設規則，
+# 一樣可以跑在免費的 CPU 硬體上。
+
+FROM python:3.11-slim
+
+# fonts-noto-cjk：matplotlib 圖表（特徵重要性、分群圖等）標題與座標軸
+# 都是中文，容器內建的 Linux 沒有任何中文字型，沒裝的話中文會變成方框。
+# app_agent.py 的 _find_cjk_font() 本來就把 "Noto Sans CJK TC"／
+# "Noto Sans CJK SC" 排在候選字型清單裡（原本是留給 Linux 部署用的），
+# 裝了這個套件就能直接吃到，不用改程式碼。
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    fonts-noto-cjk \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+# 先只複製 requirements 檔案再裝套件，Docker layer cache 才會生效——
+# 之後只改程式碼、沒改依賴套件時，重新建置不用重跑 pip install。
+COPY requirements.txt .
+RUN pip install --no-cache-dir --upgrade pip \
+    && pip install --no-cache-dir -r requirements.txt \
+    && pip install --no-cache-dir python-dotenv
+
+COPY . .
+
+# HF Docker Space 的容器以非 root、UID 1000 執行；sessions/ 是執行期才會
+# 建立與寫入的資料夾（session 上傳檔、分析產出），這裡先建好並開放寫入
+# 權限，避免執行期因權限不足寫入失敗。
+RUN mkdir -p sessions && chmod -R 777 sessions
+
+EXPOSE 7860
+
+CMD ["python", "app.py"]

README.md

@@ -3,13 +3,23 @@ title: 譯彩紛呈：重譯文本分析系統 TransPrism II
 emoji: "\U0001F308"
 colorFrom: blue
 colorTo: indigo
-sdk: gradio
-sdk_version: 6.2.0
-app_file: app.py
+sdk: docker
+app_port: 7860
 pinned: false
 license: mit
 ---
 
+<!--
+  2026-08-22：sdk 從 gradio 改成 docker。原因：HF 免費層級的 Gradio SDK
+  Space 現在強制跑 ZeroGPU（平台政策，見 Space 建立畫面的提示：「On the
+  free tier, Gradio Spaces run on ZeroGPU. Subscribe to PRO for unlocking
+  free cpu-basic flavor」），啟動時要求偵測到 @spaces.GPU 標記的函式，
+  本專案是純 CPU 應用，沒有這種函式會直接啟動失敗。改用 Docker SDK
+  （見專案根目錄 Dockerfile）繞開這條規則，一樣是免費 CPU 硬體。
+  sdk_version／app_file 是 Gradio SDK 專用欄位，Docker SDK 不需要，已移除；
+  改加 app_port 對應 Dockerfile 的 EXPOSE 7860。
+-->
+
 # 譯彩紛呈：重譯文本分析系統
 
 **TransPrism: An Analytical Framework for Retranslation II｜分析引擎 Spectra Engine**