nex/openspec/changes/unified-model-id/specs/protocol-adapter-openai/spec.md

MODIFIED Requirements

Requirement: 模型详情路径识别

OpenAI 适配器 SHALL 正确识别包含统一模型 ID 的模型详情路径。

Scenario: 含斜杠的统一模型 ID 路径

• WHEN 路径为 /v1/models/openai/gpt-4
• THEN DetectInterfaceType SHALL 返回 InterfaceTypeModelInfo

Scenario: 含多段斜杠的统一模型 ID 路径

• WHEN 路径为 /v1/models/azure/accounts/org-123/models/gpt-4
• THEN DetectInterfaceType SHALL 返回 InterfaceTypeModelInfo

Scenario: 模型列表路径不受影响

• WHEN 路径为 /v1/models
• THEN DetectInterfaceType SHALL 返回 InterfaceTypeModels

Requirement: 提取统一模型 ID

OpenAI 适配器 SHALL 从路径中提取统一模型 ID。

Scenario: 标准路径提取

• WHEN 调用 ExtractUnifiedModelID("/v1/models/openai/gpt-4")
• THEN SHALL 返回 "openai/gpt-4"

Scenario: 复杂路径提取

• WHEN 调用 ExtractUnifiedModelID("/v1/models/azure/accounts/org/models/gpt-4")
• THEN SHALL 返回 "azure/accounts/org/models/gpt-4"

Scenario: 非模型详情路径

• WHEN 调用 ExtractUnifiedModelID("/v1/models")
• THEN SHALL 返回错误

Requirement: 从请求体提取 model

OpenAI 适配器 SHALL 按 InterfaceType 从请求体中提取 model 值。

Scenario: Chat 请求提取 model

• WHEN 调用 ExtractModelName(body, InterfaceTypeChat)，body 为 {"model":"openai/gpt-4","messages":[...]}
• THEN SHALL 返回 "openai/gpt-4"

Scenario: Embedding 请求提取 model

• WHEN 调用 ExtractModelName(body, InterfaceTypeEmbeddings)，body 为 {"model":"openai/text-embedding-3","input":"text"}
• THEN SHALL 返回 "openai/text-embedding-3"

Scenario: 无 model 字段

• WHEN 调用 ExtractModelName(body, ifaceType)，body 中不含 model 字段
• THEN SHALL 返回空字符串，不返回错误

Requirement: 最小化改写请求体 model 字段

OpenAI 适配器 SHALL 按 InterfaceType 用 json.RawMessage 最小化改写请求体中的 model 字段，其余字段保持原始 bytes。

Scenario: 请求体 model 改写（统一 ID → 上游名）

• WHEN 调用 RewriteRequestModelName(body, "gpt-4", InterfaceTypeChat)，body 为 {"model":"openai/gpt-4","messages":[...],"some_param":"value"}
• THEN SHALL 返回 {"model":"gpt-4","messages":[...],"some_param":"value"}
• THEN 除 model 外的字段 SHALL 保持原始 bytes 不变

Scenario: 不同 InterfaceType 的请求改写

• WHEN 调用 RewriteRequestModelName(body, "gpt-4", InterfaceTypeEmbeddings)
• THEN SHALL 按 Embedding 接口的请求体 model 字段位置进行改写
• WHEN 调用 RewriteRequestModelName(body, "gpt-4", InterfaceTypeRerank)
• THEN SHALL 按 Rerank 接口的请求体 model 字段位置进行改写

Requirement: 最小化改写响应体 model 字段

OpenAI 适配器 SHALL 按 InterfaceType 用 json.RawMessage 最小化改写响应体中的 model 字段，其余字段保持原始 bytes。请求体和响应体的 model 字段位置可能不同，各自独立实现。

Scenario: 响应体 model 改写（上游名 → 统一 ID）

• WHEN 调用 RewriteResponseModelName(body, "openai/gpt-4", InterfaceTypeChat)，body 为上游 Chat 响应
• THEN SHALL 将 model 字段替换为 "openai/gpt-4"，其余字段原样保留

Scenario: 不同 InterfaceType 的响应改写

• WHEN 调用 RewriteResponseModelName(body, "openai/gpt-4", InterfaceTypeEmbeddings)
• THEN SHALL 按 Embedding 接口的响应体 model 字段位置进行改写