前言¶

在代理網關或自定義 provider 上調用模型時，有些 API 不暴露 reasoning effort 檔位，但請求仍能成功。DeepSeek Harness 的官方 composer 只在模型聲明瞭推理等級時才渲染“推理強度”行，導致這些網關在界面上完全看不到該選項。

dsh-official-reasoning-effort 是一個插件，它通過官方組件提供推理強度控制，而非重新實現 UI。默認四檔 Off / Low / High / Max，使用官方 drill-down 選擇器渲染，並針對未聲明檔位的模型給出提示。

插件定位¶

• 名稱：dsh-official-reasoning-effort
• 維護者：Ayowait
• 版本：0.3.1
• 許可證：MIT
• 分類：模型推理
• 核心價值：爲未聲明推理強度的 gateway/provider 提供統一檔位，同時保持對官方 UI 的完全兼容。

工作原理¶

插件不繪製自己的 UI，只做兩件事：

1. Host 半：爲缺少 reasoningEfforts 的模型添加 off / low / high / max 檔位。已存在聲明（包括 false）不會被覆蓋。模型攜帶該字段後，llm-pi-ai 會報告 reasoning: true 並列出檔位，官方 ModelSelect composer 自動渲染推理等級行。

2. Browser 半：通過官方 aria-label 定位模型選擇面板，對使用通用檔位的 provider+model 對，在面板底部用 CSS ::after 添加提示行：

上游未聲明思考強度，此處爲通用檔位，上游可能忽略或拒絕。

真正由上游聲明的模型不顯示該提示。匹配基於 data-provider-id / data-model-id，同一模型由不同推理能力 provider 時不會被誤標。

檔位與默認值¶

• 默認四檔：off / low / high / max，對應官方 Off / Low / High / Max。
• 若只聲明 reasoningEfforts 而未設置 defaultEffort，官方菜單會多出一行“Default”，共五行。插件對已填充檔位的 provider 寫入 reasoning: high（官方默認平衡檔），避免額外 Default 行。顯式配置的 reasoning 不會被覆蓋。

安裝¶

dsh plugin --profile <your-profile> add github:Ayowait/dsh-official-reasoning-effort

• lib/ 已預構建，無需本地構建。
• 客戶端打包步驟不需要，瀏覽器半是純副作用模塊。

配置¶

默認零配置：自動發現所有 llm-pi-ai provider，爲未聲明檔位的模型填充通用檔位。

需要覆蓋或排除時，在配置中插入插件條目：

- insert:
    - id: dsh-official-reasoning-effort
      name: dsh-official-reasoning-effort
      config:
        efforts:
          high: reasoning_high
        providers:
          special-gateway:
            efforts:
              max: max_reasoning
            models:
              non-reasoning-model:
                disabled: true
          excluded-provider:
            disabled: true

配置字段：

• auto：自動發現所有 provider（默認 true），設爲 false 時僅處理 providers 下列出的 provider。
• efforts：全局檔位到 wire 值的映射（默認 off/low/high/max 映射到同名）。
• defaultEffort：爲已填充檔位的 provider 寫入的默認檔位（默認 high）。
• syncDefaultEffort：設爲 false 以跳過寫入默認檔位，菜單將顯示額外 Default 行。
• providers.<id>.efforts：對指定 provider 覆蓋 wire 值映射。
• providers.<id>.disabled：排除某個 provider。
• providers.<id>.models.<model>.efforts：對指定模型覆蓋 wire 值映射。
• providers.<id>.models.<model>.disabled：標記模型爲不使用推理檔位（reasoningEfforts: false）。

安全默認與兼容性¶

• 已有 reasoningEfforts（包括 false）不會被覆蓋。
• 重複注入冪等：與插件通用檔位相同的值會被識別爲自身寫入，提示繼續顯示；上游真實聲明不會被幹擾。
• 遷移：對 0.2.x 寫入的 {low, medium, high} 集合自動升級爲 off / low / high / max。
• 不影響其他字段：不添加 provider 憑證、請求、工具或遙測。
• Host 半無依賴：不導入 @deepseek-ai/*，避免破壞整個 host bundle。
• 提供只讀接口 GET /dsh-official-reasoning-effort/api/injected，返回被填充的 provider\0model 鍵，瀏覽器據此決定是否顯示提示。

適用場景與注意¶

適合使用非官方或未聲明推理檔位的 gateway/provider，希望以官方 UI 統一展示 Off / Low / High / Max 的開發者。插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。

小結¶

dsh-official-reasoning-effort 爲 DeepSeek Harness 提供了統一推理強度控制：對未聲明檔位的模型填充通用檔位，使用官方 UI 渲染，並給出清晰提示。無需額外依賴，零配置即可使用，適合需要跨 provider 統一推理強度檔位的場景。

• 插件目錄：https://www.skillhub.cn/plugins/Ayowait/dsh-official-reasoning-effort
• GitHub：https://github.com/Ayowait/dsh-official-reasoning-effort