deepseek-official 适配器不支持 reasoning_effort: "low"

[lys849]

[Feature Request] deepseek-official 适配器不支持 reasoning_effort: "low"（官方 API 已支持，建议放行并归一 medium/xhigh）

摘要 / Summary

DeepSeek 官方文档明确支持 reasoning_effort: low/high/max（medium/xhigh 兼容映射为 high），且 V4-Pro GA 宣传口径为 "low for simple tasks, high for daily Agent workflows, max for complex tasks"。但 DeepSeek Harness 的官方 provider deepseek-official（@deepseek-ai/dsh-llm-deepseek）能力白名单只有 off / high / max，low 在请求发出前就被客户端校验拦截，导致官方模型在 DSH 内无法使用文档推荐的低推理档。

English summary: The official DeepSeek API documents and accepts reasoning_effort: low (plus medium/xhigh compat-mapped to high) for deepseek-v4-pro/deepseek-v4-flash, but the DSH deepseek-official provider adapter (@deepseek-ai/dsh-llm-deepseek) only whitelists off | high | max, so any explicit low is rejected client-side before the request reaches the API. Suggest adding low to the whitelist (and normalizing medium/xhigh → high per the official mapping).

复现 / Reproduction

• 环境：DeepSeek Harness 0.1.0-rc.6（macOS arm64，Node v26；Web GUI 与 headless 均复现）
• 模型：deepseek-v4-pro（provider deepseek-official）
• 操作：任何方式显式设置推理档为 low（模型选择器无该档位，需手写配置或脚本传入）
• 报错（在发出任何 HTTP 请求之前，由客户端预检抛出）：

UNSUPPORTED_REASONING_EFFORT: provider "deepseek-official" model "deepseek-v4-pro" does not support reasoning effort "low"

对照实验（同一环境同一模型）：

显式档位	结果
low	❌ UNSUPPORTED_REASONING_EFFORT（客户端预检拒绝，无 API 请求）
medium	❌ 同上（文档口径：应兼容映射为 high）
high	✅ 通过（默认档位，日常可用）
max	✅ 通过（实测：request/header 记录 reasoningEffort: "max"，会话正常完成）

官方文档依据 / The API itself accepts low

直接调用官方 API（https://api.deepseek.com/chat/completions，模型 deepseek-v4-pro），reasoning_effort 分别传 low / medium / high / max，四次全部 HTTP 200。因此问题不在 API 侧。

文档出处：

• Thinking Mode 指南：OpenAI 兼容格式 reasoning_effort 取值为 low / high / max，默认 high；官方映射表：low→low、medium→high、high→high、xhigh→high、max→max（deepseek-v4-flash 与 deepseek-v4-pro 一致）。
• Chat Completions API 参数：reasoning_effort 的 Possible values: [low, high, max]，原文注明"出于兼容考虑 medium、xhigh 会映射为 high"。
• V4-Pro GA 新闻："Flexible reasoning effort for V4-Pro & V4-Flash: low for simple tasks, high for daily Agent workflows, max for complex tasks"。

根因定位 / Root cause（客户端适配层白名单）

请求在发出前被 DSH 客户端预检拦截，未到达 DeepSeek API：

1. 适配器白名单：@deepseek-ai/dsh-llm-deepseek/lib/index.js — reasoningEffort() 校验函数只接受 "off" | "high" | "max"（L19–22）；能力列表 REASONING_EFFORTS = [off, high, max]（L415–431），resolveModel() 只向 harness 暴露这三个档位（L505–526）；该适配器注册的 provider 名即 "deepseek-official"（L632）。
2. 通用校验层：@deepseek-ai/dsh-llm/lib/index.js（L1245 附近）对"请求档位 ∈ 模型注册能力列表"做预检，不通过即抛 UNSUPPORTED_REASONING_EFFORT——实测文案与该处逐字一致。
3. 线上格式本身正确：适配器发送 thinking: { type: "enabled" } + reasoning_effort: <档位>（snake_case），与文档 OpenAI 格式一致；low 无需任何新映射，直接透传即可。
4. 上游现状：截至 2026-08-13 的 master 分支 packages/llm/llm-deepseek/src/index.ts L95 仍为 reasoningEffort: z.union(['off', 'high', 'max'])，尚未修复。

影响 / Impact

• 官方模型在 DSH 内只能使用 off / high / max，文档推荐用于简单任务的 low 档不可达（GUI 推理等级选择器也不提供该档位）。
• 想用 low 只能绕行：① 用 llm-pi-ai 手工声明指向 api.deepseek.com 的路由并逐模型声明 reasoningEfforts（含 low）；② 安装社区插件 dsh-thinking-effort（见相关讨论 【插件】dsh-thinking-effort：第三方（pi-ai）模型也能设置思考强度——默认档位自动补齐 + 设置页自定义 #1817）。

建议修复 / Suggested fix

1. 将 "low" 加入 @deepseek-ai/dsh-llm-deepseek 白名单：reasoningEffort() 校验（L19–22）、REASONING_EFFORTS（L415–431）、以及 GUI 模型选择器的档位展示；low 的线上透传与 high/max 相同（thinking: enabled + reasoning_effort: "low"）。
2. 可选：按官方映射表兼容 medium/xhigh → 归一为 high（文档明确这是官方兼容行为）。
3. 顺带建议：模型元数据若对已注册模型缺失 reasoning 能力信息（本次 low 报错走的是通用层"模型无 reasoning 能力"分支），应一并核对，避免显式档位校验行为不一致。

