前言¶
用 DSH(DeepSeek Harness)做智能体开发时,切换模型要确认三个维度:provider、model、reasoning effort。日常经常在「快速出结果」和「深度推理」两组配置之间来回切,每次都要点开内置模型选择器逐项重选。
如果常用组合能固定成按钮,点一下就完成切换,这部分重复操作就可以省掉。下面介绍的 dsh-model-preset 做的就是这件事。
这是什么¶
dsh-model-preset 由 kaixinbaba 维护(仓库 kaixinbaba/dsh-model-preset),许可证 MIT,当前版本 0.2.0。它在 DSH Web 的 composer 卡片上方整行显示快捷按钮,每个按钮一键选择完整的 provider + model + reasoningEffort 组合,作用于当前会话。
DSH 的理念是「一切皆插件」,这个插件遵循同样的思路:不改核心行为,只往 Web 界面的既有插槽里挂控件。
有一点需要说明:它不是 Agent preset。它不改变 Code Mode、Creator Mode、工具、提示词、权限、人设或 agent 组成,只决定「下一个请求用哪个模型」。
核心功能¶
已核实的能力如下:
1、在 composer 卡片上方整行显示两个默认扁平快捷按钮,Settings 里最多可配置到三个。
2、每个按钮对应一个完整的 provider + model + reasoningEffort 组合,点击即在当前会话生效。
3、按钮保持配置顺序,使用配置的 label 与 accent color;活动按钮由当前有效选择推导,包含解析后的 reasoning effort。
4、点击调用与内置模型选择器相同的 per-session 模型目录。
5、选择应用于当前会话的下一个模型请求,不重写进行中的请求;被拒绝的选择保留原选择,并显示紧凑的失败状态。
6、Settings → Plugins → 模型预设 提供编辑器,可增删按钮并修改所有字段,含原生取色器。
7、保存写入 $DSH_HOME/model-preset.json,立即更新当前页面并跨重启持久化;用户配置覆盖 composition 默认。
安装与启用¶
先执行安装命令:
dsh plugin --profile <profile> add dsh-model-preset
这条命令把插件装进指定的 DSH Web profile,包内同时包含 Host 插件与 Web client bundle。安装后启动或重启该 profile 的 Web host,再打开 Settings → Plugins → 模型预设,即可看到按钮编辑器。
环境要求:node >=22.19.0,dsh >=0.1.0-rc.6。
典型用法¶
composition 默认配置包含两个按钮:「快速」对应 deepseek-official / deepseek-v4-flash / reasoningEffort: high,「深度」对应 deepseek-official / deepseek-v4-pro / reasoningEffort: high。如果用 composition 管理配置,可以从插件的 cordis.patch.yml 复制下面这段加入自己的组成:
- id: dsh-model-preset
name: 'dsh-model-preset'
config:
presets:
- label: 快速
color: '#2F80ED'
provider: deepseek-official
model: deepseek-v4-flash
reasoningEffort: high
- label: 深度
color: '#9B51E0'
provider: deepseek-official
model: deepseek-v4-pro
reasoningEffort: high
几个配置规则:
1、presets 接受 0–3 个条目。
2、label、color、provider、model 为必填。
3、color 必须是六位 #RRGGBB 值。
4、省略 reasoningEffort 则保留 provider/model 默认;否则使用该模型在目录中公布的 effort id。
不想改配置文件的话,经过上面的步骤装好后,直接在 Settings → Plugins → 模型预设 里增删按钮、修改字段即可,保存后立即生效。
适用场景与注意¶
适合的场景:在 Web 端频繁切换少数几个固定模型组合的人。如果组合经常变,内置模型选择器已经够用,这个插件的价值在于把固定组合固化。
注意以下几点:
1、仅限 Web。插件要求当前 Web host 暴露 model-selection 服务,以及 conversation.input.dock 和 settings.plugins.tab 两个插槽;被寻址的 subagent 会话不渲染这些控件。
2、预设在用户点击时才对照模型目录检查。如果 model 或 effort id 已过期,点击时会收到 host 拒绝,此时保留原选择。
3、配置由 Host 通过同源的 GET 与 POST /dsh-model-preset/config 路由提供。
4、插件不添加模型可见的提示词、工具、事件或持久会话数据,所选模型与 effort 仍通过既有的 DSH 模型选择路径记录和应用。
5、删除 $DSH_HOME/model-preset.json 可回到 patch 默认配置。
安全方面:插件以当前 dsh 进程的权限运行,安装前建议自行检查源码与许可证。该项目许可证为 MIT。
小结¶
dsh-model-preset 解决的问题不大,但很具体:把重复的模型选择操作压缩成一次点击。安装一行命令,默认配置开箱可用,需要调整时在 Settings 里完成,配置跨重启持久化。
插件目录页与仓库地址:
- 社区目录:https://www.skillhub.cn/plugins/kaixinbaba/dsh-model-preset
- GitHub:https://github.com/kaixinbaba/dsh-model-preset
需要说明的是,上述目录为社区维护的独立站点,与 DeepSeek、幻方无官方从属关系。