前言¶
在 DeepSeek Harness(DSH)里装两三个 provider 插件之后,模型菜单往往会变成一长串:免费车道、工作台 App、自配网关叠在一起,三十来项里多数平时不会点,还有同一模型经不同渠道出现的近似重复项。模型选择器更适合做「选哪一个」的决定,而不是当模型仓库。
下面介绍社区插件 dsh-model-tidy(维护者 star-Cosmo)。它在不改渠道配置、不影响正在跑的会话的前提下,用显示层规则决定哪些模型出现在选择器里、叫什么、按什么顺序排,并尽量保留厂商写在名字里的计费倍率后缀。
这是什么¶
dsh-model-tidy 是 DSH 的客户端类插件:安装后在 DSH 设置里出现「模型整理」分区,对 harness 通过 ctx.llm.listModels 与 ctx.llm.listProviders 枚举出的整份模型目录做过滤与展示定制。行按 渠道 + 模型 作键,因此例如 workbuddy/gemini-3.8-flash 与 gemini/gemini-3.8-flash 是两行、各自独立开关与备注。
插件当前版本 1.1.0(见仓库 package.json),针对 DSH 0.2.0-rc.2 开发,要求 DSH >= 0.2.0-rc.1(该版本起设置层提供本插件写入分区所需的 configForms 服务)。许可证为 MIT。
- 目录页:https://www.skillhub.cn/plugins/star-Cosmo/dsh-model-tidy
- 源码:https://github.com/star-Cosmo/dsh-model-tidy
核心功能¶
显示与备注¶
- 每个模型一个开关:关闭则从模型选择器消失,打开即恢复;隐藏记录只存在插件自己的设置里,卸载后列表恢复原样。
- 备注名:给模型起你认得的名字;插件按厂商分隔符切开显示名,保留计费倍率等后缀(例如原名
GLM-5.3 · x0.79,备注改为「GLM 便宜」后选择器显示为GLM 便宜 · x0.79)。 - 搜索:按模型名、渠道或备注名过滤。
- 渠道级批量:每个渠道卡片可「隐藏全部」「显示全部」;另有全局显示/隐藏按钮。
- 恢复:可一键清空全部备注,或让全部模型重新可见。
自定义排序¶
模型顺序:渠道内每项左侧有 ▲▼,顺序显式保存,重启或换机同步配置后仍有效。只影响排列不影响可见性;渠道新上架的模型默认排在用户已排过序的模型之后;渠道头「恢复默认排序」可回退该渠道顺序。
渠道顺序:渠道卡片头部也有 ▲▼,顺序独立存为 providerOrder。未移动过的渠道与新注册渠道保持原位置;控制区「恢复渠道默认顺序」可回到 harness 自带排列。
隐藏时不跑位¶
被隐藏的模型不在 harness 目录里展示,插件会记住各行首次出现的位置,避免隐藏后行被追加到分组底部。
可用性检测(可选)¶
点「检测可用性」会对当前显示的模型逐个发极小的请求(会消耗少量 token,会先确认)。状态点含义:绿=可用,红=不可用(可看延迟与失败原因),黄=检测中,灰=未检测。检测在宿主侧进行,受限并发(宽度 4、单模型 8 秒超时);已隐藏模型不检测,结果仅存内存。需要宿主开启 Web 服务;不支持的环境仍可用整理功能,只是没有检测按钮。
刻意不做的事¶
整理是显示层决定:不重写渠道配置;正在使用某模型的会话仍按模型 id 路由;渠道新模型默认可见,插件只记录「要隐藏什么、改什么名、排什么序」。
安装与启用¶
在终端执行(命令来自官方 README):
dsh plugin --profile <你的 profile> add dsh-model-tidy
然后重新打开 DSH Web GUI,在设置导航中找到「模型整理」即可使用。
典型用法¶
- 打开 DSH 设置 →「模型整理」。
- 按渠道浏览卡片:对不用的模型关开关,常用模型可点「改备注」改成易记名称。
- 用
▲▼调整渠道顺序或渠道内模型顺序;需要时用搜索框快速定位。 - 若需确认当前显示的模型是否仍可用,且环境已开启 Web 服务,可使用「检测可用性」(注意 token 消耗)。
设置页交互示意见仓库文档截图 docs/screenshots/main.png。
适用场景与注意¶
适合:同时接多个 provider、模型列表冗长,希望选择器只保留常用项、统一备注名和顺序,并在改名时仍看到厂商标注的倍率后缀。
注意:
- 插件以当前 DSH 进程权限运行;安装前建议阅读 源码 与 MIT 许可证,自行判断是否信任维护者。
- 社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系;DSH 生态是「一切皆插件」,本介绍事实均来自上述 README 与仓库元数据。
- 可用性检测依赖宿主 Web 服务;无该能力时其余整理功能仍可用。
结尾¶
dsh-model-tidy 把模型选择器当成「决策界面」来维护:显隐、备注、排序与可选探测,都不动 provider 配置与会话路由。若你正被长模型列表干扰,可按上文命令安装,在「模型整理」里按需收敛列表。