Your Name a06df23b1d feat: 新增 OCRmyPDF 轉換引擎 (v0.1.14)

## 新功能
- OCRmyPDF 轉換引擎：將掃描版 PDF 轉換為可搜尋 PDF
  - 支援 7 種語言：en, zh-TW, zh, ja, ko, de, fr
  - 與 PDFMathTranslate 風格一致的 UI 格式 (pdf-<lang>)
  - 自動偵測頁面方向並旋轉
  - 自動校正傾斜
  - 跳過已有文字層的頁面
  - 詳細的 5 階段處理進度輸出

## 建置
- Dockerfile：安裝 ocrmypdf 與 Tesseract OCR 語言包

## 文件
- 更新 OCR 功能文件
- 文件目錄結構改為中文名稱

## 測試
- 修復 BabelDOC 和 PDFMathTranslate 測試的 OCR mock
- 所有 345 個測試通過

2026-01-23 16:28:33 +08:00

3.2 KiB

Raw Blame History

常見問題 FAQ

⚠️ 此文件已遷移

本文件內容已整合至新的文件結構，請參閱：

❓ 常見問題 FAQ

此文件將在未來版本中移除。

🔐 登入與帳號

Q: 如何註冊帳號？

首次訪問 ConvertX-CN 時：

開啟 http://localhost:3000
點擊右上角 Register
輸入 Email 和密碼
完成！系統會自動登入

✅ 預設開放註冊，無需設定任何環境變數

Q: 可以關閉公開註冊嗎？

可以。如果您想限制只有現有用戶可使用：

environment:
  - ACCOUNT_REGISTRATION=false

⚠️ 請確保您已經有至少一個帳號，否則將無法登入

Q: 忘記密碼怎麼辦？

目前版本尚未提供密碼重設功能。您可以：

刪除 data/convertx.db
重新啟動容器
重新註冊

⚠️ 這會刪除所有用戶資料和轉換歷史

🐳 Docker 相關

Q: 為什麼 Image 這麼大（4-6 GB）？

ConvertX-CN 是「完整版」，內建：

LibreOffice（文件轉換）
TexLive（LaTeX 支援）
FFmpeg（影音轉換）
Tesseract + 多語言 OCR
CJK 字型

如果您只需要基本功能，可使用原作者的輕量版：

ghcr.io/c4illin/convertx:latest

Q: Docker 啟動失敗？

常見原因：

Port 被占用：改用其他 port，如 -p 3001:3000
磁碟空間不足：Image 需約 6GB
權限問題：確保 ./data 資料夾有寫入權限

chmod -R 777 ./data

Q: 資料存在哪裡？

所有資料存放在掛載的 /app/data 目錄：

convertx.db - SQLite 資料庫
uploads/ - 上傳的原始檔案
output/ - 轉換後的檔案

🌍 語言相關

Q: 如何切換語言？

點擊右上角語言圖示 🌐
從下拉選單選擇語言
頁面自動更新

語言偏好會儲存在 Cookie 中。

Q: 支援哪些語言？

目前支援 65 種語言，詳見 i18n.md

Q: 如何貢獻翻譯？

複製 src/locales/en.json
重命名為 xx.json（語言代碼）
翻譯所有文字
在 src/i18n/index.ts 中註冊
提交 Pull Request

📄 轉換相關

Q: 支援哪些格式？

ConvertX-CN 支援數百種格式，包括：

影音：MP4, AVI, MKV, MP3, WAV 等
圖片：PNG, JPG, WEBP, SVG, PDF 等
文件：DOCX, PDF, XLSX, PPTX 等
電子書：EPUB, MOBI, AZW3 等

完整列表見 converters.md

Q: 轉換失敗怎麼辦？

檢查檔案是否損壞
確認格式組合是否支援
查看容器 logs：
```
docker logs convertx-cn
```

Q: 檔案大小有限制嗎？

預設無硬性限制，但大檔案：

上傳需要更長時間
轉換可能耗用大量記憶體

建議為容器分配足夠的記憶體資源。

🔧 進階問題

Q: 可以使用 HTTPS 嗎？

可以。推薦使用反向代理（如 Traefik、Nginx）處理 SSL。

詳見 advanced-usage.md

Q: 如何備份資料？

# 備份
docker cp convertx-cn:/app/data ./backup

# 還原
docker cp ./backup/. convertx-cn:/app/data

Q: 有 API 文件嗎？

目前尚未提供正式的 API 文件。如有 API 需求，歡迎開 Issue 討論。

3.2 KiB Raw Blame History Unescape Escape