lanyuanxiaoyao
56ecc73d1b
将 cli-config、config-priority、env-config 合并入 config-management； 将 tdesign-integration、recharts-integration、frontend-config-ui、 frontend-testing、stats-dashboard 合并入新的 frontend/spec.md； 清理其余 spec 中的冗余标记，补充缺失场景。
2.4 KiB
2.4 KiB
Anthropic Protocol Proxy
Purpose
定义 Anthropic Messages API 端点的协议代理行为，包括请求处理流程、同协议透传和双向协议转换。
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 供应商
- WHEN 客户端使用 OpenAI 协议且供应商使用 Anthropic 协议
- THEN SHALL 将 OpenAI ChatCompletionRequest 解码为 CanonicalRequest
- THEN SHALL 将 CanonicalRequest 编码为 Anthropic MessagesRequest
- THEN SHALL 将 Anthropic MessagesResponse 解码为 CanonicalResponse
- THEN SHALL 将 CanonicalResponse 编码为 OpenAI ChatCompletionResponse