Your Name 5c68308c36 feat: 擴展 i18n 支援 65 種語言 + 完整文件系統

🌐 國際化 (i18n)
- 從 5 種語言擴展到 65 種語言支援
- 新增：歐洲語系 (de, fr, es, it, pt, ru, nl, pl, tr, uk, cs, sv, da, fi, no, el, hu, ro, bg, hr, sk, sl, lt, lv, et, is, ga, cy, mt, mk, sq, ca, eu, gl, sr)
- 新增：中東語系 (ar, he, fa)
- 新增：南亞語系 (hi, bn, ta, te, mr, gu, kn, ml, ne, si)
- 新增：東南亞語系 (th, vi, id, ms, fil, my, km, lo)
- 新增：非洲語系 (af, sw, am, zu)
- 完整翻譯所有 UI 文字

📖 文件系統
- 重構 README.md 為入口型首頁
- 新增 docs/getting-started.md - 快速入門指南
- 新增 docs/docker.md - Docker 部署指南
- 新增 docs/environment-variables.md - 環境變數說明
- 新增 docs/url-id-and-storage.md - 儲存結構說明
- 新增 docs/advanced-usage.md - 進階使用指南
- 更新 docs/i18n.md - 65 種語言清單

✅ 建構驗證
- TypeScript 編譯通過
- Docker 建構通過

2026-01-20 11:30:21 +08:00

3.2 KiB

Raw Blame History

URL ID 與儲存機制

檔案儲存結構

ConvertX-CN 使用以下目錄結構儲存檔案：

/app/data/
├── convertx.db          # SQLite 資料庫
├── uploads/             # 上傳的原始檔案
│   └── {user_id}/
│       └── {job_id}/
│           ├── file1.docx
│           └── file2.pdf
└── output/              # 轉換後的檔案
    └── {user_id}/
        └── {job_id}/
            ├── file1.pdf
            └── file2.txt

Job ID 說明

每次轉換任務都會產生一個唯一的 Job ID，用於：

追蹤轉換進度
組織檔案儲存
生成下載連結

Job ID 格式

Job ID 是一個 UUID v4 格式的字串，例如：

550e8400-e29b-41d4-a716-446655440000

URL 結構

結果頁面

/results/{job_id}

例如：

http://localhost:3000/results/550e8400-e29b-41d4-a716-446655440000

下載單一檔案

/download/{user_id}/{job_id}/{filename}

下載所有檔案（Tar）

/archive/{job_id}

資料持久化

Docker Volume 映射

為了確保資料不會在容器重啟後遺失，請務必映射 /app/data 目錄：

volumes:
  - ./data:/app/data

或使用 Named Volume：

volumes:
  - convertx-data:/app/data

volumes:
  convertx-data:

自動清理

ConvertX-CN 會根據 AUTO_DELETE_EVERY_N_HOURS 設定自動清理過期檔案。

清理邏輯

系統每 N 小時執行一次清理
刪除建立時間超過 N 小時的 Job
同時刪除對應的上傳檔案和輸出檔案
資料庫記錄也會被清除

設定範例

# 每 24 小時清理一次
- AUTO_DELETE_EVERY_N_HOURS=24

# 每 1 小時清理一次（公開服務建議）
- AUTO_DELETE_EVERY_N_HOURS=1

# 停用自動清理
- AUTO_DELETE_EVERY_N_HOURS=0

資料庫

ConvertX-CN 使用 SQLite 作為資料庫，儲存於 /app/data/convertx.db。

資料表結構

users

欄位	類型	說明
id	INTEGER	使用者 ID
email	TEXT	電子郵件
password	TEXT	密碼雜湊

jobs

欄位	類型	說明
id	TEXT	Job UUID
user_id	INTEGER	使用者 ID
num_files	INTEGER	檔案數量
date_created	TEXT	建立時間

file_names

欄位	類型	說明
id	INTEGER	檔案 ID
job_id	TEXT	Job UUID
input_file_name	TEXT	原始檔名
output_file_name	TEXT	輸出檔名
status	TEXT	轉換狀態

備份與還原

備份

# 備份整個 data 目錄
tar -czvf convertx-backup-$(date +%Y%m%d).tar.gz ./data

# 僅備份資料庫
cp ./data/convertx.db ./backup-convertx-$(date +%Y%m%d).db

還原

# 還原整個 data 目錄
tar -xzvf convertx-backup-20240101.tar.gz

# 還原資料庫
cp ./backup-convertx-20240101.db ./data/convertx.db

注意事項

權限問題：確保 Docker 容器有權限寫入 data 目錄
磁碟空間：大量轉換可能佔用大量磁碟空間，建議設定自動清理
資料安全：敏感文件轉換後建議手動刪除或縮短保留時間

3.2 KiB Raw Blame History Unescape Escape