Update README.md

README.md

@@ -1,183 +1,42 @@
-# Turnstile 求解服務 - 完整方案
+---
+title: Turnstile Solver
+emoji: 🔐
+colorFrom: purple
+colorTo: blue
+sdk: docker
+app_file: app.py
+pinned: false
+---
 
-## 功能概述
+# Turnstile Solver - 驗證碼求解服務
 
-支持兩種求解方式：
+快速求解 Cloudflare Turnstile 驗證碼的服務。支持本地 Playwright 和第三方服務（2captcha、Anti-Captcha、CapSolver）。
 
-### 1. 本地 Playwright 求解
-- 使用 Playwright 自動化瀏覽器
-- 無需第三方服務
-- 適合低頻率使用
+## 功能
 
-### 2. 第三方服務求解
-支持以下服務提供商：
-- **2captcha** - 快速、便宜
-- **Anti-Captcha** - 穩定、可靠
-- **CapSolver** - 新興、高效
+- 🎨 現代化 Web UI
+- ⚡ 本地 Playwright 求解（免費）
+- 🔄 第三方服務集成（2captcha、Anti-Captcha、CapSolver）
+- 📋 完整 REST API
+- 🔐 自動複製 Token
+- 💾 本地保存設置
 
-## API 端點
-
-### 健康檢查
-```bash
-GET /health
-```
-
-### 本地求解
-```bash
-POST /solve
-Content-Type: application/json
-
-{
-  "url": "https://example.com",
-  "sitekey": "0x4AAAAAAAxxxxxx",
-  "timeout": 30000
-}
-```
-
-**響應：**
-```json
-{
-  "token": "0.xxxxx",
-  "success": true,
-  "message": "Turnstile 求解成功"
-}
-```
-
-### 第三方服務求解
-```bash
-POST /solve-external
-Content-Type: application/json
-
-{
-  "sitekey": "0x4AAAAAAAxxxxxx",
-  "pageurl": "https://example.com",
-  "provider": "2captcha",
-  "api_key": "YOUR_API_KEY",
-  "timeout": 180
-}
-```
-
-**支持的 provider：**
-- `2captcha`
-- `anti-captcha`
-- `capsolver`
-
-### 獲取服務提供商列表
-```bash
-GET /providers
-```
-
-## 部署指南
-
-### 本地測試
-
-1. 安裝依賴：
-```bash
-pip install -r requirements.txt
-```
-
-2. 安裝 Playwright 瀏覽器：
-```bash
-playwright install chromium
-```
-
-3. 運行應用：
-```bash
-python app.py
-```
-
-4. 訪問 UI：
-```
-http://localhost:7860
-```
-
-### 部署到 HuggingFace Spaces
-
-1. 創建新 Space：
-   - 訪問 https://huggingface.co/spaces
-   - 點擊 "Create new Space"
-   - 選擇 Docker SDK
-   - 填寫 Space 名稱
-
-2. 上傳文件：
-```bash
-git clone https://huggingface.co/spaces/YOUR_USERNAME/turnstile-solver
-cd turnstile-solver
-
-# 複製文件
-cp /path/to/app.py .
-cp /path/to/captcha_service.py .
-cp /path/to/requirements.txt .
-cp /path/to/Dockerfile .
-
-# 提交並推送
-git add .
-git commit -m "Initial commit"
-git push
-```
-
-3. HuggingFace 會自動構建並部署
-
-## 第三方服務配置
-
-### 2captcha
-
-1. 註冊帳戶：https://2captcha.com
-2. 獲取 API Key
-3. 充值賬戶
-4. 在 UI 中選擇 "2captcha" 並輸入 API Key
-
-**費用：** 約 $0.5-1 per 1000 captchas
-
-### Anti-Captcha
-
-1. 註冊帳戶：https://anti-captcha.com
-2. 獲取 API Key
-3. 充值賬戶
-4. 在 UI 中選擇 "anti-captcha" 並輸入 API Key
-
-**費用：** 約 $0.5-1 per 1000 captchas
-
-### CapSolver
-
-1. 註冊帳戶：https://www.capsolver.com
-2. 獲取 API Key
-3. 充值賬戶
-4. 在 UI 中選擇 "capsolver" 並輸入 API Key
-
-**費用：** 約 $0.3-0.8 per 1000 captchas
+## 快速開始
 
