DeepSeek Harness (DSH) 采用插件化架构,客户端通过插件扩展功能。在处理大量模型时,直接在配置文件中管理每个模型的状态和名称较为繁琐。dsh-ofm-model-manager 插件在 DSH 的设置界面中增加了一个模型管理面板,允许用户直接在图形界面中对每个提供商的模型进行启用/禁用操作和自定义重命名。
核心功能¶
插件在 Settings → Models 页面底部新增了一个面板,主要提供以下能力:
- 模型开关与重命名:每个模型旁边都有开关,可以独立启用或禁用。勾选“自定义名称”后,可以输入显示名称,该名称会替换内置名称显示在模型选择器中,但不会修改模型 ID。
- 多维度搜索:支持在名称、自定义名称、模型 ID、描述和提供商名称中进行精确匹配搜索。
- 状态与筛选:提供状态芯片(All / Enabled / Region-restricted / Disabled)显示数量,并支持通过下拉菜单按提供商筛选。
- 批量操作:针对当前筛选视图,提供批量启用和批量禁用按钮。
- 即时生效:偏好设置保存在配置文件中,修改后立即应用,无需刷新页面或重启 DSH。
安装¶
使用 DSH 官方插件安装命令添加该插件。命令中的 desktop 为配置文件名,如使用其他配置文件请替换。
dsh plugin --profile desktop add github:DeepseekDays/dsh-ofm-model-manager
安装完成后,需要完全退出 DSH(包括系统托盘中的进程)并重新启动,以确保新插件被正确加载。
典型用法¶
- 禁用模型:在模型面板中关闭某个模型的开关,该模型将不会出现在聊天窗口的模型选择器和
/model对话框中。如果某个提供商下的所有模型都被禁用,该提供商也会从选择器中消失。 - 重命名模型:在模型面板中勾选“自定义名称”并输入新名称。在模型选择器中,将显示你输入的名称,而非原始的内置名称。
技术实现与注意事项¶
- 运行机制:插件不修改 DSH 内核文件,而是通过运行时拦截
ctx.llm.listModels()来包装模型列表,实现显示和过滤逻辑。 - 共存性:该插件与
dsh-provider-toggle插件可以共存。它不依赖于其他运行时库。 - 路由影响:禁用模型仅影响模型目录(Catalog),不会改变现有的会话路由。已开启的对话继续使用原模型,新会话将无法选择被禁用的模型。
- 配置格式:配置使用
provider|modelId的格式保存。如果不带分隔符的modelId(如deepseek-v4.1-flash)在配置中,会被视为通配符,匹配所有提供商的同名模型。新版本插件优先处理精确匹配,确保特定配置优先于通配符配置。
该插件由 DeepseekDays 维护,遵循 MIT 许可证。