chore: clean up redundant files and add project dependencies

Removed files:
- README-HF.md: Redundant HF Spaces documentation (info in CLAUDE.md)
- UI_IMPROVEMENTS.md: Superseded by UX_IMPROVEMENTS_V2.md

Added files:
- .env.example: Environment variable template for developers
- .python-version: Python version specification for pyenv
- uv.lock: UV dependency lock file for reproducible builds

This cleanup removes duplicate documentation while preserving essential
development configuration files.

.env.example

@@ -0,0 +1,21 @@
+# 環境變數範例檔案
+# 複製此檔案為 .env 並填入實際值
+
+# 後端配置
+MODEL_PATH=/app/models/Qwen3-TTS-12Hz-1.7B-Base
+UPLOAD_DIR=/app/backend/uploads
+OUTPUT_DIR=/app/backend/outputs
+
+# CORS 允許的來源（多個用逗號分隔）
+CORS_ORIGINS=http://localhost:3000,http://localhost
+
+# 前端配置
+VITE_API_URL=http://localhost:8000
+
+# 部署配置（Render 或其他平台）
+# 如果部署到 Render，取消註解並設置正確的 URL
+# CORS_ORIGINS=https://your-frontend.onrender.com
+# VITE_API_URL=https://your-backend.onrender.com
+
+# CPU 模式（如果沒有 GPU 支援）
+USE_CPU=false

.python-version

@@ -0,0 +1 @@
+3.12

README-HF.md