-## 使用示例
-
-### Python 客戶端
+### 方式 1: Web UI（推薦）
 
-```python
-import asyncio
-import aiohttp
-
-async def solve_turnstile():
-    async with aiohttp.ClientSession() as session:
-        # 本地求解
-        payload = {
-            "url": "https://example.com",
-            "sitekey": "0x4AAAAAAAxxxxxx",
-            "timeout": 30000
-        }
-        
-        async with session.post(
-            "http://localhost:7860/solve",
-            json=payload
-        ) as resp:
-            result = await resp.json()
-            print(f"Token: {result['token']}")
-
-asyncio.run(solve_turnstile())
-```
+1. 打開應用
+2. 選擇求解方式：
+   - **本地 Playwright**：無需配置
+   - **第三方服務**：需要 API Key
+3. 輸入 URL 和 Sitekey
+4. 點擊「求解 Turnstile」
+5. 自動複製 Token
 
-### cURL 示例
+### 方式 2: API 調用
 
+**本地求解：**
 ```bash
-# 本地求解
 curl -X POST http://localhost:7860/solve \
   -H "Content-Type: application/json" \
   -d '{
@@ -185,8 +44,10 @@ curl -X POST http://localhost:7860/solve \
     "sitekey": "0x4AAAAAAAxxxxxx",
     "timeout": 30000
   }'
+```
 
-# 第三方服務求解
+**第三方服務求解：**
+```bash
 curl -X POST http://localhost:7860/solve-external \
   -H "Content-Type: application/json" \
   -d '{
@@ -198,158 +59,100 @@ curl -X POST http://localhost:7860/solve-external \
   }'
 ```
 
-## 文件結構
-
-```
-turnstile-solver/
-├── app.py                 # FastAPI 應用 + UI
-├── captcha_service.py     # 第三方服務集成
-├── requirements.txt       # Python 依賴
-├── Dockerfile             # Docker 配置
-├── config.py              # 配置管理
-├── client.py              # Python 客戶端
-├── .env.example           # 環境變量模板
-├── .gitignore             # Git 忽略文件
-└── DEPLOYMENT_GUIDE.md    # 部署指南
-```
+## 支持的服務
 
-## 環境變量配置
+| 服務 | 費用 | 速度 | 可靠性 |
+|------|------|------|--------|
+| 本地 Playwright | 免費 | ⭐⭐⭐ | ⭐⭐⭐⭐ |
+| 2captcha | $0.5-1/1000 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
+| Anti-Captcha | $0.5-1/1000 | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
+| CapSolver | $0.3-0.8/1000 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
 
-創建 `.env` 文件：
-
-```env
-# 環境設置
-ENVIRONMENT=production
-DEBUG=False
-
-# 服務設置
-HOST=0.0.0.0
-PORT=7860
+## API 端點
 
-# Playwright 設置
-BROWSER_TIMEOUT=30000
-HEADLESS=True
+- `GET /health` - 健康檢查
+- `POST /solve` - 本地求解
+- `POST /solve-external` - 第三方服務求解
+- `GET /providers` - 獲取服務列表
 
-# 第三方 API 設置
-CAPTCHA_API_PROVIDER=2captcha
-CAPTCHA_API_KEY=your_api_key_here
+## 配置第三方服務
 
-# 日誌設置
-LOG_LEVEL=INFO
-LOG_FILE=app.log
-```
+### 2captcha
+1. 訪問 https://2captcha.com
+2. 註冊並登入
+3. 進入 Settings → API Key
+4. 複製 API Key 到應用
 
-## 性能優化
+### Anti-Captcha
+1. 訪問 https://anti-captcha.com
+2. 註冊並登入
+3. 進入 Account → API Key
+4. 複製 API Key 到應用
 
-### 本地求解
-- 適合低頻率使用（< 10 req/min）
-- 消耗 CPU 和內存
-- 無額外成本
+### CapSolver
+1. 訪問 https://www.capsolver.com
+2. 註冊並登入
+3. 進入 Dashboard → API Key
+4. 複製 API Key 到應用
 
