refactor: 整合timeout/sleep常量到timeouts.py

Author: Mag1cFall

README.md

@@ -21,11 +21,11 @@
   🎤 Gemini 2.5 TTS 语音生成
 </p>
 
-<img src="docs/demo.gif" alt="Demo GIF" width="100%" />
+<img src="docs/img/demo.gif" alt="Demo GIF" width="100%" />
 
-<p align="center">
-  <img src="docs/多worker并发和媒体模型支援.png" alt="多Worker并发与媒体模型支援" width="80%" />
-</p>
+<!-- <p align="center">
+  <img src="docs/img/多worker并发和媒体模型支援.png" alt="多Worker并发与媒体模型支援" width="80%" />
+</p> -->
 
 </div>
 

README_en.md

@@ -21,11 +21,11 @@
   🎤 Gemini 2.5 TTS Speech Synthesis
 </p>
 
-<img src="docs/demo.gif" alt="Demo GIF" width="100%" />
+<img src="docs/img/demo.gif" alt="Demo GIF" width="100%" />
 
-<p align="center">
-  <img src="docs/多worker并发和媒体模型支援.png" alt="Multi-Worker Concurrency & Media Model Support" width="80%" />
-</p>
+<!-- <p align="center">
+  <img src="docs/img/多worker并发和媒体模型支援.png" alt="Multi-Worker Concurrency & Media Model Support" width="80%" />
+</p> -->
 
 </div>
 

docs/dependency-versions.md

@@ -232,4 +232,5 @@ admin-key-for-testing
 - [环境变量配置指南](environment-configuration.md) - ⭐ 推荐先配置，简化后续使用
 - [首次运行与认证指南](authentication-setup.md)
 - [API使用指南](api-usage.md) - 包含详细的密钥管理说明
+- [项目结构说明](project-structure.md) - 了解代码组织
 - [故障排除指南](troubleshooting.md)

docs/demo.gif docs/img/demo.gifdocs/demo.gif renamed to docs/img/demo.gif

@@ -74,15 +74,25 @@ AIStudio2API 是一个高性能代理服务，将 Google AI Studio 网页界面
 | 文件 | 描述 |
 |------|------|
 | `__init__.py` | 导出所有配置常量 |
-| `constants.py` | 全局常量定义 |
-| `settings.py` | 环境变量设置 |
-| `timeouts.py` | 超时配置 |
+| `constants.py` | 全局常量：模型名称、ID前缀、默认参数等 |
+| `settings.py` | 环境变量设置：调试开关、认证配置、路径定义 |
+| `timeouts.py` | **超时和时间常量**。包含所有 sleep/timeout/retry/delay 统一常量 |
 | `selectors.py` | **主选择器**。AI Studio 核心页面元素 CSS/XPath 选择器 |
 | `tts_selectors.py` | TTS 页面选择器 |
 | `imagen_selectors.py` | Imagen 页面选择器 |
 | `veo_selectors.py` | Veo 页面选择器 |
 | `nano_selectors.py` | Nano Banana 页面选择器 |
 
+#### timeouts.py 常量分类
+
+| 类别 | 示例常量 | 用途 |
+|------|----------|------|
+| Sleep | `SLEEP_TICK`, `SLEEP_RETRY`, `SLEEP_NAVIGATION` | UI操作等待时间 |
+| Delay | `DELAY_AFTER_CLICK`, `DELAY_AFTER_FILL` | 操作后延迟 |
+| Timeout | `TIMEOUT_ELEMENT_VISIBLE`, `TIMEOUT_PAGE_NAVIGATION` | 超时限制 |
+| Retry | `MAX_RETRIES`, `BASE_STREAM_RETRIES` | 重试次数 |
+| URL | `NEW_CHAT_URL` | 固定URL模板 |
+
 ---
 
 ### tts/ - TTS 语音生成模块
