[bug or limits] bug 400: {"message":"Unexpected message role.","type":"BadRequestError","param":null,"code":400} while try reasoning with llm-pi-ai

[drscrewdriver]

前沿问题
当模型配置了 reasoningEfforts 后（只要认为模型是推理模型并用pi-ai方式处理），pi-ai 会将系统消息发送为 developer role；部分 vLLM、SGLang、Qwen 或其他 OpenAI-compatible 网关只接受 system而不认developer role，因此返回 Unexpected message role。
目前workaround 方法之一
dsh-thinking-levels 族 +dsh-llm-openai-completions
设置 标记 让dsh读取配置后绕过pi-ai 改用我的实现 不会在reasoningEfforts 强制要求使用developer role
希望更深度定制pi-ai插件避免类似问题

相关项目 本人项目
https://github.com/drscrewdriver/dsh-llm-openai-completions
https://github.com/drscrewdriver/dsh-thinking-levels
相似类别 开发者友情项目issue讨论
hytime/dsh-thinking-effort#4

[weijiafu14]

你的根因描述与我们录过请求体的测量一致，补已验证的声明级修法（不用 workaround 到别处）：

给这条路由的模型声明加 compat: { supportsDeveloperRole: false }——系统消息即以 system 角色发出。这不是文档推断：我们的装置用透传录制代理抓真实请求体，断言正是"声明该 flag 后请求里不再出现 developer 角色"（examples/gateway-compat，这条断言曾专门为防"默认值假绿"重写）。声明写法：examples/custom-gateways。

你说的触发条件（配了 reasoningEfforts 就被当推理模型走 developer）正是 #3789 的提案要改的默认值（非原生 OpenAI 端点默认 false + UI 开关）——vLLM/SGLang/Qwen 一族撞这个的频率足够高（今天同池子里 #4937 也是它），建议去那边 +1 合流。

[drscrewdriver]

是的 已经转为报错到官方pi-ai配置的路线 我看一些新版似乎是默认可以使用本地局域网思考模型 不知道最近界面是否有改动 supportsDeveloperRole: false 会在官方面板里设置可调吗

[drscrewdriver]

https://github.com/drscrewdriver/dsh-thinking-levels 这个回到pi-ai 路线 支持设置ctx限制 自定义api的effort字段调整、自动根据环节对effort进行优化有auto模式

[PerryLink]

核实结论：机制属实、可精确复现，但触发条件是双重的，报告漏了半个。

1. dsh 侧本身不产生 developer 角色：llm-pi-ai 把 system 文本放进 pi-ai 的单一 systemPrompt 槽（context.ts:146-152）。
2. developer vs system 的决策在 pi-ai 的 convertMessages：仅当 model.reasoning 且 compat.supportsDeveloperRole 为 true 时才用 developer（openai-completions.js:909-912）。
3. 关键：对无法识别的自建网关 baseUrl，supportsDeveloperRole 检测默认 true（:1279）⇒ 推理模型请求即以 developer 发出，撞上只认 system 的网关就 400 —— 这正是你的触发路径；而已识别的非标准端点（deepseek.com、opencode.ai、together、xai、moonshot、cloudflare 等，:1251-1265 名单）默认 false、走 system。
4. 最简修法：给该路由的模型声明 compat: { supportsDeveloperRole: false } —— 该字段在 dsh 的 compat 配置面正式开放（catalog.ts:233），语义就是「false 保持 system」；opencode-go 的条目已显式设 false。

补充信息请求：请提供触发时请求体的实际 role 与网关地址，以确认是否落在「无法识别 URL 默认 true」分支。