[Bug] 有些协议适配问题 invalid_request_error · System messages are not allowed

[huyachigege]

提交前我已确认

• 我搜过 已有 issues，没找到一样的问题
• 我已经把日志/配置里的 Token、API Key、密码等敏感信息打码

我遇到的问题在哪块？

网关 API（/v1/chat/completions、/responses、/messages、Images）

严重程度

一般 — 偶尔触发或影响次要功能

我遇到了什么状况？

龙虾支持anthropic,reponses,chat三种协议
然后有的sdk会加system messages但是上游的responses协议可能不支持 报错invalid_request_error · System messages are not allowed,我好像记得cpa也出现过类似的把system换成了developer，也可能记错，反正这个需要处理适配。
目前下游使用reponses协议过来的，如果使用anthropic不确定会不会有类似的问题。

我是怎么触发的？（可选）

No response

我的环境信息（可选，能填就填）

• 我的部署形态：PG+Redis / SQLite+Memory / 源码 / 其他
• 我的版本或 commit：
• 我用的客户端：Codex CLI / Claude Code / OpenAI SDK / 其他
• 我的浏览器（前端问题填）：

我的补充信息（可选）

No response

[james-6-23]

已修复并合入 main(edfeef0)。

根因

上游 Codex 的 /responses 协议只接受 developer 角色,不接受 system。网关的三条下游链路中,/v1/chat/completions 与 /v1/messages(Anthropic)在翻译时早已把 system 转成 developer,唯独原生 Responses 直通路径漏了转换——所以只有用 Responses 协议直连的 SDK 会触发 invalid_request_error · System messages are not allowed。

你记得的方向是对的:参考实现也是把 system 换成 developer。

修复

在 Responses 请求体归一化管线中新增 system→developer 改写:

• 覆盖 input[] 中两种形态:带 "type":"message" 的完整消息项,以及只有 role 的裸消息项;内容原样保留。
• 位于 previous_response_id 缓存展开之后,历史回灌项中的 system 角色也一并覆盖。
• HTTP、WebSocket、Compact 三条 /v1/responses 链路共享该管线,一处修改全部生效。

关于 Anthropic 路径

你补充担心的 /v1/messages 没有此问题:该链路入口处已把 system prompt 转成 developer 消息,无需改动。

验证

• 单元测试覆盖两种消息形态的转换、user/工具调用项不受影响、WS 路径生效。
• 本地部署对真实上游实测:gpt-5.4-mini 与 gpt-5.6-sol,流式/非流式 × 带 type/裸 role 四种组合均正常完成,且 system 指令语义保留(模型按 system 内容作答)。

感谢反馈。