Upload 7 files

.env.docker

@@ -0,0 +1,150 @@
+# Docker 环境配置文件示例
+# 复制此文件为 .env 并根据需要修改配置
+
+# =============================================================================
+# Docker 主机端口配置
+# =============================================================================
+
+# 主机上映射的端口 (外部访问端口)
+HOST_FASTAPI_PORT=2048
+HOST_STREAM_PORT=3120
+
+# =============================================================================
+# 容器内服务端口配置
+# =============================================================================
+
+# FastAPI 服务端口 (容器内)
+PORT=8000
+DEFAULT_FASTAPI_PORT=2048
+DEFAULT_CAMOUFOX_PORT=9222
+
+# 流式代理服务配置
+STREAM_PORT=3120
+
+# =============================================================================
+# 代理配置
+# =============================================================================
+
+# HTTP/HTTPS 代理设置
+# HTTP_PROXY=http://host.docker.internal:7890
+# HTTPS_PROXY=http://host.docker.internal:7890
+
+# 统一代理配置 (优先级高于 HTTP_PROXY/HTTPS_PROXY)
+# UNIFIED_PROXY_CONFIG=http://host.docker.internal: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
+
+# =============================================================================
+# 浏览器配置
+# =============================================================================
+
+# 启动模式 (normal, headless, virtual_display, direct_debug_no_browser)
+LAUNCH_MODE=headless
+
+# =============================================================================
+# 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
+
+# 轮询间隔
+POLLING_INTERVAL=300
+POLLING_INTERVAL_STREAM=180
+
+# 静默超时
+SILENCE_TIMEOUT_MS=60000
+
+# =============================================================================
+# 脚本注入配置
+# =============================================================================
+
+# 是否启用油猴脚本注入功能
+ENABLE_SCRIPT_INJECTION=false
+
+# 油猴脚本文件路径（相对于容器内 /app 目录）
+USERSCRIPT_PATH=browser_utils/more_modles.js
+
+# 注意：MODEL_CONFIG_PATH 已废弃
+# 模型数据现在直接从 USERSCRIPT_PATH 指定的油猴脚本中解析
+
+# =============================================================================
+# Docker 特定配置
+# =============================================================================
+
+# 容器内存限制
+# 默认不限制。如需限制容器资源，请在你的 .env 文件中取消注释并设置以下值。
+# 例如: DOCKER_MEMORY_LIMIT=1g或DOCKER_MEMORY_LIMIT=1024m
+# 注意：DOCKER_MEMORY_LIMIT和DOCKER_MEMSWAP_LIMIT相同时，不会使用SWAP
+# DOCKER_MEMORY_LIMIT=
+# DOCKER_MEMSWAP_LIMIT=
+
+# 容器重启策略相关
+# 这些配置项在 docker-compose.yml 中使用
+
+# 健康检查间隔 (秒)
+HEALTHCHECK_INTERVAL=30
+
+# 健康检查超时 (秒)
+HEALTHCHECK_TIMEOUT=10
+
+# 健康检查重试次数
+HEALTHCHECK_RETRIES=3
+
+# =============================================================================
+# 网络配置说明
+# =============================================================================
+
+# 在 Docker 环境中访问主机服务，请使用：
+# - Linux: host.docker.internal
+# - macOS: host.docker.internal  
+# - Windows: host.docker.internal
+# 
+# 例如，如果主机上有代理服务运行在 7890 端口：
+# HTTP_PROXY=http://host.docker.internal:7890

Dockerfile

