【也许是最后一次功能性大更新】Merge pull request #142 from CJackHwang/dev

Merge pull request #141 from NyxJae/dev

Remove key.txt from tracking

Author: CJackHwang

.env.example

@@ -0,0 +1,170 @@
+# AI Studio Proxy API 配置文件示例
+# 复制此文件为 .env 并根据需要修改配置
+
+# =============================================================================
+# 服务端口配置
+# =============================================================================
+
+# FastAPI 服务端口
+PORT=8000
+
+# GUI 启动器默认端口配置
+DEFAULT_FASTAPI_PORT=2048
+DEFAULT_CAMOUFOX_PORT=9222
+
+# 流式代理服务配置
+STREAM_PORT=3120
+# 设置为 0 禁用流式代理服务
+
+# =============================================================================
+# 代理配置
+# =============================================================================
+
+# HTTP/HTTPS 代理设置
+# HTTP_PROXY=http://127.0.0.1:7890
+# HTTPS_PROXY=http://127.0.0.1:7890
+
+# 统一代理配置 (优先级高于 HTTP_PROXY/HTTPS_PROXY)
+# UNIFIED_PROXY_CONFIG=http://127.0.0.1:7890
+
+# 代理绕过列表 (用分号分隔)
+# NO_PROXY=localhost;127.0.0.1;*.local
+
+# =============================================================================
+# 日志配置
+# =============================================================================
+
+# 服务器日志级别 (DEBUG, INFO, WARNING, ERROR, CRITICAL)
+SERVER_LOG_LEVEL=INFO
+
+# 是否重定向 print 输出到日志
+SERVER_REDIRECT_PRINT=false
+
+# 启用调试日志
+DEBUG_LOGS_ENABLED=false
+
+# 启用跟踪日志
+TRACE_LOGS_ENABLED=false
+
+# =============================================================================
+# 认证配置
+# =============================================================================
+
+# 自动保存认证信息
+AUTO_SAVE_AUTH=false
+
+# 认证保存超时时间 (秒)
+AUTH_SAVE_TIMEOUT=30
+
+# 自动确认登录
+AUTO_CONFIRM_LOGIN=true
+
+# =============================================================================
+# 浏览器配置
+# =============================================================================
+
+# Camoufox WebSocket 端点
+# CAMOUFOX_WS_ENDPOINT=ws://127.0.0.1:9222
+
+# 启动模式 (normal, headless, virtual_display, direct_debug_no_browser)
+LAUNCH_MODE=normal
+
+# =============================================================================
+# API 默认参数配置
+# =============================================================================
+
+# 默认温度值 (0.0-2.0)
+DEFAULT_TEMPERATURE=1.0
+
+# 默认最大输出令牌数
+DEFAULT_MAX_OUTPUT_TOKENS=65536
+
+# 默认 Top-P 值 (0.0-1.0)
+DEFAULT_TOP_P=0.95
+
+# 默认停止序列 (JSON 数组格式)
+DEFAULT_STOP_SEQUENCES=["用户:"]
+
+# =============================================================================
+# 超时配置 (毫秒)
+# =============================================================================
+
+# 响应完成总超时时间
+RESPONSE_COMPLETION_TIMEOUT=300000
+
+# 初始等待时间
+INITIAL_WAIT_MS_BEFORE_POLLING=500
+
+# 轮询间隔
+POLLING_INTERVAL=300
+POLLING_INTERVAL_STREAM=180
+
+# 静默超时
+SILENCE_TIMEOUT_MS=60000
+
+# 页面操作超时
+POST_SPINNER_CHECK_DELAY_MS=500
+FINAL_STATE_CHECK_TIMEOUT_MS=1500
+POST_COMPLETION_BUFFER=700
+
+# 清理聊天相关超时
+CLEAR_CHAT_VERIFY_TIMEOUT_MS=4000
+CLEAR_CHAT_VERIFY_INTERVAL_MS=4000
+
+# 点击和剪贴板操作超时
+CLICK_TIMEOUT_MS=3000
+CLIPBOARD_READ_TIMEOUT_MS=3000
+
+# 元素等待超时
+WAIT_FOR_ELEMENT_TIMEOUT_MS=10000
+
+# 流相关配置
+PSEUDO_STREAM_DELAY=0.01
+
+# =============================================================================
+# GUI 启动器配置
+# =============================================================================
+
+# GUI 默认代理地址
+GUI_DEFAULT_PROXY_ADDRESS=http://127.0.0.1:7890
+
+# GUI 默认流式代理端口
+GUI_DEFAULT_STREAM_PORT=3120
+
+# GUI 默认 Helper 端点
+GUI_DEFAULT_HELPER_ENDPOINT=
+
+# =============================================================================
+# 其他配置
+# =============================================================================
+
+# 模型名称
+MODEL_NAME=AI-Studio_Proxy_API
+
+# 聊天完成 ID 前缀
+CHAT_COMPLETION_ID_PREFIX=chatcmpl-
+
+# 默认回退模型 ID
+DEFAULT_FALLBACK_MODEL_ID=no model list
+
+# 排除模型文件名
+EXCLUDED_MODELS_FILENAME=excluded_models.txt
+
+# AI Studio URL 模式
+AI_STUDIO_URL_PATTERN=aistudio.google.com/
+
+# 模型端点 URL 包含字符串
+MODELS_ENDPOINT_URL_CONTAINS=MakerSuiteService/ListModels
+
+# 用户输入标记符
+USER_INPUT_START_MARKER_SERVER=__USER_INPUT_START__
+USER_INPUT_END_MARKER_SERVER=__USER_INPUT_END__
+
+# =============================================================================
+# 流状态配置
+# =============================================================================
+
+# 流超时日志状态配置
+STREAM_MAX_INITIAL_ERRORS=3
+STREAM_WARNING_INTERVAL_AFTER_SUPPRESS=60.0
+STREAM_SUPPRESS_DURATION_AFTER_INITIAL_BURST=400.0

