前言¶

DeepSeek Harness（命令是 dsh）把模型、工具、會話和界面都做成插件，官方說法是「一切皆插件」。開發者預覽階段，網頁端已經能換模型，也能給支持思考的模型設 reasoning effort。實際用起來入口卻常常拆開：換模型走原生選擇器，調思考強度要麼敲 /model，要麼去改 settings.yaml。用過 Codex 的人會更明顯——那邊是滑塊，這邊還是菜單加命令。

社區插件 dsh-reasoning-effort 把這兩件事收進輸入框下方的一個控件：點開後上面是推理強度滑塊，下面仍是熟悉的模型列表。檔位不寫死成三檔，而是讀當前模型在目錄裏公開的 reasoning.efforts。本文按插件目錄頁、GitHub README、v0.6.0 發行說明和 DeepSeek Harness 官方文檔覈對後整理。

這是什麼¶

dsh-reasoning-effort 是一款面向 DeepSeek Harness Web 界面的模型與提供方插件，由 HanaAyane 維護，許可證 MIT，主要語言 TypeScript。社區插件目錄把它歸在「模型與提供方」，收錄日期 2026-08-15；截至 2026-08-16，GitHub 倉庫 52 星，並出現在該目錄首頁的精選列表裏。

它解決的問題很具體：在不改配置、不離開當前會話的前提下，切換模型和調節思考強度。插件默認啓用，和 dsh 自帶的 /model 命令讀寫同一份會話模型狀態。當前 main 與發行 Tag 均爲 0.6.0，README 標明兼容 DeepSeek Harness packages 0.1.0-rc.6、Node.js 22.19+、React 18.x。package.json 裏客戶端平臺標成 web，滑塊掛在網頁輸入區，不是終端 TUI。

寫生態背景時需要分清兩件事。DeepSeek Harness 是 DeepSeek 開源的智能體框架，源碼在 deepseek-ai/deepseek-harness。deepseek-harness-plugin.com 是獨立的社區目錄，用來檢索和安裝第三方插件，與 DeepSeek / 幻方沒有官方從屬關係，不能當成官方應用商店。

核心功能¶

輸入框下方的模型和強度入口¶

第一次打開插件時，DSH 輸入框下方會出現新的模型入口，按鈕上同時顯示當前模型和當前強度。點擊後彈層分成兩塊：

• 上方是推理強度滑塊。拖動或點擊軌道，釋放後吸附到最近的有效檔位。
• 下方仍是 DSH 原生模型選擇入口，點模型行就能繼續換模型。

插件默認打開。不需要時，到 設置 → 通用設置 關掉「推理強度滑塊」總開關，原生模型選擇器會立刻回來，不必卸載。

檔位完全跟模型走¶

滑塊顯示的檔位來自當前模型在 DSH 模型目錄中公開的 reasoning.efforts——檔數、名稱和順序都由模型（更準確說是適配器目錄）決定，插件只讀、自動適配。v0.5.0 起不再要求模型恰好提供 off / high / max 三檔；發行說明寫明，這一版的核心實現由 Howardzhangdqs 貢獻。

README 用常見的三檔組合舉例：

DeepSeek 系模型通常公開 off / high / max；GLM coding 系（如 GLM-5.2）公開 off / low / medium / high / xhigh 五檔。v0.5.0 發行說明還提到 GLM-5.3（Low / High / Xhigh）、GPT-5（Minimal / Low / Medium / High）以及 o3 / o4-mini 等，只要目錄裏公開了兩檔及以上，滑塊就會出現。

少於兩檔、或沒有聲明任何檔位時，菜單會顯示「當前模型未提供推理強度檔位」。滑塊只提交模型已經公開的 effort 值，不會繞過模型或部署本身的能力限制；提交前會用重新加載的目錄數據再校驗一次，避免拖動過程中切模型把檔位發錯。

自定義 provider 的只讀指引¶

內置路由的檔位來自 pi-ai 目錄，插件完全不改。只有你在 settings.yaml 的 llm-pi-ai 裏自己聲明的模型，纔會在缺檔位或聲明與知識庫不符時給出指引。這是 v0.6.0（2026-08-16）加上的能力。