@@ -0,0 +1,116 @@
+# Dockerfile
+
+#ARG PROXY_ADDR="http://host.docker.internal:7890" Linxux 下使用 host.docker.internal 可能会有问题，建议使用实际的代理地址
+FROM python:3.10-slim-bookworm AS builder
+
+ARG DEBIAN_FRONTEND=noninteractive
+ARG PROXY_ADDR
+
+RUN if [ -n "$PROXY_ADDR" ]; then \
+    printf 'Acquire::http::Proxy "%s";\nAcquire::https::Proxy "%s";\n' "$PROXY_ADDR" "$PROXY_ADDR" > /etc/apt/apt.conf.d/99proxy; \
+    fi && \
+    apt-get update && \
+    apt-get install -y --no-install-recommends curl \
+    && apt-get clean && rm -rf /var/lib/apt/lists/* && \
+    if [ -n "$PROXY_ADDR" ]; then rm -f /etc/apt/apt.conf.d/99proxy; fi
+
+ENV HTTP_PROXY=${PROXY_ADDR}
+ENV HTTPS_PROXY=${PROXY_ADDR}
+
+ENV POETRY_HOME="/opt/poetry"
+ENV POETRY_VERSION=1.8.3
+RUN curl -sSL https://install.python-poetry.org | python3 - --version ${POETRY_VERSION}
+ENV PATH="${POETRY_HOME}/bin:${PATH}"
+
+WORKDIR /app_builder
+COPY pyproject.toml poetry.lock ./
+RUN poetry config virtualenvs.create false --local && \
+    poetry install --no-root --no-dev --no-interaction --no-ansi
+
+FROM python:3.10-slim-bookworm
+
+ARG DEBIAN_FRONTEND=noninteractive
+ARG PROXY_ADDR
+
+ENV HTTP_PROXY=${PROXY_ADDR}
+ENV HTTPS_PROXY=${PROXY_ADDR}
+
+# 步骤 1: 安装所有系统依赖。
+# Playwright 的依赖也在这里一并安装。
+RUN \
+    if [ -n "$PROXY_ADDR" ]; then \
+    printf 'Acquire::http::Proxy "%s";\nAcquire::https::Proxy "%s";\n' "$PROXY_ADDR" "$PROXY_ADDR" > /etc/apt/apt.conf.d/99proxy; \
+    fi && \
+    apt-get update && \
+    apt-get install -y --no-install-recommends \
+    libatk1.0-0 libatk-bridge2.0-0 libcups2 libdbus-1-3 libdrm2 libgbm1 libgtk-3-0 libnspr4 libnss3 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxdamage1 libxext6 libxfixes3 libxrandr2 libxrender1 libxtst6 ca-certificates fonts-liberation libasound2 libpangocairo-1.0-0 libpango-1.0-0 libu2f-udev \
+    supervisor curl \
+    && \
+    # 清理工作
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/* && \
+    if [ -n "$PROXY_ADDR" ]; then rm -f /etc/apt/apt.conf.d/99proxy; fi
+
+RUN groupadd -r appgroup && useradd -r -g appgroup -s /bin/bash -d /app appuser
+
+WORKDIR /app
+
+# 步骤 2: 复制 Python 包和可执行文件。
+# 这是关键的顺序调整：在使用 playwright 之前先把它复制进来。
+COPY --from=builder /usr/local/lib/python3.10/site-packages/ /usr/local/lib/python3.10/site-packages/
+COPY --from=builder /usr/local/bin/ /usr/local/bin/
+COPY --from=builder /opt/poetry/bin/poetry /usr/local/bin/poetry
+
+# 复制应用代码
+COPY . .
+
+# 步骤 3: 现在 Python 模块已存在，可以安全地运行这些命令。
+# 注意：我们不再需要 `playwright install-deps`，因为依赖已在上面的 apt-get 中安装。
+RUN camoufox fetch && \
+    python -m playwright install firefox
+
+# 创建目录和设置权限
+RUN mkdir -p /app/logs && \
+    mkdir -p /app/auth_profiles/active && \
+    mkdir -p /app/auth_profiles/saved && \
+    mkdir -p /app/certs && \
+    mkdir -p /app/browser_utils/custom_scripts && \
+    mkdir -p /home/appuser/.cache/ms-playwright && \
+    mkdir -p /home/appuser/.mozilla && \
+    chown -R appuser:appgroup /app && \
+    chown -R appuser:appgroup /home/appuser
+
+COPY supervisord.conf /etc/supervisor/conf.d/app.conf
+
+# 修复 camoufox 缓存逻辑
+RUN mkdir -p /var/cache/camoufox && \
+    if [ -d /root/.cache/camoufox ]; then cp -a /root/.cache/camoufox/* /var/cache/camoufox/; fi && \
+    mkdir -p /app/.cache && \
+    ln -s /var/cache/camoufox /app/.cache/camoufox
+
+RUN python update_browserforge_data.py
+
+# 清理代理环境变量
+ENV HTTP_PROXY=""
+ENV HTTPS_PROXY=""
+
+EXPOSE 2048
+EXPOSE 3120
+
+USER appuser
+ENV HOME=/app
+ENV PLAYWRIGHT_BROWSERS_PATH=/home/appuser/.cache/ms-playwright
+
+ENV PYTHONUNBUFFERED=1
+
+ENV PORT=8000
+ENV DEFAULT_FASTAPI_PORT=2048
+ENV DEFAULT_CAMOUFOX_PORT=9222
+ENV STREAM_PORT=3120
+ENV SERVER_LOG_LEVEL=INFO
+ENV DEBUG_LOGS_ENABLED=false
+ENV AUTO_CONFIRM_LOGIN=true
+ENV SERVER_PORT=2048
+ENV INTERNAL_CAMOUFOX_PROXY=""
+
+CMD ["/usr/bin/supervisord", "-c", "/etc/supervisor/conf.d/app.conf"]

README-Docker.md

@@ -0,0 +1,456 @@
+# Docker 部署指南 (AI Studio Proxy API)
+
+> 📁 **注意**: 所有 Docker 相关文件现在都位于 `docker/` 目录中，保持项目根目录的整洁。
+
+本文档提供了使用 Docker 构建和运行 AI Studio Proxy API 项目的完整指南，包括 Poetry 依赖管理、`.env` 配置管理和脚本注入功能。
+
+## 🐳 概述
+
+Docker 部署提供了以下优势：
+- ✅ **环境隔离**: 容器化部署，避免环境冲突
+- ✅ **Poetry 依赖管理**: 使用现代化的 Python 依赖管理工具
+- ✅ **统一配置**: 基于 `.env` 文件的配置管理
+- ✅ **版本更新无忧**: `bash update.sh` 即可完成更新
+- ✅ **跨平台支持**: 支持 x86_64 和 ARM64 架构
+- ✅ **配置持久化**: 认证文件和日志持久化存储
+- ✅ **多阶段构建**: 优化镜像大小和构建速度
+
+## 先决条件
+
+*   **Docker**: 确保您的系统已正确安装并正在运行 Docker。您可以从 [Docker 官方网站](https://www.docker.com/get-started) 下载并安装 Docker Desktop (适用于 Windows 和 macOS) 或 Docker Engine (适用于 Linux)。
+*   **项目代码**: 项目代码已下载到本地。
+*   **认证文件**: 首次运行需要在主机上完成认证文件获取，Docker环境目前仅支持日常运行。
+
+## 🔧 Docker 环境规格
+
+*   **基础镜像**: Python 3.10-slim-bookworm (稳定且轻量)
+*   **Python版本**: 3.10 (在容器内运行，与主机Python版本无关)
+*   **依赖管理**: Poetry (现代化 Python 依赖管理)
+*   **构建方式**: 多阶段构建 (builder + runtime)
+*   **架构支持**: x86_64 和 ARM64 (Apple Silicon)
+*   **模块化设计**: 完全支持项目的模块化架构
+*   **虚拟环境**: Poetry 自动管理虚拟环境
+
+## 1. 理解项目中的 Docker 相关文件
+
+在项目根目录下，您会找到以下与 Docker 配置相关的文件：
+
+*   **[`Dockerfile`](./Dockerfile:1):** 这是构建 Docker 镜像的蓝图。它定义了基础镜像、依赖项安装、代码复制、端口暴露以及容器启动时执行的命令。
+*   **[`.dockerignore`](./.dockerignore:1):** 这个文件列出了在构建 Docker 镜像时应忽略的文件和目录。这有助于减小镜像大小并加快构建速度，例如排除 `.git` 目录、本地开发环境文件等。
+*   **[`supervisord.conf`](./supervisord.conf:1):** (如果项目使用 Supervisor) Supervisor 是一个进程控制系统，它允许用户在类 UNIX 操作系统上监控和控制多个进程。此配置文件定义了 Supervisor 应如何管理应用程序的进程 (例如，主服务和流服务)。
+
+## 2. 构建 Docker 镜像
+
+要构建 Docker 镜像，请在项目根目录下打开终端或命令行界面，然后执行以下命令：
+
+```bash
+# 方法 1: 使用 docker compose (推荐)
+cd docker
+docker compose build
+
+# 方法 2: 直接使用 docker build (在项目根目录执行)
+docker build -f docker/Dockerfile -t ai-studio-proxy:latest .
+```
+
+**命令解释:**
+
+*   `docker build`: 这是 Docker CLI 中用于构建镜像的命令。
+*   `-t ai-studio-proxy:latest`: `-t` 参数用于为镜像指定一个名称和可选的标签 (tag)，格式为 `name:tag`。
+    *   `ai-studio-proxy`: 是您为镜像选择的名称。
+    *   `latest`: 是标签，通常表示这是该镜像的最新版本。您可以根据版本控制策略选择其他标签，例如 `ai-studio-proxy:1.0`。
+*   `.`: (末尾的点号) 指定了 Docker 构建上下文的路径。构建上下文是指包含 [`Dockerfile`](./Dockerfile:1) 以及构建镜像所需的所有其他文件和目录的本地文件系统路径。点号表示当前目录。Docker 守护进程会访问此路径下的文件来执行构建。
+
+构建过程可能需要一些时间，具体取决于您的网络速度和项目依赖项的多少。成功构建后，您可以使用 `docker images` 命令查看本地已有的镜像列表，其中应包含 `ai-studio-proxy:latest`。
+
+## 3. 运行 Docker 容器
+
+镜像构建完成后，您可以选择以下两种方式来运行容器：
+
+### 方式 A: 使用 Docker Compose (推荐)
+
+Docker Compose 提供了更简洁的配置管理方式，特别适合使用 `.env` 文件：
+
+```bash
+# 1. 准备配置文件 (进入 docker 目录)
+cd docker
+cp .env.docker .env
+# 编辑 .env 文件以适应您的需求
+
+# 2. 使用 Docker Compose 启动 (在 docker 目录下)
+docker compose up -d
+
+# 3. 查看日志
+docker compose logs -f
+
+# 4. 停止服务
+docker compose down
+```
+
+### 方式 B: 使用 Docker 命令
+
+您也可以使用传统的 Docker 命令来创建并运行容器：
+
+### 方法 1: 使用 .env 文件 (推荐)
+
+```bash
+docker run -d \
+    -p <宿主机_服务端口>:2048 \
+    -p <宿主机_流端口>:3120 \
+    -v "$(pwd)/../auth_profiles":/app/auth_profiles \
+    -v "$(pwd)/.env":/app/.env \
+    # 可选: 如果您想使用自己的 SSL/TLS 证书，请取消下面一行的注释���
+    # 请确保宿主机上的 'certs/' 目录存在，并且其中包含应用程序所需的证书文件。
+    # -v "$(pwd)/../certs":/app/certs \
+    --name ai-studio-proxy-container \
+    ai-studio-proxy:latest
+```
+
+### 方法 2: 使用环境变量 (传统方式)
+
+```bash
+docker run -d \
+    -p <宿主机_服务端口>:2048 \
+    -p <宿主机_流端口>:3120 \
+    -v "$(pwd)/../auth_profiles":/app/auth_profiles \
+    # 可选: 如果您想使用自己的 SSL/TLS 证书，请取消下面一行的注释。
+    # 请确保宿主机上的 'certs/' 目录存在，并且其中包含应用程序所需的证书文件。
+    # -v "$(pwd)/../certs":/app/certs \
+    -e PORT=8000 \
+    -e DEFAULT_FASTAPI_PORT=2048 \
+    -e DEFAULT_CAMOUFOX_PORT=9222 \
+    -e STREAM_PORT=3120 \
+    -e SERVER_LOG_LEVEL=INFO \
+    -e DEBUG_LOGS_ENABLED=false \
+    -e AUTO_CONFIRM_LOGIN=true \
+    # 可选: 如果您需要设置代理，请取消下面的注释
+    # -e HTTP_PROXY="http://your_proxy_address:port" \
+    # -e HTTPS_PROXY="http://your_proxy_address:port" \
+    # -e UNIFIED_PROXY_CONFIG="http://your_proxy_address:port" \
+    --name ai-studio-proxy-container \
+    ai-studio-proxy:latest
+```
+
+**命令解释:**
+
+*   `docker run`: 这是 Docker CLI 中用于从镜像创建并启动容器的命令。
+*   `-d`: 以“分离模式”(detached mode) 运行容器。这意味着容器将在后台运行，您的终端提示符将立即可用，而不会被容器的日志输出占用。
+*   `-p <宿主机_服务端口>:2048`: 端口映射 (Port mapping)。
+    *   此参数将宿主机的某个端口映射到容器内部的 `2048` 端口。`2048` 是应用程序主服务在容器内监听的端口。
+    *   您需要将 `<宿主机_服务端口>` 替换为您希望在宿主机上用于访问此服务的实际端口号 (例如，如果您想通过宿主机的 `8080` 端口访问服务，则使用 `-p 8080:2048`)。
+*   `-p <宿主机_流端口>:3120`: 类似地，此参数将宿主机的某个端口映射到容器内部的 `3120` 端口，这是应用程序流服务在容器内监听的端口。
+    *   您需要将 `<宿主机_流端口>` 替换为您希望在宿主机上用于访问流服务的实际端口号 (例如 `-p 8081:3120`)。
+*   `-v "$(pwd)/../auth_profiles":/app/auth_profiles`: 卷挂载 (Volume mounting)。
+    *   此参数将宿主机当前工作目录 (`$(pwd)`) 下的 `auth_profiles/` 目录挂载到容器内的 `/app/auth_profiles/` 目录。
+    *   这样做的好处是：
+        *   **持久化数据:** 即使容器被删除，`auth_profiles/` 中的数据仍保留在宿主机上。
+        *   **方便配置:** 您可以直接在宿主机上修改 `auth_profiles/` 中的文件，更改会实时反映到容器中 (取决于应用程序如何读取这些文件)。
+    *   **重要:** 在运行命令前，请确保宿主机上的 `auth_profiles/` 目录已存在。如果应用程序期望在此目录中找到特定的配置文件，请提前准备好。
+*   `# -v "$(pwd)/../certs":/app/certs` (可选，已注释): 挂载自定义证书。
+    *   如果您希望应用程序使用您自己的 SSL/TLS 证书而不是自动生成的证书，可以取消此行的注释。
+    *   它会将宿主机当前工作目录下的 `certs/` 目录挂载到容器内的 `/app/certs/` 目录。
+    *   **重要:** 如果启用此选项，请确保宿主机上的 `certs/` 目录存在，并且其中包含应用程序所需的证书文件 (通常是 `server.crt` 和 `server.key` 或类似名称的文件)。应用程序也需要被配置为从 `/app/certs/` 读取这些证书。
+*   `-e SERVER_PORT=2048`: 设置环境变量。
+    *   `-e` 参数用于在容器内设置环境变量。
+    *   这里，我们将 `SERVER_PORT` 环境变量设置为 `2048`。应用程序在容器内会读取此变量来确定其主服务应监听哪个端口。这应与 [`Dockerfile`](./Dockerfile:1) 中 `EXPOSE` 指令以及 [`supervisord.conf`](./supervisord.conf:1) (如果使用) 中的配置相匹配。
+*   `-e STREAM_PORT=3120`: 类似地，设置 `STREAM_PORT` 环境变量为 `3120`，供应用程序的流服务使用。
+*   `# -e INTERNAL_CAMOUFOX_PROXY="http://your_proxy_address:port"` (可选，已注释): 设置内部 Camoufox 代理。
+    *   如果您的应用程序需要通过一个特定的内部代理服务器来访问 Camoufox 或其他外部服务，可以取消此行的注释，并将 `"http://your_proxy_address:port"` 替换为实际的代理服务器地址和端口 (例如 `http://10.0.0.5:7890` 或 `socks5://proxy-user:proxy-pass@10.0.0.10:1080`)。
+*   `--name ai-studio-proxy-container`: 为正在运行的容器指定一个名称。
+    *   这使得管理容器更加方便。例如，您可以使用 `docker stop ai-studio-proxy-container` 来停止这个容器，或使用 `docker logs ai-studio-proxy-container` 来查看其日志。
+    *   如果您不指定名称，Docker 会自动为容器生成一个随机名称。
+*   `ai-studio-proxy:latest`: 指定要运行的镜像的名称和标签。这必须与您在 `docker build` 命令中使用的名称和标签相匹配。
+
+**首次运行前的重要准备:**
+
+### 配置文件准备
+
+1. **创建 `.env` 配置文件 (推荐):**
+   ```bash
+   # 复制配置模板 (在项目 docker 目录下执行)
+   cp .env.docker .env
+
+   # 编辑配置文件
+   nano .env  # 或使用其他编辑器
+   ```
+
+   **`.env` 文件的优势:**
+   - ✅ **版本更新无忧**: 一个 `git pull` 就完成更新，无需重新配置
+   - ✅ **配置集中管理**: 所有配置项统一在 `.env` 文件中
+   - ✅ **Docker 兼容**: 容器会自动读取挂载的 `.env` 文件
+   - ✅ **安全性**: `.env` 文件已被 `.gitignore` 忽略，不会泄露配置
+
+2. **创建 `auth_profiles/` 目录:** 在项目根目录下 (与 [`Dockerfile`](./Dockerfile:1) 同级)，手动创建一个名为 `auth_profiles` 的目录。如果您的应用程序需要初始的认证配置文件，请将它们放入此目录中。
+
+3. **(可选) 创建 `certs/` 目录:** 如果您计划使用自己的证书并取消了相关卷挂载行的注释，请在项目根目录下创建一个名为 `certs` 的目录，并将您的证书文件 (例如 `server.crt`, `server.key`) 放入其中。
+
+## 4. 环境变量配置详解
+
+### 使用 .env 文件配置 (推荐)
+
+项目现在支持通过 `.env` 文件进行配置管理。在 Docker 环境中，您只需要将 `.env` 文件挂载到容器中即可：
+
+```bash
+# 挂载 .env 文件到容器
+-v "$(pwd)/.env":/app/.env
+```
+
+### 常用配置项
+
+以下是 Docker 环境中常用的配置项：
+
+```env
+# 服务端口配置
+PORT=8000
+DEFAULT_FASTAPI_PORT=2048
+DEFAULT_CAMOUFOX_PORT=9222
+STREAM_PORT=3120
+
+# 代理配置
+HTTP_PROXY=http://127.0.0.1:7890
+HTTPS_PROXY=http://127.0.0.1:7890
+UNIFIED_PROXY_CONFIG=http://127.0.0.1:7890
+
+# 日志配置
+SERVER_LOG_LEVEL=INFO
+DEBUG_LOGS_ENABLED=false
+TRACE_LOGS_ENABLED=false
+
+# 认证配置
+AUTO_CONFIRM_LOGIN=true
+AUTO_SAVE_AUTH=false
+AUTH_SAVE_TIMEOUT=30
+
+# 脚本注入配置 v3.0 (重大升级)
+ENABLE_SCRIPT_INJECTION=true
+USERSCRIPT_PATH=browser_utils/more_modles.js
+# 注意：MODEL_CONFIG_PATH 已废弃，现在直接从油猴脚本解析模型数据
+# v3.0 使用 Playwright 原生网络拦截，100% 可靠
+
+# API 默认参数
+DEFAULT_TEMPERATURE=1.0
+DEFAULT_MAX_OUTPUT_TOKENS=65536
+DEFAULT_TOP_P=0.95
+```
+
+### 配置优先级
+
+在 Docker 环境中，配置的优先级顺序为：
+
+1. **Docker 运行时环境变量** (`-e` 参数) - 最高优先级
+2. **挂载的 .env 文件** - 中等优先级
+3. **Dockerfile 中的 ENV** - 最低优先级
+
+### 示例：完整的 Docker 运行命令
+
+```bash
+# 使用 .env 文件的完整示例
+docker run -d \
+    -p 8080:2048 \
+    -p 8081:3120 \
+    -v "$(pwd)/../auth_profiles":/app/auth_profiles \
+    -v "$(pwd)/.env":/app/.env \
+    --name ai-studio-proxy-container \
+    ai-studio-proxy:latest
+```
+
+## 5. 管理正在运行的容器
+
+一旦容器启动，您可以使用以下 Docker 命令来管理它：
+
+*   **查看正在运行的容器:**
+    ```bash
+    docker ps
+    ```
+    (如果您想查看所有容器，包括已停止的，请使用 `docker ps -a`)
+
+*   **查看容器日志:**
+    ```bash
+    docker logs ai-studio-proxy-container
+    ```
+    (如果您想持续跟踪日志输出，可以使用 `-f` 参数: `docker logs -f ai-studio-proxy-container`)
+
+*   **停止容器:**
+    ```bash
+    docker stop ai-studio-proxy-container
+    ```
+
+*   **启动已停止的容器:**
+    ```bash
+    docker start ai-studio-proxy-container
+    ```
+
+*   **重启容器:**
+    ```bash
+    docker restart ai-studio-proxy-container
+    ```
+
+*   **进入容器内部 (获取一个交互式 shell):**
+    ```bash
+    docker exec -it ai-studio-proxy-container /bin/bash
+    ```
+    (或者 `/bin/sh`，取决于容器基础镜像中可用的 shell。这对于调试非常有用。)
+
+*   **删除容器:**
+    首先需要停止容器，然后才能删除它。
+    ```bash
+    docker stop ai-studio-proxy-container
+    docker rm ai-studio-proxy-container
+    ```
+    (如果您想强制删除正在运行的容器，可以使用 `docker rm -f ai-studio-proxy-container`，但不建议这样做，除非您知道自己在做什么。)
+
+## 5. 更新应用程序
+
+当您更新了应用程序代码并希望部署新版本时，通常需要执行以下步骤：
+
+1.  **停止并删除旧的容器** (如果它正在使用相同的端口或名称)：
+    ```bash
+    docker stop ai-studio-proxy-container
+    docker rm ai-studio-proxy-container
+    ```
+2.  **重新构建 Docker 镜像** (确保您在包含最新代码和 [`Dockerfile`](./Dockerfile:1) 的目录中)：
+    ```bash
+    docker build -t ai-studio-proxy:latest .
+    ```
+3.  **使用新的镜像运行新的容���** (使用与之前相同的 `docker run` 命令，或根据需要进行调整)：
+    ```bash
+    docker run -d \
+        -p <宿主机_服务端口>:2048 \
+        # ... (其他参数与之前相同) ...
+        --name ai-studio-proxy-container \
+        ai-studio-proxy:latest
+    ```
+
+## 6. 清理
+
+*   **删除指定的 Docker 镜像:**
+    ```bash
+    docker rmi ai-studio-proxy:latest
+    ```
+    (注意：如果存在基于此镜像的容器，您需要先删除这些容器。)
+
+*   **删除所有未使用的 (悬空) 镜像、容器、网络和卷:**
+    ```bash
+    docker system prune
+    ```
+    (如果想删除所有未使用的镜像，不仅仅是悬空的，可以使用 `docker system prune -a`)
+    **警告:** `prune` 命令会删除数据，请谨慎使用。
+
+希望本教程能帮助您成功地通过 Docker 部署和运行 AI Studio Proxy API 项目！
+
+## 脚本注入配置 (v3.0 新功能) 🆕
+
+### 概述
+
+Docker 环境完全支持最新的脚本注入功能 v3.0，提供革命性的改进：
+
+- **🚀 Playwright 原生拦截**: 使用 Playwright 路由拦截，100% 可靠性
+- **🔄 双重保障机制**: 网络拦截 + 脚本注入，确保万无一失
+- **📝 直接脚本解析**: 从油猴脚本中自动解析模型列表，无需配置文件
+- **🔗 前后端同步**: 前端和后端使用相同的模型数据源，100%一致
+- **⚙️ 零配置维护**: 无需手动维护模型配置文件，脚本更新自动生效
+- **🔄 自动适配**: 油猴脚本更新时无需手动更新配置
+
+### 配置选项
+
+在 `.env` 文件中配置以下选项：
+
+```env
+# 是否启用脚本注入功能
+ENABLE_SCRIPT_INJECTION=true
+
+# 油猴脚本文件路径（容器内路径）
+# 模型数据直接从此脚本文件中解析，无需额外配置文件
+USERSCRIPT_PATH=browser_utils/more_modles.js
+```
+
+### 自定义脚本和模型配置
+
+如果您想使用自定义的脚本或模型配置：
+
+1. **自定义脚本配置**：
+   ```bash
+   # 在主机上创建自定义脚本文件
+   cp browser_utils/more_modles.js browser_utils/my_script.js
+   # 编辑 my_script.js 中的 MODELS_TO_INJECT 数组
+
+   # 在 docker-compose.yml 中取消注释并修改挂载行：
+   # - ../browser_utils/my_script.js:/app/browser_utils/more_modles.js:ro
+
+   # 或者在 .env 中修改路径：
+   # USERSCRIPT_PATH=browser_utils/my_script.js
+   ```
+
+2. **自定义脚本**：
+   ```bash
+   # 将自定义脚本放在 browser_utils/ 目录
+   cp your_custom_script.js browser_utils/custom_script.js
+
+   # 在 .env 中修改路径：
+   # USERSCRIPT_PATH=browser_utils/custom_script.js
+   ```
+
+### Docker Compose 挂载配置
+
+在 `docker-compose.yml` 中，您可以取消注释以下行来挂载自定义文件：
+
+```yaml
+volumes:
+  # 挂载自定义模型配置
+  - ../browser_utils/model_configs.json:/app/browser_utils/model_configs.json:ro
+  # 挂载自定义脚本目录
+  - ../browser_utils/custom_scripts:/app/browser_utils/custom_scripts:ro
+```
+
+### 注意事项
+
+- 脚本或配置文件更新后需要重启容器
+- 如果脚本注入失败，不会影响主要功能
+- 可以通过容器日志查看脚本注入状态
+
+## 注意事项
+
+1. **认证文件**: Docker 部署需要预先在主机上获取有效的认证文件，并将其放置在 `auth_profiles/active/` 目录中。
+2. **模块化架构**: 项目采用模块化设计，所有配置和代码都已经过优化，无需手动修改。
+3. **端口配置**: 确保宿主机上的端口未被占用，默认使用 2048 (主服务) 和 3120 (流式代理)。
+4. **日志查看**: 可以通过 `docker logs` 命令查看容器运行日志，便于调试和监控。
+5. **脚本注入**: 新增的脚本注入功能默认启用，可通过 `ENABLE_SCRIPT_INJECTION=false` 禁用。
+
+## 配置管理总结 ⭐
+
+### 新功能：统一的 .env 配置
+
+现在 Docker 部署完全支持 `.env` 文件配置管理：
+
+✅ **统一配置**: 使用 `.env` 文件管理所有配置
+✅ **版本更新无忧**: `git pull` + `docker compose up -d` 即可完成更新
+✅ **配置隔离**: 开发、测试、生产环境可使用不同的 `.env` 文件
+✅ **安全性**: `.env` 文件不会被提交到版本控制
+
+### 推荐的 Docker 工作流程
+
+```bash
+# 1. 初始设置
+git clone <repository>
+cd <project>/docker
+cp .env.docker .env
+# 编辑 .env 文件
+
+# 2. 启动服务
+docker compose up -d
+
+# 3. 版本更新
+bash update.sh
+
+# 4. 查看状态
+docker compose ps
+docker compose logs -f
+```
+
+### 配置文件说明
+
+- **`.env`**: 您的实际配置文件 (从 `.env.docker` 复制并修改)
+- **`.env.docker`**: Docker 环境的配置模板
+- **`.env.example`**: 通用配置模板 (适用于所有环境)
+- **`docker-compose.yml`**: Docker Compose 配置文件
+
+这样的配置管理方式确保了 Docker 部署与本地开发的一致性���同时简化了配置和更新流程。

README.md

@@ -1,379 +1,77 @@
-# AI Studio Proxy API
+# Docker 部署文件
 
-这是一个基于 Python 的代理服务器，用于将 Google AI Studio 的网页界面转换为 OpenAI 兼容的 API。通过 Camoufox (反指纹检测的 Firefox) 和 Playwright 自动化，提供稳定的 API 访问。
+这个目录包含了 AI Studio Proxy API 项目的所有 Docker 相关文件。
 
-[![Star History Chart](https://api.star-history.com/svg?repos=CJackHwang/AIstudioProxyAPI&type=Date)](https://www.star-history.com/#CJackHwang/AIstudioProxyAPI&Date)
+## 📁 文件说明
 
-This project is generously sponsored by ZMTO. Visit their website: [https://zmto.com/](https://zmto.com/)
+- **`Dockerfile`** - Docker 镜像构建文件
+- **`docker-compose.yml`** - Docker Compose 配置文件
+- **`.env.docker`** - Docker 环境配置模板
+- **`README-Docker.md`** - 详细的 Docker 部署指南
 
-本项目由 ZMTO 慷慨赞助服务器支持。访问他们的网站：[https://zmto.com/](https://zmto.com/)
+## 🚀 快速开始
 
----
-
-## 致谢 (Acknowledgements)
-
-本项目的诞生与发展，离不开以下个人、组织和社区的慷慨支持与智慧贡献：
-
-- **项目发起与主要开发**: @CJackHwang ([https://github.com/CJackHwang](https://github.com/CJackHwang))
-- **功能完善、页面操作优化思路贡献**: @ayuayue ([https://github.com/ayuayue](https://github.com/ayuayue))
-- **实时流式功能优化与完善**: @luispater ([https://github.com/luispater](https://github.com/luispater))
-- **3400+行主文件项目重构伟大贡献**: @yattin (Holt) ([https://github.com/yattin](https://github.com/yattin))
-- **项目后期高质量维护**: @Louie （[https://github.com/NikkeTryHard](https://github.com/NikkeTryHard)）
-- **社区支持与灵感碰撞**: 特别感谢 [Linux.do 社区](https://linux.do/) 成员们的热烈讨论、宝贵建议和问题反馈，你们的参与是项目前进的重要动力。
-
-同时，我们衷心感谢所有通过提交 Issue、提供建议、分享使用体验、贡献代码修复等方式为本项目默默奉献的每一位朋友。是你们共同的努力，让这个项目变得更好！
-
----
-
-**这是当前维护的 Python 版本。不再维护的 Javascript 版本请参见 [`deprecated_javascript_version/README.md`](deprecated_javascript_version/README.md)。**
-
-## 系统要求
-
-- **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 客户端和第三方工具
-- **三层流式响应机制**: 集成流式代理 → 外部 Helper 服务 → Playwright 页面交互的多重保障
-- **智能模型切换**: 通过 API 请求中的 `model` 字段动态切换 AI Studio 中的模型
-- **完整参数控制**: 支持 `temperature`、`max_output_tokens`、`top_p`、`stop`、`reasoning_effort` 等所有主要参数
-- **反指纹检测**: 使用 Camoufox 浏览器降低被检测为自动化脚本的风险
-- **脚本注入功能 v3.0**: 使用 Playwright 原生网络拦截，支持油猴脚本动态挂载，100%可靠 🆕
-- **现代化 Web UI**: 内置测试界面，支持实时聊天、状态监控、分级 API 密钥管理
-- **图形界面启动器**: 提供功能丰富的 GUI 启动器，简化配置和进程管理
-- **灵活认证系统**: 支持可选的 API 密钥认证，完全兼容 OpenAI 标准的 Bearer token 格式
-- **模块化架构**: 清晰的模块分离设计，api_utils/、browser_utils/、config/ 等独立模块
-- **统一配置管理**: 基于 `.env` 文件的统一配置方式，支持环境变量覆盖，Docker 兼容
-- **现代化开发工具**: Poetry 依赖管理 + Pyright 类型检查，提供优秀的开发体验
-
-## 系统架构
-
-```mermaid
-graph TD
-    subgraph "用户端 (User End)"
-        User["用户 (User)"]
-        WebUI["Web UI (Browser)"]
-        API_Client["API 客户端 (API Client)"]
-    end
-
-    subgraph "启动与配置 (Launch & Config)"
-        GUI_Launch["gui_launcher.py (图形启动器)"]
-        CLI_Launch["launch_camoufox.py (命令行启动)"]
-        EnvConfig[".env (统一配置)"]
-        KeyFile["auth_profiles/key.txt (API Keys)"]
-        ConfigDir["config/ (配置模块)"]
-    end
-
-    subgraph "核心应用 (Core Application)"
-        FastAPI_App["api_utils/app.py (FastAPI 应用)"]
-        Routes["api_utils/routes.py (路由处理)"]
-        RequestProcessor["api_utils/request_processor.py (请求处理)"]
-        AuthUtils["api_utils/auth_utils.py (认证管理)"]
-        PageController["browser_utils/page_controller.py (页面控制)"]
-        ScriptManager["browser_utils/script_manager.py (脚本注入)"]
-        ModelManager["browser_utils/model_management.py (模型管理)"]
-        StreamProxy["stream/ (流式代理服务器)"]
-    end
-
-    subgraph "外部依赖 (External Dependencies)"
-        CamoufoxInstance["Camoufox 浏览器 (反指纹)"]
-        AI_Studio["Google AI Studio"]
-        UserScript["油猴脚本 (可选)"]
-    end
-
-    User -- "运行 (Run)" --> GUI_Launch
-    User -- "运行 (Run)" --> CLI_Launch
-    User -- "访问 (Access)" --> WebUI
-
-    GUI_Launch -- "启动 (Starts)" --> CLI_Launch
-    CLI_Launch -- "启动 (Starts)" --> FastAPI_App
-    CLI_Launch -- "配置 (Configures)" --> StreamProxy
-
-    API_Client -- "API 请求 (Request)" --> FastAPI_App
-    WebUI -- "聊天请求 (Chat Request)" --> FastAPI_App
-
-    FastAPI_App -- "读取配置 (Reads Config)" --> EnvConfig
-    FastAPI_App -- "使用路由 (Uses Routes)" --> Routes
-    AuthUtils -- "验证密钥 (Validates Key)" --> KeyFile
-    ConfigDir -- "提供设置 (Provides Settings)" --> EnvConfig
-
-    Routes -- "处理请求 (Processes Request)" --> RequestProcessor
-    Routes -- "认证管理 (Auth Management)" --> AuthUtils
-    RequestProcessor -- "控制浏览器 (Controls Browser)" --> PageController
-    RequestProcessor -- "通过代理 (Uses Proxy)" --> StreamProxy
-
-    PageController -- "模型管理 (Model Management)" --> ModelManager
-    PageController -- "脚本注入 (Script Injection)" --> ScriptManager
-    ScriptManager -- "加载脚本 (Loads Script)" --> UserScript
-    ScriptManager -- "增强功能 (Enhances)" --> CamoufoxInstance
-    PageController -- "自动化 (Automates)" --> CamoufoxInstance
-    CamoufoxInstance -- "访问 (Accesses)" --> AI_Studio
-    StreamProxy -- "转发请求 (Forwards Request)" --> AI_Studio
-
-    AI_Studio -- "响应 (Response)" --> CamoufoxInstance
-    AI_Studio -- "响应 (Response)" --> StreamProxy
-
-    CamoufoxInstance -- "返回数据 (Returns Data)" --> PageController
-    StreamProxy -- "返回数据 (Returns Data)" --> RequestProcessor
-
-    FastAPI_App -- "API 响应 (Response)" --> API_Client
-    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) (命令行) 进行日常运行。仅在首次设置或认证过期时才需要使用调试模式。
-
-### 快速开始
-
-本项目采用现代化的 Python 开发工具链，使用 [Poetry](https://python-poetry.org/) 进行依赖管理，[Pyright](https://github.com/microsoft/pyright) 进行类型检查。
-
-#### 🚀 一键安装脚本 (推荐)
-
-```bash
-# macOS/Linux 用户
-curl -sSL https://raw.githubusercontent.com/CJackHwang/AIstudioProxyAPI/main/scripts/install.sh | bash
-
-# Windows 用户 (PowerShell)
-iwr -useb https://raw.githubusercontent.com/CJackHwang/AIstudioProxyAPI/main/scripts/install.ps1 | iex
-```
-
-#### 📋 手动安装步骤
-
-1.  **安装 Poetry** (如果尚未安装):
-
-    ```bash
-    # macOS/Linux
-    curl -sSL https://install.python-poetry.org | python3 -
-
-    # Windows (PowerShell)
-    (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -
-
-    # 或使用包管理器
-    # macOS: brew install poetry
-    # Ubuntu/Debian: apt install python3-poetry
-    ```
-
-2.  **克隆项目**:
-
-    ```bash
-    git clone https://github.com/CJackHwang/AIstudioProxyAPI.git
-    cd AIstudioProxyAPI
-    ```
-
-3.  **安装依赖**:
-    Poetry 会自动创建虚拟环境并安装所有依赖：
-
-    ```bash
-    poetry install
-    ```
-
-4.  **激活虚拟环境**:
-
-    ```bash
-    # 方式1: 激活 shell (推荐日常开发)
-    poetry env activate
-
-    # 方式2: 直接运行命令 (推荐自动化脚本)
-    poetry run python gui_launcher.py
-    ```
-
-#### 🔧 后续配置步骤
-
-5.  **环境配置**: 参见 [环境变量配置指南](docs/environment-configuration.md) - **推荐先配置**
-6.  **首次认证**: 参见 [认证设置指南](docs/authentication-setup.md)
-7.  **日常运行**: 参见 [日常运行指南](docs/daily-usage.md)
-8.  **API 使用**: 参见 [API 使用指南](docs/api-usage.md)
-9.  **Web 界面**: 参见 [Web UI 使用指南](docs/webui-guide.md)
-
-#### 🛠️ 开发者选项
-
-如果您是开发者，还可以：
+### 1. 准备配置文件
 
 ```bash
-# 安装开发依赖 (包含类型检查、测试工具等)
-poetry install --with dev
-
-# 启用类型检查 (需要安装 pyright)
-npm install -g pyright
-pyright
-
-# 查看项目依赖树
-poetry show --tree
-
-# 更新依赖
-poetry update
+# 进入 docker 目录
+cp .env.docker .env
+nano .env  # 编辑配置文件
 ```
 
-### 📚 详细文档
-
-#### 🚀 快速上手
-
-- [安装指南](docs/installation-guide.md) - 详细的安装步骤和环境配置
-- [环境变量配置指南](docs/environment-configuration.md) - **.env 文件配置管理** ⭐
-- [认证设置指南](docs/authentication-setup.md) - 首次运行与认证文件设置
-- [日常运行指南](docs/daily-usage.md) - 日常使用和配置选项
-
-#### 🔧 功能使用
-
-- [API 使用指南](docs/api-usage.md) - API 端点和客户端配置
-- [Web UI 使用指南](docs/webui-guide.md) - Web 界面功能说明
-- [脚本注入指南](docs/script_injection_guide.md) - 油猴脚本动态挂载功能使用指南 (v3.0) 🆕
-
-#### ⚙️ 高级配置
-
-- [流式处理模式详解](docs/streaming-modes.md) - 三层响应获取机制详细说明 🆕
-- [高级配置指南](docs/advanced-configuration.md) - 高级功能和配置选项
-- [日志控制指南](docs/logging-control.md) - 日志系统配置和调试
-- [故障排除指南](docs/troubleshooting.md) - 常见问题解决方案
-
-#### 🛠️ 开发相关
-
-- [项目架构指南](docs/architecture-guide.md) - 模块化架构设计和组件详解 🆕
-- [开发者指南](docs/development-guide.md) - Poetry、Pyright 和开发工作流程
-- [依赖版本说明](docs/dependency-versions.md) - Poetry 依赖管理和版本控制详解
-
-## 客户端配置示例
-
-以 Open WebUI 为例：
-
-1. 打开 Open WebUI
-2. 进入 "设置" -> "连接"
-3. 在 "模型" 部分，点击 "添加模型"
-4. **模型名称**: 输入你想要的名字，例如 `aistudio-gemini-py`
-5. **API 基础 URL**: 输入 `http://127.0.0.1:2048/v1`
-6. **API 密钥**: 留空或输入任意字符
-7. 保存设置并开始聊天
-
----
-
-## 🐳 Docker 部署
-
-本项目支持通过 Docker 进行部署，使用 **Poetry** 进行依赖管理，**完全支持 `.env` 配置文件**！
-
-> 📁 **注意**: 所有 Docker 相关文件已移至 `docker/` 目录，保持项目根目录整洁。
-
-### 🚀 快速 Docker 部署
+### 2. 启动服务
 
 ```bash
-# 1. 准备配置文件
+# 进入 docker 目录
 cd docker
-cp .env.docker .env
-nano .env  # 编辑配置
 
-# 2. 使用 Docker Compose 启动
+# 构建并启动服务
 docker compose up -d
 
-# 3. 查看日志
+# 查看日志
 docker compose logs -f
-
-# 4. 版本更新 (在 docker 目录下)
-bash update.sh
 ```
 
-### 📚 详细文档
-
-- [Docker 部署指南 (docker/README-Docker.md)](docker/README-Docker.md) - 包含完整的 Poetry + `.env` 配置说明
-- [Docker 快速指南 (docker/README.md)](docker/README.md) - 快速开始指南
-
-### ✨ Docker 特性
-
-- ✅ **Poetry 依赖管理**: 使用现代化的 Python 依赖管理工具
-- ✅ **多阶段构建**: 优化镜像大小和构建速度
-- ✅ **配置统一**: 使用 `.env` 文件管理所有配置
-- ✅ **版本更新**: `bash update.sh` 即可完成更新
-- ✅ **目录整洁**: Docker 文件已移至 `docker/` 目录
-- ✅ **跨平台支持**: 支持 x86_64 和 ARM64 架构
-- ⚠️ **认证文件**: 首次运行需要在主机上获取认证文件，然后挂载到容器中
-
----
-
-## 关于 Camoufox
-
-本项目使用 [Camoufox](https://camoufox.com/) 来提供具有增强反指纹检测能力的浏览器实例。
-
-- **核心目标**: 模拟真实用户流量，避免被网站识别为自动化脚本或机器人
-- **实现方式**: Camoufox 基于 Firefox，通过修改浏览器底层 C++ 实现来伪装设备指纹（如屏幕、操作系统、WebGL、字体等），而不是通过容易被检测到的 JavaScript 注入
-- **Playwright 兼容**: Camoufox 提供了与 Playwright 兼容的接口
-- **Python 接口**: Camoufox 提供了 Python 包，可以通过 `camoufox.server.launch_server()` 启动其服务，并通过 WebSocket 连接进行控制
+### 3. 版本更新
 
-使用 Camoufox 的主要目的是提高与 AI Studio 网页交互时的隐蔽性，减少被检测或限制的可能性。但请注意，没��任何反指纹技术是绝对完美的。
-
-## 重要提示
-
-### 三层响应获取机制与参数控制
-
-- **响应获取优先级**: 项目采用三层响应获取机制，确保高可用性：
-
-  1. **集成流式代理服务 (Stream Proxy)**: 默认启用，端口 3120，提供最佳性能和稳定性
-  2. **外部 Helper 服务**: 可选配置，需要有效认证文件，作为备用方案
-  3. **Playwright 页面交互**: 最终后备方案，通过浏览器自动化获取响应
-
-- **参数控制机制**:
-
-  - **流式代理模式**: 支持基础参数传递，性能最优
-  - **Helper 服务模式**: 参数支持取决于外部服务实现
-  - **Playwright 模式**: 完整支持所有参数（`temperature`, `max_output_tokens`, `top_p`, `stop`, `reasoning_effort`等）
-
-- **脚本注入增强**: v3.0 版本使用 Playwright 原生网络拦截，确保注入模型与原生模型 100%一致
+```bash
+# 在 docker 目录下
+bash update.sh
+```
 
-### 客户端管理历史
+## 📖 详细文档
 
-**客户端管理历史，代理不支持 UI 内编辑**: 客户端负责维护完整的聊天记录并将其发送给代理。代理服务器本身不支持在 AI Studio 界面中对历史消息进行编辑或分叉操作。
+完整的 Docker 部署指南请参见：[README-Docker.md](README-Docker.md)
 
-## 未来计划
+## 🔧 常用命令
 
-以下是一些计划中的改进方向：
+```bash
+# 查看服务状态
+docker compose ps
 
-- **云服务器部署指南**: 提供更详细的在主流云平台上部署和管理服务的指南
-- **认证更新流程优化**: 探索更便捷的认证文件更新机制，减少手动操作
-- **流程健壮性优化**: 减少错误几率和接近原生体验
+# 查看日志
+docker compose logs -f
 
-## 贡献
+# 停止服务
+docker compose down
 
-欢迎提交 Issue 和 Pull Request！
+# 重启服务
+docker compose restart
 
-## License
+# 进入容器
+docker compose exec ai-studio-proxy /bin/bash
+```
 
-[AGPLv3](LICENSE)
+## 🌟 主要优势
 
-## 开发不易，支持作者
+- ✅ **统一配置**: 使用 `.env` 文件管理所有配置
+- ✅ **版本更新无忧**: `bash update.sh` 即可完成更新
+- ✅ **环境隔离**: 容器化部署，避免环境冲突
+- ✅ **配置持久化**: 认证文件和日志持久化存储
 
-如果您觉得本项目对您有帮助，并且希望支持作者的持续开发，欢迎通过以下方式进行捐赠。您的支持是对我们最大的鼓励！
+## ⚠️ 注意事项
 
-![开发不易，支持作者](./支持作者.jpg)
+1. **认证文件**: 首次运行需要在主机上获取认证文件
+2. **端口配置**: 确保主机端口未被占用
+3. **配置文件**: `.env` 文件需要放在 `docker/` 目录下，确保正确获取环境变量
+4. **目录结构**: Docker 文件已移至 `docker/` 目录，保持项目根目录整洁

SCRIPT_INJECTION_DOCKER.md

@@ -0,0 +1,209 @@
+# Docker 环境脚本注入配置指南
+
+## 概述
+
+本指南专门针对 Docker 环境中的油猴脚本注入功能配置。
+
+## 快速开始
+
+### 1. 基础配置
+
+```bash
+# 进入 docker 目录
+cd docker
+
+# 复制配置模板
+cp .env.docker .env
+
+# 编辑配置文件
+nano .env
+```
+
+在 `.env` 文件中确保以下配置：
+
+```env
+# 启用脚本注入
+ENABLE_SCRIPT_INJECTION=true
+
+# 使用默认脚本（模型数据直接从脚本解析）
+USERSCRIPT_PATH=browser_utils/more_modles.js
+```
+
+### 2. 启动容器
+
+```bash
+# 构建并启动
+docker compose up -d
+
+# 查看日志确认脚本注入状态
+docker compose logs -f | grep "脚本注入"
+```
+
+## 自定义配置
+
+### 方法 1: 直接替换脚本文件
+
+```bash
+# 1. 创建自定义油猴脚本
+cp ../browser_utils/more_modles.js ../browser_utils/my_custom_script.js
+
+# 2. 编辑脚本文件中的 MODELS_TO_INJECT 数组
+nano ../browser_utils/my_custom_script.js
+
+# 3. 重启容器
+docker compose restart
+```
+
+### 方法 2: 挂载自定义脚本
+
+```bash
+# 1. 创建自定义脚本文件
+cp ../browser_utils/more_modles.js ../browser_utils/my_script.js
+
+# 2. 编辑 docker-compose.yml，取消注释并修改：
+# volumes:
+#   - ../browser_utils/my_script.js:/app/browser_utils/more_modles.js:ro
+
+# 3. 重启服务
+docker compose down
+docker compose up -d
+```
+
+### 方法 3: 环境变量配置
+
+```bash
+# 1. 在 .env 文件中修改路径
+echo "USERSCRIPT_PATH=browser_utils/my_custom_script.js" >> .env
+
+# 2. 创建对应的脚本文件
+cp ../browser_utils/more_modles.js ../browser_utils/my_custom_script.js
+
+# 3. 重启容器
+docker compose restart
+```
+
+## 验证脚本注入
+
+### 检查日志
+
+```bash
+# 查看脚本注入相关日志
+docker compose logs | grep -E "(脚本注入|script.*inject|模型增强)"
+
+# 实时监控日志
+docker compose logs -f | grep -E "(脚本注入|script.*inject|模型增强)"
+```
+
+### 预期日志输出
+
+成功的脚本注入应该显示类似以下日志：
+
+```
+设置网络拦截和脚本注入...
+成功设置模型列表网络拦截
+成功解析 6 个模型从油猴脚本
+添加了 6 个注入的模型到API模型列表
+✅ 脚本注入成功，模型显示效果与油猴脚本100%一致
+   解析的模型: 👑 Kingfall, ✨ Gemini 2.5 Pro, 🦁 Goldmane...
+```
+
+### 进入容器检查
+
+```bash
+# 进入容器
+docker compose exec ai-studio-proxy /bin/bash
+
+# 检查脚本文件
+cat /app/browser_utils/more_modles.js
+
+# 检查脚本文件列表
+ls -la /app/browser_utils/*.js
+
+# 退出容器
+exit
+```
+
+## 故障排除
+
+### 脚本注入失败
+
+1. **检查配置文件路径**：
+   ```bash
+   docker compose exec ai-studio-proxy ls -la /app/browser_utils/
+   ```
+
+2. **检查文件权限**：
+   ```bash
+   docker compose exec ai-studio-proxy cat /app/browser_utils/more_modles.js
+   ```
+
+3. **查看详细错误日志**：
+   ```bash
+   docker compose logs | grep -A 5 -B 5 "脚本注入"
+   ```
+
+### 脚本文件无效
+
+1. **验证 JavaScript 格式**：
+   ```bash
+   # 在主机上验证 JavaScript 语法
+   node -c browser_utils/more_modles.js
+   ```
+
+2. **检查必需字段**：
+   确保每个模型都有 `name` 和 `displayName` 字段。
+
+### 禁用脚本注入
+
+如果遇到问题，可以临时禁用：
+
+```bash
+# 在 .env 文件中设置
+echo "ENABLE_SCRIPT_INJECTION=false" >> .env
+
+# 重启容器
+docker compose restart
+```
+
+## 高级配置
+
+### 使用自定义脚本
+
+```bash
+# 1. 将自定义脚本放在 browser_utils/ 目录
+cp your_custom_script.js ../browser_utils/custom_injector.js
+
+# 2. 在 .env 中修改脚本路径
+echo "USERSCRIPT_PATH=browser_utils/custom_injector.js" >> .env
+
+# 3. 重启容器
+docker compose restart
+```
+
+### 多环境配置
+
+```bash
+# 开发环境
+cp .env.docker .env.dev
+# 编辑 .env.dev
+
+# 生产环境
+cp .env.docker .env.prod
+# 编辑 .env.prod
+
+# 使用特定环境启动
+cp .env.prod .env
+docker compose up -d
+```
+
+## 注意事项
+
+1. **文件挂载**: 确保主机上的文件路径正确
+2. **权限问题**: Docker 容器内的文件权限可能需要调整
+3. **重启生效**: 配置更改后需要重启容器
+4. **日志监控**: 通过日志确认脚本注入状态
+5. **备份配置**: 建议备份工作的配置文件
+
+## 示例配置文件
+
+参考 `model_configs_docker_example.json` 文件了解完整的配置格式和选项。

docker-compose.yml

@@ -0,0 +1,56 @@
+services:
+  ai-studio-proxy:
+    build:
+      context: ..
+      dockerfile: docker/Dockerfile
+    container_name: ai-studio-proxy-container
+    mem_limit: ${DOCKER_MEMORY_LIMIT:-0}
+    memswap_limit: ${DOCKER_MEMSWAP_LIMIT:-0}
+    ports:
+      - "${HOST_FASTAPI_PORT:-2048}:${DEFAULT_FASTAPI_PORT:-2048}"
+      - "${HOST_STREAM_PORT:-3120}:${STREAM_PORT:-3120}"
+    volumes:
+      # 挂载认证文件目录 (必需)
+      - ../auth_profiles:/app/auth_profiles
+      # 挂载 .env 配置文件 (推荐)
+      # 请将 docker/.env.docker 复制为 docker/.env 并根据需要修改
+      - ../docker/.env:/app/.env:ro
+      # 挂载日志目录 (可选，用于持久化日志)
+      # 如果出现权限报错，需要修改日志目录权限 sudo chmod -R 777 ../logs
+      # - ../logs:/app/logs
+      # 挂载自定义证书 (可选)
+      # - ../certs:/app/certs:ro
+      # 挂载脚本注入相关文件 (可选，用于自定义脚本和模型配置)
+      # 如果您有自定义的油猴脚本或模型配置，可以取消注释以下行
+      # - ../browser_utils/custom_scripts:/app/browser_utils/custom_scripts:ro
+      # - ../browser_utils/model_configs.json:/app/browser_utils/model_configs.json:ro
+    environment:
+      # 这些环境变量会覆盖 .env 文件中的设置
+      # 如果您想使用 .env 文件，可以注释掉这些行
+      - PYTHONUNBUFFERED=1
+      # - PORT=${PORT:-8000}
+      # - DEFAULT_FASTAPI_PORT=${DEFAULT_FASTAPI_PORT:-2048}
+      # - DEFAULT_CAMOUFOX_PORT=${DEFAULT_CAMOUFOX_PORT:-9222}
+      # - STREAM_PORT=${STREAM_PORT:-3120}
+      # - SERVER_LOG_LEVEL=${SERVER_LOG_LEVEL:-INFO}
+      # - DEBUG_LOGS_ENABLED=${DEBUG_LOGS_ENABLED:-false}
+      # - AUTO_CONFIRM_LOGIN=${AUTO_CONFIRM_LOGIN:-true}
+      # 代理配置 (可选)
+      # - HTTP_PROXY=${HTTP_PROXY}
+      # - HTTPS_PROXY=${HTTPS_PROXY}
+      # - UNIFIED_PROXY_CONFIG=${UNIFIED_PROXY_CONFIG}
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:${DEFAULT_FASTAPI_PORT:-2048}/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+    # 可选：如果需要特定的网络配置
+    # networks:
+    #   - ai-studio-network
+
+# 可选：自定义网络
+# networks:
+#   ai-studio-network:
+#     driver: bridge

update.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+
+# 定义颜色变量以便复用
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+set -e
+
+echo -e "${GREEN}==> 正在更新并重启服务...${NC}"
+
+# 获取脚本所在的目录，并切换到项目根目录
+SCRIPT_DIR=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" &> /dev/null && pwd)
+cd "$SCRIPT_DIR/.."
+
+echo -e "${YELLOW}--> 步骤 1/4: 拉取最新的代码...${NC}"
+git pull
+
+cd "$SCRIPT_DIR"
+
+echo -e "${YELLOW}--> 步骤 2/4: 停止并移除旧的容器...${NC}"
+docker compose down
+
+echo -e "${YELLOW}--> 步骤 3/4: 使用 Docker Compose 构建并启动新容器...${NC}"
+docker compose up -d --build
+
+echo -e "${YELLOW}--> 步骤 4/4: 显示当前运行的容器状态...${NC}"
+docker compose ps
+
+echo -e "${GREEN}==> 更新完成！${NC}"