.gitignore

@@ -229,4 +229,7 @@ deprecated_javascript_version/node_modules/
 
 .roomodes
 memory-bank/
-gui_config.json
+gui_config.json
+
+# key
+key.txt

README.md

@@ -108,21 +108,53 @@ graph TD
     FastAPI_App -- "UI 响应 (Response)" --> WebUI
 ```
 
+## 配置管理 ⭐
+
+**新功能**: 项目现在支持通过 `.env` 文件进行配置管理，避免硬编码参数！
+
+### 快速配置
+
+```bash
+# 1. 复制配置模板
+cp .env.example .env
+
+# 2. 编辑配置文件
+nano .env  # 或使用其他编辑器
+
+# 3. 启动服务（自动读取配置）
+python gui_launcher.py
+# 或直接命令行启动
+python launch_camoufox.py --headless
+```
+
+### 主要优势
+
+- ✅ **版本更新无忧**: 一个 `git pull` 就完成更新，无需重新配置
+- ✅ **配置集中管理**: 所有配置项统一在 `.env` 文件中
+- ✅ **启动命令简化**: 无需复杂的命令行参数，一键启动
+- ✅ **安全性**: `.env` 文件已被 `.gitignore` 忽略，不会泄露配置
+- ✅ **灵活性**: 支持不同环境的配置管理
+- ✅ **Docker 兼容**: Docker 和本地环境使用相同的配置方式
+
+详细配置说明请参见 [环境变量配置指南](docs/environment-configuration.md)。
+
 ## 使用教程
 
 推荐使用 [`gui_launcher.py`](gui_launcher.py) (图形界面) 或直接使用 [`launch_camoufox.py`](launch_camoufox.py) (命令行) 进行日常运行。仅在首次设置或认证过期时才需要使用调试模式。
 
 ### 快速开始
 
 1. **安装**: 参见 [安装指南](docs/installation-guide.md)
-2. **首次认证**: 参见 [认证设置指南](docs/authentication-setup.md)  
-3. **日常运行**: 参见 [日常运行指南](docs/daily-usage.md)
-4. **API使用**: 参见 [API使用指南](docs/api-usage.md)
-5. **Web界面**: 参见 [Web UI使用指南](docs/webui-guide.md)
+2. **配置**: 参见 [环境变量配置指南](docs/environment-configuration.md) - **推荐先配置**
+3. **首次认证**: 参见 [认证设置指南](docs/authentication-setup.md)
+4. **日常运行**: 参见 [日常运行指南](docs/daily-usage.md)
+5. **API使用**: 参见 [API使用指南](docs/api-usage.md)
+6. **Web界面**: 参见 [Web UI使用指南](docs/webui-guide.md)
 
 ### 详细文档
 
 - [安装指南](docs/installation-guide.md) - 详细的安装步骤和环境配置
+- [环境变量配置指南](docs/environment-configuration.md) - **.env 文件配置管理** ⭐
 - [认证设置指南](docs/authentication-setup.md) - 首次运行与认证文件设置
 - [日常运行指南](docs/daily-usage.md) - 日常使用和配置选项
 - [API使用指南](docs/api-usage.md) - API端点和客户端配置
@@ -148,11 +180,36 @@ graph TD
 
 ## Docker 部署
 
-本项目支持通过 Docker 进行部署。详细的构建和运行说明，请参阅：
+本项目支持通过 Docker 进行部署，**现在完全支持 `.env` 配置文件**！
+
+> 📁 **注意**: 所有 Docker 相关文件已移至 `docker/` 目录，保持项目根目录整洁。
+
+### 快速 Docker 部署
+
+```bash
+# 1. 准备配置文件
+cp docker/.env.docker .env
+nano .env  # 编辑配置
+
+# 2. 使用 Docker Compose 启动
+cd docker
+docker-compose up -d
+
+# 3. 版本更新
+cd .. && git pull && cd docker && docker-compose up -d --build
+```
+
+### 详细文档
+
+- [Docker 部署指南 (docker/README-Docker.md)](docker/README-Docker.md) - 包含完整的 `.env` 配置说明
+- [Docker 快速指南 (docker/README.md)](docker/README.md) - 快速开始指南
 
-- [Docker 部署指南 (README-Docker.md)](README-Docker.md)
+### 重要说明
 
-请注意，首次运行获取认证文件目前不能在docker环境完成，必须在主机完成，因此docker方式安装当前仅仅是为了方便云端部署项目。在主机部署本项目成功取得json认证文件后，日常运行通过挂载json可以使用docker来运行本项目。
+- ✅ **配置统一**: Docker 和本地环境使用相同的 `.env` 配置方式
+- ✅ **版本更新**: `git pull` + `docker-compose up -d --build` 即可完成更新
+- ✅ **目录整洁**: Docker 文件已移至 `docker/` 目录
+- ⚠️ **认证文件**: 首次运行需要在主机上获取认证文件，然后挂载到容器中
 
 ---
 

api_utils/request_processor.py

@@ -306,6 +306,7 @@ async def create_stream_generator_from_helper(event_to_set: Event) -> AsyncGener
                                 "model": model_name_for_stream,
                                 "created": created_timestamp,
                                 "choices":[{
+                                    "index": 0,
                                     "delta":{
                                         "role": "assistant",
                                         "content": None,
@@ -326,6 +327,7 @@ async def create_stream_generator_from_helper(event_to_set: Event) -> AsyncGener
 
                             delta_content = {"role": "assistant", "content": body[last_body_pos:]}
                             choice_item = {
+                                "index": 0,
                                 "delta": delta_content,
                                 "finish_reason": finish_reason_val,
                                 "native_finish_reason": finish_reason_val,
@@ -376,13 +378,15 @@ async def create_stream_generator_from_helper(event_to_set: Event) -> AsyncGener
                                     })
                                 delta_content["tool_calls"] = tool_calls_list
                                 choice_item = {
+                                    "index": 0,
                                     "delta": delta_content,
                                     "finish_reason": "tool_calls",
                                     "native_finish_reason": "tool_calls",
                                 }
                             else:
                                 # 纯结束，没有新内容和函数调用
                                 choice_item = {
+                                    "index": 0,
                                     "delta": {"role": "assistant"},
                                     "finish_reason": "stop",
                                     "native_finish_reason": "stop",
@@ -409,6 +413,7 @@ async def create_stream_generator_from_helper(event_to_set: Event) -> AsyncGener
                             "model": model_name_for_stream,
                             "created": created_timestamp,
                             "choices": [{
+                                "index": 0,
                                 "delta": {"role": "assistant", "content": f"\n\n[错误: {str(e)}]"},
                                 "finish_reason": "stop",
                                 "native_finish_reason": "stop",