前言¶

在 DSH 中配置自定义 llm-pi-ai 提供方时，除了 provider 和 model，还经常需要处理推理强度：每个模型支持哪些级别，每个级别实际发送什么 wire value，provider 的默认值是什么。

dsh-reasoning-settings 是面向这个场景的 DSH 插件。它为自定义提供方提供独立的推理强度设置页，并支持在 subagent 调用中选择 provider、model 与推理强度。

这是什么¶

dsh-reasoning-settings 由 JuneLearn 维护，许可证为 MIT。

它围绕模型推理配置和自定义提供方设置，主要解决两类问题：

• 为自定义 llm-pi-ai 提供方声明可选择的推理强度级别，并配置实际发送的 wire value。
• 在 subagent 调用中，让模型路由和推理强度继承更符合父级当前选择。

核心能力¶

设置页能力¶

插件的设置页能力包括：

1. 自动读取官方 Models 页面中已添加的自定义 providers 和 models。
2. 为每个模型声明 off / minimal / low / medium / high / xhigh / max 推理强度级别。
3. 为每个级别自定义实际发送到 API 的 wire value。
4. 设置 provider 范围默认推理强度，并限制在该 provider 所有模型支持的级别内。
5. 为 openai-completions provider 配置推理 wire format。
6. 通过官方 settings.mutate API 写回 llm-pi-ai.providers.*，且不触碰 API keys。

子代理调用能力¶

插件在 subagent 调用方面提供以下能力：

1. 修复进程内 subagents 继承 Agent 创建时的官方模型，而不是父级当前第三方 provider/model 选择的问题。
2. 让 subagents 继承显式父级推理强度，或回退到目标 provider 配置的默认推理强度。
3. 将仅 model 的子覆盖（如 grok-4.5）解析到用户配置的第三方 provider，而不是无关的官方 provider。
4. 扩展普通 subagent 与 subagent_fork 工具，增加每次调用的 provider、model、reasoning_effort 字段，且不替代其官方生命周期、后台或结果行为。
5. 服务器入口修复针对 Harness 0.1.0-rc.5 的进程内 subagent、subagent_fork 与 Workflow children。

安装与启用¶

安装前先检查运行环境。

运行环境需要 Node.js 22.19.x 或 24 及以上版本，推荐 Node.js 24 LTS；还需要 Git、pnpm，并能访问 registry.npmjs.org 与 github.com。

npx 方式¶

npx 方式不需要 DeepSeek Harness 源码 checkout。

先安装插件：

npx --yes -p @deepseek-ai/dsh dsh plugin --profile web add github:JuneLearn/dsh-reasoning-settings

安装后启动 Web：

npx --yes -p @deepseek-ai/dsh dsh web

Web 默认监听 http://127.0.0.1:3080；仅默认端口被占用或显式选择其他端口时使用其他端口。

pnpm 源码方式¶

pnpm 源码方式需要 DeepSeek Harness 源码树。

进入 D:\deepseek-harness 后安装插件：

cd D:\deepseek-harness
pnpm dsh plugin --profile web add github:JuneLearn/dsh-reasoning-settings

然后启动 Web：

cd D:\deepseek-harness
pnpm dsh web

升级¶

升级时再次运行对应的安装命令；无需卸载或维护 profile-patch。

npx 方式再次运行：

npx --yes -p @deepseek-ai/dsh dsh plugin --profile web add github:JuneLearn/dsh-reasoning-settings

pnpm 源码方式再次运行：

cd D:\deepseek-harness
pnpm dsh plugin --profile web add github:JuneLearn/dsh-reasoning-settings

卸载¶

npx 方式卸载：

npx --yes -p @deepseek-ai/dsh dsh plugin --profile web remove dsh-reasoning-settings

典型用法¶

下面是一个完整使用路径：

1. 先在官方 Models 页面添加自定义 provider 和模型。
2. 打开 Settings > Reasoning effort。
3. 为每个模型选择支持的推理强度级别。
4. 设置 provider 默认强度。
5. 在该 provider 下点击 Save。
6. 开始新会话后，在模型选择器中选择模型和推理强度。

这里需要区分“能发送”和“被接受”：插件只声明 Harness 可选择和发送的推理强度级别；relay API 是否真正支持取决于该 relay。

如果请求返回 HTTP 400，应取消该模型不支持的级别或调整其 wire value。

子代理工具字段¶

插件扩展普通 subagent 与 subagent_fork 工具，增加每次调用的字段：

• provider：已配置的 provider id。
• model：该 provider 拥有的 model id。
• reasoning_effort：可选的 off / minimal / low / medium / high / xhigh / max 级别。

使用规则如下：

• provider 和 model 必须一起提供。
• 省略两者保持正常继承。
• 省略 reasoning_effort 时，按目标 provider 配置的默认推理强度处理。

适用场景与注意¶

适合以下场景：

• 已配置自定义 llm-pi-ai provider 和 models 的 DSH 使用场景。
• 需要为不同模型声明推理强度级别，并配置实际发送 wire value 的场景。
• 需要在 subagent 或 subagent_fork 调用中按次指定 provider、model 与推理强度的场景。

使用前注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码、依赖与许可证。
• 插件不触碰 API keys，仅通过官方 settings.mutate API 写回 llm-pi-ai.providers.*。
• 插件独立于任何特定 relay；资料中包含第三方 API relay 推广链接和兑换码，但插件不要求任何特定 relay。
• 是否使用第三方 relay 服务，应自行判断其价格、可靠性与隐私条款。

参考¶

• GitHub：https://github.com/JuneLearn/dsh-reasoning-settings
• 社区目录页：https://www.skillhub.cn/plugins/JuneLearn/dsh-reasoning-settings

社区目录页是独立站点，不是官方应用商店；不要将插件目录与 DeepSeek / 幻方理解为官方从属关系。