在 DSH Web UI 中,模型切換是高頻操作。手動選擇不僅耗時,還難以快速掌握供應商餘額。dsh-model-slider 插件通過滑塊和麪板集成,直接解決模型切換效率與用量監控問題。
插件定位¶
由 ipcjs 維護的 DSH Web UI 模型選擇器增強插件。核心價值在於低/中/高三檔快切滑塊、高級選擇器、多模態圖標以及供應商用量/餘額顯示。
核心功能¶
-
三檔快切滑塊
點擊模型名彈出面板,頂部是低/中/高三檔滑塊。每檔的模型和推理等級在配置文件中預置,單擊即直接切換(面板保持打開,可立即看到新模型與用量)。 -
高級選擇
滑塊下方保留原「模型」和「推理等級」入口,可像原生選擇器一樣瀏覽全部模型。 -
多模態圖標
模型名後直接顯示圖片/視頻/語音支持圖標(純文本模型不顯示)。 -
供應商用量
面板底部顯示當前供應商的用量/餘額。
* 會員制供應商(如 kimi-coding):懸停顯示每週額度與 5 小時窗口明細。
* 預付費供應商(如 deepseek):顯示餘額。 -
用戶級配置
配置文件位於~/.dsh/.model-slider.json,所有工作區共享。
安裝與啓用¶
使用官方插件命令安裝:
dsh plugin --profile web install ipcjs/dsh-model-slider
安裝後重啓 DSH 生效。
配置說明¶
配置文件位於 ~/.dsh/.model-slider.json。如果該文件不存在,插件會使用內置默認值,無需手動創建。
檔位配置 (levels)¶
定義滑塊的三個檔位。每個檔位包含 provider、model 和可選的 reasoningEffort。
id:檔位唯一標識。label:顯示文本(如「低」、「中」、「高」)。provider/model:必須與 DSH 中已配置的供應商與模型名稱一致。reasoningEffort:推理等級,省略則使用模型默認值。- 若配置了不可用的模型或推理等級,點擊該檔位會提示錯誤。
用量查詢配置 (usage)¶
配置各供應商的用量查詢接口。
kind:membership:會員額度,解析usage.{limit,remaining,resetTime}及limits[]窗口。prepaid:預付費餘額,解析balance_infos[0].{total_balance,currency}。
endpoint:查詢接口地址。空串表示不查詢(顯示「不可用」)。
API Key 安全:插件從 DSH 的 credentials 服務讀取 API Key(settings.yaml 中配置的 apiKeyEnv),不會硬編碼或寫入本配置文件。
兼容性與依賴¶
- 運行環境:DSH Web GUI (
dsh web)。 - 插件類型:服務端靜態插件。隨 DSH 啓動自動加載,無需動態插件審批。
- 依賴服務:DSH 自帶的
conversation.input.model槽位與modelDirectories服務。