-### 第三方服務
-- 適合高頻率使用（> 10 req/min）
-- 按次數計費
-- 更穩定可靠
+## 常見問題
 
-### 建議配置
+**Q: 本地求解需要什麼？**
+A: 只需要 Playwright 和 Chromium 瀏覽器，無需第三方服務。
 
-| 使用場景 | 推薦方案 | 預估成本 |
-|---------|--------|--------|
-| 低頻率 (< 100/天) | 本地 Playwright | $0 |
-| 中頻率 (100-1000/天) | 2captcha | $0.5-5/月 |
-| 高頻率 (> 1000/天) | Anti-Captcha | $5-50/月 |
-| 超高頻率 (> 10000/天) | CapSolver | $50-200/月 |
+**Q: 第三方服務需要付費嗎？**
+A: 是的，按求解次數計費。通常 $0.3-1 per 1000 captchas。
 
-## 故障排除
+**Q: 哪個方式更快？**
+A: 第三方服務通常更快（3-10 秒），本地求解可能需要 10-30 秒。
 
-### 本地求解失敗
+**Q: 可以免費使用嗎？**
+A: 本地 Playwright 完全免費。第三方服務需要付費。
 
-**問題：** Playwright 超時
-```
-求解失敗: Timeout waiting for selector
-```
+## 使用示例
 
-**解決方案：**
-1. 增加 timeout 參數
-2. 檢查網絡連接
-3. 確認 sitekey 正確
+### Python
+```python
+import requests
 
-### 第三方服務失敗
+response = requests.post(
+    "http://localhost:7860/solve",
+    json={
+        "url": "https://example.com",
+        "sitekey": "0x4AAAAAAAxxxxxx",
+        "timeout": 30000
+    }
+)
 
-**問題：** API Key 無效
-```
-求解失敗: Invalid API key
+print(response.json()['token'])
 ```
 
-**解決方案：**
-1. 檢查 API Key 是否正確
-2. 確認賬戶已充值
-3. 檢查服務是否支持 Turnstile
+### JavaScript
+```javascript
+const response = await fetch('http://localhost:7860/solve', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    url: 'https://example.com',
+    sitekey: '0x4AAAAAAAxxxxxx',
+    timeout: 30000
+  })
+});
 
-**問題：** 超時
-```
-求解失敗: Timeout
+const data = await response.json();
+console.log(data.token);
 ```
 
-**解決方案：**
-1. 增加 timeout 參數
-2. 檢查服務狀態
-3. 嘗試其他服務提供商
-
-## 安全建議
-
-1. **不要在代碼中硬編碼 API Key**
-   - 使用環境變量
-   - 使用 .env 文件
-
-2. **實現速率限制**
-   - 防止濫用
-   - 保護服務
-
-3. **添加身份驗證**
-   - 使用 API Key 驗證
-   - 實現 JWT token
-
-4. **監控日誌**
-   - 追蹤求解成功率
-   - 檢測異常行為
-
-## 常見問題
-
-**Q: 本地求解和第三方服務有什麼區別？**
-
-A: 本地求解使用 Playwright 自動化瀏覽器，無需第三方服務。第三方服務使用專門的驗證碼求解 API，更快更穩定。
-
-**Q: 哪個第三方服務最便宜？**
-
-A: CapSolver 通常最便宜，約 $0.3-0.8 per 1000 captchas。
-
-**Q: 可以同時使用多個服務嗎？**
-
-A: 可以，在 UI 中選擇不同的服務提供商。
-
-**Q: 如何提高求解成功率？**
+## 許可證
 
-A: 
-1. 使用多個服務提供商
-2. 實現重試機制
-3. 增加 timeout 參數
+MIT License
 
 ## 支持
 
-- 文檔：查看本文件
-- 問題：提交 GitHub Issue
-- 討論：加入社區
-
-## 許可證
-
-MIT License
+- 遇到問題？查看文檔
+- 需要幫助？提交 Issue
+- 有建議？提交 Pull Request
 
-## 更新日誌
+---
 
-### v1.0.0 (2024-04-04)
-- 初始版本
-- 支持本地 Playwright 求解
-- 支持 2captcha、Anti-Captcha、CapSolver
-- 完整的 Web UI
-- 完整的 API 文檔
+**祝您使用愉快！** 🚀