打開模型菜單後，符合條件時會出現 查看檔位聲明指引：

1. 面板給出建議檔位。知識庫命中時，例如 GLM-5.2 是 minimal / low / medium / high。
2. 給出一段可直接複製的完整條目 YAML（含 - id: 行，原有 name、contextWindow、maxTokens 會保留），以及 settings.yaml 路徑。
3. 用這段內容整體替換對應的 - id: 條目（不要複製出第二個 llm-pi-ai: 根）並保存。DSH 一般會自動加載；未生效就重啓 Web Host 再刷新頁面。

內置知識庫目前收錄 GLM-5.2（minimal / low / medium / high）和 Kimi K3（low / high / max）。未收錄的模型會得到帶註釋的通用模板，按端點文檔填值即可。遇到「端點因 developer 角色拒絕請求」這類情況，面板會直接警告；README 舉例：阿里雲百鍊 OpenAI 兼容端點建議改用內置 zai 路由。

插件只提供片段，不會替你改任何配置；內置目錄裏的檔位集合（即使只有一檔）也不會被標記。README 還寫明：插件不新增遙測、憑據處理或服務端存儲。

可選的大肥魚滑塊¶

首次安裝默認是純白按鈕。想換成八幀奔跑小人，到 設置 → 通用設置，在「外觀」下方打開 大肥魚滑塊，再回到模型入口即可。v0.4.0 把這套外觀並進主線，默認關閉。

大肥魚只替換按鈕外觀，不改變檔位吸附、鍵盤控制和模型選擇。靜止時大約 720 ms 播放一輪，拖動時加速到大約 420 ms。系統開了「減少動態效果」後會停在穩定幀。兩個開關都只保存在當前瀏覽器。

跟手拖動、主題和回滾¶

README 把交互邊界寫得很清楚：

• 按鈕按指針位置連續移動，釋放後才吸附到有效檔位，用來去掉拖動延遲。
• 深色主題是藍紫黑漸變，淺色是藍白漸變，強度越高藍色越深。
• 波浪、衝擊波、像素輻射、粒子和拖尾只出現在按鈕左側，不會越過按鈕。
• 更新失敗時恢復到上一個已確認檔位。

安裝與啓用¶

社區目錄頁給出的安裝命令是：

dsh plugin add github:HanaAyane/dsh-reasoning-effort

在 DeepSeek Harness 終端裏運行即可。目錄頁同時提醒：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼；安裝前應檢查源代碼倉庫和許可證。如需可復現安裝，請固定 commit 哈希。

倉庫 README 面向 Web Profile，推薦兩條命令（PowerShell / 終端均可）：

dsh plugin --profile web add github:HanaAyane/dsh-reasoning-effort#main
dsh --profile web --dump-config

#main 始終裝最新代碼，之後可能包含未發佈改動。當前 main 是 0.6.0，與 Tag v0.6.0 一致。要釘在這一版，把 #main 改成 #v0.6.0：

dsh plugin --profile web add github:HanaAyane/dsh-reasoning-effort#v0.6.0

按目錄頁的寫法固定到本稿覈對過的 commit：

dsh plugin add github:HanaAyane/dsh-reasoning-effort#f94622b46078ac8c064f91bdc10ab27e8cf32270

插件在 Web Host 啓動時載入。安裝命令跑完後，結束當前 Host 再重新啓動，然後刷新 DSH 頁面。不要讓 Agent 替你關掉正在跑的 Host。確認是否載入：

dsh --profile web --dump-config

輸出裏應出現 name: dsh-reasoning-effort。卸載：

dsh plugin --profile web remove dsh-reasoning-effort

卸載後同樣重啓 Web Host，原生模型選擇器會自動恢復。

典型用法¶

第一次打開滑塊¶

1. 新建或打開一個會話。
2. 點擊輸入框下方顯示「模型 + 當前強度」的按鈕。
3. 拖動滑塊或點擊軌道，釋放後吸附到最近檔位。
4. 點擊滑塊下方的模型行，進入 DSH 原生模型列表。

之後用 /model 改模型和強度，滑塊會跟着變，因爲兩邊讀寫的是同一份會話模型目錄。

