前言¶
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