Files

lanyuanxiaoyao b7e205f4b6 refactor: 优化 URL 路径拼接，修复 /v1 重复问题

## 主要变更

**核心修改**：
- 路由定义：/:protocol/v1/*path → /:protocol/*path
- proxy_handler：nativePath 直接使用 path 参数，不添加 /v1 前缀
- OpenAI 适配器：DetectInterfaceType 和 BuildUrl 去掉 /v1 前缀
- Anthropic 适配器：保持 /v1 前缀（Claude Code 兼容）

**URL 格式变化**：
- OpenAI: /openai/v1/chat/completions → /openai/chat/completions
- Anthropic: /anthropic/v1/messages (保持不变)

**base_url 配置**：
- OpenAI: 配置到版本路径，如 https://api.openai.com/v1
- Anthropic: 不配置版本路径，如 https://api.anthropic.com

## 测试验证

- 所有单元测试通过
- 所有集成测试通过
- 真实 API 测试验证成功
- 跨协议转换正常工作

## 文档更新

- 更新 backend/README.md URL 格式说明
- 同步 OpenSpec 规范文件

2026-04-21 20:21:17 +08:00

2.7 KiB

Raw Blame History

OpenAI Protocol Proxy

Purpose

定义 OpenAI Chat Completions API 端点的协议代理行为，包括请求处理流程、模型路由、同协议透传和跨协议转换。

Requirements

Requirement: 支持 OpenAI Chat Completions API 端点

网关 SHALL 提供 OpenAI Chat Completions API 端点供外部应用调用。

Scenario: 成功的非流式请求

WHEN 应用发送 POST 请求到 /openai/chat/completions，携带有效的 OpenAI 请求格式（非流式）
THEN 网关 SHALL 通过 ConversionEngine 转换请求
THEN 网关 SHALL 将转换后的请求转发到配置的供应商
THEN 网关 SHALL 将供应商的响应通过 ConversionEngine 转换为 OpenAI 格式返回给应用

Scenario: 成功的流式请求

WHEN 应用发送 POST 请求到 /openai/chat/completions，携带 stream: true
THEN 网关 SHALL 通过 ConversionEngine 创建 StreamConverter
THEN 网关 SHALL 使用 SSE 格式将转换后的响应流式返回给应用
THEN 网关 SHALL 在流完成时发送 data: [DONE]

Scenario: 同协议透传（OpenAI → OpenAI Provider）

WHEN 客户端使用 OpenAI 协议且目标供应商也是 OpenAI 协议
THEN 网关 SHALL 跳过 Canonical 转换，仅重建认证 Header 后原样转发
THEN 请求和响应 Body SHALL 保持原样

Requirement: 根据模型名称路由请求

网关 SHALL 根据请求中的 model 字段将请求路由到相应的供应商。

Scenario: 有效模型路由

WHEN 请求包含存在于配置模型中的 model 字段
AND 该模型已启用
THEN 网关 SHALL 将请求路由到该模型关联的供应商
THEN 网关 SHALL 从供应商的 protocol 字段获取 providerProtocol

Scenario: 模型未找到

WHEN 请求包含不存在于配置模型中的 model 字段
THEN 网关 SHALL 使用 OpenAI 格式返回错误响应

Scenario: 模型已禁用

WHEN 请求包含已禁用模型的 model 字段
THEN 网关 SHALL 使用 OpenAI 格式返回错误响应

Requirement: 跨协议请求转换

网关 SHALL 对非 OpenAI 兼容供应商的请求和响应通过 ConversionEngine 进行转换处理。

Scenario: 跨协议请求转发

WHEN 网关收到 OpenAI 协议请求且目标供应商使用不同协议
THEN 网关 SHALL 通过 ConversionEngine 将请求转换为目标协议格式
THEN 网关 SHALL 使用目标协议的 Adapter 构建 URL 和 Header

Scenario: 扩展层接口代理

WHEN 网关收到 /openai/v1/models 等 GET 请求
THEN 网关 SHALL 通过 ConversionEngine 转换扩展层接口的响应格式

2.7 KiB Raw Blame History Unescape Escape