@@ -1,64 +0,0 @@
----
-title: Qwen3-TTS Voice Clone
-emoji: 🎤
-colorFrom: blue
-colorTo: purple
-sdk: docker
-pinned: false
-license: apache-2.0
----
-
-# 🎤 Qwen3-TTS 語音複製
-
-基於 Qwen3-TTS-12Hz-1.7B-Base 的全功能語音複製應用。
-
-## ✨ 功能特色
-
-- 🎯 **3秒快速複製**: 僅需 3-10 秒參考音訊
-- 🌏 **多語言支持**: 中、英、日、韓等 10 種語言
-- 🎨 **高相似度**: 聲音相似度可達 95%
-- 💻 **完整 Web UI**: React 前端 + FastAPI 後端
-- 🚀 **即開即用**: 模型自動下載
-
-## 🚀 使用方法
-
-1. 上傳 3-10 秒的參考音訊（清晰人聲）
-2. 輸入參考音訊的逐字稿
-3. 輸入想要生成的目標文字
-4. 選擇語言
-5. 點擊「複製並生成」
-
-## 📊 效能說明
-
-- **CPU 模式**: 10-20 秒/次
-- **記憶體**: 約 8-12GB
-- **模型大小**: 4.3GB
-
-## 🛠️ 技術棧
-
-- **前端**: React + TypeScript + Tailwind CSS
-- **後端**: FastAPI + Python
-- **模型**: Qwen3-TTS-12Hz-1.7B-Base
-- **部署**: Docker
-
-## 📝 本地運行
-
-```bash
-# Clone 項目
-git clone https://huggingface.co/spaces/你的用戶名/qwen3-tts-clone
-cd qwen3-tts-clone
-
-# 使用 Docker
-docker build -f Dockerfile.huggingface -t qwen3-tts .
-docker run -p 7860:7860 qwen3-tts
-```
-
-訪問: http://localhost:7860
-
-## 🤝 貢獻
-
-基於 [Qwen3-TTS](https://github.com/QwenLM/Qwen3-TTS) by Alibaba Qwen Team
-
-## 📄 授權
-
-Apache 2.0 License

UI_IMPROVEMENTS.md

@@ -1,206 +0,0 @@
-# UI/UX 專業化改進總結
-
-## 改進概述
-
-根據 UI/UX Pro Max 設計系統建議，對 Qwen3-TTS 語音複製應用進行了全面的專業化改進。
-
-## 設計系統規格
-
-### 色彩配置
-- **Primary**: `#6366f1` (Indigo)
-- **Secondary**: `#312E81` (Deep Indigo)
-- **Accent**: `#F97316` (Warm Orange)
-- **Background**: `#0F0F23` (Dark Audio)
-- **Text**: `#F8FAFC` (High contrast white)
-
-### 字體
-- **主要字體**: Poppins (標題、按鈕)
-- **次要字體**: Open Sans (正文)
-- 字體配對適合現代、專業、清晰的企業風格
-
-### 設計風格
-- **Pattern**: Interactive Demo + Feature-Rich
-- **Style**: Micro-interactions (小動畫、觸覺反饋、響應式互動)
-- **Performance**: ⚡ 優秀
-- **Accessibility**: ✓ 良好
-
-## 具體改進項目
-
-### 1. 移除所有表情符號 (Emoji)
-**改進前**: ❌ ✓ 等表情符號用作狀態指示器
-**改進後**: 使用專業的 SVG 圖示 (Lucide React)
-
-**影響檔案**:
-- `frontend/src/App.tsx` (所有狀態訊息)
-
-### 2. 添加專業互動效果
-
-#### 按鈕與可點擊元素
-- ✅ 所有按鈕添加 `cursor-pointer`
-- ✅ Hover 狀態使用 `transform: scale()` 和 `box-shadow` 增強
-- ✅ 平滑過渡動畫 (`transition-all duration-200`)
-- ✅ Focus states 可見性 (鍵盤導航支援)
-
-#### 表單元素
-- ✅ Input/Textarea 添加 focus ring (`focus:ring-2 focus:ring-brand-primary/20`)
-- ✅ Hover 狀態邊框顏色變化
-- ✅ Disabled 狀態視覺反饋
-
-#### 上傳區域
-- ✅ 拖放區域 hover 效果 (背景色 + 邊框色)
-- ✅ 圖示包裹在圓形背景中提升視覺層次
-- ✅ 添加 ARIA 標籤提升無障礙性
-
-### 3. 視覺層次優化
-
-#### 區塊標題
-- **改進前**: 單色背景 + 圖示
-- **改進後**: 漸層背景 (`from-brand-primary to-brand-secondary`) + 圖示在圓形容器內
-
-#### 卡片與容器
-- 添加細微陰影 (`shadow-sm`)
-- 更清晰的間距與內距
-- 統一圓角半徑 (`rounded-lg`)
-
-### 4. 狀態反饋改進
-
-#### 狀態訊息
-- **Info**: 藍色背景 + 邊框 (`bg-brand-primary/10 border-brand-primary/30`)
-- **Success**: 綠色背景 + 邊框 (`bg-green-500/10 border-green-500/30`)
-- **Error**: 紅色背景 + 邊框 (`bg-red-500/10 border-red-500/30`)
-- 圖示與文字顏色對應狀態類型
-
-#### 上傳成功狀態
-- 添加圓形綠色背景包裹勾選圖示
-- 顯示「點擊以重新上傳」提示
-
-#### 空狀態設計
-- 生成音訊區域添加圖示圓形背景
-- 顯示「尚無生成的音訊」文字說明
-
-### 5. 微互動 (Micro-interactions)
-
-#### 動畫效果
-- Hero section badge 脈衝動畫 (`animate-pulse`)
-- 按鈕 hover 放大效果 (`scale-[1.02]`)
-- 陰影增強效果 (hover 時)
-- Loading spinner 旋轉動畫
-
-#### 過渡時間
-- 150-300ms 用於微互動 (符合 UX 最佳實踐)
-- 所有過渡使用 `ease-out` 緩動函數
-
-### 6. 無障礙性改進
-
-#### ARIA 標籤
-- ✅ 上傳區域: `aria-label="上傳參考音訊檔案"`
-- ✅ 表單元素: `aria-label` 屬性
-- ✅ 按鈕: `aria-label` 描述功能
-
-#### 鍵盤導航
-- ✅ 所有互動元素可透過 Tab 鍵導航
-- ✅ Focus ring 可見 (`focus:ring-2`)
-- ✅ Checkbox 使用語義化 `<label>` 與隱藏 `<input>`
-
-#### 語義化 HTML
-- 上傳區域使用 `role="button"` 和 `tabIndex={0}`
-- Audio 元素包含原生控制項
-
-### 7. 響應式設計
-
-#### 斷點
-- Mobile-first 設計方法
-- 測試於 375px, 768px, 1024px, 1440px
-
-#### 間距
-- 響應式內距: `px-6 md:px-12 lg:px-24`
-- 響應式字體: `text-5xl md:text-6xl`
-
-## 技術實現
-
-### 檔案修改清單
-
-1. **frontend/src/App.tsx**
-   - 移除所有 emoji
-   - 添加互動狀態與過渡動畫
-   - 改進 ARIA 標籤與無障礙性
-   - 優化視覺層次
-
-2. **frontend/tailwind.config.js**
-   - 更新色彩配置 (符合設計系統)
-   - 添加 Poppins 與 Open Sans 字體
-   - 添加 brand.accent 色彩
-
-3. **frontend/index.html**
-   - 更新 Google Fonts 引用
-   - 添加 Poppins 與 Open Sans 字體載入
-
-## 效能優化
-
-### CSS 優化
-- 使用 `transform` 和 `opacity` 進行動畫 (GPU 加速)
-- 避免使用 `width/height/top/left` 動畫
-- 過渡時間控制在 150-300ms
-
-### 字體載入
-- 使用 `preconnect` 加速 Google Fonts
-- `display=swap` 避免字體載入閃爍
-
-## 前後對比
-
-### 改進前問題
-❌ 使用 emoji (❌ ✓) 作為 UI 元素 - 不專業
-❌ 缺少互動反饋 (hover, focus states)
-❌ 視覺層次不明確
-❌ 缺少無障礙性支援
-❌ 狀態訊息設計簡陋
-
-### 改進後優勢
-✅ 專業的 SVG 圖示系統
-✅ 完整的互動反饋與微動畫
-✅ 清晰的視覺層次與色彩系統
-✅ 完整的 ARIA 標籤與鍵盤導航
-✅ 專業的狀態反饋設計
-
-## 設計檢查清單
-
-根據 UI/UX Pro Max 交付前檢查清單:
-
-### 視覺品質
-- [x] 無 emoji 作為圖示 (使用 SVG)
-- [x] 所有圖示來自一致的圖示集 (Lucide React)
-- [x] Hover 狀態不造成版面移位
-- [x] 使用主題色彩直接套用
-
-### 互���
-- [x] 所有可點擊元素有 `cursor-pointer`
-- [x] Hover 狀態提供清晰視覺反饋
-- [x] 過渡動畫平滑 (150-300ms)
-- [x] Focus 狀態鍵盤導航可見
-
-### 版面
-- [x] 浮動元素與邊緣有適當間距
-- [x] 無內容被固定導航列遮蔽
-- [x] 響應式於 375px, 768px, 1024px, 1440px
-- [x] 行動裝置無水平捲動
-
-### 無障礙性
-- [x] 所有圖片有 alt 文字
-- [x] 表單輸入有標籤
-- [x] 顏色非唯一指示器
-- [x] 尊重 `prefers-reduced-motion`
-
-## 建議下一步
-
-1. **性能監控**: 使用 Lighthouse 測試效能與無障礙性評分
-2. **使用者測試**: 收集實際使用者對新 UI 的反饋
-3. **暗色模式**: 目前設計已是暗色，可考慮添加亮色模式選項
-4. **國際化**: 準備多語言支援 (目前為繁體中文)
-
-## 參考資源
-
-- [UI/UX Pro Max Design System](/.claude/skills/ui-ux-pro-max/)
-- [Lucide Icons](https://lucide.dev/)
-- [Tailwind CSS Documentation](https://tailwindcss.com/)
-- [Google Fonts - Poppins](https://fonts.google.com/specimen/Poppins)
-- [Google Fonts - Open Sans](https://fonts.google.com/specimen/Open+Sans)