Bug: llm-pi-ai 丢弃 supportsDeveloperRole，SGLang/Qwen 收到 developer role 后返回 400

[Anothers]

TL;DR

@deepseek-ai/dsh-root@0.1.0-rc.7 的 llm-pi-ai 配置 schema 会静默丢弃显式的 compat.supportsDeveloperRole: false。pi-ai 随后按 URL/模型自动推断 reasoning model 支持 developer message role；只接受 system role 的 SGLang/Qwen OpenAI-compatible endpoint 因此返回 HTTP 400 Unexpected message role.。

官方目前不接受外部 PR，下面的 fork 分支仅作为可审阅、可 cherry-pick 的修复与测试证据。

环境

• DeepSeek Harness：0.1.0-rc.7，上游基线 99f6f02fecdb7dff40c3fbc9470f5907c29f74ca
• Provider：自托管 SGLang OpenAI-compatible endpoint
• Model：Qwen reasoning model
• Route protocol：openai-completions

没有在报告或分支中提交 endpoint、API key 或本地部署配置。

现象

配置希望覆盖自动探测：

- id: llm
  name: "@deepseek-ai/dsh-llm-pi-ai"
  config:
    providers:
      local-qwen:
        api: openai-completions
        baseURL: https://example.invalid/v1
        compat:
          supportsDeveloperRole: false
        models:
          - id: qwen-reasoning
            reasoningEfforts:
              off:
              high: high

但 rc.7 实际发出的第一条 instruction message 是：

{"role":"developer","content":"..."}

SGLang 返回 HTTP 400，底层错误为 Unexpected message role.。在 Harness 页面上，该请求还可能表现为 400 status code (no body) / CONTEXT_WINDOW_EXCEEDED，容易被误诊为上下文长度问题。

应用修复后，相同配置和其他参数不变，实际 payload 变为：

{"role":"system","content":"..."}

本地 Standard 与 Router Standard 两条真实请求均正常完成。

根因

PiAiCompatProfile 和 compatProfile schema 只暴露了：

• thinkingFormat
• supportsReasoningEffort

因此配置加载阶段会丢掉 supportsDeveloperRole: false。resolveModelCompat() 也没有把该字段按 model → route → installed catalog → pi-ai URL detection 的顺序合并。布尔值 false 丢失后，pi-ai 只能使用自动推断，并给 reasoning model 发送 developer role。

修复

修复分支：

• Branch: https://github.com/Anothers/deepseek-harness/tree/fix/pi-ai-developer-role-compat
• Commit: Anothers@bab04e4

改动包括：

1. 在 public config type 与 schema 中加入 supportsDeveloperRole?: boolean。
2. 在 route/model compat 解析中逐字段合并该值，model override 优先于 route default。
3. 仍只允许它用于 openai-completions，其他 protocol 保持 fail-loud。
4. 增加 schema boundary 测试，固定 false 不会被物化过程吞掉。
5. 增加真实 mock HTTP provider 回归测试，断言 reasoning request 的 system prompt 以 role: system 发出。
6. 同步英文/中文 README、generated config catalog 与既有 Agent Note。

验证

• llm-pi-ai：9 个测试文件，218 项全部通过。
• 受影响的 catalog.ts、config.ts：statements / branches / functions / lines 均为 100%。
• 仓库 pre-push 全量 build + TypeScript typecheck 通过。
• 946 组中英文文档 pairing 检查通过；其余 27 项 doc-sync gates 通过。
• 本地真实 SGLang 请求：修复前 developer → 400；修复后 system → 成功。

如果维护者认可这个配置边界，可以直接采用或 cherry-pick 上述提交；提交基于当前 rc.7 master，未包含任何本地部署 patch。

[voodoodoy]

升级一下吧，我看dsh-v0.1.0-rc.8里已经修复了，我用的dsh-v0.1.1-rc.2正常，是这个commit增加的

[weijiafu14]

最新评论判断正确：该字段已由 rc.8 相关 commit 加入，当前 0.1.1-rc.2 可正常使用。升级后保留 compat.supportsDeveloperRole: false，并从实际 HTTP 请求确认角色为 system。现在应按“上游已修、升级解决”处理。