前言¶
在 DeepSeek Harness（DSH）裏用 Composer 時，選模型和調推理強度（reasoning effort）往往要分兩步：先換模型，再在子菜單裏打開 Effort，從 Default、Low、High、Max 裏點選。日常調試不同模型、掃一遍強度檔位時，這套路徑偏長。dsh-effort-menu 由社區維護者 xuanfenglajiao 發佈，分類爲模型推理；它接管 Composer 自帶的模型選擇入口，把最近用過的模型、按服務商展開的完整列表，以及可拖動的推理強度滑塊放進同一塊彈出菜單，並與 DSH 自帶的按會話模型目錄讀寫，使原生選擇器和 /model 彈窗共享同一狀態。
這是什麼¶
dsh-effort-menu（npm 包名 dsh-effort-menu，當前資料中的版本爲 1.0.1）是一套客戶端插件：用「最近模型 + 全量服務商浮層 + 底部推理強度滑塊」替換默認的 Composer 模型菜單。實現思路上參考 zcode 的做法，把原先藏在二級列表裏的 effort 檔位改爲滑塊上的節點，節點數量隨當前模型支持的 reasoning.efforts 變化；選完模型後可以立刻拖動調節，無需再進子菜單。
許可證爲 MIT；要求 DSH >=0.2.2-rc.1，且構建中需包含 dsh-client-ui-conversation、dsh-client-ui-model-selection 與 dsh-client-locale 等客戶端包。資料記載的開發驗證環境爲 DeepSeek Harness Desktop 44.7.0（DSH 0.2.2-rc.1）與 Windows 11。
核心功能¶
下面介紹插件在菜單裏實際提供的能力，均來自倉庫 README 與 package.json 說明。
模型列表與服務商浮層¶
菜單頂部展示最近使用的三個模型。將指針懸停在服務商（provider）一行時，會彈出浮層，列出該服務商下的全部模型，便於在不離開當前菜單的情況下切換遠端模型。
推理強度滑塊¶
滑塊位於菜單底部，每個節點對應當前模型支持的一個 effort 級別。若模型未聲明自有默認值，滑塊會在最前增加一個 “Default” 節點，表示交由服務商默認策略處理。切換模型時，會盡量保留當前選中的強度；若新模型不支持該檔，則落到該模型支持的最高檔。
若當前模型沒有 reasoning.efforts，菜單會提示該模型不提供強度檔位，滑塊無從展示。
狀態同步與體驗細節¶
讀寫走 DSH 自帶的 per-session 模型目錄，因此與本機原生模型選擇器、/model 彈窗保持一致。模型列表加載失敗時，菜單內會提示並提供重試按鈕。支持方向鍵在條目與滑塊間移動，Esc 關閉菜單；界面跟隨應用的明/暗主題，文案支持英文與中文。
在 subagent 會話中，插件不渲染任何 UI。
安裝與啓用¶
插件以當前 DSH 進程的權限在本地運行；安裝前建議在 GitHub 上查看源碼與 MIT 許可證，確認與自身環境匹配。社區插件目錄（skillhub.cn）與 DeepSeek / 幻方無官方從屬關係，安裝命令以 README 原文爲準。
Web 配置檔¶
在已由 CLI 管理的 web 配置檔下，一條命令即可安裝，無需額外構建步驟（瀏覽器側使用倉庫內已提交的 client.js）：
dsh plugin --profile web add dsh-effort-menu
安裝後重啓 dsh web，或刷新頁面。
Desktop 配置檔¶
desktop 配置檔由桌面應用管理。使用 CLI 安裝前需完全退出桌面應用；若應用保持運行，可通過應用內的 Plugin Manager 指向插件檢出目錄完成安裝。
# CLI 安裝（需先完全退出桌面應用）
dsh plugin --profile desktop add dsh-effort-menu
安裝完成後重新啓動應用。README 另載明可通過克隆倉庫後在 Plugin Manager 中指定目錄；若你更傾向不用 CLI，可改動手動維護的 package.json（見下文）。
手動寫入 package.json¶
Web。 編輯 ~/.dsh/profiles/web/package.json，在 dependencies 中加入：
"dependencies": {
"dsh-effort-menu": "^1.0.0"
}
並在 dsh.profile.bundles 數組中追加包名：
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-effort-menu"]
在該目錄執行 pnpm install，然後重啓 dsh web。
Desktop。 編輯 ~/.dsh/profiles/desktop/package.json，僅在 dependencies 中加入同上依賴（desktop 配置檔不在 bundles 中羅列插件）。執行 pnpm install 後重啓應用。
卸載 Web 側可用：
dsh plugin --profile web remove dsh-effort-menu
Desktop 側可在 Plugin Manager 中移除。
典型用法¶
安裝並重啓（或刷新）後，在 Composer 輸入區使用模型入口，即可看到替換後的菜單，而非默認二級 Effort 列表。
- 從頂部最近三個模型中點擊一項，或懸停 provider 行，在浮層裏選擇其他模型。
- 若模型支持推理強度，在菜單底部滑塊上拖動或按方向鍵選擇檔位。
- 需要與命令行一致時，仍可使用
/model彈窗；二者共享同一套會話模型狀態。
切換模型時留意強度是否會因新模型能力而被抬到最高支持檔，這在 README 中作爲預期行爲說明。
適用場景與注意¶
適合誰： 經常在同一 Composer 會話裏切換模型、對比不同 reasoning effort 的開發者；希望減少「選模型 → 再開 Effort 子菜單」步數的 DSH 用戶。
兼容性： 僅支持 DSH 0.2.2-rc.1 及更新版本；更早版本不受支持。當前模型必須暴露 reasoning.efforts，滑塊纔有內容。
與其它插件的關係：
- 插件以優先級
-1佔用conversation.input.model插槽，會遮蔽自帶的模型選擇器。同一插槽只能有一個替換型插件，不宜與另一個「整段替換模型菜單」的插件並存；僅在外圍改樣式的插件未必作用於本菜單。 conversation.input.model.label子插槽不可重複聲明；本插件自行渲染模型名稱，其他插件爲該子插槽提供的標籤不會出現在此菜單中。
質量與測試： README 標明尚無自動化測試，變更依賴在運行中的應用中手工驗證。
結尾¶
dsh-effort-menu 把「選模型」和「調推理強度」收到同一塊 Composer 模型菜單裏，並與 DSH 原生模型狀態對齊。若你在使用 DSH 0.2.2-rc.1 及以上版本，且主要工作在 Composer 而非 subagent 會話，可按上述命令安裝後直接使用。
- 社區目錄頁：https://www.skillhub.cn/plugins/xuanfenglajiao/dsh-effort-menu
- 源碼與安裝說明：https://github.com/xuanfenglajiao/dsh-effort-menu
