在管理多个 OpenAI 兼容模型提供方时,调整默认模型和过滤模型列表往往需要多次点击和配置。在 Composer 模型选择器和 /model 命令中保持会话一致性容易出错,且在 Web 搜索中强制使用特定的 OpenAI Responses 模型通常需要手动配置。sharewiner/dsh-model-management 旨在通过集中管理提供方、模型和可见性,解决这些繁琐的重复操作。
这是一个 DSH Web profile 插件,用于管理 OpenAI 兼容的模型提供方,设置默认模型,控制模型可见性,并可选地将 Web 搜索路由到选定的 OpenAI Responses 提供方。该插件由 sharewiner 维护,使用 MIT 许可证。
核心功能¶
- 集中设置入口:在 DSH 设置中添加
模型管理部分。 - 全局模型概览:列出 DSH 当前注册的所有模型,按提供方分组显示。
- 路由控制:设置默认提供方、默认模型以及支持的推理努力。
- 可见性管理:隐藏单个模型,使其不出现在 Composer 模型选择器和
/model命令中;或关闭整个提供方,移除该提供方的所有模型。 - 会话保护:保持当前选定的模型可见,直到用户主动切换,防止会话丢失当前路由。
- Web 搜索路由:注册
model-management-openai-responses,这是一个使用活动默认 OpenAI Responses 模型、基础 URL 和凭据引用的 Web 搜索提供方。
安装与启用¶
该插件需要 DSH Web profile 环境以及 Node.js 22.19 或更高版本。
在终端中执行以下命令安装指定版本:
dsh plugin --profile web add @sharewiner/dsh-model-management@0.2.3
安装完成后,需要重启 DSH Desktop 或刷新 Web profile 以加载插件。
典型用法¶
- 打开 DSH 设置并选择 模型管理。
- 在 DSH 的原生 模型 设置页面中,添加 OpenAI 兼容提供方及其模型。
- 从 模型管理 中选择默认模型。
- 使用 隐藏 从 Composer 模型选择器和
/model列表中移除单个模型。 - 使用 关闭提供方 从这些列表中移除提供方的所有模型。
- 使用 显示 或 开启提供方 恢复它们。
- 如果你想让 Web 搜索自动跟随当前默认模型,请配置 DSH 的 Web 服务以使用该提供方。
适用场景与注意¶
- 早期访问状态:尽管 npm 版本 0.2.3 使用稳定语义化版本,但该项目仍处于早期访问阶段。
- 兼容性检查:插件使用一个兼容层来访问 DSH 的客户端
modelDirectories服务,因为 DSH 尚未公开模型目录过滤 API。在每次 DeepSeek Harness 升级后,建议验证 Composer 模型选择器和/model命令的功能是否正常。 - 安全机制:插件仅在执行 OpenAI Responses Web 搜索请求时,才通过 DSH 的凭据服务或启动环境读取提供方凭据。它不会将 API 密钥、令牌或端点密钥存储在插件源代码或模型管理设置中。
- 依赖要求:需要安装兼容的宿主包(peer dependencies)。
结语¶
该插件为 DSH 用户提供了更精细的模型控制能力,通过统一管理提供方和默认路由,简化了多模型环境下的操作流程。如果你正在寻找更高效的方式来管理 DSH 的模型生态,可以访问插件目录或 GitHub 仓库查看源码。