Files

lanyuanxiaoyao bc1ee612d9 refactor: 实现 ConversionEngine 协议转换引擎，替代旧 protocol 包

- 新增 ConversionEngine 核心引擎，支持 OpenAI 和 Anthropic 协议转换
- 添加 stream decoder/encoder 实现
- 更新 provider client 支持新引擎
- 补充单元测试和集成测试
- 更新 specs 文档

2026-04-20 13:02:28 +08:00

3.5 KiB

Raw Blame History

Anthropic Protocol Proxy

MODIFIED Requirements

Requirement: 支持 Anthropic Messages API 端点

网关 SHALL 提供 Anthropic Messages API 端点供外部应用调用。

Scenario: 成功的非流式请求

WHEN 应用发送 POST 请求到 /anthropic/v1/messages，携带有效的 Anthropic 请求格式（非流式）
THEN 网关 SHALL 通过 ConversionEngine 将 Anthropic 请求解码为 Canonical 格式
THEN 网关 SHALL 将 Canonical 请求编码为目标供应商协议格式
THEN 网关 SHALL 将供应商的响应通过 ConversionEngine 转换为 Anthropic 格式返回给应用

Scenario: 成功的流式请求

WHEN 应用发送 POST 请求到 /anthropic/v1/messages，携带 stream: true
THEN 网关 SHALL 通过 ConversionEngine 创建 StreamConverter
THEN 网关 SHALL 将上游协议的 SSE 流转换为 Anthropic 命名事件格式
THEN 网关 SHALL 使用 event: <type>\ndata: <json>\n\n 格式流式返回给应用

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

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

Requirement: 双向协议转换

网关 SHALL 支持 Anthropic 协议与任意已注册协议间的双向转换。

Scenario: Anthropic 客户端 → OpenAI 供应商

WHEN 客户端使用 Anthropic 协议且供应商使用 OpenAI 协议
THEN SHALL 将 Anthropic MessagesRequest 解码为 CanonicalRequest
THEN SHALL 将 CanonicalRequest 编码为 OpenAI ChatCompletionRequest
THEN SHALL 将 OpenAI ChatCompletionResponse 解码为 CanonicalResponse
THEN SHALL 将 CanonicalResponse 编码为 Anthropic MessagesResponse

Scenario: OpenAI 客户端 → Anthropic 供应<E4BE9B><E5BA94>

WHEN 客户端使用 OpenAI 协议且供应商使用 Anthropic 协议
THEN SHALL 将 OpenAI ChatCompletionRequest 解码为 CanonicalRequest
THEN SHALL 将 CanonicalRequest 编码为 Anthropic MessagesRequest
THEN SHALL 将 Anthropic MessagesResponse 解码为 CanonicalResponse
THEN SHALL 将 CanonicalResponse 编码为 OpenAI ChatCompletionResponse

ADDED Requirements

Requirement: 使用 service 层处理请求

Handler SHALL 通过 service 层处理业务逻辑。

Scenario: 调用 routing service

WHEN ProxyHandler 收到 Anthropic 协议请求
THEN SHALL 调用 RoutingService.Route() 获取路由结果
THEN SHALL 从路由结果获取 Provider（含 protocol 字段）

Scenario: 调用 stats service

WHEN 请求成功完成
THEN SHALL 调用 StatsService.Record() 记录统计
THEN SHALL 异步记录统计（不阻塞响应）

Requirement: 使用结构化错误处理

ProxyHandler SHALL 使用 ConversionError 和 Anthropic 的 encodeError 处理错误。

Scenario: 协议转换错误

WHEN ConversionEngine 返回 ConversionError
THEN SHALL 使用 Anthropic 的 Adapter.encodeError 编码错误响应
THEN SHALL 使用 Anthropic 错误格式（{type: "error", error: {type, message}}）

Scenario: 路由错误处理

WHEN RoutingService 返回错误
THEN SHALL 转换为 ConversionError
THEN SHALL 使用 Anthropic 错误格式返回

Scenario: 供应商错误处理

WHEN ProviderClient 返回错误
THEN SHALL 包装为 ConversionError
THEN SHALL 使用 Anthropic 错误格式返回

3.5 KiB Raw Blame History Unescape Escape