自定义 OpenAI 兼容服务商无法使用 DeepSeek 思考强度：supportsDeveloperRole 被丢弃且 UI 缺少档位控件

[NieRMHY]

环境

• @deepseek-ai/dsh 0.1.0-rc.6
• @deepseek-ai/dsh-llm-pi-ai 0.1.0-rc.6
• @earendil-works/pi-ai 0.82.1
• 上游：自建 / 公司的 OpenAI 兼容网关 → DeepSeek 官方 API

两个问题

1. 自定义服务商在 UI 上没有任何思考强度（reasoning effort）控件

“自定义服务提供商”卡片和编辑器刻意不提供推理档位字段，只能手工编辑 settings.yaml，给每个模型写 reasoningEfforts 和 compat.thinkingFormat: deepseek。对于把公司 DeepSeek 网关配成自定义服务商的用户，表现就是“无法选择思考强度”。

2. 即使按上述方式写好了配置，请求也会报 400

messages[0].role: unknown variant `developer`, expected one of
`system`, `user`, `assistant`, `tool`, `latest_reminder`

配置示例：

llm-pi-ai:
  providers:
    company-gateway:
      api: openai-completions
      baseURL: https://gateway.example.com/v1
      compat:
        thinkingFormat: deepseek
        supportsReasoningEffort: true
        supportsDeveloperRole: false   # DeepSeek 不接受 developer 角色
      models:
        - id: deepseek-v4-pro
          contextWindow: 1000000
          maxTokens: 128000
          reasoningEfforts:
            low: low
            high: high
            max: max

根因：pi-ai 在 model.reasoning && compat.supportsDeveloperRole 为真时，把 system prompt 序列化成 developer 角色（OpenAI o1/gpt-5 风格）。对非标准 baseURL，pi-ai 的自动检测会把 supportsDeveloperRole 默认成 true（只有 *.deepseek.com 的 URL 才会走 DeepSeek 专用检测），而 DeepSeek 的 OpenAI 兼容接口只接受 system，不接受 developer。

但 settings.yaml 里写 compat.supportsDeveloperRole: false 不会生效，因为 dsh-llm-pi-ai 在三个位置把它丢弃了：

• packages/llm/llm-pi-ai/src/catalog.ts 的 PiAiCompatProfile 只声明了 thinkingFormat / supportsReasoningEffort；
• packages/llm/llm-pi-ai/src/config.ts 的 compatProfile schema 只校验这两个字段；
• resolveModelCompat 只把这两个字段透传给模型。

复现与验证

按上面的配置（包含 supportsDeveloperRole: false）抓包，发往上游的请求体仍然是 "role":"developer" → 400。本地给 schema 加上字段、并让 resolveModelCompat 透传后，同样请求变成 "role":"system" → 200，响应正常带 reasoning_content。

建议修复

1. 在 PiAiCompatProfile、compatProfile schema 和 resolveModelCompat 透传中增加 supportsDeveloperRole?: boolean。
2. 当配置 compat.thinkingFormat: "deepseek" 时，把 supportsDeveloperRole 默认设为 false（DeepSeek 协议永远不接受 developer 角色）。
3. 在自定义服务商编辑器的 UI 里暴露每个模型的 reasoningEfforts / compat 配置，避免必须手改 settings.yaml。

[weijiafu14]

这里两个缺口可以一起绕过，但不是继续手写同一段 settings。做法是让网关对应的 Pi provider package 经 pi2dsh 注册原生 route：

dsh plugin --profile web add pi2dsh
dsh plugin --profile web add <Pi provider 包>

自带 transport 的 provider 会把自己的 thinkingLevelMap 暴露成 DSH 推理档位，并在用户选择后把 effort 传给 stream；它模型描述上的 supportsDeveloperRole: false 同样直接参与请求组装，不经过 PiAiCompatProfile 白名单。

我们在真实 DSH 选择器和透传请求体上都验过：档位出现、选择值下传、首条 role 为 system。这条方案不会修改原 settings 路径，原 schema 问题仍需上游修。