feat: v0.1.9 - Setup 頁面 i18n + 語言選擇器 UI 修復 + 文件重構

 Features:
- 全頁拖曳上傳:檔案可拖曳到頁面任何位置
- Setup 頁面新增語言選擇器

🐛 Bug Fixes:
- 語言 icon 尺寸修復(h-5→h-6)
- Dropdown 背景完全不透明
- 新增 scrollbar 樣式

🌍 i18n:
- 所有 confirm/alert 訊息國際化
- Setup 頁面 i18n 完整化

📚 Documentation:
- README 精簡為開箱即用版本
- 新增 docs/deployment/, docs/config/, docs/versions/
This commit is contained in:
Your Name 2026-01-20 15:55:49 +08:00
parent a45a049fe2
commit d563682753
14 changed files with 1305 additions and 594 deletions

View file

@ -5,56 +5,42 @@
### ✨ Features
- **全頁拖曳上傳**:檔案可拖曳到頁面任何位置上傳
- 不再需要精準拖到上傳框內
- 原本的上傳框視覺效果保持不變
- 點擊上傳功能不受影響
- **Setup 頁面語言切換**:首次設定頁面新增語言選擇器
### 🐛 Bug Fixes
- **語言選擇器 UI 修復**
- 語言 icon 尺寸從 h-5 w-5 增大至 h-6 w-6與文字視覺高度一致
- Dropdown 背景改為完全不透明,提升可讀性
- 新增 scrollbar 樣式,改善滾動體驗
- 邊框顏色加深,增強視覺對比
### 🌍 i18n
- **提示訊息國際化**:所有 confirm / alert 訊息改用 i18n
- 刪除任務前的確認提示
- 刪除成功 / 失敗提示
- 錯誤訊息
- 隨語言切換即時更新顯示內容
- **Setup 頁面 i18n 完整化**:首次設定頁面所有文字皆使用 i18n key
### 📚 Documentation
- **新增版本更新教學**README 新增「如何更新 ConvertX-CN 版本」章節
- 完整的 Docker Compose 更新步驟
- 更新到指定版本的方法
- 驗證更新成功的方式
**README 重新定位為「開箱即用」**
- **README 重新定位**:從參考手冊改為「新手教學入口」
- 完整 5 步驟部署教學(從安裝 Docker 到成功使用)
- 跨平台 data 資料夾建立指令Linux / macOS / Windows
- 常見問題 FAQ登入失敗、資料遺失、被登出
- 明確說明為何範例保留完整註解(教學導向)
- 精簡至 100 行內5 分鐘完成部署
- 只保留必要參數說明
- 進階內容移至 docs 子目錄
- **Docker Compose 範例分層**
- `compose.minimal.yml` - 精簡版Docker 老手)
- `compose.production.yml` - 生產環境(含 Reverse Proxy 說明)
- `compose.reference.yml` - 完整參考(所有環境變數)
**新增文件結構**
- **新增 deployment.md**
- Reverse Proxy 設定Nginx / Traefik / Caddy
- HTTPS / Let's Encrypt 設定
- 安全性建議與防火牆設定
- 備份與還原指南
| 目錄 | 內容 |
| ------------------ | ---------------------------------- |
| `docs/deployment/` | quickstart, docker-compose, update |
| `docs/config/` | environment, security |
| `docs/versions/` | latest, pinned-version |
- **更新 environment-variables.md**
- 依重要程度分類(必填 / 建議 / 可選)
- 每個變數都有詳細設定指南
- 常見情境範例
**文件拆分原則**
### 🎯 Design Philosophy
本專案的 README 與 docker-compose.yml 定位為「教學版」:
- README 是新手的第一個成功體驗
- docker-compose.yml 寧願註解多,也不要極簡
- 強調「為什麼要這樣設」與「不這樣設會怎樣」
如需精簡版配置,請使用 `docs/docker-compose/compose.minimal.yml`
- README = 新手入口(一分鐘看懂怎麼部署)
- docs/ = 進階參考(完整設定、情境範例)
- 每個文件都有清楚的連結導航
---