[Bug] llm-pi-ai: hand-declared routes cannot disable the OpenAI "developer" system-prompt role — reasoning requests 400 on gateways that only accept "system" (e.g. Alibaba Cloud Model Studio / 阿里云百炼)

[Sherkirito]

现象 / Symptom

在 settings.yaml 里手声明一个 OpenAI 兼容网关路由（api: openai-completions），并给模型声明 reasoningEfforts（思考强度）后，所有请求以 400 失败：

invalid_parameter_error: developer is not one of ['system', 'assistant', 'user', 'tool', 'function']

具体场景：阿里云百炼（Model Studio）MaaS 专属部署 https://ws-*.maas.aliyuncs.com/compatible-mode/v1，模型 deepseek-v4-flash-0731 / deepseek-v4-pro-0813，带 reasoningEfforts: { off: null, high: high, max: max }。

根因 / Root cause

1. pi-ai 的 convertMessages（openai-completions）里：const useDeveloperRole = model.reasoning && compat.supportsDeveloperRole —— 模型一旦声明了推理能力（model.reasoning = true），system 提示词就以 OpenAI 的 role: "developer" 发送。
2. detectCompat 对未知网关（ws-*.maas.aliyuncs.com 不在任何已知名单里）默认 supportsDeveloperRole: true。
3. DSH 的 PiAiCompatProfile 只暴露了 thinkingFormat 和 supportsReasoningEffort，没有暴露 supportsDeveloperRole，因此配置层无法关闭它 —— 手声明路由无法复刻内置 provider 的此开关。

证据 / Evidence

直接探测网关（相同请求，仅 role 不同）：

role	结果
developer	400 developer is not one of [...]
system	200 正常返回（含 reasoning_content）

上游已知此行为：pi-ai 内置的 qwen-token-plan-cn provider（同为 *.maas.aliyuncs.com 域名）在模型数据里显式设置了 compat.supportsDeveloperRole: false，说明阿里云 MaaS 网关只接受 system 角色，且上游已在内置目录中处理。手声明路由缺这个开关，无法做同样的处理。

建议修复 / Suggested fix

给 PiAiCompatProfile（packages/llm/llm-pi-ai/src/catalog.ts + config.ts schema）增加 supportsDeveloperRole?: boolean 并在 resolveModelCompat 透传给 pi-ai。已在本地验证可行：

llm-pi-ai:
  providers:
    alibaba:
      api: openai-completions
      baseURL: https://ws-xxx.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
      compat:
        supportsReasoningEffort: true
        supportsDeveloperRole: false   # 网关只接受 system 角色

临时绕法 / Workaround

不给模型声明 reasoningEfforts（回到无思考强度状态），或等官方补上该开关。

---

环境：pi-ai 0.82.1，DSH 当前 master。

[weijiafu14]

百炼这个场景的根因判断没问题。当前可以用“provider 自己拥有 transport”的方式绕过手写 llm-pi-ai schema：

dsh plugin --profile web add pi2dsh
dsh plugin --profile web add <能够直连该端点的 Pi provider 包>

pi2dsh 会把它经 llm.registerAdapter 注册到 DSH 原生模型目录。请求由 provider 自己组装，因此模型描述里的 supportsDeveloperRole: false 和 reasoning level map 不会在 DSH 配置层被丢掉。

透传录制已验证：同一路径发出的是 system，选择的 reasoning effort 也进入请求。需要说明：catalog-only provider 仍会回落到官方 adapter，只有自带 transport 的 provider 才能绕开这个字段缺口。

[zgxkbtl]

百炼的问题现在修复了吗