dsh-reasoning-effort：爲 DeepSeek Harness 模型配置推理強度

DeepSeek Harness（DSH）的生態遵循「一切皆插件」的理念。對於需要在模型層面精細控制推理強度（如 reasoning_effort）的場景，手動修改配置文件往往不夠直觀。dsh-reasoning-effort 插件通過提供可視化的配置入口和協議映射能力，解決了這一問題。

插件簡介¶

這個插件由 Mu-scorpio 維護，採用 MIT 許可證。它主要服務於 DSH 中的任意模型，通過 UI 滑塊配置推理強度，並在最高檔位提供紫色輝光特效。

核心能力¶

通用性：不限制 Provider，只要是已接入 Harness 的模型，均可配置。
自動發現：零配置自動掃描 llm-pi-ai 中的所有現有 Provider。
檔位支持：支持 off、minimal、low、medium、high、xhigh、max 七個等級。
配置層級：支持 Provider 級默認值、模型級覆蓋，以及協議（wire）值映射。
界面交互：模型選擇器按 Provider 分組摺疊；滑塊爲粗軌道、離散檔位；最高檔位帶有紫色輝光、閃爍和拖尾特效。
狀態保護：模型切換在前端暫存，關閉選擇框時才提交，避免界面閃回。
非破壞性：追加更新 settings，不覆蓋已有的 reasoningEfforts。

安裝與啓用¶

在終端執行以下命令，將預構建的 Bundle 安裝到 DSH web profile：

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

安裝後，重啓 Harness 使配置生效。

配置方式¶

插件會自動發現 llm-pi-ai 中的 Provider。若需針對特定 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` 時僅處理顯式列出的項。
`defaults.api`	當 Provider 自身沒有 `api` 時使用的協議回退值。
`defaults.reasoning`	爲所有 Provider 補充默認推理等級，但不覆蓋已有值。
`defaults.efforts`	覆蓋所有 Provider 的通用 wire 值映射。
`providers.<id>.api`	爲指定 Provider 選擇協議默認映射。
`providers.<id>.reasoning`	爲指定 Provider 補充默認推理等級。
`providers.<id>.efforts`	覆蓋指定 Provider 的 wire 值映射。
`providers.<id>.disabled`	排除指定 Provider。
`providers.<id>.models.<model-id>.efforts`	單獨覆蓋某個模型的映射。
`providers.<id>.models.<model-id>.disabled`	顯式標記某個模型不使用推理強度。

開發與調試¶

如需從源碼運行或構建，執行以下步驟：

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

注意事項¶

安全性：插件以當前 DSH 進程權限運行，安裝前建議查看源碼與許可證。
兼容性：已存在的 reasoningEfforts 永遠不會被覆蓋。
功能範圍：不新增 Provider 憑據、請求、工具或遙測數據，僅增強 settings 契約。

該插件專注於模型推理強度的配置管理，具體的模型調用仍由 DSH 自身處理。