update

.clinerules

@@ -0,0 +1,153 @@
+# 自定义指令
+CUSTOM_INSTRUCTIONS = """
+# 必须遵守的约束
+- 所有交流均采用中文
+- 如果在开发中有不明确的需求，或者需要用户的任何帮助，请告知用户，如果是调研，请一次只提出一个问题
+- 本项目使用conda进行环境管理，当前使用的环境为any-api，如果找不到此环境，请使用: conda create -n any-api python=3.12；如果找到环境，请使用: conda activate any-api激活环境
+
+# 实现目标
+- 使用python进行开发
+- 当用户访问中转主机url：http://127.0.0.1:7860/v1/https/open.bigmodel.cn/api/paas/v4/chat/completions时，实际上中转主机会访问：https/open.bigmodel.cn/api/paas/v4/chat/completions，可以看出实际上对于主机来说，就是http://127.0.0.1:7860/v1/https/open.bigmodel.cn会跳转到 https://open.bigmodel.cn，就是https协议，域名open.bigmodel.cn，endpoint为：/api/paas/v4/chat/completions
+- 要求实现多线程的模式实现代理功能
+- 功能的实现，采用fastapi框架
+
+# 知识参考
+- 无
+
+"""
+
+
+--- 
+description: Describes Cline's Memory Bank system, its structure, and workflows for maintaining project knowledge across sessions.
+author: https://github.com/nickbaumann98
+version: 1.0
+tags: ["memory-bank", "knowledge-base", "core-behavior", "documentation-protocol"]
+globs: ["memory-bank/**/*.md", "*"]
+---
+# Cline's Memory Bank
+
+I am Cline, an expert software engineer with a unique characteristic: my memory resets completely between sessions. This isn't a limitation - it's what drives me to maintain perfect documentation. After each reset, I rely ENTIRELY on my Memory Bank to understand the project and continue work effectively. I MUST read ALL memory bank files at the start of EVERY task - this is not optional.
+
+## Memory Bank Structure
+
+The Memory Bank consists of core files and optional context files, all in Markdown format. Files build upon each other in a clear hierarchy:
+
+```mermaid
+flowchart TD
+    PB[projectbrief.md] --> PC[productContext.md]
+    PB --> SP[systemPatterns.md]
+    PB --> TC[techContext.md]
+    
+    PC --> AC[activeContext.md]
+    SP --> AC
+    TC --> AC
+    
+    AC --> P[progress.md]
+```
+
+### Core Files (Required)
+1. `projectbrief.md`
+   - Foundation document that shapes all other files
+   - Created at project start if it doesn't exist
+   - Defines core requirements and goals
+   - Source of truth for project scope
+
+2. `productContext.md`
+   - Why this project exists
+   - Problems it solves
+   - How it should work
+   - User experience goals
+
+3. `activeContext.md`
+   - Current work focus
+   - Recent changes
+   - Next steps
+   - Active decisions and considerations
+   - Important patterns and preferences
+   - Learnings and project insights
+
+4. `systemPatterns.md`
+   - System architecture
+   - Key technical decisions
+   - Design patterns in use
+   - Component relationships
+   - Critical implementation paths
+
+5. `techContext.md`
+   - Technologies used
+   - Development setup
+   - Technical constraints
+   - Dependencies
+   - Tool usage patterns
+
+6. `progress.md`
+   - What works
+   - What's left to build
+   - Current status
+   - Known issues
+   - Evolution of project decisions
+
+### Additional Context
+Create additional files/folders within memory-bank/ when they help organize:
+- Complex feature documentation
+- Integration specifications
+- API documentation
+- Testing strategies
+- Deployment procedures
+
+## Core Workflows
+
+### Plan Mode
+```mermaid
+flowchart TD
+    Start[Start] --> ReadFiles[Read Memory Bank]
+    ReadFiles --> CheckFiles{Files Complete?}
+    
+    CheckFiles -->|No| Plan[Create Plan]
+    Plan --> Document[Document in Chat]
+    
+    CheckFiles -->|Yes| Verify[Verify Context]
+    Verify --> Strategy[Develop Strategy]
+    Strategy --> Present[Present Approach]
+```
+
+### Act Mode
+```mermaid
+flowchart TD
+    Start[Start] --> Context[Check Memory Bank]
+    Context --> Update[Update Documentation]
+    Update --> Execute[Execute Task]
+    Execute --> Document[Document Changes]
+```
+
+## Documentation Updates
+
+Memory Bank updates occur when:
+1. Discovering new project patterns
+2. After implementing significant changes
+3. When user requests with **update memory bank** (MUST review ALL files)
+4. When context needs clarification
+
+```mermaid
+flowchart TD
+    Start[Update Process]
+    
+    subgraph Process
+        P1[Review ALL Files]
+        P2[Document Current State]
+        P3[Clarify Next Steps]
+        P4[Document Insights & Patterns]
+        
+        P1 --> P2 --> P3 --> P4
+    end
+    
+    Start --> Process
+```
+
+Note: When triggered by **update memory bank**, I MUST review every memory bank file, even if some don't require updates. Focus particularly on activeContext.md and progress.md as they track current state.
+
+REMEMBER: After every memory reset, I begin completely fresh. The Memory Bank is my only link to previous work. It must be maintained with precision and clarity, as my effectiveness depends entirely on its accuracy.
+
+"""
+# 自动批准规则
+AUTO_APPROVE = true

global_state.py

@@ -0,0 +1,9 @@
+# global_state.py
+_state = {}
+
+def set(key, value):
+    _state[key] = value
+
+def get(key):
+    return _state.get(key)
+

memory-bank/activeContext.md

@@ -0,0 +1,25 @@
+# 活跃背景
+
+## 当前工作重点
+- 正在进行Memory Bank核心文件的生成，以确保项目知识的持久化和可追溯性。
+
+## 最近的更改
+- 已创建`projectbrief.md`，`productContext.md`，`systemPatterns.md`和`techContext.md`。
+
+## 下一步计划
+- 创建`progress.md`文件。
+- 完成所有Memory Bank核心文件的创建。
+- 准备好根据用户指令，进入下一步的开发或规划阶段。
+
+## 活跃的决策和考虑事项
+- 确保Memory Bank中的每个文件都准确地反映了项目的当前状态、目标和技术细节。
+- 持续评估和更新Memory Bank，以适应项目进展和需求变化。
+
+## 重要模式和偏好
+- 在FastAPI代理实现中，优先使用`httpx`进行异步HTTP请求转发，以保持与FastAPI异步特性的兼容性。
+- 严格遵循URL解析规则，确保代理转发的准确性。
+
+## 项目见解
+- URL解析和重构是代理功能的核心，其健壮性直接影响代理的可用性。
+- 异步编程模型对于实现高性能的代理服务至关重要。
+- 依赖项中存在`flask`和`requests`，在实际开发中需注意避免与FastAPI和`httpx`的混用，以保持代码库的一致性和性能。

memory-bank/productContext.md

@@ -0,0 +1,17 @@
+# 产品背景
+
+## 为什么存在？
+在某些场景下，直接访问外部HTTPS API可能会面临跨域、证书、协议转换等问题。本项目旨在提供一个本地代理服务，简化这些复杂性，使得用户可以通过统一的HTTP接口访问各种外部HTTPS API。
+
+## 解决的问题
+- **协议转换**：将HTTP请求透明地转换为HTTPS请求。
+- **URL映射**：根据特定的URL路径规则，将本地代理URL映射到实际的外部API URL。
+- **简化开发**：为开发者提供一个统一的、本地可访问的API入口，无需关心底层API的协议和域名细节。
+
+## 工作方式
+用户通过访问本地代理服务器的特定URL（例如：`http://127.0.0.1:7860/v1/https/open.bigmodel.cn/...`），代理服务器会解析URL，提取出目标协议（`https`）、目标域名（`open.bigmodel.cn`）和原始路径（`/api/paas/v4/chat/completions`），然后将请求转发到实际的外部API地址。
+
+## 用户体验目标
+- **透明性**：用户无需感知代理的存在，感觉就像直接访问外部API一样。
+- **易用性**：提供简单直观的URL结构，方便用户理解和使用。
+- **高性能**：通过多线程处理，确保代理服务在高并发场景下依然响应迅速。

memory-bank/progress.md

@@ -0,0 +1,21 @@
+# 项目进度
+
+## 已完成的工作
+- **Memory Bank初始化**：已成功创建并填充所有核心Memory Bank文件，包括：
+    - `projectbrief.md`：项目简介和核心需求。
+    - `productContext.md`：产品背景、解决的问题和用户体验目标。
+    - `systemPatterns.md`：系统架构、关键技术决策和设计模式。
+    - `techContext.md`：技术栈、开发设置和依赖项。
+    - `activeContext.md`：当前工作重点、最近更改和下一步计划。
+    - `progress.md`：当前进度和已知问题。
+
+## 剩余的工作
+- Memory Bank的核心文件生成任务已完成。
+- 接下来将根据用户指令，开始FastAPI代理服务器的实际开发或进一步的规划。
+
+## 当前状态
+- 项目的初始知识库已建立。
+- 环境配置（conda环境`any-api`）和依赖安装（`requirements.txt`）是下一步开发前的准备工作。
+
+## 已知问题
+- `requirements.txt`中包含了`flask`和`requests`，尽管FastAPI代理主要依赖`httpx`。这可能意味着存在未使用的依赖或历史遗留，在未来的代码清理或优化阶段可以考虑移除。目前不影响核心代理功能的实现。

memory-bank/projectbrief.md

@@ -0,0 +1,13 @@
+# 项目简介
+
+本项目旨在开发一个基于FastAPI的多线程代理服务器。主要目标是将特定格式的HTTP请求（例如：`http://127.0.0.1:7860/v1/https/open.bigmodel.cn/api/paas/v4/chat/completions`）转发到其对应的HTTPS目标地址（例如：`https://open.bigmodel.cn/api/paas/v4/chat/completions`）。
+
+## 核心需求
+- 实现HTTP到HTTPS的代理转发。
+- 支持多线程处理请求以提高并发性能。
+- 使用FastAPI框架进行开发。
+- 环境管理使用conda，环境名为`any-api`。
+
+## 目标
+- 提供一个稳定、高效的代理服务，用于转发API请求。
+- 简化外部API的访问，特别是对于需要HTTPS协议的API。

memory-bank/systemPatterns.md

@@ -0,0 +1,30 @@
+# 系统模式
+
+## 系统架构
+本项目采用客户端-代理服务器-目标API的架构模式。
+- **客户端**：发起HTTP请求到代理服务器。
+- **代理服务器**：基于FastAPI构建，接收客户端请求，解析URL，重构目标URL，并将请求转发到实际的外部API。
+- **目标API**：外部的HTTPS API服务。
+
+```mermaid
+graph LR
+    Client -- HTTP Request --> ProxyServer
+    ProxyServer -- HTTPS Request --> TargetAPI
+    TargetAPI -- Response --> ProxyServer
+    ProxyServer -- Response --> Client
+```
+
+## 关键技术决策
+- **Web框架**：选择FastAPI，因为它支持异步操作，性能高，并且易于构建API。
+- **HTTP客户端**：使用`httpx`库进行HTTP请求转发。`httpx`支持异步请求，与FastAPI的异步特性兼容良好。
+- **并发模型**：利用FastAPI的异步特性和Python的`asyncio`实现多线程（或更准确地说是协程）并发处理，以提高代理服务的吞吐量。
+- **URL解析与重构**：代理服务器的核心逻辑在于解析传入的URL，提取出协议、域名和路径，然后重新构造目标API的URL。例如，将`/v1/https/open.bigmodel.cn/api/paas/v4/chat/completions`解析为`https://open.bigmodel.cn/api/paas/v4/chat/completions`。
+
+## 设计模式
+- **代理模式 (Proxy Pattern)**：本项目是代理模式的典型应用，代理服务器作为客户端和目标API之间的中介。
+- **URL路由 (URL Routing)**：FastAPI的路由机制用于匹配传入的URL路径，并将其分派到相应的处理函数。
+
+## 组件关系
+- **FastAPI应用**：作为整个代理服务的入口点。
+- **路由处理器**：定义了处理不同URL模式的函数，例如处理`/v1/{protocol}/{domain}/{path:path}`的通用代理路由。
+- **HTTP转发逻辑**：在路由处理器内部，负责使用`httpx`构建并发送请求到目标API，并处理响应。

memory-bank/techContext.md

@@ -0,0 +1,27 @@
+# 技术背景
+
+## 使用的技术
+- **编程语言**：Python 3.12
+- **Web框架**：FastAPI
+- **ASGI服务器**：Uvicorn (用于运行FastAPI应用)
+- **HTTP客户端**：httpx (用于异步请求转发)
+- **环境管理**：Conda
+
+## 开发设置
+- **Conda环境**：`any-api`。如果不存在，需要通过`conda create -n any-api python=3.12`创建。
+- **环境激活**：`conda activate any-api`。
+- **依赖安装**：通过`pip install -r requirements.txt`安装所有项目依赖。
+
+## 技术约束
+- **URL解析规则**：代理URL必须遵循`/v1/{protocol}/{domain}/{path:path}`的格式，以便正确解析目标API的URL。
+- **并发模型**：虽然FastAPI本身是异步的，但为了处理高并发请求，需要确保请求转发逻辑是非阻塞的，并充分利用`asyncio`的协程能力。
+- **错误处理**：需要考虑代理过程中可能出现的网络错误、超时、目标API响应错误等情况，并进行适当的错误处理和响应。
+
+## 依赖项
+根据`requirements.txt`文件：
+- `flask` (虽然项目使用FastAPI，但`requirements.txt`中包含Flask，可能用于其他部分或历史遗留，在FastAPI代理中不直接使用)
+- `httpx`
+- `fastapi`
+- `uvicorn`
+- `requests` (可能用于同步请求，但推荐在FastAPI中使用`httpx`进行异步请求)
+- `python-dotenv` (用于加载环境变量)

proxyserver-fastapi.py

@@ -4,12 +4,22 @@ import httpx
 import uvicorn
 import asyncio, os
 from dotenv import load_dotenv
+from pathlib import Path
+from global_state import set
 
 # 加载 .env 文件中的环境变量
 load_dotenv()
 
+# 获取当前文件的父目录的绝对路径，即：project_root
+parent_dir = Path(__file__).resolve().parent
+set('project_root', parent_dir)
+
+from routers.api_v1 import router as api_router_v1
+
 app = FastAPI()
 
+app.include_router(api_router_v1, prefix="/v1", tags=["api_router_v1"])
+
 # Placeholder for Airs Platform Token (replace with actual validation logic)
 AIRS_PLATFORM_TOKEN = os.getenv("AIRS_PLATFORM_TOKEN", "")