前言¶
DeepSeek Harness (DSH) 的 WebUI 插件化架構允許開發者擴展原生設置頁面的能力。在模型推理場景中,開發者往往需要同時管理官方 DeepSeek 提供商與自定義 LLM 提供商的配置,並精細調整推理參數。本插件旨在填補這一空白,爲 DSH WebUI 增加一個“高級模型設置”入口。
插件介紹¶
這是一個由 u9521 維護的 DSH WebUI 插件,主要用於在 WebUI 的設置頁面中管理 LLM 提供商配置。
它解決了在單一界面中統一管理不同命名空間(包括自定義命名空間 llm-pi-ai 和官方命名空間 llm-deepseek)模型參數的問題。插件內置了對內置和自定義提供商的支持,涵蓋了模型列表、推理/思考選項、請求頭設置以及重試策略等配置項。
核心功能¶
插件提供的核心能力集中在模型配置管理上:
- 多命名空間管理:支持在自定義提供商命名空間 (
llm-pi-ai) 和官方提供商命名空間 (llm-deepseek) 中管理配置文件。 - 提供商與模型:同時支持內置提供商和自定義提供商,並提供模型列表管理。
- 推理參數:提供推理/思考相關的選項配置。
- 請求與容錯:支持自定義請求頭 和重試策略。
- 規則一致性:遵循 DSH 官方設置 UI 的驗證規則與衝突處理邏輯。
安裝與啓用¶
安裝插件後需要重啓 Web 服務並刷新瀏覽器緩存。
- 執行安裝命令,從 GitHub 的
dist分支拉取預構建版本:
dsh plugin --profile web add github:u9521/dsh-advanced-model-editor#dist
-
安裝完成後,重啓 Web 服務 (
dsh web),並在瀏覽器中執行硬刷新 (Cmd+Shift+R / Ctrl+Shift+R)。 -
在 WebUI 的設置頁面中,查找名爲 Advanced Model Settings 的入口。
升級¶
當有新版本發佈時,可以通過更新命令拉取最新的 dist 發佈版本。
- 執行以下命令進行遠程更新:
dsh plugin --profile web update @local/dsh-advanced-model-editor
或者,如果重新添加 dist 分支:
dsh plugin --profile web add github:u9521/dsh-advanced-model-editor#dist
- 同樣需要 重啓 Web 服務 並 硬刷新 瀏覽器。
環境要求與注意事項¶
在安裝或使用此插件前,請確認環境符合以下依賴條件:
- DSH 版本:必須安裝 DSH 版本
>= 0.1.5-rc.1。插件的 main 分支不再向後兼容 DSH 0.1.5 之前的舊版本。 - Node.js:需要 Node.js 版本
^22.19 || >=24。 - 包管理器:需要安裝
pnpm,因爲dsh plugin命令在內部依賴 pnpm 進行構建和添加操作。
結語¶
該插件通過在 DSH WebUI 中提供結構化的模型參數配置入口,簡化了自定義 LLM 提供商及推理參數的管理流程。所有配置均基於 DSH 的官方驗證規則,保證了配置的穩定性。
- 插件目錄:https://www.skillhub.cn/plugins/u9521/dsh-advanced-model-editor
- 源碼倉庫:https://github.com/u9521/dsh-advanced-model-editor
- 許可證:MIT