[BUG] llm-pi-ai 应支持配置 compat.supportsDeveloperRole

[Sn0wo2]

在我使用自定义OpenAI-compatible网关时，reasoning模型会将system prompt自动发送为developer role;
但部分LLM网关只支持system/assistant/user/tool。
比如: 火山 Coding Plan/Agent Plan:

failed to stream request: Request failed: Bad Request, error: The parameter `messages.role` specified in the request are not valid: invalid value: `developer`, supported values are: `system`, `assistant`, `user`, `tool`. Request id: 02178663536702991be90b70b1bfc3059428bd07e108b7e3fbf3e, code: InvalidParameter, type: BadRequest

---

pi-ai已支持：

compat: {
  supportsDeveloperRole: false
}

但DSH的llm-pi-ai配置目前只暴露：

compat:
  thinkingFormat: ...
  supportsReasoningEffort: ...

希望增加：

compat:
  supportsDeveloperRole: false

从而支持「reasoning + system role」而不必禁用reasoning~

[AlbireoA]

我也遇到了

场景：自定义 OpenAI-compatible 网关 newapi，上游是 Opencode Go。模型声明 reasoningEfforts 后（reasoning: true），system prompt 被 pi-ai 以 developer role 发送，上游 400：

Failed to deserialize the JSON body into the target type:
messages[0].role: unknown variant `developer`, expected one of
`system`, `user`, `assistant`, `tool`, `latest_reminder`

我让dsv4f查的原因（已验证）：

1. useDeveloperRole = model.reasoning && compat.supportsDeveloperRole（openai-completions.js:788）
2. supportsDeveloperRole 默认按 baseURL 自动检测（detectCompat）：非标准网关列表（deepseek.com / openai / opencode.ai 等）之外的 URL 一律判定为 true
3. 于是对 roxyai.online 这类中转网关误判为"支持 developer role"
4. 而 dsh 的 llm-pi-ai 配置层无法覆盖它：compatProfile schema 只有 thinkingFormat / supportsReasoningEffort 两个字段，settings 里写 supportsDeveloperRole: false 会被 resolveModelCompat 静默丢弃，最终回退 URL 检测

临时本地修复方法（packages/llm/llm-pi-ai，改动两处）：
resolveModelCompat 透传该字段：

 	const thinkingFormat = entry.compat?.thinkingFormat ?? route?.thinkingFormat;
 	const supportsReasoningEffort = entry.compat?.supportsReasoningEffort ?? route?.supportsReasoningEffort;
+	const supportsDeveloperRole = entry.compat?.supportsDeveloperRole;
-	if (thinkingFormat === void 0 && supportsReasoningEffort === void 0) return {};
+	if (thinkingFormat === void 0 && supportsReasoningEffort === void 0 && supportsDeveloperRole === void 0) return {};
 	return { compat: {
 		...base?.api === api ? base.compat : void 0,
 		...thinkingFormat === void 0 ? {} : { thinkingFormat },
-		...supportsReasoningEffort === void 0 ? {} : { supportsReasoningEffort }
+		...supportsReasoningEffort === void 0 ? {} : { supportsReasoningEffort },
+		...supportsDeveloperRole === void 0 ? {} : { supportsDeveloperRole }
 	} };

schema 增加字段（与 pi-ai 的 OpenAICompletionsCompat 对齐）：

 const compatProfile = z.object({
 	thinkingFormat: z.union(SUPPORTED_THINKING_FORMATS),
-	supportsReasoningEffort: z.boolean()
+	supportsReasoningEffort: z.boolean(),
+	supportsDeveloperRole: z.boolean()
 });

修复后在settings.yaml的对应位置填入supportsDeveloperRole: false即可
实测修改后可用，可以临时这样改

希望deepseek harness尽快支持supportsDeveloperRole字段

[adam40341619-del]

补充一个场景：DashScope（百炼）官方 OpenAI 兼容端点同样受此影响，不只是第三方网关。

复现：~/.dsh/settings.yaml 自定义 route，baseURL: https://dashscope.aliyuncs.com/compatible-mode/v1，api: openai-completions，模型 qwen3.8-max 配 compat.thinkingFormat: qwen。声明 reasoningEfforts（如 off + high）后，dsh --profile headless "<prompt>" 立即失败：

dsh: INVALID_REQUEST: 400: {"message":"developer is not one of ['system', 'assistant', 'user', 'tool', 'function']","type":"invalid_request_error","param":null,"code":"invalid_parameter_error"}

已排除 API 侧：直接 curl 该端点带 enable_thinking: true，reasoning_content 正常流式返回（61 reasoning tokens / 问题规模很小）。pi-ai 的 qwen wire 编码本身正确（openai-completions.js:571 发 enable_thinking），400 纯粹来自 developer role。

版本：dsh 0.1.0-rc.6（npm latest）。compatProfile schema（dsh-llm-pi-ai/lib/index.js:1333）只暴露 thinkingFormat / supportsReasoningEffort，确认无配置可修。

补充一个修复线索：pi-ai 内置 catalog 里同一端点族的条目（dist/providers/data/qwen-token-plan.json，token-plan.*.maas.aliyuncs.com/compatible-mode/v1）已经显式写了 "supportsDeveloperRole": false。所以除了暴露配置字段，把 dashscope.aliyuncs.com 加入 detectCompat 的 non-standard 判定也能对齐内置行为。

影响面：任何把 Qwen thinking 模型挂在 DashScope 兼容端点上的 dsh 用户，当前版本完全没有配置路径开启推理模式（只能本地代理重写 role）。

[Sn0wo2]

目前较为干净的办法就是起一个api gateway, 去patch里面的developer role到system role; 期待DeepSeek Harness在后续版本解决这个问题