feat: Enhance documentation and installation scripts for AI Studio Proxy API

- Updated README-Docker.md to include Poetry dependency management and multi-stage builds.
- Revised dependency-versions.md to detail Python version requirements and Poetry usage.
- Added development-guide.md for comprehensive developer setup instructions.
- Improved installation-guide.md with a focus on Poetry and streamlined installation steps.
- Introduced install.sh and install.ps1 scripts for one-click installation on macOS/Linux and Windows respectively.
- Updated pyproject.toml to include development dependencies for testing and code quality tools.

Author: CJackHwang

README.md

@@ -28,7 +28,9 @@ This project is generously sponsored by ZMTO. Visit their website: [https://zmto
 
 ## 系统要求
 
-*   **Python**: >=3.9, <4.0 (由 Poetry 管理)
+*   **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
@@ -47,6 +49,7 @@ This project is generously sponsored by ZMTO. Visit their website: [https://zmto
 *   **灵活认证系统**: 支持可选的API密钥认证，完全兼容OpenAI标准的Bearer token格式
 *   **模块化架构**: 采用清晰的模块化设计，便于维护和扩展
 *   **统一配置管理**: 基于 `.env` 文件的统一配置方式，支持环境变量覆盖
+*   **现代化开发工具**: 集成 Poetry 依赖管理和 Pyright 类型检查，提供优秀的开发体验
 
 ## 系统架构
 
@@ -158,10 +161,32 @@ python launch_camoufox.py --headless
 
 ### 快速开始
 
-本项目现在使用 [Poetry](https://python-poetry.org/) 进行依赖管理。
+本项目采用现代化的 Python 开发工具链，使用 [Poetry](https://python-poetry.org/) 进行依赖管理，[Pyright](https://github.com/microsoft/pyright) 进行类型检查。
 
-1.  **安装 Poetry**:
-    如果您尚未安装 Poetry，请参照其官方文档进行安装：[Poetry Installation](https://python-poetry.org/docs/#installation)。
+#### 🚀 一键安装脚本 (推荐)
+
+```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
@@ -170,38 +195,68 @@ python launch_camoufox.py --headless
     ```
 
 3.  **安装依赖**:
-    使用 Poetry 安装项目依赖。这会自动创建一个虚拟环境（如果当前没有激活的虚拟环境）。
+    Poetry 会自动创建虚拟环境并安装所有依赖：
     ```bash
     poetry install
     ```
 
-4.  **激活虚拟环境 (可选但推荐)**:
-    要激活 Poetry 创建的虚拟环境，请运行：
+4.  **激活虚拟环境**:
     ```bash
+    # 方式1: 激活 shell (推荐日常开发)
     poetry shell
+
+    # 方式2: 直接运行命令 (推荐自动化脚本)
+    poetry run python gui_launcher.py
     ```
-    之后，您可以直接运行 Python 脚本 (例如 `python gui_launcher.py`)。
-    或者，如果您不想激活 shell，可以在每个命令前加上 `poetry run` (例如 `poetry run python gui_launcher.py`)。
 
-5.  **配置**: 参见 [环境变量配置指南](docs/environment-configuration.md) - **推荐先配置**
+#### 🔧 后续配置步骤
+
+5.  **环境配置**: 参见 [环境变量配置指南](docs/environment-configuration.md) - **推荐先配置**
 6.  **首次认证**: 参见 [认证设置指南](docs/authentication-setup.md)
-7.  **日常运行**: 参见 [日常运行指南](docs/daily-usage.md) (请使用 `poetry run python launch_camoufox.py` 或在 `poetry shell` 中运行 `python launch_camoufox.py`)
+7.  **日常运行**: 参见 [日常运行指南](docs/daily-usage.md)
 8.  **API使用**: 参见 [API使用指南](docs/api-usage.md)
 9.  **Web界面**: 参见 [Web UI使用指南](docs/webui-guide.md)
 
-### 详细文档
+#### 🛠️ 开发者选项
+
+如果您是开发者，还可以：
+
+```bash
+# 安装开发依赖 (包含类型检查、测试工具等)
+poetry install --with dev
+
+# 启用类型检查 (需要安装 pyright)
+npm install -g pyright
+pyright
 
+# 查看项目依赖树
+poetry show --tree
+
+# 更新依赖
+poetry update
+```
+
+### 📚 详细文档
+
+#### 🚀 快速上手
 - [安装指南](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/troubleshooting.md) - 常见问题解决方案
-- [高级配置指南](docs/advanced-configuration.md) - 高级功能和配置选项
 - [脚本注入指南](docs/script_injection_guide.md) - 油猴脚本动态挂载功能使用指南 (v3.0) 🆕
+
+#### ⚙️ 高级配置
+- [高级配置指南](docs/advanced-configuration.md) - 高级功能和配置选项
 - [日志控制指南](docs/logging-control.md) - 日志系统配置和调试
-- [依赖版本说明](docs/dependency-versions.md) - Python版本要求和依赖兼容性详解
+- [故障排除指南](docs/troubleshooting.md) - 常见问题解决方案
+
+#### 🛠️ 开发相关
+- [开发者指南](docs/development-guide.md) - Poetry、Pyright 和开发工作流程 🆕
+- [依赖版本说明](docs/dependency-versions.md) - Poetry 依赖管理和版本控制详解
 
 ## 客户端配置示例
 
@@ -217,13 +272,13 @@ python launch_camoufox.py --headless
 
 ---
 
-## Docker 部署
+## 🐳 Docker 部署
 
-本项目支持通过 Docker 进行部署，**现在完全支持 `.env` 配置文件**！
+本项目支持通过 Docker 进行部署，使用 **Poetry** 进行依赖管理，**完全支持 `.env` 配置文件**！
 
 > 📁 **注意**: 所有 Docker 相关文件已移至 `docker/` 目录，保持项目根目录整洁。
 
-### 快速 Docker 部署
+### 🚀 快速 Docker 部署
 
 ```bash
 # 1. 准备配置文件
@@ -234,20 +289,26 @@ nano .env  # 编辑配置
 # 2. 使用 Docker Compose 启动
 docker compose up -d
 
-# 3. 版本更新 (在 docker 目录下)
+# 3. 查看日志
+docker compose logs -f
+
+# 4. 版本更新 (在 docker 目录下)
 bash update.sh
 ```
 
-### 详细文档
+### 📚 详细文档
 
-- [Docker 部署指南 (docker/README-Docker.md)](docker/README-Docker.md) - 包含完整的 `.env` 配置说明
+- [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 架构
 - ⚠️ **认证文件**: 首次运行需要在主机上获取认证文件，然后挂载到容器中
 
 ---

docker/README-Docker.md

@@ -2,30 +2,34 @@
 
 > 📁 **注意**: 所有 Docker 相关文件现在都位于 `docker/` 目录中，保持项目根目录的整洁。
 
-本文档提供了使用 Docker 构建和运行 AI Studio Proxy API 项目的完整指南，包括最新的 `.env` 配置管理和脚本注入功能。
+本文档提供了使用 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 环境规格
+## 🔧 Docker 环境规格
 
 *   **基础镜像**: Python 3.10-slim-bookworm (稳定且轻量)
 *   **Python版本**: 3.10 (在容器内运行，与主机Python版本无关)
+*   **依赖管理**: Poetry (现代化 Python 依赖管理)
+*   **构建方式**: 多阶段构建 (builder + runtime)
 *   **架构支持**: x86_64 和 ARM64 (Apple Silicon)
-*   **依赖管理**: 容器内自动安装所有必需依赖
 *   **模块化设计**: 完全支持项目的模块化架构
+*   **虚拟环境**: Poetry 自动管理虚拟环境
 
 ## 1. 理解项目中的 Docker 相关文件