@@ -190,6 +200,7 @@ AIStudio2API 是一个高性能代理服务，将 Google AI Studio 网页界面
 | `multi-worker-guide.md` | 多 Worker 模式说明 |
 | `docker-deployment.md` | Docker 部署指南 |
 | `development-guide.md` | 开发指南 |
+| `project-structure.md` | 项目结构说明 (本文档) |
 | `dependency-versions.md` | 依赖版本说明 |
 | `reverse-engineering-internals.md` | 逆向工程内部文档 |
 | `client-stop-mechanisms-analysis.md` | 客户端中断机制分析 |

docs/多worker并发和媒体模型支援.png docs/img/多worker并发和媒体模型支援.pngdocs/多worker并发和媒体模型支援.png renamed to docs/img/多worker并发和媒体模型支援.png

@@ -10,6 +10,7 @@
 from fastapi.responses import JSONResponse, StreamingResponse
 from playwright.async_api import Page as AsyncPage, Locator, Error as PlaywrightAsyncError, expect as expect_async
 from config import *
+from config.timeouts import STREAM_CHUNK_SIZE
 from models import ChatCompletionRequest, ClientDisconnectedError
 from browser import switch_ai_studio_model, save_error_snapshot
 from .utils import validate_chat_request, prepare_combined_prompt, generate_sse_chunk, generate_sse_stop_chunk, use_stream_response, calculate_usage_stats, request_manager, calculate_stream_max_retries
@@ -548,7 +549,7 @@ async def create_response_stream_generator():
                             pass
                         break
                     if line:
-                        chunk_size = 50
+                        chunk_size = STREAM_CHUNK_SIZE
                         for i in range(0, len(line), chunk_size):
                             chunk = line[i:i + chunk_size]
                             yield generate_sse_chunk(chunk, req_id, current_ai_studio_model_id or MODEL_NAME)

docs/installation-guide.md

@@ -12,6 +12,8 @@
 import hashlib
 import threading
 
+from config.timeouts import BASE_STREAM_RETRIES
+
 class RequestCancellationManager:
 
     def __init__(self):
@@ -49,7 +51,7 @@ def get_active_requests(self) -> List[Dict[str, Any]]:
 request_manager = RequestCancellationManager()
 
 def calculate_stream_max_retries(messages: List[Message]) -> int:
-    base_retries = 300
+    base_retries = BASE_STREAM_RETRIES
     total_token_estimate = 0
     image_count = 0
 

docs/project-structure.md

@@ -6,6 +6,7 @@
 from typing import Optional, Set
 from playwright.async_api import Page as AsyncPage, expect as expect_async, Error as PlaywrightAsyncError
 from config import *
+from config.timeouts import MAX_RETRIES, SLEEP_VIDEO_POLL
 from models import ClientDisconnectedError
 logger = logging.getLogger('AIStudioProxyServer')
 
@@ -367,7 +368,7 @@ async def _handle_initial_model_state_and_storage(page: AsyncPage):
             await _set_model_from_page_display(page, set_storage=True)
             current_page_url = page.url
             logger.info(f'   步骤 2: 重新加载页面 ({current_page_url}) 以应用 isAdvancedOpen=true...')
-            max_retries = 3
+            max_retries = MAX_RETRIES
             for attempt in range(max_retries):
                 try:
                     logger.info(f'   尝试重新加载页面 (第 {attempt + 1}/{max_retries} 次): {current_page_url}')
@@ -385,7 +386,7 @@ async def _handle_initial_model_state_and_storage(page: AsyncPage):
                     logger.warning(f'   ⚠️ 页面重新加载尝试 {attempt + 1}/{max_retries} 失败: {reload_err}')
                     if attempt < max_retries - 1:
                         logger.info(f'   将在5秒后重试...')
-                        await asyncio.sleep(5)
+                        await asyncio.sleep(SLEEP_VIDEO_POLL)
                     else:
                         logger.error(f'   ❌ 页面重新加载在 {max_retries} 次尝试后最终失败: {reload_err}. 后续模型状态可能不准确。', exc_info=True)
                         from .operations import save_error_snapshot