dsh-plugin-reasoning-efforts：爲 DSH 第三方中轉模型補全推理等級選擇

DeepSeek Harness (DSH) 的聊天框裏有一個「推理等級」選擇器，只有當模型上報了 reasoning.efforts 能力時纔會出現。官方 DeepSeek 通道自帶這個能力，但通過 llm-pi-ai 手工聲明的第三方中轉模型（如各類公益站）默認沒有，選擇器也就不出現。Web 設置頁又沒有暴露 reasoningEfforts 字段，想配都沒地方配。

本插件是給 DeepSeek Harness (dsh) 的第三方中轉模型補上「推理等級」選擇器。它由 chuling-lingling 維護，採用 MIT 許可證。

核心功能¶

監聽 llm-pi-ai 設置段並自動補寫能力聲明。
默認提供 6 檔推理等級選擇。
支持按模型族定製方言（thinkingFormat）。
路由級默認等級智能寫入。
會話級獨立設置等級。

安裝與啓用¶

確保已安裝 pnpm。
確認 dsh 版本爲 0.1.x。
執行安裝命令。

dsh plugin --profile web add github:chuling-lingling/dsh-plugin-reasoning-efforts

安裝後需重啓 dsh web 才能生效，無需任何額外配置。

典型用法¶

啓動 dsh web，打開任意會話。
點擊聊天框底部的「選擇模型」按鈕。
在模型列表中選中轉分組下的模型。
點擊「推理等級」，選擇想要的檔位。
發送消息，等級隨每次請求生效（會話級）。

等級選擇是會話級的，每個會話可以獨立設置。

配置 (可選)¶

插件默認給所有模型提供統一的 6 檔等級（off / low / medium / high / xhigh / max），默認檔位爲 high。規則放在 ~/.dsh/settings.yaml 的 reasoning-efforts 段，全部有默認值。

reasoning-efforts:
  # 基礎規則:默認匹配所有模型(.),統一 6 檔 + 通用 reasoning_effort 方言
  patterns: ['.']                  # 模型 ID 匹配(不區分大小寫的正則)
  levels: [off, low, medium, high, xhigh, max]
  default: high
  thinkingFormat: openai
  setCompat: true                  # 是否給匹配模型補 thinkingFormat
  providers: []                    # 只處理這些路由;空 = 全部
  # 附加規則:數組順序即優先級,先命中先生效;都不命中才回落到基礎規則
  rules:                           # 內置默認:DeepSeek 系用專屬方言
    - patterns: [deepseek, reasoner]
      levels: [off, low, medium, high, xhigh, max]
      default: high
      thinkingFormat: deepseek

按模型族定製方言/檔位示例（默認已覆蓋全部模型；只有想給某族換方言或收窄檔位時才需要）：

reasoning-efforts:
  rules:
    # 保留 DeepSeek 內置規則(不寫則失去 Off 的真關閉語義)
    - patterns: [deepseek, reasoner]
      levels: [off, low, medium, high, xhigh, max]
      default: high
      thinkingFormat: deepseek
    # 智譜 GLM 系改用 zai 方言(thinking: {type: enabled/disabled} + reasoning_effort)
    - patterns: [glm]
      levels: [off, low, high]
      default: high
      thinkingFormat: zai

路由默認等級說明：插件只會在「該路由上所有已獲等級的模型都支持默認值」時才寫路由級 reasoning（因爲不支持的模型會在請求時報錯）。混合路由（比如 Grok 和 GLM 同站）如果拿不到默認檔，需給每條規則配一個共同支持的 default，或手動在路由上寫 reasoning:。

已知邊界¶

只處理路由裏手工聲明的模型（models: 列表）；目錄路由（pi-ai 自帶模型目錄）本就有完整能力元數據，無需處理。
插件只補缺失字段，不覆蓋已有聲明：想改某個模型的檔位，直接編輯 settings.yaml（或刪掉該模型的 reasoningEfforts 讓插件按當前規則重新生成）。
擴展檔位（Medium / Xhigh 等）以 reasoning_effort: "<等級>" 原樣發給後端；如果中轉不支持某個值，選擇後會在請求時報錯，切回其他檔即可。
自定義規則的等級集合請確認中轉真實支持，插件無法預先驗證。

結尾¶

該插件通過監聽配置段並按規則補寫能力聲明，解決了第三方中轉模型在 DSH 中無法使用推理等級選擇的問題。對於需要在聊天界面精細控制推理強度的用戶，這是一個必要的工具。

插件目錄：https://www.skillhub.cn/plugins/chuling-lingling/dsh-plugin-reasoning-efforts
代碼倉庫：https://github.com/chuling-lingling/dsh-plugin-reasoning-efforts