前言¶
用 DSH(DeepSeek Harness)做智能體開發時,切換模型要確認三個維度:provider、model、reasoning effort。日常經常在「快速出結果」和「深度推理」兩組配置之間來回切,每次都要點開內置模型選擇器逐項重選。
如果常用組合能固定成按鈕,點一下就完成切換,這部分重複操作就可以省掉。下面介紹的 dsh-model-preset 做的就是這件事。
這是什麼¶
dsh-model-preset 由 kaixinbaba 維護(倉庫 kaixinbaba/dsh-model-preset),許可證 MIT,當前版本 0.2.0。它在 DSH Web 的 composer 卡片上方整行顯示快捷按鈕,每個按鈕一鍵選擇完整的 provider + model + reasoningEffort 組合,作用於當前會話。
DSH 的理念是「一切皆插件」,這個插件遵循同樣的思路:不改核心行爲,只往 Web 界面的既有插槽裏掛控件。
有一點需要說明:它不是 Agent preset。它不改變 Code Mode、Creator Mode、工具、提示詞、權限、人設或 agent 組成,只決定「下一個請求用哪個模型」。
核心功能¶
已覈實的能力如下:
1、在 composer 卡片上方整行顯示兩個默認扁平快捷按鈕,Settings 裏最多可配置到三個。
2、每個按鈕對應一個完整的 provider + model + reasoningEffort 組合,點擊即在當前會話生效。
3、按鈕保持配置順序,使用配置的 label 與 accent color;活動按鈕由當前有效選擇推導,包含解析後的 reasoning effort。
4、點擊調用與內置模型選擇器相同的 per-session 模型目錄。
5、選擇應用於當前會話的下一個模型請求,不重寫進行中的請求;被拒絕的選擇保留原選擇,並顯示緊湊的失敗狀態。
6、Settings → Plugins → 模型預設 提供編輯器,可增刪按鈕並修改所有字段,含原生取色器。
7、保存寫入 $DSH_HOME/model-preset.json,立即更新當前頁面並跨重啓持久化;用戶配置覆蓋 composition 默認。
安裝與啓用¶
先執行安裝命令:
dsh plugin --profile <profile> add dsh-model-preset
這條命令把插件裝進指定的 DSH Web profile,包內同時包含 Host 插件與 Web client bundle。安裝後啓動或重啓該 profile 的 Web host,再打開 Settings → Plugins → 模型預設,即可看到按鈕編輯器。
環境要求:node >=22.19.0,dsh >=0.1.0-rc.6。
典型用法¶
composition 默認配置包含兩個按鈕:「快速」對應 deepseek-official / deepseek-v4-flash / reasoningEffort: high,「深度」對應 deepseek-official / deepseek-v4-pro / reasoningEffort: high。如果用 composition 管理配置,可以從插件的 cordis.patch.yml 複製下面這段加入自己的組成:
- id: dsh-model-preset
name: 'dsh-model-preset'
config:
presets:
- label: 快速
color: '#2F80ED'
provider: deepseek-official
model: deepseek-v4-flash
reasoningEffort: high
- label: 深度
color: '#9B51E0'
provider: deepseek-official
model: deepseek-v4-pro
reasoningEffort: high
幾個配置規則:
1、presets 接受 0–3 個條目。
2、label、color、provider、model 爲必填。
3、color 必須是六位 #RRGGBB 值。
4、省略 reasoningEffort 則保留 provider/model 默認;否則使用該模型在目錄中公佈的 effort id。
不想改配置文件的話,經過上面的步驟裝好後,直接在 Settings → Plugins → 模型預設 裏增刪按鈕、修改字段即可,保存後立即生效。
適用場景與注意¶
適合的場景:在 Web 端頻繁切換少數幾個固定模型組合的人。如果組合經常變,內置模型選擇器已經夠用,這個插件的價值在於把固定組合固化。
注意以下幾點:
1、僅限 Web。插件要求當前 Web host 暴露 model-selection 服務,以及 conversation.input.dock 和 settings.plugins.tab 兩個插槽;被尋址的 subagent 會話不渲染這些控件。
2、預設在用戶點擊時纔對照模型目錄檢查。如果 model 或 effort id 已過期,點擊時會收到 host 拒絕,此時保留原選擇。
3、配置由 Host 通過同源的 GET 與 POST /dsh-model-preset/config 路由提供。
4、插件不添加模型可見的提示詞、工具、事件或持久會話數據,所選模型與 effort 仍通過既有的 DSH 模型選擇路徑記錄和應用。
5、刪除 $DSH_HOME/model-preset.json 可回到 patch 默認配置。
安全方面:插件以當前 dsh 進程的權限運行,安裝前建議自行檢查源碼與許可證。該項目許可證爲 MIT。
小結¶
dsh-model-preset 解決的問題不大,但很具體:把重複的模型選擇操作壓縮成一次點擊。安裝一行命令,默認配置開箱可用,需要調整時在 Settings 裏完成,配置跨重啓持久化。
插件目錄頁與倉庫地址:
- 社區目錄:https://www.skillhub.cn/plugins/kaixinbaba/dsh-model-preset
- GitHub:https://github.com/kaixinbaba/dsh-model-preset
需要說明的是,上述目錄爲社區維護的獨立站點,與 DeepSeek、幻方無官方從屬關係。