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

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

openspec/specs/anthropic-protocol-proxy/spec.md

@@ -4,42 +4,47 @@
 
 ### Requirement: 支持 Anthropic Messages API 端点
 
-网关 SHALL 提供 Anthropic Messages API 端点 `POST /v1/messages` 供外部应用调用。
+网关 SHALL 提供 Anthropic Messages API 端点供外部应用调用。
 
 #### Scenario: 成功的非流式请求
 
-- **WHEN** 应用发送 POST 请求到 `/v1/messages`，携带有效的 Anthropic 请求格式（非流式）
-- **THEN** 网关 SHALL 将 Anthropic 请求转换为 OpenAI 格式
-- **THEN** 网关 SHALL 将转换后的请求转发到配置的供应商
-- **THEN** 网关 SHALL 将 OpenAI 响应转换回 Anthropic 格式
-- **THEN** 网关 SHALL 将转换后的响应返回给应用
+- **WHEN** 应用发送 POST 请求到 `/anthropic/v1/messages`，携带有效的 Anthropic 请求格式（非流式）
+- **THEN** 网关 SHALL 通过 ConversionEngine 将 Anthropic 请求解码为 Canonical 格式
+- **THEN** 网关 SHALL 将 Canonical 请求编码为目标供应商协议格式
+- **THEN** 网关 SHALL 将供应商的响应通过 ConversionEngine 转换为 Anthropic 格式返回给应用
 
 #### Scenario: 成功的流式请求
 
-- **WHEN** 应用发送 POST 请求到 `/v1/messages`，携带 `stream: true`
-- **THEN** 网关 SHALL 将 Anthropic 请求转换为 OpenAI 格式
-- **THEN** 网关 SHALL 将转换后的请求转发给供应商
-- **THEN** 网关 SHALL 将 OpenAI 流事件转换为 Anthropic 流事件
-- **THEN** 网关 SHALL 使用 SSE 格式将转换后的事件流式返回给应用
+- **WHEN** 应用发送 POST 请求到 `/anthropic/v1/messages`，携带 `stream: true`
+- **THEN** 网关 SHALL 通过 ConversionEngine 创建 StreamConverter
+- **THEN** 网关 SHALL 将上游协议的 SSE 流转换为 Anthropic 命名事件格式
+- **THEN** 网关 SHALL 使用 `event: <type>\ndata: <json>\n\n` 格式流式返回给应用
 
-**变更说明：** handler 通过 service 层调用，而非直接调用 config 和 provider 包。API 接口保持不变。
+#### Scenario: 同协议透传（Anthropic → Anthropic Provider）
 
-### Requirement: 将 Anthropic 请求转换为 OpenAI 格式
+- **WHEN** 客户端使用 Anthropic 协议且目标供应商也是 Anthropic 协议
+- **THEN** 网关 SHALL 跳过 Canonical 转换，仅重建认证 Header 后原样转发
+- **THEN** 请求和响应 Body SHALL 保持原样
 
-网关 SHALL 将 Anthropic Messages API 请求转换为 OpenAI Chat Completions API 格式。
+### Requirement: 双向协议转换
 
-#### Scenario: System 消息转换
+网关 SHALL 支持 Anthropic 协议与任意已注册协议间的双向转换。
 
-- **WHEN** Anthropic 请求包含 `system` 字段
-- **THEN** 网关 SHALL 将其转换为 `messages` 数组中 `role: "system"` 的消息
+#### Scenario: Anthropic 客户端 → OpenAI 供应商
 
-#### Scenario: Messages 转换
+- **WHEN** 客户端使用 Anthropic 协议且供应商使用 OpenAI 协议
+- **THEN** SHALL 将 Anthropic MessagesRequest 解码为 CanonicalRequest
+- **THEN** SHALL 将 CanonicalRequest 编码为 OpenAI ChatCompletionRequest
+- **THEN** SHALL 将 OpenAI ChatCompletionResponse 解码为 CanonicalResponse
+- **THEN** SHALL 将 CanonicalResponse 编码为 Anthropic MessagesResponse
 
-- **WHEN** Anthropic 请求包含 `messages` 数组
-- **THEN** 网关 SHALL 在转换后的 OpenAI 请求中保留这些消息
-- **THEN** 网关 SHALL 保留每条消息的 role 和 content
+#### Scenario: OpenAI 客户端 → Anthropic 供应<E4BE9B><E5BA94>
 
-**变更说明：** 协议转换逻辑保持不变，仅调用方式改为通过 service 层。
+- **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
 
@@ -49,9 +54,9 @@ Handler SHALL 通过 service 层处理业务逻辑。
 
 #### Scenario: 调用 routing service
 
-- **WHEN** handler 收到请求并转换为 OpenAI 格式
+- **WHEN** ProxyHandler 收到 Anthropic 协议请求
 - **THEN** SHALL 调用 RoutingService.Route() 获取路由结果
-- **THEN** SHALL 使用路由结果中的供应商信息
+- **THEN** SHALL 从路由结果获取 Provider（含 protocol 字段）
 
 #### Scenario: 调用 stats service
 
@@ -61,16 +66,22 @@ Handler SHALL 通过 service 层处理业务逻辑。
 
 ### Requirement: 使用结构化错误处理
 
-Handler SHALL 使用结构化错误处理。
+ProxyHandler SHALL 使用 ConversionError 和 Anthropic 的 encodeError 处理错误。
 
 #### Scenario: 协议转换错误
 
-- **WHEN** 协议转换失败
-- **THEN** SHALL 返回结构化错误响应
-- **THEN** SHALL 包含详细的错误信息
+- **WHEN** ConversionEngine 返回 ConversionError
+- **THEN** SHALL 使用 Anthropic 的 Adapter.encodeError 编码错误响应
+- **THEN** SHALL 使用 Anthropic 错误格式（`{type: "error", error: {type, message}}`）
 
 #### Scenario: 路由错误处理
 
 - **WHEN** RoutingService 返回错误
-- **THEN** SHALL 转换为对应的 AppError
-- **THEN** SHALL 返回统一的错误响应
+- **THEN** SHALL 转换为 ConversionError
+- **THEN** SHALL 使用 Anthropic 错误格式返回
+
+#### Scenario: 供应商错误处理
+
+- **WHEN** ProviderClient 返回错误
+- **THEN** SHALL 包装为 ConversionError
+- **THEN** SHALL 使用 Anthropic 错误格式返回