前言¶

在 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 在社區目錄中檢索。