Mu-scorpio/dsh-reasoning-effort

dsh-reasoning-effort

npm 版本
npm 下载量
GitHub
许可证

让自定义 DeepSeek Harness Provider 真正拥有可用、可控的推理强度。

dsh-reasoning-effort 是一个独立的 DSH Bundle，在 llm-pi-ai 的 settings
命名空间中补齐缺失的推理强度声明。它支持 Provider 默认值、按模型覆盖和
协议 wire 值映射，同时不会替换已有设置。

模型选择器与最高推理强度特效

_模型选择器按 Provider 折叠分组；可以为任意已接入模型配置推理强度，滑到最高级时会出现紫色辉光、边缘闪烁和拖尾特效。_

实时推理强度滑块

_GIF 展示滑块在离散档位间移动；到达最高档时会出现紫色辉光、边缘闪烁和扫光拖尾。_

它解决什么问题

不同 Provider 对同一个概念使用不同的词汇：有的接受 low / medium /
high，有的需要自己的字符串，还有的必须按模型单独处理。这个插件把它们
统一到 Harness 的推理强度等级，再把每个 Provider 实际需要的 wire 值映射出去。

它只做必要的配置工作：

- 零配置自动发现当前 llm-pi-ai 中的全部现有 Provider；
- 为常见 DSH 适配协议提供按 Provider 识别的默认映射；
- 支持 Provider 级和模型级推理强度映射；
- 支持 Provider 级默认推理等级；
- 支持用 disabled: true 显式关闭某个模型的推理能力；
- 以追加方式更新 settings，保留已有声明。
- 在输入框发送按钮旁提供按模型变化的推理条；
- 与 DSH 自带模型菜单共用同一条选择路径；
- 最高档启用清晰的紫色特效，方便确认当前推理强度。

安装

将 npm 上已构建的 Bundle 安装到 DSH web profile，然后重启正在运行的 Harness：

dsh plugin --profile web add -w dsh-reasoning-effort
dsh web

包已经发布了预构建产物，正常安装不需要从源码编译插件。

配置

默认不需要写 Provider 名称。插件会从 llm-pi-ai settings 自动发现当前电脑上
已经存在的全部 Provider，并为其中缺少声明的模型补齐通用推理档位。因此，
Bundle 不再把 cliproxyapi、jyld 或任何其他名称当作默认白名单。

只有特殊网关需要不同 wire 值、需要排除某个 Provider，或需要单独处理模型时，
才在最终使用的 Cordis patch 中加入覆盖：

- insert:
- id: reasoning-effort
name: dsh-reasoning-effort
config:
defaults:
reasoning: medium
providers:
special-provider:
api: openai-responses
efforts:
high: reasoning_high
models:
non-reasoning-model:
disabled: true
excluded-provider:
disabled: true

配置字段

| 字段 | 作用 |
| --- | --- |
| auto | 是否自动发现全部现有 Provider，默认 true；设为 false 时只处理 providers 中显式列出的项。 |
| defaults.api | 当 Provider 自身没有 api 时使用的协议回退值。 |
| defaults.reasoning | 为所有 Provider 补充默认推理等级，但不覆盖已有值。 |
| defaults.efforts | 覆盖所有 Provider 的通用 wire 值映射。 |
| providers..api | 为指定 Provider 选择协议默认映射。 |
| providers..reasoning | 为指定 Provider 补充默认推理等级。 |
| providers..efforts | 覆盖指定 Provider 的 wire 值映射。 |
| providers..disabled | 排除指定 Provider。 |
| providers..models..efforts | 单独覆盖某个模型的映射。 |
| providers..models..disabled | 显式标记某个模型不使用推理强度。 |

Harness 支持的等级为 off、minimal、low、medium、high、xhigh 和
max。内置协议映射覆盖 low 到 max 五个常用等级；特殊网关可以自行提供
对应的实际值。

Provider 必须已经存在于 llm-pi-ai settings 中。插件只增强现有 Provider，
不会重新创建已经被删除的 Provider。

默认安全策略

这个插件可以和已有 DSH 配置并排工作：

- 已有的 reasoningEfforts 永远不会被覆盖，包括 false；
- 模型中与推理无关的字段保持不变；
- llm-pi-ai 延迟注册时会短暂重试；
- settings 更新后会重新执行一次追加同步；
- 不新增 Provider 凭据、请求、工具或遥测。

换句话说，它只准备好 settings 契约，具体的模型控制仍交给 DSH 自己完成。

输入框推理条

浏览器端会读取当前模型公布的推理等级，把这些等级绘制成离散滑条，
并通过 DSH 共享的模型目录提交选择。拖动过程中，文字、填充条和最高档特效
只在前端实时更新；松手后才把最终位置提交给后端。没有推理元数据的模型不会
显示空控件。

本地开发

通过本地 overlay 运行与发布 Bundle 相同的配置：

pnpm install
npm run build
dsh web --patch ./cordis.yml

cordis.yml 会挂载 src/index.ts，并使用与 Bundle patch 相同的零配置自动发现行为。

许可证

MIT