dsh-thinking-levels

dsh plugin --profile web add dsh-thinking-levels

dsh-thinking-levels

为 DeepSeek Harness (dsh) 提供按轮次的思考档位（reasoning_effort）控制：在会话模型选择器中可选 Auto（mask）——由插件按工具调用历史自动在 low / high / max 间调度后提交 API；也可手动固定 off / on / minimal / low / medium / high / xhigh / max，让廉价工具轮次保持廉价，同时绝不让重任务缺少推理。

v0.7.0-beta.1（2026-09-06）：短路路线退役。 本版本不再依赖 dsh-llm-openai-completions——自定义网关修复全部改走 dsh 官方 llm-pi-ai compat 面（要求 dsh ≥ v0.1.0-rc.8），短路插件应保持卸载。详见 [CHANGELOG](./CHANGELOG.md)。

• [English README](./README.md)
• [中文 README](./README.zh.md)
• [日本語 README](./README.ja.md)
• [한국어 README](./README.ko.md)
• [README en français](./README.fr.md)
• [Deutsche README](./README.de.md)
• [README in italiano](./README.it.md)
• [README на русском](./README.ru.md)
• [README en español](./README.es.md)
• [安装指南](./INSTALL.zh.md)
• [English installation guide](./INSTALL.md)
• [日本語インストールガイド](./INSTALL.ja.md)
• [한국어 설치 안내](./INSTALL.ko.md)
• [Guide d'installation en français](./INSTALL.fr.md)
• [Installationsanleitung auf Deutsch](./INSTALL.de.md)
• [Guida all'installazione in italiano](./INSTALL.it.md)
• [Руководство по установке на русском](./INSTALL.ru.md)
• [Guía de instalación en español](./INSTALL.es.md)
• [版本更新日志](./CHANGELOG.md)
• [日本語 changelog](./CHANGELOG.ja.md)
• [한국어 changelog](./CHANGELOG.ko.md)
• [Changelog en français](./CHANGELOG.fr.md)
• [Changelog auf Deutsch](./CHANGELOG.de.md)
• [Changelog in italiano](./CHANGELOG.it.md)
• [Список изменений на русском](./CHANGELOG.ru.md)
• [Changelog en español](./CHANGELOG.es.md)

兼容性说明： 0.6.0 已包含日本語（ja）和한국어（ko）字典及选择项，但当前官方 DSH 只通过 LocaleRuntime 提供 zh 和 en。在原版 DSH 中选择 ja 或 ko 会失败，并提示 locale "<id>" is not registered。需要等待官方 DSH 增加对应 locale ID 后才能正常使用。高级用户可以维护 DSH fork，在 packages/client/locale/src/locale-settings.ts 更新 LOCALE_IDS，在 packages/client/locale/src/client/index.ts 更新 LOCALES 标签，并补齐核心字典和测试，然后重新构建并运行 fork 版本。仅修改本插件无法扩展 DSH 的全局 locale 列表。

版本兼容： 本版本（4.3.x）按 DSH 宿主精确 16 档枚举钉定：0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4 || 0.2.1-rc.5——逐 rc 单列，不用区间/caret；0.2.1 稳定线发布前不声明。自 0.1.7-rc.1 边界起，DSH 移除了命令式设置注册（settings.register / installSettingsSection）与客户端 settingsScope 服务及每插件卡片槽位，运行时调整的配置字段在 schemastery schema 中标 .volatile()，设置表单由宿主按 schema 自动生成（无注册调用、无客户端设置卡片），插件按请求读取实时值（由 loader/volatile-update 驱动）——4.0.x 面向 0.2.0-rc 区段的同一声明式表面；0.1.7-rc.1 至 <0.2.0 的宿主请使用 3.x 线（3.4.3，npm dist-tag dsh-0.1.7），0.1.2–0.1.6 宿主请继续使用插件 3.0.2。

版本范围约定： 每条兼容线都把宿主钉在本线自己的区段内。面向 0.1.x 宿主的线遵循 >=0.1.x-rc.1 <0.1.(x+1)-0（3.1.x：>=0.1.7-rc.1 <0.1.8-0；3.0.x：>=0.1.5-alpha.1 <0.1.6-0；2.0.x：>=0.1.2-alpha.1 <0.1.3-0；1.0.0-beta：>=0.1.0-rc.8 <0.1.2-alpha.1）；面向 0.2.x 区段的线遵循 >=0.2.0-rc.1 <0.2.1-0（4.0.x：>=0.2.0-rc.1 <0.2.1-0）。任何线都不声明开放的上限，兼容性解析器因此绝不会把插件线匹配到它并未适配的更新宿主区段。0.4.0–0.6.0 完全没有声明 dsh peer 依赖，属于无兼容性标注版本——不要安装。自 4.2.x 多线时代起，4.x 线改用上述逐 rc 精确枚举钉定宿主，区间公式仅描述历史上的分区段线。

在多步工具链任务中，模型在每一次工具调用前都会重新思考——而这个思考过程占据了绝大部分墙钟时间（一个 50 步的 agent 任务可能在工具之间花费数分钟思考）。dsh-thinking-levels 接入 dsh 每一步都会重新解析的 agent/request waterfall（以 prepend 置于最外层，避免被会话模型选择覆盖），向下一次模型请求注入思考档位。

档位

档位 · 含义 · 位置

off · 关闭思考（仅手动选择，自动调度永不选用） · 模型选择器 / 默认档位

on · 开启思考（仅 toggle 型模型）：只发 enable_thinking，不发 think effort · 模型选择器 / 默认档位

minimal · 最低档（极轻任务） · 模型选择器 / 默认档位

low · 手动低档，对应简单对话任务（廉价轮次保持廉价） · 模型选择器 / 默认档位

medium · 中档 · 模型选择器 / 默认档位

high · 官方默认档位 · 模型选择器 / 默认档位

xhigh · 特高档 · 模型选择器 / 默认档位

max · 重任务 · 模型选择器 / 默认档位

auto · mask：按最近的工具调用历史逐轮调度，提交 API 前解析为具体档位 · 模型选择器（由插件注入元数据）/ 默认档位

线缆档位事实（对照官方 DeepSeek 文档与 dsh llm-deepseek 适配器核实）：deepseek-v4-flash / v4-pro 上 low 1:1 生效，medium / xhigh 折叠到 high。适配器只接受 off | low | high | max，其他值抛 UNSUPPORTED_REASONING_EFFORT——auto 是插件的 mask 层，永不直接发送给 API，注入前必然解析为具体线缆档位。on 不是 effort 档位：它只由 toggle 型模型（Qwen3.6 类）广告，且只把 enable_thinking 置 true——不发送 reasoning_effort；effort 能力模型永不广告 on，所以手动选 on 会被剥离。

自定义传输字段映射

对 llm-pi-ai 手工声明的模型，可以把每个档位映射为你网关真正接受的值（借鉴 dsh-thinking-effort）：勾选档位并填写线上值，例如 high → ultra。映射存为该模型的 reasoningEfforts 表——Composer 选中 High 时，网关实际收到 ultra。off 留空表示不发送。

该映射的可视化编辑器原先搭载在插件设置卡片上，DSH 0.1.7 迁移已将其移除（对应槽位不复存在）。请改为通过官方「模型」设置面编辑 reasoningEfforts 表——host 侧的检测与注入本就实时读取该配置。

• 官方预设：Off / High / Max（官方 DeepSeek 风格）
• 通用预设：Off / Low / Medium / High

思考强度滑块（逐模型行）

模型面板里的逐行思考强度下拉框已改造为分段滑块：点击模型行的档位 chip（显示当前生效档位或「提供方默认」），该行下方展开全宽滑动条。分段数随模型广告的档位自适应——toggle 型只有两档、官方 off/low/high/max、网关自定义线上值均可；目录带 auto mask 时 auto 恒在最左，其后依次 off/on 与强度递增档，未知线上值排最末。

选择器头的档位 chip（4.4.0 起）显示的是用户意图而非调度器的解析值：意图为 auto 时主标签保持 Auto，本步实际发出的档位降为次级标注（如 → low）。注意：关闭模型界面接管时，官方选择器的 chip 仍显示本步解析值（宿主投影语义，插件不可代改）。

交互对齐 dsh-reasoning-effort 已批准的视觉基线：滑钮拖动时连续跟手、松手吸附提交（每次手势只写一次路由）；普通滑钮全主题纯白；两端刻度处滑钮完整可见；键盘 ←/→/Home/End 逐档移动。原「提供方默认」重置保留为滑块行的 ↺ 按钮。

DeepSeek 行（官方路由，或 id/名称含 deepseek 的网关模型）滑钮为鲸鱼娘奔跑立绘：8 帧侧面奔跑 strip，乒乓循环（静止 720ms/单向，拖动中 420ms/单向），prefers-reduced-motion 下冻结；其他模型为普通白色圆钮。

模型界面接管（4.4.0 起）

新增设置项「模型界面接管」（takeoverUi，缺省关闭）：关闭时不替换官方模型弹窗——搜索、分组、加载都由宿主原生选择器负责，auto 档位照常经服务端广告出现；官方模型的上下文编辑在设置卡内完成。开启时恢复本插件的 ModelPanel 接管（逐行上下文/档位编辑 + 弹窗搜索）。切换即时生效，无需重载。

立绘为社区鲸鱼娘二创，来源 HanaAyane/dsh-reasoning-effort（assets/chibi-runner-strip.png）；用 python tools/whale-mascot.py 可重新生成内联素材。

模型能力守卫（v0.5.0）

插件绝不向未声明推理能力的模型发送 reasoning_effort。自定义 openai-completions 路由（如未配置 reasoningEfforts 的本地 Qwen3.6）通过 ctx.llm.resolveModelInfo 被判定为非推理模型，任何档位（继承的或调度产生的）都会被剥离而不是下发——dsh 的逐请求 UNSUPPORTED_REASONING_EFFORT 拒绝因此不会触发。不支持的字段绝不打进 API。

版本行为：

dsh 版本 · low 处理

rc.6（老） · 非原生：仅当配置 models 覆盖确认该档位时选择器才显示；注入展示（选择器 + 请求校验放行）后原样透传

rc.7+（新） · 原生：插件既不重写也不重复注入；手动选 low 原样透传

auto 调度对支持的模型仍可选出 low——由上面的能力守卫负责让它远离不能接收它的模型。

模型选择器 Auto

会话界面模型选择器（模型旁）现在提供 *

…(truncated)