provider-guide 2.2.0a0__py3-none-any.whl

provider_guide-2.2.0a0.dist-info/METADATA

@@ -0,0 +1,2344 @@
+Metadata-Version: 2.4
+Name: provider-guide
+Version: 2.2.0a0
+Summary: Unified AI model gateway aggregating 17+ platforms behind a single OpenAI/Anthropic-compatible API
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: aiohttp-socks>=0.8.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: pycryptodome>=3.20.0
+Requires-Dist: loguru>=0.7.0
+Requires-Dist: tomlkit>=0.12.0
+Requires-Dist: watchdog>=4.0.0
+Requires-Dist: watchfiles>=0.21.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: typing-extensions>=4.7.0
+Requires-Dist: echotools>=2.0.0
+Requires-Dist: provider-sdk>=0.3.0
+Requires-Dist: tomli>=2.0.0; python_version < "3.11"
+Provides-Extra: deepseek
+Requires-Dist: wasmtime>=0.40.0; extra == "deepseek"
+Provides-Extra: cerebras
+Requires-Dist: cerebras-cloud-sdk>=1.0.0; extra == "cerebras"
+Provides-Extra: ssh
+Requires-Dist: paramiko>=3.0.0; extra == "ssh"
+Provides-Extra: async-perf
+Requires-Dist: uvloop>=0.19.0; extra == "async-perf"
+Provides-Extra: all
+Requires-Dist: provider-guide[async-perf,cerebras,deepseek,ssh]; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: coverage>=7.0.0; extra == "dev"
+
+# Provider-V2
+
+> 统一 AI 模型网关，聚合多个 AI 平台，提供 OpenAI 和 Anthropic 兼容 API
+
+## 分支说明
+
+| 分支 | 定位 | 说明 |
+|------|------|------|
+| **main** | 稳定发布 | 经过验证的稳定版本，适合生产部署与日常使用 |
+| **dev** | 活跃开发 | 相比 main 包含更多最新更改与功能，但可能不够稳定，建议仅在需要新特性时使用 |
+| **classical** | 历史快照 | 重构前的冻结版本，仅供对比与回退参考，不再接受更新 |
+
+> ⚠️ **重要**
+> - **禁止直接提交到 `main` 和 `classical` 分支**
+> - 所有新功能开发和 Bug 修复请基于 `dev` 分支创建功能分支
+> - PR 目标必须为 `dev`，由作者审核后合并
+> - `main` 仅用于稳定发布；`classical` 为只读存档
+
+<div align="center">
+
+![Status](https://img.shields.io/badge/status-v2.2.266-blue)
+![Version](https://img.shields.io/badge/version-v2.2.266-blue)
+![Python](https://img.shields.io/badge/python-3.8+-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+![Platforms](https://img.shields.io/badge/platforms-24-orange)
+
+[![GitHub stars](https://img.shields.io/github/stars/nichengfuben/provider-v2)](https://github.com/nichengfuben/provider-v2/stargazers)
+[![GitHub issues](https://img.shields.io/github/issues/nichengfuben/provider-v2)](https://github.com/nichengfuben/provider-v2/issues)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen)](https://github.com/nichengfuben/provider-v2/pulls)
+
+</div>
+
+---
+
+## 📋 目录
+
+- [项目简介](#-项目简介)
+- [功能特性](#-功能特性)
+- [效果展示](#-效果展示)
+- [快速开始](#-快速开始)
+- [安装指南](#-安装指南)
+- [使用说明](#-使用说明)
+- [项目结构](#-项目结构)
+- [配置说明](#-配置说明)
+- [API 文档](#-api-文档)
+- [测试指南](#-测试指南)
+- [开发指南](#-开发指南)
+- [路线图](#-路线图)
+- [常见问题](#-常见问题)
+- [贡献指南](#-贡献指南)
+- [许可证](#-许可证)
+- [联系方式](#-联系方式)
+
+---
+
+## 🎯 项目简介
+
+### 项目背景
+
+随着 AI 大模型技术的飞速发展，市场上涌现出众多优秀的 AI 平台（如 Qwen、DeepSeek、GLM、Cerebras 等）。每个平台都提供各自独立的 API 接口，格式各异，调用方式不同。开发者在集成多个平台时，面临以下痛点：
+
+- **接口不统一**：每个平台的 API 格式各异，需要编写大量适配代码
+- **切换成本高**：更换平台需要修改核心业务逻辑
+- **缺乏容错机制**：单平台故障导致服务不可用
+- **工具调用差异**：Function Calling 格式各平台实现不一致
+- **推理增强不兼容**：thinking、search 等高级功能调用方式各异
+
+**Provider-V2 应运而生**——一个高性能的 AI 模型网关，通过统一的 API 接口，让开发者可以轻松访问多个主流 AI 平台，无需关心各平台的差异性实现细节。
+
+### 核心功能
+
+- 🔌 **多平台聚合**：统一接入 Qwen、DeepSeek、Cerebras、Ollama、OpenRouter、OpenCode 等 24 个平台适配器
+- 🔄 **API 兼容性**：同时兼容 OpenAI 和 Anthropic API 规范，无缝迁移现有项目
+- ⚡ **并发竞速**：智能选择最快响应的候选项，显著降低延迟
+- 🛠️ **工具调用支持**：完整的 function calling 功能，支持 7 种协议（xml/original/antml/bracket/custom/nous/dsml），中英文模板自定义
+- 🧠 **推理增强**：支持 thinking 和 search 参数增强推理能力
+- 📡 **流式响应**：完整支持 SSE 流式输出，实时展示生成内容
+- 🔐 **鉴权中间件**：可配置的 API Key 鉴权机制，保障服务安全
+- 🔄 **配置热加载**：修改配置文件后自动重载，无需重启服务
+- 🌐 **代理支持**：全局代理配置，自动禁用 SSL 验证
+- 🔁 **平台热重载**：平台代码变更时自动重载，无需重启进程
+
+### 技术栈
+
+| 类别 | 技术 | 版本要求 |
+|------|------|----------|
+| Web 框架 | aiohttp | >= 3.9.0 |
+| HTTP 客户端 | aiohttp | >= 3.9.0 |
+| 数据验证 | pydantic | >= 2.0.0 |
+| 平台 SDK | cerebras-cloud-sdk | >= 1.0.0 |
+| WASM 运行时 | wasmtime | >= 0.40.0 |
+| HTML 解析 | beautifulsoup4 | >= 4.12.0 |
+| 加密库 | pycryptodome | >= 3.20.0 |
+
+### 为什么选择 Provider-V2
+
+| 特性 | Provider-V2 | 直接接入各平台 |
+|------|:-----------:|:-------------:|
+| 统一 API | ✅ OpenAI/Anthropic 兼容 | ❌ 各平台 API 不同 |
+| 并发竞速 | ✅ 自动选择最快响应 | ❌ 需自行实现 |
+| 多平台切换 | ✅ 配置文件切换 | ❌ 需修改代码 |
+| 工具调用 | ✅ 统一 fncall 接口，XML 模板可定制 | ❌ 格式各异 |
+| 推理增强 | ✅ thinking/search 支持 | ❌ 仅部分支持 |
+| 代理支持 | ✅ 全局代理配置 | ❌ 需逐个配置 |
+| 热加载 | ✅ 配置和平台代码均可热重载 | ❌ 不支持 |
+| 账号池 | ✅ 多账号轮询 | ❌ 需自行管理 |
+
+---
+
+## ✨ 功能特性
+
+### 核心功能
+
+| 功能 | 状态 | 说明 |
+|------|:----:|------|
+| **多平台聚合** | ✅ | 24 个平台适配器（`src/platforms/*/core/adaptercore.py`） |
+| **OpenAI 兼容 API** | ✅ | 完整支持 `/v1/chat/completions`、`/v1/models` 等接口 |
+| **Anthropic 兼容 API** | ✅ | 完整支持 `/v1/messages`、`/v1/models` 等接口 |
+| **并发竞速模式** | ✅ | 同时请求多个候选项，选择最快响应 |
+| **工具调用（fncall）** | ✅ | 7 种协议（xml/original/antml/bracket/custom/nous/dsml），中英文模板，支持多行参数 |
+| **推理增强** | ✅ | 支持 thinking 和 search 参数增强 |
+| **流式响应** | ✅ | 完整支持 SSE 流式输出 |
+| **鉴权中间件** | ✅ | 可配置的 API Key 鉴权 |
+| **配置热加载** | ✅ | 修改 `config/main_config.toml` 自动重载，无需重启 |
+| **平台热重载** | ✅ | 修改平台代码自动重载适配器 |
+| **代理支持** | ✅ | 全局代理配置，自动禁用 SSL 验证 |
+
+### 高级功能
+
+| 功能 | 状态 | 说明 |
+|------|:----:|------|
+| **智能 Token 回退** | ✅ | 平台返回 usage 为 0 时自动估算 |
+| **模型映射** | ✅ | 支持自定义模型名称映射 |
+| **健康检查** | ✅ | 内置 `/health` 健康检查端点 |
+| **WASM PoW** | ✅ | DeepSeek 平台自动管理 PoW 求解 |
+| **账号池管理** | ✅ | 支持多账号轮询和自动登录 |
+| **TAS 选择器** | ✅ | Thompson Sampling + 冷却机制，智能选择候选项 |
+| **文件管理** | ✅ | 支持文件上传和管理 API（内存存储） |
+| **Assistants API** | ✅ | 基础实现（内存存储） |
+
+### 已支持平台
+
+| 平台 | 状态 | 能力 |
+|------|:----:|------|
+| Qwen | ✅ | chat, tools, vision, search |
+| DeepSeek | ✅ | chat, thinking, search |
+| Cerebras | ✅ | chat |
+| Ollama | ✅ | chat, embedding |
+| ChatMoe | ✅ | chat |
+| Cursor | ✅ | chat |
+| CodeBuddy | ✅ | chat |
+| NVIDIA | ✅ | chat |
+| NoobKeys | ✅ | chat |
+| OpenCode | ✅ | chat, tools, vision, native_tools |
+| OpenRouter | ✅ | chat |
+| Chutes | ✅ | chat |
+| N1N / Zen / Caiyuesbk 等 | ✅ | chat 或专项能力 |
+| 翻译 / TTS（DeepL、Google、Edge TTS 等） | ✅ | translate, tts |
+| 更多平台 | 🚧 | 持续开发中（当前共 24 个 adaptercore 适配器） |
+
+---
+
+## 🖼️ 效果展示
+
+### 服务启动
+
+```bash
+$ python main.py
+
+2026-04-05 10:30:15 | INFO     | main | Provider-V2 已启动: http://0.0.0.0:1337
+2026-04-05 10:30:15 | INFO     | registry | 发现 24 个平台适配器，开始注册
+2026-04-05 10:30:16 | INFO     | registry | 平台 [qwen] 已注册 (3 模型)
+2026-04-05 10:30:16 | INFO     | registry | 平台 [deepseek] 已注册 (2 模型)
+2026-04-05 10:30:16 | INFO     | registry | 注册完成: ['qwen', 'deepseek', 'openrouter', ...]
+```
+
+### API 调用示例
+
+```bash
+# OpenAI 兼容调用
+curl -X POST http://localhost:1337/v1/chat/completions \
+  -H "Authorization: Bearer sk-xxx" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "qwen-plus",
+    "messages": [{"role": "user", "content": "你好"}]
+  }'
+```
+
+**响应示例：**
+```json
+{
+  "id": "chatcmpl-xxx",
+  "object": "chat.completion",
+  "created": 1234567890,
+  "model": "qwen-plus",
+  "choices": [
+    {
+      "index": 0,
+      "message": {
+        "role": "assistant",
+        "content": "你好！我是 AI 助手，很高兴为你服务。"
+      },
+      "finish_reason": "stop"
+    }
+  ],
+  "usage": {
+    "prompt_tokens": 10,
+    "completion_tokens": 20,
+    "total_tokens": 30
+  }
+}
+```
+
+### 内置 WebUI
+
+启动服务后直接访问 `http://localhost:1337/` 即可打开内置 WebUI，包含聊天、终端、文件管理、统计与配置等面板；启用鉴权时需先访问 `/login`。
+
+---
+
+## 🚀 快速开始
+
+### 环境要求
+
+| 依赖 | 版本要求 |
+|------|----------|
+| Python | >= 3.8 |
+| pip | >= 21.0 |
+| 操作系统 | Windows / macOS / Linux |
+
+### 30 秒快速体验
+
+```bash
+# 1. 克隆项目
+git clone https://github.com/nichengfuben/provider-v2.git
+cd provider-v2
+
+# 2. 安装依赖
+pip install -r requirements.txt
+
+# 3. 配置平台账号
+# 编辑 config/main_config.toml（首次启动可由 template/template_config.toml 自动生成）
+
+# 4. 启动服务
+python main.py
+```
+
+### 验证安装
+
+访问以下地址验证服务是否正常运行：
+
+| 地址 | 说明 |
+|------|------|
+| http://localhost:1337/health | 健康检查，返回 `{"status": "healthy"}` |
+| http://localhost:1337/ | 内置 WebUI 管理界面 |
+| http://localhost:1337/v1/models | 模型列表接口 |
+
+---
+
+## 📦 安装指南
+
+### 方式一：pip 安装（推荐）
+
+```bash
+# 克隆仓库
+git clone https://github.com/nichengfuben/provider-v2.git
+cd provider-v2
+
+# 安装依赖
+pip install -r requirements.txt
+```
+
+### 方式二：使用虚拟环境
+
+```bash
+# 创建虚拟环境
+python -m venv venv
+
+# 激活虚拟环境
+# Windows
+.\venv\Scripts\activate
+# macOS / Linux
+source venv/bin/activate
+
+# 安装依赖
+pip install -r requirements.txt
+```
+
+### 方式三：Docker 安装
+
+**Dockerfile：**
+```dockerfile
+FROM python:3.11-slim
+
+WORKDIR /app
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+EXPOSE 1337
+
+CMD ["python", "main.py"]
+```
+
+```bash
+# 构建镜像
+docker build -t provider-v2:latest .
+
+# 运行容器
+docker run -d -p 1337:1337 -v $(pwd)/config:/app/config provider-v2:latest
+```
+
+### 系统特定说明
+
+#### Windows
+
+```powershell
+# 使用虚拟环境
+python -m venv venv
+.\venv\Scripts\activate
+pip install -r requirements.txt
+python main.py
+```
+
+> **注意**：Windows 平台使用 `asyncio` 事件循环，其他平台优先使用 `uvloop`。
+
+#### macOS
+
+```bash
+# 安装 Homebrew（如已安装可跳过）
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+
+# 安装 Python 3.11
+brew install python@3.11
+
+# 创建虚拟环境并安装
+python3.11 -m venv venv
+source venv/bin/activate
+pip install -r requirements.txt
+python main.py
+```
+
+#### Linux (Ubuntu/Debian)
+
+```bash
+# 安装 Python 和依赖
+sudo apt-get update
+sudo apt-get install python3 python3-pip python3-venv
+
+# 创建虚拟环境并安装
+python3 -m venv venv
+source venv/bin/activate
+pip install -r requirements.txt
+python main.py
+
+# 使用 systemd 管理（可选）
+sudo systemctl enable python3
+```
+
+---
+
+## 💻 使用说明
+
+### 基础用法
+
+#### OpenAI API 调用
+
+```python
+import aiohttp
+import asyncio
+
+async def chat_with_openai():
+    async with aiohttp.ClientSession() as session:
+        headers = {
+            "Authorization": "Bearer your-api-key",
+            "Content-Type": "application/json"
+        }
+        data = {
+            "model": "qwen-plus",
+            "messages": [
+                {"role": "user", "content": "你好，请介绍一下你自己"}
+            ],
+            "stream": False
+        }
+
+        async with session.post(
+            "http://localhost:1337/v1/chat/completions",
+            headers=headers,
+            json=data
+        ) as response:
+            result = await response.json()
+            print(result["choices"][0]["message"]["content"])
+
+asyncio.run(chat_with_openai())
+```
+
+#### Anthropic API 调用
+
+```python
+import aiohttp
+import asyncio
+
+async def chat_with_anthropic():
+    async with aiohttp.ClientSession() as session:
+        headers = {
+            "x-api-key": "your-api-key",
+            "Content-Type": "application/json",
+            "anthropic-version": "2023-06-01"
+        }
+        data = {
+            "model": "claude-3-sonnet-20240229",
+            "max_tokens": 1024,
+            "messages": [
+                {"role": "user", "content": "你好，请介绍一下你自己"}
+            ]
+        }
+
+        async with session.post(
+            "http://localhost:1337/v1/messages",
+            headers=headers,
+            json=data
+        ) as response:
+            result = await response.json()
+            print(result["content"][0]["text"])
+
+asyncio.run(chat_with_anthropic())
+```
+
+### 高级用法
+
+#### 工具调用（Function Calling）
+
+Provider-V2 使用 XML 标签格式将工具描述注入到提示中。模型需要按照以下格式返回函数调用：
+
+```xml
+<function=函数名>
+<参数名1>
+参数值
+</参数名1>
+<参数名2>
+参数值
+</参数名2>
+</function>
+```
+
+**重要格式要求：**
+- XML 标签名必须与参数名完全一致
+- 标签和值之间**必须**有换行符
+- 必须包含所有必需参数
+- 支持多行参数（如代码块）
+
+**示例代码：**
+
+```python
+import aiohttp
+import asyncio
+
+async def function_calling_example():
+    async with aiohttp.ClientSession() as session:
+        headers = {
+            "Authorization": "Bearer your-api-key",
+            "Content-Type": "application/json"
+        }
+        data = {
+            "model": "qwen-plus",
+            "messages": [
+                {"role": "user", "content": "北京今天的天气怎么样？"}
+            ],
+            "tools": [
+                {
+                    "type": "function",
+                    "function": {
+                        "name": "get_weather",
+                        "description": "获取指定城市的天气",
+                        "parameters": {
+                            "type": "object",
+                            "properties": {
+                                "city": {
+                                    "type": "string",
+                                    "description": "城市名称"
+                                }
+                            },
+                            "required": ["city"]
+                        }
+                    }
+                }
+            ]
+        }
+
+        async with session.post(
+            "http://localhost:1337/v1/chat/completions",
+            headers=headers,
+            json=data
+        ) as response:
+            result = await response.json()
+            tool_call = result["choices"][0]["message"]["tool_calls"][0]
+            print(f"模型调用了工具: {tool_call['function']['name']}")
+            print(f"参数: {tool_call['function']['arguments']}")
+
+asyncio.run(function_calling_example())
+```
+
+**自定义模板：**
+
+可以在 `config/main_config.toml` 中自定义中英文提示模板：
+
+```toml
+[fncall.templates]
+en = """
+You are a helpful AI assistant that can interact with tools to solve tasks.
+
+<chat_history>
+{chat_history}
+</chat_history>
+
+# Available Tools
+
+<tools>
+{tool_descs}
+</tools>
+
+To call a function, wrap each parameter value in XML tags named after the parameter:
+
+<function=function_name>
+<first_parameter>
+value
+</first_parameter>
+<second_parameter>
+value
+</second_parameter>
+</function>
+
+<IMPORTANT>
+- The XML tag name MUST exactly match the parameter name defined above.
+- There MUST be a line break between the opening tag and the value, and between the value and the closing tag.
+- Required parameters MUST be included.
+- Only provide reasoning BEFORE the function call, never after.
+- If no function call is needed, answer normally without mentioning tools.
+</IMPORTANT>"""
+
+zh = """
+你是一个乐于助人的AI助手，可以使用工具来解决任务。
+
+<chat_history>
+{chat_history}
+</chat_history>
+
+# 可用工具
+
+<tools>
+{tool_descs}
+</tools>
+
+调用函数时，将每个参数值用与参数名同名的XML标签包裹：
+
+<function=函数名>
+<第一个参数名>
+值
+</第一个参数名>
+<第二个参数名>
+值
+</第二个参数名>
+</function>
+
+<IMPORTANT>
+- XML标签名必须与参数名完全一致，不要添加前缀。
+- 标签和值之间必须有换行符。
+- 必须包含所有必需参数。
+- 只能在函数调用之前提供推理说明，不能在之后。
+- 如果不需要调用函数，请正常回答问题。
+</IMPORTANT>"""
+```
+
+#### 流式响应
+
+```python
+import aiohttp
+import asyncio
+import json
+
+async def streaming_example():
+    async with aiohttp.ClientSession() as session:
+        headers = {
+            "Authorization": "Bearer your-api-key",
+            "Content-Type": "application/json"
+        }
+        data = {
+            "model": "qwen-plus",
+            "messages": [
+                {"role": "user", "content": "请写一首关于春天的诗"}
+            ],
+            "stream": True
+        }
+
+        async with session.post(
+            "http://localhost:1337/v1/chat/completions",
+            headers=headers,
+            json=data
+        ) as response:
+            async for line in response.content:
+                line = line.decode('utf-8').strip()
+                if line.startswith('data: '):
+                    data_str = line[6:]
+                    if data_str == '[DONE]':
+                        break
+                    try:
+                        chunk = json.loads(data_str)
+                        if chunk['choices'][0]['delta'].get('content'):
+                            print(chunk['choices'][0]['delta']['content'], end='', flush=True)
+                    except json.JSONDecodeError:
+                        continue
+
+asyncio.run(streaming_example())
+```
+
+#### Thinking 推理增强
+
+```python
+import aiohttp
+import asyncio
+
+async def thinking_example():
+    async with aiohttp.ClientSession() as session:
+        headers = {
+            "Authorization": "Bearer your-api-key",
+            "Content-Type": "application/json"
+        }
+        data = {
+            "model": "deepseek-reasoner",
+            "messages": [
+                {"role": "user", "content": "解释量子纠缠现象"}
+            ],
+            "extra_body": {
+                "thinking": True  # 启用 thinking 模式
+            }
+        }
+
+        async with session.post(
+            "http://localhost:1337/v1/chat/completions",
+            headers=headers,
+            json=data
+        ) as response:
+            result = await response.json()
+            if result.get("reasoning_content"):
+                print("推理过程:", result["reasoning_content"])
+            print("最终答案:", result["choices"][0]["message"]["content"])
+
+asyncio.run(thinking_example())
+```
+
+### 请求参数说明
+
+| 参数名 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| `model` | string | - | 模型名称，如 `qwen-plus`、`deepseek-chat` |
+| `messages` | array | - | 消息列表，格式为 `[{role, content}]` |
+| `stream` | boolean | `false` | 是否启用流式输出 |
+| `max_tokens` | integer | - | 最大生成 Token 数 |
+| `temperature` | float | `1.0` | 温度参数，控制随机性（0-2） |
+| `top_p` | float | `1.0` | 核采样参数（0-1） |
+| `tools` | array | - | 工具定义列表（fncall） |
+| `extra_body` | object | - | 额外参数，如 `thinking`、`search` |
+
+---
+
+## 🏗️ 项目结构
+
+```
+provider-v2/
+├── 📁 config/                   # 运行时配置（main_config.toml，通常不提交）
+├── 📁 template/                 # 配置模板 template_config.toml
+├── 📁 persist/                  # 持久化数据（账号状态、WebUI、缓存等）
+├── 📁 src/
+│   ├── 📁 bootstrap/            # 单一组合根（app_factory、lifecycle、webui_bindings）
+│   ├── 📁 core/
+│   │   ├── 📁 auth/             # 会话 cookie 常量（core 不依赖 webui）
+│   │   ├── 📁 config/           # 配置管理（sections/manager）
+│   │   ├── 📁 dispatch/         # 网关分发（gateway/executors/fncall_context）
+│   │   ├── 📁 errors/           # 分层异常 + classify_http_error
+│   │   ├── 📁 fncall/           # 工具调用（protocols/parsers/prompt）
+│   │   ├── 📁 observability/    # 观测 Protocol + AppKey（stats/logs/terminal）
+│   │   ├── 📁 server/           # HTTP 服务（app/runner/worker/middleware）
+│   │   │   └── 📁 infra/        # connector、reload、terminal_sessions
+│   │   └── 📁 utils/
+│   │       └── 📁 compat/       # models_cache、tools、scriptgen 等兼容层
+│   ├── 📁 platforms/            # 平台适配器（*/core/adaptercore.py）
+│   ├── 📁 routes/
+│   │   ├── 📁 main/             # health、models、function_call
+│   │   ├── 📁 openai/           # chat、media、stubs
+│   │   └── 📁 anthropic/        # messages、streaming、convert
+│   └── 📁 webui/
+│       ├── 📁 bootstrap/        # app、routes、server
+│       ├── 📁 routers/          # admin、api、session
+│       ├── 📁 static/           # 内置 WebUI 前端资源
+│       └── 📁 services/         # stats、request_log、summaries
+├── 📄 main.py                   # Runner-Worker 双进程入口（<60 行，委托 runner/worker）
+├── 📄 pyproject.toml            # 依赖与打包 SSOT
+├── 📄 requirements.txt          # 核心依赖（与 pyproject 同步）
+└── 📄 README.md
+```
+
+### 核心目录说明
+
+| 目录 | 说明 |
+|------|------|
+| `src/core/` | 核心网关逻辑，包括配置管理、请求分发、TAS 候选项选择、文件监视热重载 |
+| `src/platforms/` | 各平台适配器实现，自动发现机制，支持热重载 |
+| `src/routes/` | OpenAI / Anthropic 兼容 HTTP 路由 |
+| `src/core/server/infra/` | 连接器、IPC、热重载、文件监视、终端会话存储 |
+| `src/webui/` | 内置 WebUI（bootstrap 应用、session/api/admin 路由、静态资源） |
+
+---
+
+## ⚙️ 配置说明
+
+### 配置文件位置
+
+Provider-V2 默认从 `config/main_config.toml` 加载配置（`config/` 目录通常不纳入版本库）。
+
+- 若文件不存在，会基于 `template/template_config.toml` 自动生成并提示补全后重启
+- 可通过 ConfigCenter / 环境变量等方式指定其他配置文件路径
+
+### 完整配置示例
+
+```toml
+# Provider-V2 配置文件
+
+# ============================================================
+# 服务器配置
+# ============================================================
+[server]
+host = "0.0.0.0"          # 监听地址
+port = 1337               # 监听端口
+debug = false             # 调试模式
+
+[server.anthropic]
+api_version = "2023-06-01"
+
+[server.anthropic.model_mapping]
+# 可选：自定义模型映射
+# "claude-3-sonnet" = "qwen-plus"
+
+# ============================================================
+# 鉴权配置
+# ============================================================
+[auth]
+enabled = false           # 是否启用鉴权
+keys = [
+    "sk-your-api-key-1",
+    "sk-your-api-key-2"
+]
+
+# ============================================================
+# 网关配置
+# ============================================================
+[gateway]
+concurrent_enabled = true # 是否启用并发竞速
+concurrent_count = 3      # 并发请求数
+min_tokens = 10           # 选择胜者的最小 Token 阈值
+
+# ============================================================
+# 代理配置
+# ============================================================
+[proxy]
+proxy_server = "http://127.0.0.1:40000"
+proxy_enabled = false
+
+# ============================================================
+# 工具调用配置
+# ============================================================
+[fncall]
+call_start_tag = "<function="
+call_end_tag = "</function>"
+tools_start_tag = "<tools>"
+tools_end_tag = "</tools>"
+
+[fncall.templates]
+en = """
+You are a helpful AI assistant that can interact with tools to solve tasks.
+
+<chat_history>
+{chat_history}
+</chat_history>
+
+# Available Tools
+
+<tools>
+{tool_descs}
+</tools>
+
+To call a function, wrap each parameter value in XML tags named after the parameter:
+
+<function=function_name>
+<first_parameter>
+value
+</first_parameter>
+<second_parameter>
+value
+</second_parameter>
+</function>
+
+<IMPORTANT>
+- The XML tag name MUST exactly match the parameter name defined above.
+- There MUST be a line break between the opening tag and the value, and between the value and the closing tag.
+- Required parameters MUST be included.
+- Only provide reasoning BEFORE the function call, never after.
+- If no function call is needed, answer normally without mentioning tools.
+</IMPORTANT>"""
+
+zh = """
+你是一个乐于助人的AI助手，可以使用工具来解决任务。
+
+<chat_history>
+{chat_history}
+</chat_history>
+
+# 可用工具
+
+<tools>
+{tool_descs}
+</tools>
+
+调用函数时，将每个参数值用与参数名同名的XML标签包裹：
+
+<function=函数名>
+<第一个参数名>
+值
+</第一个参数名>
+<第二个参数名>
+值
+</第二个参数名>
+</function>
+
+<IMPORTANT>
+- XML标签名必须与参数名完全一致，不要添加前缀。
+- 标签和值之间必须有换行符。
+- 必须包含所有必需参数。
+- 只能在函数调用之前提供推理说明，不能在之后。
+- 如果不需要调用函数，请正常回答问题。
+</IMPORTANT>"""
+```
+
+### 配置项详解
+
+#### 服务器配置
+
+```toml
+[server]
+host = "0.0.0.0"        # 监听地址，0.0.0.0 表示监听所有网卡
+port = 1337             # 监听端口
+debug = false           # 调试模式，开启后输出更多日志
+```
+
+#### Anthropic 兼容层配置
+
+```toml
+[server.anthropic]
+api_version = "2023-06-01"  # Anthropic API 版本
+
+[server.anthropic.model_mapping]
+# 模型名称映射，将 Anthropic 模型名映射到实际平台模型
+# "claude-3-sonnet" = "qwen-plus"
+```
+
+#### 鉴权配置
+
+```toml
+[auth]
+enabled = true                      # 是否启用鉴权
+keys = ["key1", "key2", "key3"]    # 允许的 API Key 列表
+```
+
+**鉴权方式**：
+- 优先从 `Authorization: Bearer {key}` 头提取
+- 失败后从 `x-api-key` 头提取
+- 以下路径无条件跳过 API 鉴权：`/login`、`/logout`、`/health`、`/static/*`
+- 启用鉴权后，`/`、`/v1/*`（含 `/v1/models`）需有效 API Key 或 WebUI 会话 Cookie
+
+#### 网关配置
+
+```toml
+[gateway]
+concurrent_enabled = true    # 是否启用并发竞速
+concurrent_count = 3         # 并发请求数（同时请求多少个候选项）
+min_tokens = 10              # 选择胜者的最小 Token 阈值
+```
+
+**并发竞速机制**：
+- 同时向 `concurrent_count` 个候选项发送请求
+- 当任一候选项累积 Token 数 ≥ `min_tokens` 时立即选择该候选项
+- 适用于低延迟场景，会消耗更多配额
+
+#### 代理配置
+
+```toml
+[proxy]
+proxy_server = "http://proxy.example.com:8080"  # 代理服务器地址
+proxy_enabled = true                             # 是否启用代理
+proxy_list_type = "whitelist"                    # 列表类型：whitelist（白名单）或 blacklist（黑名单）
+proxy_urls = [                                   # URL 正则匹配列表
+    ".*qwen\\.ai.*",
+    ".*deepseek\\.com.*"
+]
+```
+
+**说明：**
+- `whitelist` 模式：仅匹配 `proxy_urls` 正则的请求走代理，其余直连
+- `blacklist` 模式：匹配 `proxy_urls` 正则的请求直连，其余走代理
+- 直接 IP 地址始终 bypass 代理
+- `proxy_urls` 为空时：whitelist 模式全部直连，blacklist 模式全部走代理
+
+> **注意**：代理在 `src.core.proxy` 模块导入时即生效，修改后需重启服务。
+
+#### 工具调用配置
+
+```toml
+[fncall]
+call_start_tag = "<function="      # 函数调用开始标签
+call_end_tag = "</function>"       # 函数调用结束标签
+tools_start_tag = "<tools>"        # 工具列表开始标签
+tools_end_tag = "</tools>"         # 工具列表结束标签
+
+[fncall.templates]
+en = "..."    # 英文模板，支持 {chat_history} 和 {tool_descs} 占位符
+zh = "..."    # 中文模板
+```
+
+### 配置热加载
+
+- 修改 `config/main_config.toml` 后自动重载，无需重启服务
+- 配置监听器每 2 秒检查一次变更
+- 代理配置修改后需要重启服务
+
+---
+
+## 🔌 API 文档
+
+### 接口概览
+
+| 方法 | 端点 | 说明 |
+|------|------|------|
+| GET | `/health` | 健康检查 |
+| GET | `/v1/models` | 获取模型列表 |
+| POST | `/v1/chat/completions` | OpenAI 聊天补全 |
+| POST | `/v1/messages` | Anthropic 聊天接口 |
+| POST | `/v1/completions` | Legacy 文本补全 |
+| POST | `/v1/embeddings` | 嵌入向量生成 |
+| POST | `/v1/images/generations` | 图片生成 |
+| POST | `/v1/audio/speech` | 语音合成 |
+| POST | `/v1/audio/transcriptions` | 语音转录 |
+| POST | `/v1/moderations` | 内容审核 |
+
+### 接口详情
+
+#### 健康检查
+
+```http
+GET /health
+```
+
+**响应示例：**
+```json
+{
+  "status": "healthy",
+  "timestamp": 1234567890
+}
+```
+
+#### 获取模型列表
+
+```http
+GET /v1/models
+Authorization: Bearer <api-key>
+```
+
+**响应示例：**
+```json
+{
+  "object": "list",
+  "data": [
+    {
+      "id": "qwen-plus",
+      "object": "model",
+      "created": 1234567890,
+      "owned_by": "qwen",
+      "capabilities": {
+        "chat": true,
+        "tools": true,
+        "vision": true,
+        "search": true
+      }
+    },
+    {
+      "id": "deepseek-chat",
+      "object": "model",
+      "created": 1234567890,
+      "owned_by": "deepseek",
+      "capabilities": {
+        "chat": true,
+        "thinking": true,
+        "search": true
+      }
+    }
+  ]
+}
+```
+
+#### OpenAI 聊天补全
+
+```http
+POST /v1/chat/completions
+Authorization: Bearer <api-key>
+Content-Type: application/json
+```
+
+**请求示例：**
+```json
+{
+  "model": "qwen-plus",
+  "messages": [
+    {"role": "system", "content": "你是一个乐于助人的助手"},
+    {"role": "user", "content": "你好"}
+  ],
+  "stream": false,
+  "max_tokens": 1024,
+  "temperature": 0.7
+}
+```
+
+**响应示例：**
+```json
+{
+  "id": "chatcmpl-xxx",
+  "object": "chat.completion",
+  "created": 1234567890,
+  "model": "qwen-plus",
+  "choices": [
+    {
+      "index": 0,
+      "message": {
+        "role": "assistant",
+        "content": "你好！我是 AI 助手，很高兴为你服务。"
+      },
+      "finish_reason": "stop",
+      "logprobs": null
+    }
+  ],
+  "usage": {
+    "prompt_tokens": 10,
+    "completion_tokens": 20,
+    "total_tokens": 30
+  },
+  "system_fingerprint": null
+}
+```
+
+#### Anthropic 聊天接口
+
+```http
+POST /v1/messages
+x-api-key: <api-key>
+anthropic-version: 2023-06-01
+Content-Type: application/json
+```
+
+**请求示例：**
+```json
+{
+  "model": "claude-3-sonnet-20240229",
+  "max_tokens": 1024,
+  "messages": [
+    {"role": "user", "content": "你好"}
+  ],
+  "stream": false
+}
+```
+
+**响应示例：**
+```json
+{
+  "id": "msg-xxx",
+  "type": "message",
+  "role": "assistant",
+  "content": [
+    {
+      "type": "text",
+      "text": "你好！我是 Claude，很高兴为你服务。"
+    }
+  ],
+  "stop_reason": "end_turn",
+  "stop_sequence": null,
+  "usage": {
+    "input_tokens": 10,
+    "output_tokens": 20
+  }
+}
+```
+
+### 错误码说明
+
+| HTTP 状态码 | 错误类型 | 说明 |
+|------------|---------|------|
+| 400 | `invalid_request_error` | 请求参数错误 |
+| 401 | `authentication_error` | API Key 无效或缺失 |
+| 404 | `not_found_error` | 资源不存在 |
+| 429 | `rate_limit_error` | 请求频率超限 |
+| 500 | `server_error` | 服务器内部错误 |
+| 503 | `overloaded_error` | 服务过载，无可用候选项 |
+
+### 完整 API 文档
+
+启动服务后访问 `http://localhost:1337/` 通过内置 WebUI 的「模型」与「配置」选项卡查看接口清单与能力矩阵。
+
+---
+
+## 🧪 测试指南
+
+### 运行测试
+
+```bash
+# 运行所有测试
+pytest tests/
+
+# 运行特定测试文件
+pytest tests/test_gateway.py
+
+# 运行特定测试函数
+pytest tests/test_gateway.py::test_dispatch
+
+# 生成覆盖率报告
+pytest --cov=src tests/
+```
+
+### 平台独立测试
+
+每个平台都提供独立的 `test.py` 测试脚本：
+
+```bash
+# 测试 Qwen 平台
+cd src/platforms/qwen
+python test.py
+
+# 测试 DeepSeek 平台
+cd src/platforms/deepseek
+python test.py
+```
+
+### 测试覆盖率要求
+
+| 类型 | 最低覆盖率 |
+|------|:---------:|
+| 语句覆盖 | 70% |
+| 分支覆盖 | 60% |
+| 函数覆盖 | 80% |
+
+---
+
+## 📝 开发指南
+
+### 开发状态
+
+> ⚠️ **项目状态：Alpha 2.1 - 活跃开发中**
+>
+> 本项目正处于**活跃开发阶段**，代码和文档持续更新中。
+>
+> **贡献者请注意**：
+> - 请将 Pull Request 提交到 **`dev` 分支**
+> - `main` 分支仅用于稳定版本发布
+> - 新功能开发请基于 `dev` 分支创建功能分支
+
+### 开发环境搭建
+
+```bash
+# 1. Fork 并克隆项目
+git clone https://github.com/你的用户名/provider-v2.git
+cd provider-v2
+
+# 2. 添加上游仓库
+git remote add upstream https://github.com/nichengfuben/provider-v2.git
+
+# 3. 切换到 dev 分支
+git checkout dev
+
+# 4. 创建功能分支
+git checkout -b feature/你的功能名
+
+# 5. 安装开发依赖
+pip install -r requirements.txt
+pip install pytest pytest-cov black isort mypy
+
+# 6. 运行测试确保环境正常
+pytest tests/
+```
+
+### 代码规范
+
+- 遵循 PEP 8 代码风格
+- 使用 `black` 进行格式化：`black src/`
+- 使用 `isort` 进行导入排序：`isort src/`
+- 使用 `mypy` 进行类型检查：`mypy src/`
+- 添加类型注解
+- 编写中文注释和文档字符串
+- **不使用 f-string**，使用 `str.format()` 保持 Python 3.8 兼容
+
+### Git 提交规范
+
+采用 [Conventional Commits](https://conventionalcommits.org/) 规范：
+
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer]
+```
+
+**Type 类型：**
+| 类型 | 说明 |
+|------|------|
+| `feat` | 新功能 |
+| `fix` | Bug 修复 |
+| `docs` | 文档更新 |
+| `style` | 代码格式调整 |
+| `refactor` | 重构 |
+| `test` | 测试相关 |
+| `chore` | 构建/工具相关 |
+
+**示例：**
+```
+feat(qwen): 添加 qwen3.5-122b 模型支持
+
+- 更新 MODELS 列表
+- 调整 max_tokens 限制
+
+fix(gateway): 修复并发竞速时 token 计数错误
+```
+
+### 分支命名规范
+
+| 分支类型 | 命名格式 | 示例 |
+|----------|----------|------|
+| 功能分支 | `feature/xxx` | `feature/qwen-new-model` |
+| 修复分支 | `fix/xxx` | `fix/gateway-timeout` |
+| 文档分支 | `docs/xxx` | `docs/api-update` |
+| 重构分支 | `refactor/xxx` | `refactor/selector` |
+
+### 添加新平台适配器
+
+参考 [平台适配器开发指南](docs-src/src/platforms/guide.md) 了解如何添加新平台支持。
+
+---
+
+## 🗺️ 路线图
+
+### 当前版本：v2.2.266
+
+✅ 已完成（v2.2.234）：
+- fix(webui): rewrite log panel with structured rendering, module colors, mobile layout, and smart auto-scroll
+
+✅ 已完成（v2.2.232）：
+- fix(terminal): add legacy base64 data URL to server-side file migration
+- test(core): fix ModelsCache test to match ListCache init behavior (fallback only, explicit load required)
+- refactor(dispatch): update Registry tests to match new plugin-based API
+
+✅ 已完成（v2.2.231）：
+- refactor(webui): migrate request logs from JSON to SQLite persistence
+- fix(webui): terminal tab add button always visible regardless of tab count
+- fix(webui): close-all button repositioned to avoid overlapping the add button
+- feat(terminal): add custom background image support with opacity control and pseudo-element rendering
+- fix(terminal): resolve panel positioning issue when switching tabs (remove display:flex !important)
+- fix(terminal): enhance DEC response stripping for cross-message handling
+
+✅ 已完成（v2.2.221）：
+- refactor(webui): replace native prompt/confirm dialogs with custom input/confirm components for terminal rename, restart confirmation, and new folder creation
+
+✅ 已完成（v2.2.220）：
+- fix(terminal): resolve terminal height overflow with precise flex layout and viewport-constrained sizing
+- fix(qwen): add `supported_models` property to QwenAdapter for runtime model count reporting
+- feat(terminal): improve session recovery with read-only reattach and offline output consumption
+- feat(terminal): add background mode toggle button for terminal UI
+- refactor(terminal): optimize terminal container layout with flex-based sizing
+
+✅ 已完成（v2.2.213）：
+- feat(terminal): migrate terminal system to T3 Code architecture
+  - Added shell fallback chains for cross-platform compatibility (Windows: pwsh.exe → PowerShell → cmd.exe; POSIX: $SHELL → zsh → bash → sh)
+  - Added output sanitization for clean history management
+  - Added subprocess monitoring with metadata events
+  - Added history management with 5000-line limit
+  - Added clear history and restart terminal operations
+  - Added subprocess indicator showing running command name in tab title
+  - Added terminal configuration options (max_history_lines, subprocess_monitor_interval, enable_subprocess_monitoring)
+  - Updated frontend with Clear History and Restart buttons in context menu
+  - Updated WebSocket protocol with clear, restart, and metadata messages
+  - All tests passing, documentation updated
+
+✅ 已完成（v2.2.209）：
+- fix(routes): accept enable_thinking from extra_body for thinking mode
+  - Updated thinking parameter handling in src/routes/openai_chat.py to accept both "thinking" and "enable_thinking" from extra_body
+
+✅ 已完成（v2.2.207）：
+- feat(opencode): enable proxy fetch and update RECORD.md
+  - Changed PROXY_FETCH_ENABLED from False to True in opencode constants
+  - Updated RECORD.md with brotli entry from previous session
+
+✅ 已完成（v2.2.206）：
+- fix(deps): add brotli for brotli decompression support
+  - aiohttp requires brotli to decode brotli-compressed responses from opencode and zen APIs
+
+✅ 已完成（v2.2.205）：
+
+- refactor(qwen): extract crypto/file_objects/io_utils/headers modules from shared.py
+- refactor(fncall): restructure parsers, protocols, prompt, and shared subpackages
+- refactor(core): extract utils subpackage (files/ids/io_utils/retry/scheduler)
+- refactor(config): extract base config module
+- refactor(dispatch): extract dispatch __init__ facade
+- refactor(webui): extract request_log service module
+
+✅ 已完成（v2.2.204）：
+- refactor(errors): add to_dict() serialization to all ProviderError subclasses
+- refactor(errors): fix ServerError to pass actual upstream status code instead of hardcoded 502
+- refactor(errors): centralize context-length detection keywords as bilingual frozenset
+- refactor(config): remove __getattr__ proxy from ConfigManager, deduplicate color-setting code
+
+✅ 已完成（v2.2.203）：
+- refactor(core): remove shims and slim down core public API
+- Add pyproject.toml for project packaging configuration
+- Remove src/core/shims.py backward-compatibility layer
+- Slim src/core/__init__.py from 203 to 25 lines, exposing only 7 core symbols
+- Mirror changes in docs-src/src/core/
+
+✅ 已完成（v2.2.202）：
+- refactor(main): Extract _setup_signal_handlers, _create_background_tasks, _shutdown from _run()
+- refactor(main): Narrow broad except Exception to specific exception types
+- refactor(base): Extract DEFAULT_CONTEXT_LENGTH, MODERATION_CATEGORIES, MODERATION_CATEGORY_SCORES constants
+- fix(webui): Fix import order (from __future__ import annotations after docstring)
+
+✅ 已完成（v2.2.201）：
+- fix(opencode): MAX_RETRIES 从 50 降至 3，避免无效重试消耗
+
+✅ 已完成（v2.2.200）：
+- fix(opencode): 修复 `_do_request()` 中 `record_success` 在异步生成器中断时不执行的问题，改用 `_request_ok` 标志 + `finally` 块确保评分记录
+- fix(opencode): 更新常量定义
+
+✅ 已完成（v2.2.198）：
+- fix(ollama): 修复 `detect_capabilities()` 和 `_verify_server()` 中 `.get()` 返回 `None` 导致 `'NoneType' object is not iterable` 的问题
+
+✅ 已完成（v2.2.197）：
+- refactor(routes): 拆分 `routes/openai.py`（2153 行）为 5 个聚焦子模块
+- refactor(qwen): 通过 mixin 模式拆分 QwenClient（2613 行）为 5 个模块
+- refactor(logging): 迁移 49 个平台适配器文件从 stdlib logging 到 loguru
+- feat(selector): 新增 stale candidate 自动清理功能（默认 30 天阈值）
+- fix(webui): 修复剪贴板 API 在 HTTP 环境下的兼容性（3 个 JS 文件）
+- chore(deps): 移除未使用的 tqdm 和 brotli 依赖
+- docs: 新增 ADR-006 至 ADR-013，修复 README 技术栈表（移除错误的 uvicorn 条目）
+
+✅ 已完成（v2.2.196）：
+- refactor(core): 将 `server/` 子包合并为单个 `server.py` 文件，更新全部导入路径
+- fix(main): asyncio WindowsSelectorEventLoopPolicy 添加 Python 版本守卫，兼容 3.8-3.14
+- fix(opencode): `fetch_remote_models` 改为直连，不再通过代理获取模型列表
+
+✅ 已完成（v2.2.194）：
+- fix(core): 在 `__init__.py` 中添加 sys.modules 向后兼容别名，修复旧模块路径导入失败
+
+✅ 已完成（v2.2.193）：
+- fix(core): 更新 `__init__.py` 导入 — `http_request/stream_request` 替换为 `clean_fncall/safe_flush`，`with_retry` 替换为 `retry_with_backoff`
+
+✅ 已完成（v2.2.192）：
+- feat(fncall): 新增 DSML 工具调用协议支持（echotools 升级至 1.0.32）
+- refactor(core): 合并 16 个兼容 shim 文件至 shims.py 模块，减少 59% 文件数量
+
+✅ 已完成（v2.2.191）：
+- Ollama 平台新增 FILTER_CLOUD_MODELS 常量（默认 True），服务器扫描时过滤 :cloud 后缀的付费云端模型，过滤发生在注册表构建前
+
+✅ 已完成（v2.2.190）：
+- WebUI 文件面板懒加载：后端 offset/limit 分页 + os.scandir 性能优化，前端滚动触发按批次加载（每批 200 条），CSS 加载指示器动画
+
+✅ 已完成（v2.2.189）：
+- opencode HTTP 429 改为可重试，触发 TAS 代理切换重试
+- opencode 支持从 accounts.py 注入本地代理（LOCAL_PROXIES），启动和每次刷新时合并到代理池参与 TAS 选择
+
+✅ 已完成（v2.2.187）：
+- opencode 连接重试修复：连接断开/负载截断时不再中止，所有连接错误均触发 TAS 选择新代理重试；仅 PlatformError 为不可重试异常
+- echotools 升级到 1.0.30：自动更新合并冲突自修复（merge abort 检测）、hard reset 回退、暂存恢复（stash pop）、祖先检查（ancestry check）
+
+✅ 已完成（v2.2.186）：
+- opencode 平台改为单候选项模式，代理选择完全由平台内部 TAS 处理（包括首次尝试）
+- 代理池抓取日志全部从 INFO 降为 DEBUG，减少运行时日志噪音
+
+✅ 已完成（v2.2.185）：
+- opencode 平台重试逻辑优化：每次重试用 TAS 选择器轮换到不同代理，排除上次失败的代理
+
+✅ 已完成（v2.2.184）：
+- opencode 平台重试逻辑重构：50 次重试、1 秒固定延迟、远程断开/负载截断时立即中止，MAX_RETRIES 常量移至 constants.py
+
+✅ 已完成（v2.2.183）：
+- 新增 opencode 平台适配器 — proxy-pool 架构，无需 API Key，TAS 式代理评分选择器，6 个 free 模型，native_tools 支持
+
+✅ 已完成（v2.2.182）：
+- 终端 WebSocket 修复：本地/SSH 终端启动失败时向客户端发送明确错误信息
+
+✅ 已完成（v2.2.181）：
+- 自动更新修复：应用更新时改用镜像源拉取并支持本地未提交变更自动暂存恢复
+- 日志级别调整：zen 平台初始化与 Worker 启动日志降为 DEBUG
+
+✅ 已完成（v2.2.180）：
+- 架构审计修复：裸 except 块添加 debug 日志 + 创建 PROJECT_DECISIONS.md（5 条 ADR）
+- 异常处理加固：terminal_sessions/terminal router/request_log 共 12 处裸 except 块缩窄为具体异常类型，Unexpected 兜底升为 WARNING
+- 聊天面板 JS 重构：工具调用 HTML 提取为 _buildToolCallsHtml、模型协议选择独立持久化、loadChatState try/finally 守卫
+
+✅ 已完成（v2.2.178）：
+- echotools 升级到 1.0.29：终端会话生命周期日志降级为 debug（ConPTY started/attached/killed）
+
+✅ 已完成（v2.2.177）：
+- 聊天面板持久化修复：工具调用参数刷新后可展开、模型与协议选择刷新后保留
+
+✅ 已完成（v2.2.176）：
+- echotools 升级到 1.0.28：修复 Linux/macOS 终端 WebSocket 连接失败（Unix PTY 启动移到线程池 + shell 候选链 + select 超时读取）
+
+✅ 已完成（v2.2.175）：
+- 终端 + 按钮重新设计：点击立即创建 chooser 标签页（类 Chrome 新标签），页内选本地/远程终端
+
+✅ 已完成（v2.2.174）：
+- 终端标签恢复加速：_restPreFetch 并行探测 + _discoveryProcessed 防竞态；每 tab attach 延迟去除
+- 终端 CSI 泄漏防御：_stripDecResponses 加 null-safe 守卫，覆盖所有 xterm.write 入口
+- 光标错位/双光标修复：_initTerminal 顶部完整 dispose 守卫 + 孤儿 DOM 清理 + fitAddon.dispose
+- 文件管理器 confirm() 替换为 showConfirmDialog 自定义对话框（_deleteEntries、_cancelEdit 两处）
+
+✅ 已完成（v2.2.173）：
+- 修复页面刷新后标签消失：终端从 existing_sessions 重建并 attach；文件标签用 activeTabIndex 鲁棒恢复
+
+✅ 已完成（v2.2.172）：
+- 修复终端字符交错双写与 CSI 响应泄漏：删除 terminal.py 重复回调，过滤 DEC private mode 响应
+- 恢复侧边栏压缩按钮为迁移前原始设计：全宽按钮置顶，替换 24x24 绝对定位小方块
+- 终端与文件侧边栏联动压缩：onToggleCollapsed 回调同步 window._tabBars 所有实例
+
+✅ 已完成（v2.2.171）：
+- 终端会话持久化与进程保活（Phase 0）：WS 断连不杀进程，主动关闭才终止；多客户端同时挂载；重启自动恢复存活会话
+- echotools 1.0.27：LocalTerminal 新增 detach/attach/kill API，离线输出缓冲，recover_sessions 重启挂载
+- 文件管理器迁移到统一 TabBar（Phase 1b），压缩态显示文件夹图标（修圆点痛点）
+
+✅ 已完成（v2.2.170）：
+- WebUI 文件管理器默认目录改为项目根（main.py 所在目录），保留任意目录导航能力
+
+✅ 已完成（v2.2.169）：
+- WebUI 终端前端全量重写：自定义 DOM ANSI 渲染器迁移到 @xterm/xterm 5.5.0 + @xterm/addon-fit
+- 删除 ~720 行自写 ANSI 解析、SGR、光标、DOM 渲染代码；删除 LOCAL_ECHO 与行回显剥离
+- xterm.js 通过 CDN 懒加载（lazy.js 注入 TAB_RESOURCES.terminal）
+- 键盘输入由 xterm.js 内部 textarea 原生捕获，不再依赖 document 级 keydown 捕获
+
+✅ 已完成（v2.2.168）：
+- WebUI 终端升级 ConPTY：echotools 1.0.26 新增 Windows ConPTY 后端，支持 cls/color/ANSI/resize
+- 终端前后端模式协商：后端发送 mode 消息，前端动态开关本地回显
+- 文件管理器 UI 全中文化：64 处英文标签统一为中文
+
+✅ 已完成（v2.2.167）：
+- WebUI 终端禁用路径超链接渲染：输出纯文本，与原生终端体验一致
+
+✅ 已完成（v2.2.166）：
+- Qwen 平台登录失败日志聚合：60 秒窗口缓冲，单条 WARNING 输出 "first*** and N other account(s)"
+- Qwen 登录端点不可达时熔断：跳过本批次剩余账号，避免刷屏
+
+✅ 已完成（v2.2.165）：
+- WebUI 文件管理器完全解锁：支持浏览整个文件系统，Windows 枚举盘符，Linux 直达根目录，新增项目根快捷按钮
+- WebUI 终端全量本地回显：修复 Windows PIPE I/O 下输入不可见，修正 Enter 行终止为 \r\n，修复提示符误染蓝色
+
+✅ 已完成（v2.2.164）：
+- 修正 zen 平台日志 format 字符串（{} → %d/%s），修复占位符原样输出 bug
+- ollama 平台空网络发现日志从 WARNING 降级为 DEBUG
+
+✅ 已完成（v2.2.163）：
+- 新增 native_tools 能力 — 平台可声明原生工具调用支持，跳过 inject_fncall 直接传递 tools
+- zen 平台声明 native_tools=True，流式 tool_calls delta 累积，语法高亮文件预览
+
+✅ 已完成（v2.2.162）：
+- WebUI 文件管理器全面增强：文件编辑（行号/Ctrl+S/脏跟踪）、上传（按钮+拖拽）、复制移动（剪贴板 Ctrl+C/X/V）、目录搜索（300ms 防抖）
+- 终端与文件管理器联动：右键在终端打开、终端输出路径可点击跳转文件管理器
+
+✅ 已完成（v2.2.161）：
+- 新增 zen 平台适配器 — OpenCode.ai API，Bearer 认证，SSE 流式，reasoning→thinking 映射，自动模型获取
+
+✅ 已完成（v2.2.160）：
+- 恢复静态资源 no-cache 缓存策略，撤销 max-age=3600 以避免浏览器缓存旧版 JS/CSS
+
+✅ 已完成（v2.2.159）：
+- persist_get 文件不存在时返回 200 null 而非 404，消除控制台报错
+- index.html 添加 console.warn 过滤器抑制 Tailwind CDN 生产环境警告
+
+✅ 已完成（v2.2.158）：
+- echotools 1.0.25：修复 Windows asyncio ProactorEventLoop ConnectionResetError（终端关闭时 [WinError 10054] 日志噪音）
+
+✅ 已完成（v2.2.157）：
+- 终端键盘捕获改为 document 级别 capture phase，不依赖元素焦点，只要终端标签页可见即捕获
+
+✅ 已完成（v2.2.156）：
+- 修复终端键盘输入：移除 textarea 输入层，改用 wrapper div keydown 直接捕获所有按键
+
+✅ 已完成（v2.2.155）：
+- 修复终端 Enter 键在 Windows 下不执行命令的问题（CRLF 兼容）
+
+✅ 已完成（v2.2.154）：
+- Qwen 重试日志改为缓冲聚合输出（DEBUG 级别）
+- WebUI 终端重写：移除 xterm.js，自研轻量终端渲染器
+- echotools 新增 terminal 模块（v1.0.24），终端逻辑下沉为通用组件
+
+✅ 已完成（v2.2.153）：
+- WebUI 静态资源懒加载：按标签页延迟加载 JS/CSS，初始负载从 ~335KB 降至 ~100KB
+- 新增 LazyLoader 模块，xterm.js CDN 从预加载改为按需加载
+- 静态资源缓存策略优化（no-cache → 1 小时缓存）
+
+✅ 已完成（v2.2.152）：
+- 聊天历史加载添加调试日志和逐条错误处理，定位首条助手消息消失问题
+
+✅ 已完成（v2.2.151）：
+- 修复聊天历史加载竞态：sendChatMessage 等待 loadChatState 完成后再读取历史
+
+✅ 已完成（v2.2.150）：
+- 聊天工具定义持久化（保存到 persist/webui/tools.json，页面加载自动恢复）
+
+✅ 已完成（v2.2.149）：
+- 代码块渲染重构：JS Map 存储避免属性转义截断、独立 preview 容器、折叠/展开按钮、完整 CSS 样式
+
+✅ 已完成（v2.2.148）：
+- 代码块选项卡默认 code（仅 HTML 显示 preview）、流式代码块解析支持未闭合反引号、请求日志持久化
+
+✅ 已完成（v2.2.147）：
+- WebUI 日志 ANSI 颜色、聊天加载动画与 Send→Stop、工具调用持久化修复、流式渲染优化、便携面板交互改进
+
+✅ 已完成（v2.2.146）：
+- WebUI 便携设置持久化从 config.json 迁移到 config.toml，后端 persist API 支持 TOML 格式
+
+✅ 已完成（v2.2.145）：
+- Qwen 排队重登日志聚合：60 秒缓冲窗口，多账号 token 无效时合并为单条日志输出
+
+✅ 已完成（v2.2.144）：
+- Windows 终端改用 asyncio subprocess（非阻塞 I/O）；移除 WebUI 自构日志（仅保留后端 WebSocket 日志转发）
+
+✅ 已完成（v2.2.142）：
+- 修复运行日志行号顺序（最新条目 #1 在顶部，向下递增）
+
+✅ 已完成（v2.2.141）：
+- 终端退格键修复（DEL→BS 转换）、全部关闭浮动按钮（标签>5时显示）、Windows 终端改用 cmd.exe + UTF-8
+
+✅ 已完成（v2.2.140）：
+- Windows 终端改用 PowerShell + 块读取 + 修复 write_input lambda 闭包；竖向标签栏加号 sticky 底部
+
+✅ 已完成（v2.2.139）：
+- 修复竖向标签栏展开/压缩模式加号按钮纵向位置不一致
+
+✅ 已完成（v2.2.138）：
+- 修复标签栏侧边切换按钮消失（renderTabBar 保留 toggle 按钮）、竖向布局加号居中、终端点击聚焦输入
+
+✅ 已完成（v2.2.137）：
+- 修复 STT/TTS 模型下拉菜单无法识别模型（TTS 使用 audio_gen 能力、STT 使用 chat+vision 多模态能力）
+
+✅ 已完成（v2.2.136）：
+- 修复终端选项卡不显示（switchTab 未移除 hidden 类）；修复 Markdown 渲染多余空行（块级元素后不插入 br）
+
+✅ 已完成（v2.2.135）：
+- Ollama 服务器发现使用代理获取、网络故障时保留缓存不覆盖、发现日志降为 DEBUG、WebUI 日志渲染匹配控制台格式
+
+✅ 已完成（v2.2.134）：
+- 新增标签栏布局切换（横向顶部/竖向侧边），竖向支持展开/压缩形态，设置持久化到 persist/webui/config.json
+
+✅ 已完成（v2.2.133）：
+- 终端选项卡 UI 文本全面汉化（标签名、右键菜单、SSH 对话框、验证提示、终端输出消息、空状态）
+
+✅ 已完成（v2.2.132）：
+- 日志面板性能优化（O(1) DOM 更新替代全量重建）；录音设备面板打开时刷新设备列表
+
+✅ 已完成（v2.2.131）：
+- 新增文件管理器选项卡：目录浏览、多标签管理、面包屑导航、右键菜单、文件预览、下载、会话持久化
+
+✅ 已完成（v2.2.130）：
+- 模型下拉菜单按能力过滤：聊天面板仅显示 chat 模型，STT/TTS 下拉仅显示对应能力模型
+
+✅ 已完成（v2.2.129）：
+- 修复 record_prompt 不生效（gateway 导入路径修正）、日志双重时间戳、toast 恢复右下角、Qwen 定时任务持久化执行时间
+
+✅ 已完成（v2.2.128）：
+- WebUI 10 项修复：复选框渲染、镜像源拖拽排序、配置下拉菜单自定义组件、diff 左右对比+分支下拉、主题切换分离、语音按钮亮色模式、静音自动停止录音、录音停止修复
+
+✅ 已完成（v2.2.127）：
+- 修复更新面板复选框不显示（CSS input reset 排除 checkbox）、toast 移至左下角、zip 脚本自动替换 color=false、deepseek/ollama 初始化不阻塞
+
+✅ 已完成（v2.2.126）：
+- 请求检查器详情弹窗新增复制按钮（响应内容 + 请求消息），支持流式更新时保留
+
+✅ 已完成（v2.2.125）：
+- 通用逻辑下沉到 echotools 1.0.23（KeyState/KeyPool、translate 工具、ProxySelector、异步生成器重试），provider-self 代码复用 ~400 行精简
+
+✅ 已完成（v2.2.124）：
+- 新增 4 个翻译平台：DeepL、Google Translate（免费公共 API）、Yandex Translate、Azure Translator
+
+✅ 已完成（v2.2.123）：
+- 聊天文件附件改为文件卡片显示（图标+名称+大小）；统计数据服务端持久化（30秒定时+启停保存，修复运行时间等数据丢失）
+
+✅ 已完成（v2.2.122）：
+- 新增终端选项卡：本地终端（pty/cmd）+ SSH 远程终端（paramiko），xterm.js 多标签管理，右键菜单，SSH 连接持久化
+
+✅ 已完成（v2.2.121）：
+- WebUI 五项修复：录音设备选择器、日志 ANSI 颜色+行号、统计/聊天持久化、Markdown 渲染+原始复制、信息框边框移除
+
+✅ 已完成（v2.2.120）：
+- 更新面板修复：文件复选框正常显示、确认/取消按钮、搜索框（>5 文件时自动出现）、已选计数
+
+✅ 已完成（v2.2.119）：
+- 修复 Windows 下 Runner 进程日志无颜色（colorama 包装 stderr 确保 VTP 启用 + isatty 检测改为 stderr）
+
+✅ 已完成（v2.2.118）：
+- 请求日志每页调整为 7 条，搜索框始终显示
+
+✅ 已完成（v2.2.117）：
+- 请求日志分页（每页 5 条、页码输入框 + /{n}、搜索框 >5 条时自动显示）
+
+✅ 已完成（v2.2.116）：
+- 修复 Qwen 平台热重载失败（echotools 插件发现支持 __getattr__ 懒加载 + watcher 平台分类修复）
+
+✅ 已完成（v2.2.115）：
+- 新增智能代理选择器（src/core/proxy_selector.py），TAS 式 4 维评分（失败次数、最近成功、延迟 EMA、总调用数），Qwen 平台集成，代理状态独立持久化
+
+✅ 已完成（v2.2.114）：
+- 所有平台启动日志从 INFO 降为 DEBUG（config manager + 9 个平台客户端/适配器）
+
+✅ 已完成（v2.2.113）：
+- Qwen 平台登录逻辑重写：统一轮询式登录替代并发批量登录，智能选择算法（最旧100→随机15-30→取10顺序登录），login+settings 统一，代理支持
+
+✅ 已完成（v2.2.112）：
+- 修复端口占用检测竞态条件（echotools 升级至 1.0.20，添加 taskkill 后重试等待）及 main.py 错误信息与实际配置不一致
+
+✅ 已完成（v2.2.111）：
+- 请求检查器卡片支持点击弹出详情对话框（完整消息 JSON、响应内容、元数据），卡片显示截断摘要
+
+✅ 已完成（v2.2.110）：
+- WebUI 聊天错误消息与正常助手消息完全一致（无任何视觉区分），输入框始终固定在聊天面板底部
+
+✅ 已完成（v2.2.109）：
+- WebUI 聊天错误消息改为助手消息气泡样式，不再使用独立错误提示框
+
+✅ 已完成（v2.2.108）：
+- 修复非流式补全路径 NameError: resp 未定义（移除错误的 resp._platform 赋值）
+
+✅ 已完成（v2.2.107）：
+- 配置保存防覆写改用时间戳守卫（5 秒窗口），比单次 boolean 更可靠
+
+✅ 已完成（v2.2.106）：
+- 修复配置保存后被 refreshAll 覆写回原样的问题（configDirty 检查 + _skipNextConfigRender 标记）
+
+✅ 已完成（v2.2.105）：
+- 新增 MappingEditor 键值对编辑器组件（替代 JSON textarea），用于 fncall_mapping 和 model_mapping
+
+✅ 已完成（v2.2.104）：
+- 配置组件溢出修复：输入框弹性宽度 + _fieldBlock 纵向布局（列表/JSON 编辑器全宽显示）
+
+✅ 已完成（v2.2.103）：
+- 配置 JSON 编辑器修复：textarea 只在失焦时提交（不再每次按键 parse），防止事件重复绑定
+
+✅ 已完成（v2.2.102）：
+- 配置标签页重写为组件化架构：Toggle/Number/Text/Select/StringList/JsonEditor 六种组件，每个配置段独立渲染器
+
+✅ 已完成（v2.2.101）：
+- config_get 添加 tomli 回退兼容 Python < 3.11
+
+✅ 已完成（v2.2.100）：
+- 聊天工具参数切换改用 document 级全局事件委托，彻底修复点击无效
+
+✅ 已完成（v2.2.99）：
+- GET /v1/config 改为直接读取 config.toml（tomllib.load），返回与文件一致的结构
+
+✅ 已完成（v2.2.98）：
+- 聊天工具调用「查看参数/收起参数」改用事件委托 + style.display 切换（修复点击无效）
+
+✅ 已完成（v2.2.97）：
+- 请求检查器 Request Messages 折叠切换改用 addEventListener 事件委托（修复 inline onclick 失效）
+
+✅ 已完成（v2.2.96）：
+- WebUI 配置标签页改为从 /v1/config 加载真实配置（与 config.toml 结构一致），不再使用摘要 API 的简化版本
+
+✅ 已完成（v2.2.95）：
+- WebUI 聊天调试日志：发送时显示消息数量和角色
+- reasoning_content 捕获并保存到对话历史，防止思考内容丢失导致上下文断裂
+
+✅ 已完成（v2.2.94）：
+- openaifm 导入修复：util.py 移除已删除的 DEFAULT_MODEL 引用，恢复平台加载
+
+✅ 已完成（v2.2.93）：
+- openaifm 候选项构建移除对 accounts.py（gitignored）的依赖，始终生成 1 个候选项
+
+✅ 已完成（v2.2.92）：
+- openaifm 平台修复：无需认证（单占位候选项）、表单字段修正（input/prompt/voice/vibe）、multipart/form-data、移除无效 auth
+
+✅ 已完成（v2.2.91）：
+- chatmoe 平台增强：配置 UUID Key + Authorization: Key 格式
+- SSE 解析重写：支持 event/data/id 行 + X-Stream-Id 捕获
+- 新增 abort_stream（停止生成）和 resume_stream（继续生成）
+- 定时 Key 重新生成（每 24 小时，类似 qwen 定时登录）
+- 新增 flash-lite 模型
+
+✅ 已完成（v2.2.90）：
+- 移除自动更新中错误的嵌套协议检查，允许代理镜像 URL 正常拼接
+
+✅ 已完成（v2.2.89）：
+- 侧栏标签文字简化：「自动更新」→「更新」，「聊天测试」→「聊天」
+
+✅ 已完成（v2.2.88）：
+- 请求检查器流式内容改为路由层直接推送到 broker（绕过中间件收集器）
+- 中间件 request_start 事件新增 messages 字段（原始请求消息）
+- 请求详情新增可折叠的 Request Messages 区域显示原始请求 JSON
+- echotools 升级至 1.0.19
+
+✅ 已完成（v2.2.87）：
+- 修复自动更新 URL 污染 bug：_fetch_from_mirrors 改为 try/finally 保存恢复原始 remote URL
+- 新增 _extract_repo_path() 函数清理嵌套协议前缀（regex 去重）
+- 构造的 URL 含多个 :// 时直接跳过
+
+✅ 已完成（v2.2.86）：
+- echotools 升级至 1.0.18：中间件跳过 GET 请求 + request 级别 chunk 收集器修复请求检查器
+- requirements.txt 更新为 echotools>=1.0.18
+
+✅ 已完成（v2.2.85）：
+- 新增 SortableList 可排序列表组件（上下箭头 + 删除，来自 echotools）
+- 自动更新镜像源列表改用 SortableList 组件替代旧的数字优先级输入
+
+✅ 已完成（v2.2.84）：
+- 自动更新检查结果支持文件 diff 预览：点击文件名弹出彩色 diff 对话框
+- 新增 POST /v1/admin/autoupdate/diff 接口返回单文件变更
+- 自动更新应用后自动热重载配置
+
+✅ 已完成（v2.2.83）：
+- 请求检查器修复：流式响应内容改用 request 级别 chunk 收集器，路由层推入中间件广播
+- 跳过 GET 请求（/v1/models 等），仅捕获 POST API 调用
+
+✅ 已完成（v2.2.82）：
+- 便携设置 STT/TTS 模型改为下拉选择菜单（从 /v1/models 加载）
+- TTS 引导 Prompt 新增「恢复默认」按钮，从 prompts/tts_default.prompt 加载模板
+- 新增 /prompts/ 静态路由服务 prompt 模板文件
+
+✅ 已完成（v2.2.81）：
+- 语音输入波形 GIF 改为 base64 内嵌（与 echotools 一致），移除外部 waveform_64x64.gif 文件依赖
+
+✅ 已完成（v2.2.80）：
+- 语音输入录音时按钮替换为波形 GIF 动画，录音结束后恢复原按钮内容
+
+✅ 已完成（v2.2.79）：
+- 批量测试统计：首包延迟、总耗时、Tokens、TPS 实时显示
+- 结果卡片点击展开详情对话框，支持实时流式内容更新（200ms 轮询）
+- 批量测试空 prompt 时使用默认 prompt 而非报错
+
+✅ 已完成（v2.2.78）：
+- 配置 Tab 补全：新增 fncall 和 autoupdate 段，debug 段补充 color/access_log
+- WebUI 自动滑动修复：.webui-content 改为滚动容器，切换 Tab 时滚动到顶部
+
+✅ 已完成（v2.2.77）：
+- 批量测试工具定义生效：自动收集工具定义并注入请求
+- 批量测试结果卡片可点击展开详情对话框（显示完整 Prompt + 响应）
+- chatTestReport 移入 batchTestSection 内部，收起时一并隐藏
+
+✅ 已完成（v2.2.76）：
+- WebUI 批量测试改为点击展开模式（默认隐藏参数表单）
+- Tab 切换滚动位置修复：滚动到右侧内容容器底部而非页面顶部
+
+✅ 已完成（v2.2.75）：
+- WebUI 批量测试重设计为 OpenAI Batch 风格：参数表单（Temperature/MaxTokens/SystemPrompt）+ 实时流式结果展示
+- 每个 prompt 独立卡片，流式内容实时更新
+- 工具调用检测 + 最终汇总
+
+✅ 已完成（v2.2.74）：
+- 通用逻辑下沉到 echotools：RequestStats、RequestBroker、stats_middleware 迁移到 echotools.web
+- provider-self 改为 echotools 薄包装（re-export），减少约 400 行重复代码
+- echotools 升级至 1.0.17
+
+✅ 已完成（v2.2.73）：
+- WebUI 批量测试：多行文本框输入多个 prompt，顺序提交并展示每个结果
+- 配置 Tab：过滤内部字段（group_list_set 等），界面更简洁
+- 自动更新差异文件选择：每个变更文件显示勾选框 + 全选/取消全选 + 选择性覆盖
+- 请求检查器流式捕获：中间件包装 response.write 捕获流式 chunks 并广播
+
+✅ 已完成（v2.2.72）：
+- 自动更新镜像源改进：默认使用基础 URL（如 `https://github.com/`），后端自动拼接仓库路径
+- 镜像源 UI 添加优先级数字输入框（带上下箭头），支持拖拽排序
+
+✅ 已完成（v2.2.71）：
+- InputBox 通用组件集成：替换旧聊天输入区，支持文件上传、语音输入、长文本自动转文件
+- 便携设置新增 STT/TTS 模型配置和 TTS 引导 Prompt（localStorage 持久化）
+- echotools 新增 web/input_box 组件（input-box.js + input-box.css）
+
+✅ 已完成（v2.2.70）：
+- 自动更新功能完善：差异更新（仅覆盖变更文件）、镜像源优先级配置、变更文件列表展示
+- 新增 `diff_update` 和 `mirrors` 配置字段
+- 新增 `POST /v1/admin/autoupdate/apply` API（差异 checkout / 全量 pull）
+- WebUI 自动更新 Tab 重写：toggle 开关 + 镜像源增删 + 检查结果面板 + 应用按钮
+
+✅ 已完成（v2.2.69）：
+- WebUI 配置 Tab 表单化：布尔值显示开关、字符串/数字显示输入框、列表/字典显示 JSON 文本域
+- WebUI 请求检查器：实时请求日志列表 + 详情面板，WebSocket 推送 request_start/end 事件
+- 新增 RequestBroker 服务（环形缓冲 100 条 + WebSocket 广播）
+- stats_middleware 增强：请求开始/结束时广播事件
+- 新增 API：GET /v1/webui/ws/requests（WebSocket）、GET /v1/webui/requests（REST）
+
+✅ 已完成（v2.2.68）：
+- 修复工具调用标签泄露到流式输出的 bug（safe_flush 未检测 buffer 本身是 trigger tag 前缀）
+- 修复 clean_fncall/safe_flush 使用 echotools 而非项目 wrapper 的 get_protocol（忽略 config 配置）
+- 修复非流式路径未传递 protocol_id 到 gateway 和 clean_fncall
+- 修复 Runner 进程重复加载配置（proxy._init 仅在 Worker 中加载）
+- ConfigManager.exit_after_merge=False 消除模板合并后的多余重启
+- echotools 升级到 1.0.14（NousProtocol 重写为真正的 Nous/Hermes 格式）
+
+✅ 已完成（v2.2.67）：
+- 修复工具协议选择未生效 bug：`get_protocol()` 现在自动从 `[fncall]` 配置读取默认协议和平台映射
+- `gateway.py` 改用项目薄包装版 `get_protocol`（自动读 config），不再直接用 echotools 版本
+
+✅ 已完成（v2.2.66）：
+- WebUI 新增「统计」Tab：请求量、错误率、延迟分位数、Token 用量、请求趋势 sparkline、状态码分布、Top 平台/模型排行、系统资源
+- 新增请求统计收集器（内存环形缓冲 + 时间桶聚合，零外部依赖）
+- 新增统计 API：`GET /v1/webui/stats` + `POST /v1/webui/stats/reset`
+- 新增统计中间件：自动记录 API 请求（platform/model/status/latency）
+- 前端模块化架构：`js/core/`（api.js, router.js）+ `js/features/`（stats.js）
+
+✅ 已完成（v2.2.65）：
+- 核心重构：`src/core/` 全面迁移至 `echotools` 包，减少约 6000 行重复代码
+- 新增 `echotools>=1.0.1` 依赖
+- 修复 `registry.py` 持久化路径计算错误（`.parent` 层级不足导致写入 `src/persist/`）
+- `[debug]` 启用彩色日志（`color = true`）
+
+✅ 已完成（v2.2.64）：
+- `src/logger.py` 新增 `_resolve_log_name()` 函数，日志文件名和默认 `module_name` 改为从 `config.toml` 的 `debug.log_name` 读取（默认 `provider-v2`）
+- `[debug]` 新增 `log_name` 配置项，支持自定义日志文件名前缀
+- 新增 `noobkeys` 平台适配器：OpenAI 兼容协议的纯文本对话中转，支持 Claude / GPT-OSS / Qwen / Kimi 共 9 个模型；SSE 解析兼容 `delta.reasoning` 与 `delta.reasoning_content`；按上游错误消息区分余额不足、鉴权失败与限速并分类处理
+
+✅ 已完成（v2.2.62）：
+- 修复并发竞速模式下 `inject_fncall()` 重复写入 prompt 文件：`_race()` 中 worker 启动前统一转储一次，worker 内部传 `dump_prompt=False` 抑制重复
+
+✅ 已完成（v2.2.61）：
+- TAS 候选项自动调优重构：基于 4 个核心变量（错误时间、调用时间、token 速度、首包延迟）的自适应评分系统，持久化到 persist/gateway/，权重自动学习
+
+✅ 已完成（v2.2.60）：
+- 移除 `_format_conversation_history()` 中的 `is_webui` 检测逻辑，始终渲染 assistant tool_calls 和 tool results，所有协议所有客户端统一处理；跳过无内容的空 assistant 块
+
+✅ 已完成（v2.2.59）：
+- 修复 `dispatch()` 无 tools 时 system 消息处理：将 `role=system` 消息折叠到第一条 user 消息，确保所有平台（包括不原生支持 system role 的平台如 Qwen）都能收到系统指令
+
+✅ 已完成（v2.2.58）：
+- 修复 `create_embeddings()` 路由：改用 `get_candidates(model=, capability=)` 双重过滤，优先选择有请求模型的服务器，回退到仅 capability 过滤保证可用性
+
+✅ 已完成（v2.2.57）：
+- `DYNAMIC_DISCOVERY` 设为 `False`，Ollama 使用已重建的持久化缓存（480 台服务器），不再执行网络抓取和定时刷新
+
+✅ 已完成（v2.2.56）：
+- 修复 `background_setup()` 在 `DYNAMIC_DISCOVERY=False` 时直接 return，不再调用 `_do_refresh(force=True)` 覆盖持久化缓存（此 bug 导致 480 台服务器缓存被清空）
+- `DYNAMIC_DISCOVERY` 临时恢复为 `True` 以重建被清空的缓存
+- `collect_servers()` 的 `skip_network` 参数保留供未来使用
+
+✅ 已完成（v2.2.55）：
+- Ollama candidates() 运行时 embedding 检测：添加模型名关键词检测覆盖缓存中过期的 `embedding: false`
+- Ollama collect_servers() 添加 skip_network 参数跳过网络抓取
+- Ollama background_setup() DYNAMIC_DISCOVERY=False 时仍验证 ACCOUNTS 本地服务器
+
+✅ 已完成（v2.2.54）：
+- Ollama 动态服务器发现关闭：`DYNAMIC_DISCOVERY` 设为 `False`，Ollama 平台仅使用持久化缓存中的服务器数据，不再执行网络抓取和定时刷新
+
+✅ 已完成（v2.2.53）：
+- 代理 localhost 直连修复：`_should_proxy_url()` 新增 `_LOCAL_HOSTS` 正则匹配 `localhost` 和 `*.localhost`，启用全局代理时本地地址不再被误判为需要代理，修复 Ollama 等本地服务连接失败问题
+- 日志颜色初始化修复：`_setup_handlers()` 尽早通过 tomllib 读取 `config.toml` 的 `debug.color`，确保首行日志就尊重 `color=false` 设置
+- Ollama 动态发现开关：新增 `DYNAMIC_DISCOVERY` 常量，为 False 时跳过网络服务器发现和定时刷新，仅使用持久化缓存
+
+✅ 已完成（v2.2.52）：
+- Ollama embedding 支持：OllamaAdapter/OllamaClient 新增 `create_embedding()` 调用 `/api/embed`；增强 `detect_capabilities()` embedding 模型名称关键词检测；修复 `_verify_server()` URL 格式 bug；添加 `EMBED_PATH` 常量和 CAPS embedding 声明
+- 日志颜色 bug 修复：`logger.py set_color()` 重建 console handler 使颜色变更立即生效；`main.py` Runner 读取 `config.toml` 决定 `CLICOLOR_FORCE`
+
+✅ 已完成（v2.2.51）：
+- 全平台合规审计与修正：18 个平台逐一对照 platform-guide 规范检查并修复偏差
+- `core/constants.py` 补齐：apiairforce、caiyuesbk、cerebras、chatmoe 四个平台提取内联常量至标准 `constants.py`（BASE_URL、MODELS、CAPS 等）
+- n1n 门面重写：`adapter.py` 从 783 行实现改为 5 行纯门面 re-export，`util.py` 引入 `__getattr__` 懒加载，常量统一从 `core/constants.py` 导入
+- qwen 常量集中化：`BASE_URL`/`USER_AGENT` 从 `shared.py` 移至 `core/constants.py`，消除重复定义
+- openaifm `util.py` 补齐 `MODELS`/`CAPS` 导出
+- ollama、perplexity 清理顶层死代码兼容 shim
+
+✅ 已完成（v2.2.48）：
+- fncall 全协议健康检查：6 个协议逐一审计插值完整性、参数一致性、schema 字段完整性、prompt 结构一致性、测试覆盖；`format_tool_descs` 已支持嵌套 object/array/oneOf/anyOf/allOf/additionalProperties 递归渲染（max_depth=4），无需改动；上游 tools 透传链路（openai/anthropic/gateway）完整无裁剪
+- original 协议 `render_prompt` 修复：`loop_warning` 参数此前被静默丢弃，现以 `<loop_warning>` XML 包装注入 prompt；该参数是工具调用死循环安全告警，所有协议都应无条件渲染
+
+✅ 已完成（v2.2.47）：
+- nous fncall 协议 `render_prompt` 修复：`'{tool_descs}\n\n'` 由普通字符串字面量改为拼接，工具定义（参数名/类型/必填/schema）现可正确注入 prompt；默认配置 `qwen = "nous"` 下所有工具调用请求此前均命中此 bug，模型只能靠报错摸索调用方式
+
+✅ 已完成（v2.2.46）：
+- aitianhu2 SSE 解析重写：移植上游 `_V1DeltaAccumulator`（228 行状态机），支持短键/长键双向规范化、字段继承、多通道并行、完整 JSONPatch op 集（add/replace/append/patch/truncate/remove）。**根因修复**：gpt-5.5 上游使用长键或省略重复字段时，旧解析器静默丢弃整段 antml 标签导致工具调用失效
+- `openai.py::_stream_chat` 标签检测改用 `proto.detect_start(buffer)`，兼容 `<antml:function_calls >` / 带属性等变体；不支持该方法的协议回退到严格 `trigger_tags` 匹配
+- 路由守卫放宽：delta 事件只要含 `o`/`op`/`p`/`path`/`v`/`value`/`c`/`channel` 任一即交状态机，仅有 `v` 靠继承的 delta 不再被丢弃
+
+✅ 已完成（v2.2.45）：
+- fncall `record_prompt` 字段激活：原字段定义在 `FncallCfg` 但全代码未读取，现作为 `print_prompt` 别名生效，两者任一为 `true` 都会把注入后的 prompt 落盘到 `logs/prompts/<uuid7>.txt`
+
+✅ 已完成（v2.2.44）：
+- antml fncall 解析：`_BLOCK_RE` 放宽以容忍 `<antml:function_calls >` / 带属性 / 换行等变体；`detect_start()` 同步放宽前缀匹配
+- 非流式 chat completions：即使网关未产出 `tool_calls` 块（请求未带 `tools` 或流式解析器漏掉），也对整段 content 再跑一次协议解析提取 tool_calls
+- aitianhu2 `chat.py::stream()` 增加 429 限流感知：解析 `please wait N seconds` 并抛结构化 `RateLimitError`；`client.py::complete()` 重试循环尊重上游冷却秒数
+- aitianhu2 `/conversation` 旧端点 fallback 补齐 `openai-sentinel-chat-requirements-token` 头
+
+✅ 已完成（v2.2.43）：
+- aitianhu2 多账号重构：每个 Account → 独立 `aiohttp.ClientSession` + cookie jar + device_id + 持久化条目；N 账号暴露 N 个 Candidate，限速失败时自动切换账号
+- aitianhu2 动态 `chatgpt-account-id`：`fetch_account_id()` 从 `/backend-api/accounts/check/v4-2023-04-27` 按 plan 优先级（team/plus/pro/business/enterprise）挑选；每个账号独立缓存 22h
+- aitianhu2 持久化 schema 升级：`state.json` 形如 `{accounts: {...}, carids: {...}}`；旧扁平格式按 `api_key_hint` 透明迁移
+- aitianhu2 CRITICAL bug 修复：`/f/conversation` 500 / 连接异常回退到旧 `/conversation` 端点；SSE 解析增加旧格式 `data["message"]`；`resolve_image` URL 检查放宽为 `not startswith("http")`
+- aitianhu2 models fetch 移除多余 `chatgpt-account-id` header
+- 所有服务（sentinel/chat/upload）的 `chatgpt-account-id` 改为方法参数，由账号级 `account_id` 驱动
+
+✅ 已完成（v2.2.42）：
+- `[gateway].group_list` 语义修正：名单决定"谁允许并发竞速"，不决定"谁能路由"；非名单内平台仍可路由但请求强制单发（n=1），竞速池需 ≥ 2 才启用并发
+
+✅ 已完成（v2.2.41）：
+- `[gateway]` 新增 `group_list_type`（whitelist/blacklist）+ `group_list`：并发竞速平台黑白名单
+- `[platforms_proxy]` 新增 `group_list_type`：让 `enabled_platforms` 在白名单（默认，向后兼容）与黑名单之间切换
+- Qwen / DeepSeek 代理切换统一走 `platforms_proxy.is_platform_enabled()`
+- runtime 摘要导出新字段
+
+✅ 已完成（v2.2.40）：
+- `_auth_middleware` 移除 `/health` 与 `/v1/models` 的无条件放行：必须持有 `pv2_session` Cookie 或有效 Bearer/X-API-Key 才能访问；浏览器无凭证自动 302 到 `/login`，API 客户端 JSON 401
+
+✅ 已完成（v2.2.39）：
+- `_auth_middleware` 不再放行 `/`：未登录浏览器访问管理面板自动 302 到 `/login`，登录后 Cookie 驱动回到 `/`
+
+✅ 已完成（v2.2.38）：
+- WebUI 新增 `/login` 表单页（自包含内联 CSS，light/dark 自适应）
+- `_auth_middleware` 接受 `pv2_session` Cookie 作为 Bearer 等价凭证
+- `_auth_middleware` 放行 `/login` 与 `/static/`，解决未登录时 CSS/JS 401 导致 UI 风格丢失
+- 浏览器访问受保护路由时无凭证自动 302 到 `/login`，API 客户端仍保持 JSON 401 协议
+- 新增 `/logout` 路由清除 `pv2_session` Cookie
+
+✅ 已完成（v2.2.37）：
+- aitianhu2 认证失败 / 401 重认证时强制刷新 carids（清空模块缓存 + 绕过 48h 阈值）
+- aitianhu2 落地页 200 但 carids 正则未匹配时记录页面片段便于排查
+
+✅ 已完成（v2.2.36）：
+- aitianhu2 流式对话：`system_hints` 非空时透传 `client_prepare_state: "success"`
+- aitianhu2 流式对话：`prepare` 响应的 `conduit_token` 注入 stream `x-conduit-token` 头
+
+✅ 已完成（v2.2.35）：
+- aitianhu2 平台对齐上游：动态 carids 抓取 + 48h 刷新 + 持久化
+- aitianhu2 图像生成透传 `system_hints=["picture_v2"]`
+- aitianhu2 补全 sentinel/upload 的 `Authorization: Bearer` 头
+- aitianhu2 认证加固：200 响应 `wrong-email-credentials` / 登录页检测
+- aitianhu2 会话 22h 软刷新 + 24h 硬过期双保险
+
+✅ 已完成（v2.2.34）：
+- 非 WebUI 客户端一律不渲染工具调用历史
+
+✅ 已完成（v2.2.33）：
+- agent CLI 消息跳过渲染工具调用历史，避免双重渲染
+
+✅ 已完成（v2.2.32）：
+- 修复 LLM 工具调用死循环：历史中工具调用格式与协议指令格式不一致
+
+✅ 已完成（v2.2.31）：
+- 修复自动更新检查 Path 未导入导致的 NameError
+
+✅ 已完成（v2.2.30）：
+- 修复聊天发送按钮不可见：Tailwind backgroundColor 缺少 accent 定义
+
+✅ 已完成（v2.2.29）：
+- 修复 Anthropic 路由协议硬编码导致工具调用标签泄漏到客户端
+
+✅ 已完成（v2.2.28）：
+- 修复助手消息编辑按钮在浅色背景上不可见的问题
+
+✅ 已完成（v2.2.27）：
+- 消息编辑对话框按钮统一为「确定」+「取消」
+
+✅ 已完成（v2.2.26）：
+- 修复 qwen 平台 enabled_platforms=[] 时仍能使用代理的 bug
+
+✅ 已完成（v2.2.25）：
+- WebUI CustomDropdown 组件添加搜索筛选功能，选项超过5项时自动显示搜索框，列表最多显示5项
+
+✅ 已完成（v2.2.24）：
+- 废除 `/docs` 端点与 `/webui` 页面路由，根路径 `/` 直接服务内置 WebUI
+- 静态资源前缀由 `/webui/static/` 简化为 `/static/`
+- 删除 `DocLink`/`DocSection`、`build_doc_sections`、`render_page`、`render_webui` 等未使用的兼容导出
+- 鉴权跳过集合仅保留 `/`、`/health`、`/v1/models`
+
+✅ 已完成（v2.2.11）：
+- 新增自动更新功能（autoupdate.enabled/branch/interval，git pull + exit 42 自动重启）
+
+✅ 已完成（v2.2.10）：
+- 修复工具调用 fncall 协议不一致问题（_single 缺少注入、_race 缺少 fncall_lang 参数、FncallStreamParser 协议错误）
+
+✅ 已完成（v2.2.5）：
+- 修复 antml 协议 prompt 缺少 Function Invocation Syntax
+- 延迟 `_build_param_schema_index` 构建至确认有 function_calls 块后
+- 修复 ServerCfg 缺少 version 字段
+- 消除 silent `except Exception: pass` 模式（10 处）
+- 补全缺失的 `from __future__ import annotations`（4 文件）
+- 补全核心函数/类 docstring
+
+✅ 已完成（v2.2.1）：
+- 修复平台 accounts 模块导入路径（遵循平台开发规范）
+
+✅ 已完成（v2.2.0）：
+- 核心网关架构重构
+- OpenAI 和 Anthropic API 兼容
+- 11+ 平台适配器
+- 并发竞速机制
+- 工具调用（fncall）XML 模板可配置
+- 配置热加载
+- 文件监视热重载（平台代码热重载）
+- TAS 选择器（Thompson Sampling + 冷却）
+- 错误类命名修复（RequestTimeoutError）
+- 热重载 BUG 修复（清理 sys.modules）
+
+### v2.1（计划中）
+
+- [ ] 更多平台适配器
+- [ ] 请求缓存机制
+- [ ] 负载均衡策略优化
+- [ ] 更完善的监控指标
+- [ ] WebSocket 实时通信支持
+
+### v2.2（规划中）
+
+- [ ] 分布式部署支持
+- [ ] 请求限流和熔断
+- [x] 可视化控制台
+- [ ] 插件化架构
+
+### 长期目标
+
+- 成为最全面的 AI 模型网关
+- 支持 30+ AI 平台
+- 毫秒级延迟
+- 99.99% 可用性
+
+📢 欢迎在 [Issues](https://github.com/nichengfuben/provider-v2/issues) 中提出功能建议！
+
+---
+
+## ❓ 常见问题
+
+<details>
+<summary><b>Q1: 启动时提示 "ModuleNotFoundError: No module named 'xxx'" 怎么办？</b></summary>
+
+**问题描述**：运行 `python main.py` 时提示缺少依赖模块
+
+**解决方案：**
+```bash
+# 确保已安装所有依赖
+pip install -r requirements.txt
+
+# 或使用虚拟环境
+python -m venv venv
+source venv/bin/activate  # Windows: .\venv\Scripts\activate
+pip install -r requirements.txt
+```
+</details>
+
+<details>
+<summary><b>Q2: 如何配置代理服务器？</b></summary>
+
+**解决方案：**
+
+编辑 `config/main_config.toml` 文件：
+```toml
+[proxy]
+proxy_server = "http://proxy.example.com:8080"
+proxy_enabled = true
+proxy_list_type = "blacklist"
+proxy_urls = []
+```
+
+> **注意**：代理配置在 `src.core.proxy` 模块导入时即生效，修改后需重启服务。
+</details>
+
+<details>
+<summary><b>Q3: 并发竞速模式下如何控制配额消耗？</b></summary>
+
+**解决方案：**
+
+编辑 `config/main_config.toml` 调整参数：
+```toml
+[gateway]
+concurrent_enabled = true    # 启用并发竞速
+concurrent_count = 2         # 减少并发数（降低配额消耗）
+min_tokens = 50              # 增加 Token 阈值（减少早期切换）
+```
+
+**建议：**
+- 配额紧张时设置 `concurrent_count = 1`（禁用竞速）
+- 低延迟优先时设置 `concurrent_count = 3`，`min_tokens = 10`
+</details>
+
+<details>
+<summary><b>Q4: DeepSeek 平台提示 "WASM 下载失败" 怎么办？</b></summary>
+
+**可能原因：**
+1. 代理配置不正确
+2. 网络连接问题
+3. `persist/deepseek/` 目录无写入权限
+
+**排查步骤：**
+```bash
+# 检查目录权限
+ls -la persist/deepseek/
+
+# 手动创建目录
+mkdir -p persist/deepseek/
+
+# 检查代理配置
+# 确保 config/main_config.toml 中 [proxy] 配置正确
+```
+
+**WASM 文件位置：**
+- 保存路径：`persist/deepseek/sha3_wasm_bg.7b9ca65ddd.wasm`
+- 自动下载 URL：`https://fe-static.deepseek.com/chat/static/sha3_wasm_bg.7b9ca65ddd.wasm`
+- 更新检查频率：24 小时
+</details>
+
+<details>
+<summary><b>Q5: 如何添加新的平台适配器？</b></summary>
+
+**解决方案：**
+
+1. 在 `src/platforms/<name>/` 下创建目录结构
+2. 在 `core/adaptercore.py` 实现平台适配器（导出 `Adapter` / `*Adapter`）
+3. 按需添加 `accounts.py`、`core/client.py` 等模块
+4. 确保注册表能自动发现 `src/platforms/<name>/__init__.py` 中的 `Adapter`
+
+详细步骤请参考 [平台适配器开发指南](docs-src/src/platforms/guide.md)。
+</details>
+
+<details>
+<summary><b>Q6: 工具调用（fncall）中 XML 标签格式有何要求？</b></summary>
+
+**解决方案：**
+
+Provider-V2 要求模型返回的 XML 遵循以下格式：
+
+```xml
+<function=函数名>
+<参数名1>
+参数值
+</参数名1>
+<参数名2>
+参数值
+</参数名2>
+</function>
+```
+
+**关键要求：**
+- XML 标签名必须与工具定义中的参数名完全一致
+- 标签和值之间**必须**有换行符
+- 支持多行参数（如代码块），换行符会被保留
+- 必须包含所有必需参数
+
+如果模型没有按此格式返回，Provider-V2 将无法正确解析工具调用。
+</details>
+
+<details>
+<summary><b>Q7: 配置文件修改后不生效怎么办？</b></summary>
+
+**解决方案：**
+
+```bash
+# 方法一：等待自动重载（最多延迟 2 秒）
+
+# 方法二：重启服务
+# Ctrl+C 停止，然后重新运行
+python main.py
+
+# 方法三：检查配置文件语法
+python -c "import tomllib; print(tomllib.load(open('config/main_config.toml', 'rb')))"
+```
+
+**代理配置需要重启**：
+- `config/main_config.toml` 中的 `[proxy]` 配置在模块导入时生效
+- 修改代理配置后必须重启服务
+</details>
+
+<details>
+<summary><b>Q8: 如何禁用鉴权？</b></summary>
+
+**解决方案：**
+
+编辑 `config/main_config.toml`：
+```toml
+[auth]
+enabled = false  # 设置为 false
+keys = []
+```
+
+**无条件跳过鉴权的路径**：
+- `/login`、`/logout`、`/health`、`/static/*`
+</details>
+
+### 更多问题
+
+- 🐛 在 [Issues](https://github.com/nichengfuben/provider-v2/issues) 中报告问题
+- 💬 加入社区讨论
+
+---
+
+## 🤝 贡献指南
+
+我们欢迎所有形式的贡献！
+
+### 如何贡献
+
+1. **报告 Bug**：通过 [Issues](https://github.com/nichengfuben/provider-v2/issues) 提交详细报告
+2. **功能建议**：在 [Discussions](https://github.com/nichengfuben/provider-v2/discussions) 中提出想法
+3. **代码贡献**：提交 Pull Request 到 **`dev` 分支**
+4. **文档改进**：帮助完善 README 和 API 文档
+5. **分享经验**：在社区分享使用心得
+
+### Pull Request 流程
+
+```bash
+# 1. 确保在 dev 分支基础上创建
+git checkout dev
+git pull upstream dev
+git checkout -b feature/your-feature
+
+# 2. 提交更改
+git add .
+git commit -m "feat: add your feature"
+
+# 3. 运行测试
+pytest tests/
+
+# 4. 推送到你的 fork
+git push origin feature/your-feature
+
+# 5. 创建 Pull Request（目标分支：dev）
+```
+
+### 代码规范检查
+
+```bash
+# 格式化代码
+black src/
+
+# 排序导入
+isort src/
+
+# 类型检查
+mypy src/
+
+# 运行测试
+pytest tests/
+```
+
+### 贡献者名单
+
+感谢所有贡献者！
+
+<a href="https://github.com/nichengfuben/provider-v2/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=nichengfuben/provider-v2" />
+</a>
+
+---
+
+## 📜 许可证
+
+本项目采用 [MIT 许可证](./LICENSE)。
+
+```
+MIT License
+
+Copyright (c) 2026 Provider-V2 Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+---
+
+## 📮 联系方式
+
+- **作者**：nightpoem
+- **邮箱**：nichengfuben@outlook.com
+- **主页**：https://github.com/nichengfuben/provider-v2
+
+### 技术支持
+
+- 📧 技术支持邮箱：nichengfuben@outlook.com
+- 🐛 [问题反馈](https://github.com/nichengfuben/provider-v2/issues)
+- 💬 [社区讨论](https://github.com/nichengfuben/provider-v2/discussions)
+
+---
+
+<div align="center">
+
+**如果这个项目对你有帮助，请给一个 ⭐️ Star！**
+
+Made with ❤️ by [nightpoem](https://github.com/nichengfuben)
+
+</div>