在 DeepSeek Harness (DSH) 的 Web 畫布中,模型選擇通常由單一的輸入框承擔。當管理多個模型或需要配置推理模式時,這種單一視圖顯得較爲侷促。dsh-model-accordion 插件通過引入摺疊式的 Provider 結構,將模型選擇器從單一的“座位”擴展爲層級化的列表,使界面在保持整潔的同時提供了更豐富的配置選項。
插件定位¶
dsh-model-accordion 是一個 Web UI 插件,由維護者 lakabuji-arch 開發。它位於 DSH 的插件生態中,不涉及後端服務或模型目錄的構建,僅負責增強 Web 界面的交互體驗。
安裝與啓用¶
在 Web Profile 環境下安裝該插件:
dsh plugin --profile web add dsh-model-accordion
安裝完成後,請刷新 Web UI 以加載新組件。
功能說明¶
該插件主要實現了以下交互邏輯:
- Provider 摺疊結構:默認狀態下,Provider 分組是摺疊的,只有點擊纔會展開查看具體模型。
- 推理模式讀取:插件會讀取每個模型在已解析的目錄元數據中的推理模式(reasoning-effort)選項。內置了一張官方的推理模式表作爲後備,具體優先級遵循:模型自身配置 > Provider 級別默認值 > 內置表。
- 數據流轉:選定的模型和推理模式會通過 DSH 的共享 model-directory 服務發送給系統。
- UI 限制:彈窗高度受內部滾動區域限制,保證界面不會無限拉伸。
- 主題適配:使用 DSH 的語義主題 tokens 定義顏色,並支持淺色與深色模式的切換。
配置與用法¶
插件通過讀取 DSH 的配置文件來獲取模型元數據。你可以通過 settings.yaml 爲特定模型聲明推理模式。
例如,爲某個未在官方表中定義的模型添加自定義推理階梯:
providers:
my-relay:
api: openai-completions
baseURL: https://…
models:
- id: my-unknown-model
api: openai-completions
contextWindow: 200000
maxTokens: 32000
input: [text]
reasoningEfforts:
off: null # 允許用戶關閉思考
low: low
high: high
max: max
插件會優先使用模型自身的 reasoningEfforts 配置。如果模型不支持用戶選中的推理模式,該選項會被靜默丟棄,系統將使用模型的默認值,而不會拋出錯誤。
注意事項¶
- 插件性質:這是一個 Web UI 插件,它不會添加 Host 服務、模型提供商、視覺後端或模型目錄。Provider 的可用性以及圖像會話的准入規則,仍由 DSH 及已安裝的 Provider/Vision 插件控制。
- 兼容性:插件依賴 DSH Web 環境提供的官方模型選擇包和模型目錄服務。
- 語言限制:當前版本的狀態提示和搜索框文本均爲英文,完整的本地化集成計劃在後續版本中發佈。
- 權限:插件以當前 DSH 進程的權限運行,安裝前建議檢查源碼與許可證(MIT)。