改动很小（一个 union 加一个枚举项 + UI 档位列表），但能对齐官方文档口径。

相关讨论 / Related

#122 第三方模型无法选择推理强度 · #302 自定义 provider 不支持 reasoning effort · #843 自定义 provider 模型无法从 GUI 选档 · #1643 网关选档功能请求 · #1817 dsh-thinking-effort 插件

以上均为第三方/自定义 provider 的档位入口问题；本帖针对的是官方 provider（deepseek-official）自身的档位白名单缺 low，是另一个独立缺口。

[zoahdev]

Confirmed in source and staged a patch.

packages/llm/llm-deepseek/src/adapter.ts:

const REASONING_EFFORTS = [
  { id: ReasoningEffortId('off'), name: 'Off' },
  { id: ReasoningEffortId('high'), name: 'High' },
  { id: ReasoningEffortId('max'), name: 'Max' },
]

No low ? so the client-side capability list rejects it before any request is sent.

Cherry-pick-ready branch (on current master): https://github.com/zoahdev/deepseek-harness/tree/fix/llm-deepseek-reasoning-low ? adds low to the whitelist (one const + one entry). medium/xhigh ? high normalization is a separate, small change if the official mapping should be enforced client-side too; say the word and I'll stage that as well.

[lys849]

感谢确认与补丁，跟我们在 rc.6 上的定位完全一致（同一处 REASONING_EFFORTS）。

关于 medium/xhigh 归一化：赞成一起做。官方文档明确 medium/xhigh 是兼容值、映射为 high；客户端归一后，习惯传 medium 的 OpenAI 风格工具链在 DSH 里也不会被 schema 拒绝，行为与 API 口径一致。

另外补丁可能还差两个位置，否则"选择 low"在请求阶段仍会被拦截（我们在 rc.6 编译版上实测过拒绝路径，对应 master 源码）：

1. src/serialize.ts：reasoningEffort() 校验（L26–34）只放行 off/high/max，resolveThinking()（L37–53）的 wire 分支只处理 high/max——能力列表放行后，请求会在这里继续抛 DeepSeek does not support reasoning effort "low"；需要把 low 加进校验、ResolvedThinking 类型（L22）和 wire 映射（L49–50）。
2. src/index.ts：部署配置 schema reasoningEffort: z.union(['off','high','max'])（L95，类型 L70）——不加 low 就无法把 low 设为部署默认档位。
   若归一化也做，这两处同样需接受 medium/xhigh 并映射为 high。

补丁齐了之后我可以在 macOS + rc.6 上用现成的 headless 验证通道对等复验一份。再次感谢！

[lys849]

这里src的路径可能造成疑惑，对应官方仓库路径分别为packages/llm/llm-deepseek/src/serialize.ts和packages/llm/llm-deepseek/src/index.ts

[zoahdev]

Patch now verified against the official test suite (full monorepo at master 47f9438, Windows / Node 24 / pnpm 11):

• Baseline (no patches): 45 test files / 1140 tests ?
• After applying all five staged patches (Bug: installing any plugin that depends on @deepseek-ai/dsh-tools breaks every tool call (Cannot read properties of undefined (reading 'prepare')) #1697/Bug: profile package.json with UTF-8 BOM crashes dsh web (Unexpected token ... is not valid JSON) #1842/【Bug】Windows 上官方 minimal（极简模式）预设的 bash 无法启动：默认 shellPath /bin/bash 不可解析（实测+修复建议） #1856/deepseek-official 适配器不支持 `reasoning_effort: "low"` #1861/Bug: single tilde (~) renders as strikethrough — gfm() default singleTilde:true in client-ui-primitives markdown parser #1869): 46 files / 1146 tests ? (exit 0)

This patch (fix/llm-deepseek-reasoning-low) required updating 3 official adapter assertions that hard-coded the old off/high/max list ? that test update is now part of the branch (commit 9cb2afa), so the patch is self-contained and CI-clean.

Full verification matrix: https://github.com/zoahdev/dsh-docs/blob/main/docs/specs/upstream-patches.md

[lys849]

验证可信，想补充一点：CI 全绿与"选择 low 后请求能跑通"之间还有距离。分支当前改动只有 packages/llm/llm-deepseek/src/adapter.ts 与 tests/adapter.spec.ts 两处（能力列表加 low + 对应断言更新）；官方测试套件对推理档的覆盖集中在 serialize.spec.ts——它只测现有档位（off/high/max 的 wire 映射、部署锁死拒绝、medium 拒绝），没有 low 用例，所以分支测试全绿是必然的，但 low 在请求路径上仍会被拦：

1. packages/llm/llm-deepseek/src/serialize.ts：reasoningEffort() 校验（L26–34）仍只放行 off/high/max，wire 分支（L49–50）只处理 high/max——能力列表放行后，请求会在这里抛 DeepSeek does not support reasoning effort "low"（错误码相同，来源从通用层移到适配器层，现象不变）。建议同步把 low 加进校验、ResolvedThinking 类型（L22）和 wire 映射，并在 serialize.spec.ts 补一条 low → reasoning_effort: "low" 的用例（L206–213 那条 max 用例的镜像）。
2. packages/llm/llm-deepseek/src/index.ts：部署 schema reasoningEffort: z.union(['off','high','max'])（L95）与类型（L70）——不加 low 就无法把 low 设为部署默认档位（该 schema 目前无测试覆盖）。