前言¶

在 DSH 中处理 custom provider 的模型时，有些推理级别需要写入 llm-pi-ai 配置。如果只想在 Web UI 中调整单个模型的 reasoning effort，而不是每次都手动改配置文件，可以把这类设置页做成插件加入。

DSH Effort Tweak 就是为这个场景提供的一个小型 DSH 插件。下面介绍它的用途、安装方式、典型用法和需要注意的事项。

这是什么¶

toukaiteio/dsh-effort-tweak 是由 Toukaiteio 维护的 DSH 插件，许可证为 MIT。

它为 DeepSeek Harness custom providers 提供一个按模型编辑 reasoning effort 的设置页，让你可以在 DSH Web UI 中查看已配置模型，并为单个模型选择推理级别，而不必直接编辑配置文本。

核心功能¶

• 在 DSH Web UI 中增加 Settings → Reasoning effort 页面。
• 列出 llm-pi-ai.providers.<provider>.models 中明确配置的模型。
• 支持为单个模型选择 off、minimal、low、medium、high、xhigh 或 max。
• 保留模型的其他字段，以及现有 provider-specific wire values。
• 通过 DSH 的 settings service 保存，无需手动编辑配置文件。

安装与启用¶

安装脚本会下载最新 GitHub Release 存档，在可用时校验 GitHub 提供的 SHA-256，并把存档保留在 DSH_HOME/plugin-archives/dsh-effort-tweak/ 下用于未来依赖解析。脚本会通过 dsh plugin 安装插件。除非传入 --no-start 或 -NoStart，脚本会启动默认 web Profile。

Windows PowerShell¶

在 PowerShell 中执行：

irm https://raw.githubusercontent.com/Toukaiteio/dsh-effort-tweak/main/scripts/Install-DshEffortTweak.ps1 | iex

macOS 和 Linux¶

在终端中执行：

curl -fsSL https://raw.githubusercontent.com/Toukaiteio/dsh-effort-tweak/main/scripts/install-dsh-effort-tweak.sh | bash

本地包安装¶

也可以从本地包安装。下面命令是本地包安装示例，会先安装依赖、构建，再把本地 .tgz 包添加到 web Profile：

pnpm install
pnpm build
dsh plugin --profile web add ./dsh-effort-tweak-0.1.0.tgz

安装或更新插件后，重启 DSH Web，使新的 client bundle 被加载。

典型用法¶

先为 custom provider 添加模型列表，再打开 Settings → Reasoning effort。该页面不显示 catalog-only providers，所以如果页面上看不到目标 provider 或模型，通常先检查该 custom provider 下是否已经有模型列表。

配置会体现在 llm-pi-ai 的 providers.<provider>.models 中。示例形状如下：

providers:
  my-gateway:
    models:
      - id: my-reasoning-model
        reasoningEfforts:
          off: null
          low: low
          high: high

在这个示例里，reasoningEfforts 用来配置该模型可用的 effort 映射。通过页面选择某个级别后，保存会经过 DSH 的 settings service 完成。

适用场景与注意¶

适合以下场景：

• 已经在 DSH custom provider 中配置了模型列表。
• 希望按模型单独调整 reasoning effort。
• 不想每次都在配置文件中手工修改 llm-pi-ai.providers.<provider>.models 相关字段。

注意事项：

• 页面不显示 catalog-only providers。需要先在 custom provider 中添加模型列表，再打开页面调整模型。
• 插件以当前 dsh 进程权限运行。安装前应检查源码与 MIT 许可证。
• 本地包安装命令会引用本地 .tgz 包，实际文件名以你本地构建产物为准。
• 开发环境需要 Node.js 22.19 或更新以及 pnpm 10。

结尾¶

DSH Effort Tweak 的作用比较集中：把 custom provider 模型的 reasoning effort 选择放到 DSH Web UI 里，并通过 DSH settings service 保存，减少手工编辑配置的操作。

GitHub 仓库：

https://github.com/Toukaiteio/dsh-effort-tweak

社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，也不是官方应用商店。本文只采用已核实信息，不给出未核实的目录页 URL；如有需要，可按插件名 dsh-effort-tweak 在社区目录中检索。