docs: 暂存本次变更的设计文档

openspec/changes/refactor-conversion-engine/specs/error-handling/spec.md

@@ -0,0 +1,53 @@
+## MODIFIED Requirements
+
+### Requirement: 统一错误响应
+
+系统 SHALL 统一错误响应格式，新增 ConversionError 支持。
+
+#### Scenario: OpenAI 协议错误响应
+
+- **WHEN** OpenAI 协议发生错误
+- **THEN** SHALL 返回标准 OpenAI 错误响应格式
+- **THEN** SHALL 包含 error.message、error.type、error.code 字段
+
+#### Scenario: Anthropic 协议错误响应
+
+- **WHEN** Anthropic 协议发生错误
+- **THEN** SHALL 返回标准 Anthropic 错误响应格式
+- **THEN** SHALL 包含 type、error.type、error.message 字段
+
+#### Scenario: 转换错误响应
+
+- **WHEN** ConversionEngine 在协议转换过程中产生 ConversionError
+- **THEN** SHALL 使用客户端协议的 Adapter.encodeError 编码错误响应
+- **THEN** 错误响应 SHALL 使用客户端可理解的协议格式
+
+#### Scenario: 管理 API 错误响应
+
+- **WHEN** 管理 API 发生错误
+- **THEN** SHALL 返回统一的错误响应格式
+- **THEN** SHALL 包含 code、message 字段
+- **THEN** SHALL 可选包含 details 字段（验证错误详情）
+
+## ADDED Requirements
+
+### Requirement: 定义 ConversionError 错误类型
+
+系统 SHALL 定义 ConversionError 结构体和 ErrorCode 枚举。
+
+#### Scenario: ConversionError 结构
+
+- **WHEN** 定义转换错误
+- **THEN** SHALL 包含 Code（ErrorCode 枚举）、Message 字段
+- **THEN** SHALL 可选包含 ClientProtocol、ProviderProtocol、InterfaceType、Details、Cause 字段
+
+#### Scenario: ErrorCode 枚举
+
+- **WHEN** 定义错误码
+- **THEN** SHALL 包含 INVALID_INPUT、MISSING_REQUIRED_FIELD、INCOMPATIBLE_FEATURE、FIELD_MAPPING_FAILURE、TOOL_CALL_PARSE_ERROR、JSON_PARSE_ERROR、STREAM_STATE_ERROR、UTF8_DECODE_ERROR、PROTOCOL_CONSTRAINT_VIOLATION、ENCODING_FAILURE、INTERFACE_NOT_SUPPORTED
+
+#### Scenario: 错误码到协议错误类型的映射
+
+- **WHEN** 使用 encodeError 编码错误
+- **THEN** ErrorCode SHALL 映射为各协议的错误类型字符串
+- **THEN** 例如 INVALID_INPUT → OpenAI "invalid_request_error"，Anthropic "invalid_request_error"