Merge pull request #191 from CJackHwang/dev

更新推送dev

Author: CJackHwang

.env.example

@@ -85,6 +85,21 @@ DEFAULT_TOP_P=0.95
 # 默认停止序列 (JSON 数组格式)
 DEFAULT_STOP_SEQUENCES=["用户:"]
 
+# 是否在处理请求时自动打开并使用 "URL Context" 功能,此工具功能详情可参考:https://ai.google.dev/gemini-api/docs/url-context
+ENABLE_URL_CONTEXT=true
+
+# 是否默认启用 "指定思考预算" 功能 (true/false),不启用时模型一般将自行决定思考预算
+# 当 API 请求中未提供 reasoning_effort 参数时将使用此值。
+ENABLE_THINKING_BUDGET=false
+
+# "指定思考预算量" 的默认值 (token)
+# 当 API 请求中未提供 reasoning_effort 参数时，将使用此值。
+DEFAULT_THINKING_BUDGET=8192
+
+# 是否默认启用 "Google Search" 功能 (true/false)
+# 当 API 请求中未提供 tools 参数时，将使用此设置作为 Google Search 的默认开关状态。
+ENABLE_GOOGLE_SEARCH=false
+
 # =============================================================================
 # 超时配置 (毫秒)
 # =============================================================================

README.md