給自定義模型補檔位¶

模型不在 pi-ai 自帶目錄裏時（README 以 GLM-5.3 爲例），菜單會提示未提供檔位。可以按指引粘貼，也可以自己在 ~/.dsh/settings.yaml 聲明。倉庫文檔裏的 zai coding 路由示例如下：

llm-pi-ai:
  providers:
    zai-coding-cn:
      models:
        - id: glm-5.3
          name: GLM-5.3
          contextWindow: 1000000
          maxTokens: 131072
          reasoningEfforts:   # 鍵＝滑塊顯示的檔位名，值＝實際發給 API 的 reasoning_effort
            low: "low"
            high: "high"
            xhigh: "max"
          compat:             # zai 路由檢測默認不發 reasoning_effort，需要顯式打開
            thinkingFormat: "zai"
            supportsReasoningEffort: true

幾點來自 README 的約束：

• 檔位名用 DSH 體系（off / minimal / low / medium / high / xhigh），值是端點實際接受的 reasoning_effort；off 不聲明即不可選，適合無法關閉思考的模型。
• 已收錄在 pi-ai 目錄中的模型（如 GLM-5.2）會自動繼承檔位，不必手寫。
• 上游目錄收錄該模型後，手寫聲明可以刪掉；手寫條目始終優先於目錄。
• 最終取值由 host 校驗併發送，插件不會繞過限制。

要給插件自己的知識庫追加條目，寫到它的命名空間，用戶條目優先於內置：

dsh-reasoning-effort:
  entries:
    - id: my-model
      provider: "*"          # provider 路由名，* 通配
      model: "my-model-id"   # 模型 id，* 通配
      note: 說明文字
      efforts:               # 檔位名 → 端點實際接受的取值
        low: "low"
        high: "high"
        max: "max"
      compat:                # 僅 openai-completions 路由需要
        thinkingFormat: "openai"
        supportsReasoningEffort: true

安裝後看不到滑塊¶

按 README 依次確認：

1. 安裝後已經重啓 DSH Web Host。
2. 設置 → 通用設置 → 推理強度滑塊 處於啓用狀態。
3. 當前模型在目錄中公開了至少兩檔推理強度，且部署沒有關閉 thinking。未聲明檔位的模型，用上一節補聲明。

適用場景與注意事項¶

適合經常在 DSH 網頁界面裏換模型、按任務調思考強度的人，尤其是已經接了自定義 provider（自建網關、第三方兼容端點）卻發現滑塊不出現的情況。日常問答用低檔、複雜調試用高檔，不必先改 YAML。只在終端 profile 裏跑 dsh、不用 Web UI 的話，這套客戶端控件用不上。

使用前注意這幾條已經覈對過的邊界：

• 插件以當前 dsh 進程的權限運行，安裝時可能執行構建腳本。安裝前檢查 GitHub 倉庫和 MIT 許可證；生產環境建議固定 Tag 或 commit。
• 客戶端平臺是 web。檔位指引的 RPC 也只掛在 Web profile 上。
• DeepSeek Harness 仍處於開發者預覽，上游 UI 或服務變更可能要求插件同步更新。當前目標版本是 0.1.0-rc.6。
• 滑塊不能給模型「發明」思考能力。目錄沒有檔位、部署關掉了 thinking，界面就不會出現可拖的檔。
• 插件不改內置目錄、不寫 settings.yaml、不新增遙測或憑據處理。自定義檔位要你自己粘貼。

小結¶

dsh-reasoning-effort 把 Codex 風格的「模型 + 推理強度」收進 DeepSeek Harness 輸入框下方：檔位跟模型目錄走，和 /model 同步，失敗會回滾。v0.6.0 又給自定義 provider 加了只讀的 YAML 指引，仍然不替你改配置。社區目錄安裝命令和倉庫地址如下，裝之前先看源碼和許可證。

• 目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-reasoning-effort/
• GitHub：https://github.com/HanaAyane/dsh-reasoning-effort
• 當前發行版：https://github.com/HanaAyane/dsh-reasoning-effort/releases/tag/v0.6.0