@@ -28,28 +28,27 @@ This project is generously sponsored by ZMTO. Visit their website: [https://zmto
 
 ## 系统要求
 
-*   **Python**: >=3.9, <4.0 (推荐 3.10+ 以获得最佳性能)
-*   **依赖管理**: [Poetry](https://python-poetry.org/) (现代化Python依赖管理工具)
-*   **类型检查**: [Pyright](https://github.com/microsoft/pyright) (可选，用于开发时类型检查)
-*   **操作系统**: Windows, macOS, Linux (完全跨平台支持)
-*   **内存**: 建议 2GB+ 可用内存
-*   **网络**: 稳定的互联网连接访问 Google AI Studio
+*   **Python**: >=3.9, <4.0 (推荐 3.10+ 以获得最佳性能，Docker环境使用3.10)
+*   **依赖管理**: [Poetry](https://python-poetry.org/) (现代化Python依赖管理工具，替代传统requirements.txt)
+*   **类型检查**: [Pyright](https://github.com/microsoft/pyright) (可选，用于开发时类型检查和IDE支持)
+*   **操作系统**: Windows, macOS, Linux (完全跨平台支持，Docker部署支持x86_64和ARM64)
+*   **内存**: 建议 2GB+ 可用内存 (浏览器自动化需要)
+*   **网络**: 稳定的互联网连接访问 Google AI Studio (支持代理配置)
 
 ## 主要特性
 
-*   **OpenAI 兼容 API**: 支持 `/v1/chat/completions` 端点，完全兼容 OpenAI 客户端
-*   **流式和非流式响应**: 支持实时流式输出和传统的完整响应模式
+*   **OpenAI 兼容 API**: 支持 `/v1/chat/completions` 端点，完全兼容 OpenAI 客户端和第三方工具
+*   **三层流式响应机制**: 集成流式代理 → 外部Helper服务 → Playwright页面交互的多重保障
 *   **智能模型切换**: 通过 API 请求中的 `model` 字段动态切换 AI Studio 中的模型
-*   **完整参数控制**: 支持 `temperature`、`max_output_tokens`、`top_p`、`stop` 等所有主要参数
+*   **完整参数控制**: 支持 `temperature`、`max_output_tokens`、`top_p`、`stop`、`reasoning_effort` 等所有主要参数
 *   **反指纹检测**: 使用 Camoufox 浏览器降低被检测为自动化脚本的风险
-*   **多层响应获取**: 集成流式代理、外部 Helper 服务、Playwright 页面交互的多重保障机制
-*   **脚本注入功能**: 支持油猴脚本动态挂载，实现与前端显示效果100%一致的模型增强 🆕
-*   **现代化 Web UI**: 内置测试界面，支持实时聊天、状态监控、API密钥管理
+*   **脚本注入功能 v3.0**: 使用 Playwright 原生网络拦截，支持油猴脚本动态挂载，100%可靠 🆕
+*   **现代化 Web UI**: 内置测试界面，支持实时聊天、状态监控、分级API密钥管理
 *   **图形界面启动器**: 提供功能丰富的 GUI 启动器，简化配置和进程管理
 *   **灵活认证系统**: 支持可选的API密钥认证，完全兼容OpenAI标准的Bearer token格式
-*   **模块化架构**: 采用清晰的模块化设计，便于维护和扩展
-*   **统一配置管理**: 基于 `.env` 文件的统一配置方式，支持环境变量覆盖
-*   **现代化开发工具**: 集成 Poetry 依赖管理和 Pyright 类型检查，提供优秀的开发体验
+*   **模块化架构**: 清晰的模块分离设计，api_utils/、browser_utils/、config/ 等独立模块
+*   **统一配置管理**: 基于 `.env` 文件的统一配置方式，支持环境变量覆盖，Docker兼容
+*   **现代化开发工具**: Poetry 依赖管理 + Pyright 类型检查，提供优秀的开发体验
 
 ## 系统架构
 
@@ -250,12 +249,14 @@ poetry update
 - [脚本注入指南](docs/script_injection_guide.md) - 油猴脚本动态挂载功能使用指南 (v3.0) 🆕
 
 #### ⚙️ 高级配置
+- [流式处理模式详解](docs/streaming-modes.md) - 三层响应获取机制详细说明 🆕
 - [高级配置指南](docs/advanced-configuration.md) - 高级功能和配置选项
 - [日志控制指南](docs/logging-control.md) - 日志系统配置和调试
 - [故障排除指南](docs/troubleshooting.md) - 常见问题解决方案
 
 #### 🛠️ 开发相关
-- [开发者指南](docs/development-guide.md) - Poetry、Pyright 和开发工作流程 🆕
+- [项目架构指南](docs/architecture-guide.md) - 模块化架构设计和组件详解 🆕
+- [开发者指南](docs/development-guide.md) - Poetry、Pyright 和开发工作流程
 - [依赖版本说明](docs/dependency-versions.md) - Poetry 依赖管理和版本控制详解
 
 ## 客户端配置示例
@@ -326,14 +327,19 @@ bash update.sh
 
 ## 重要提示
 
-### 响应获取与参数控制
+### 三层响应获取机制与参数控制
 
-*   **响应获取优先级**: 项目采用多层响应获取机制：
-    1. **集成的流式代理服务**: 默认启用，提供最佳性能
-    2. **外部 Helper 服务**: 可选配置
-    3. **Playwright 页面交互**: 后备方案
+*   **响应获取优先级**: 项目采用三层响应获取机制，确保高可用性：
+    1. **集成流式代理服务 (Stream Proxy)**: 默认启用，端口3120，提供最佳性能和稳定性
+    2. **外部 Helper 服务**: 可选配置，需要有效认证文件，作为备用方案
+    3. **Playwright 页面交互**: 最终后备方案，通过浏览器自动化获取响应
 
-*   **参数控制**: API 请求中的模型参数（如 `temperature`, `max_output_tokens`, `top_p`, `stop`）**仅在通过 Playwright 页面交互获取响应时生效**。使用集成流式代理或外部 Helper 服务时，参数传递取决于这些服务的实现。
+*   **参数控制机制**:
+    - **流式代理模式**: 支持基础参数传递，性能最优
+    - **Helper服务模式**: 参数支持取决于外部服务实现
+    - **Playwright模式**: 完整支持所有参数（`temperature`, `max_output_tokens`, `top_p`, `stop`, `reasoning_effort`等）
+
+*   **脚本注入增强**: v3.0版本使用Playwright原生网络拦截，确保注入模型与原生模型100%一致
 
 ### 客户端管理历史
 

browser_utils/__init__.py

@@ -15,7 +15,11 @@
     switch_ai_studio_model,
     load_excluded_models,
     _handle_initial_model_state_and_storage,
-    _set_model_from_page_display
+    _set_model_from_page_display,
+    _verify_ui_state_settings,
+    _force_ui_state_settings,
+    _force_ui_state_with_retry,
+    _verify_and_apply_ui_state
 )
 from .script_manager import ScriptManager, script_manager
 
@@ -40,6 +44,10 @@
     'load_excluded_models',
     '_handle_initial_model_state_and_storage',
     '_set_model_from_page_display',
+    '_verify_ui_state_settings',
+    '_force_ui_state_settings',
+    '_force_ui_state_with_retry',
+    '_verify_and_apply_ui_state',
 
     # 脚本管理相关
     'ScriptManager',