模型选择管控 chen1880216/dsh-model-guard

dsh-model-guard

DSH（DeepSeek Harness）插件：禁用模型 / 服务商，并自定义模型选择器的显示顺序。

本开源项目已链接并认可 LINUX DO 社区。

被禁用的模型或服务商不会出现在对话的模型选择器里，也无法被选中或提交；排序决定选择器里服务商的先后，以及每个服务商内部模型的先后。

功能

- 禁用单个模型：勾掉后它从模型选择器消失，且 Host 侧拒绝选中/提交该模型。
- 禁用整个服务商：该 provider 的全部模型一并隐藏，连分组都不再出现。
- 两级排序：
- 手工顺序：每个服务商、每个模型都有「置顶 / 上移 / 下移」。
- 自动顺序：可选「按名称」排列未被手工调整过的项。
- 规则恒为 显式顺序 > 回退策略 > 原顺序，未列出的新模型自动排在后面，模型增减无需重写配置。
- 全部设置改完即时生效，不需要重启 DSH。

使用位置

安装后，在 DSH 的 设置 → 模型禁用与排序 中使用。

安装

要求 DSH 0.2.x（@deepseek-ai/dsh），Node >=22。

从本仓库目录安装到 web profile
dsh plugin --profile web add /path/to/dsh-model-guard

dsh plugin add 会把包写进 profile 的 dependencies 与 dsh.profile.bundles，随后 HMR 自动组合。

若用 link: 方式安装，profile 的 package.json 需要同时出现在两处：

{
"dependencies": { "@local/dsh-model-guard": "link:/path/to/dsh-model-guard" },
"dsh": { "profile": { "bundles": [ /* … /, "@local/dsh-model-guard" ] } }
}

link: 安装必须声明 peerDependencies（本包已声明 @deepseek-ai/cordis、@deepseek-ai/schemastery）。
DSH 的 ResolutionRouter.routeLinked() 只对「在祖先 node_modules 里被声明为 peer」的裸包名走 interception 路由，否则退回 Node 原生解析、从插件目录向上找不到 DSH 安装目录里的包，直接 ERR_MODULE_NOT_FOUND。

生效时机

dsh-hmr 监视 profile 的 cordis.patch.yml、$DSH_HOME/cordis.patch.yml 与 profile package.json 的 bundles。
前两者按内容比较，所以只 touch 不触发重组合——改内容才会。

配置

全部字段可在设置页编辑，也可直接写进 profile 的 cordis.patch.yml：

- id: model-guard
config:
disabledModels: [] # "provider/model"，禁用单个模型
disabledProviders: [] # provider id，禁用整个服务商
providerOrder: [] # 服务商显示顺序（id 列表）
modelOrder: [] # 模型显示顺序（"provider/model" 列表）
providerSort: natural # natural | name
modelSort: natural # natural | name

这些字段都是 volatile()，改动即时生效。

实现要点

不改动 DSH 已发布的包，而是作为 profile 层 bundle，在 internal/get waterfall 上拦截对 llm 服务的属性读取，返回一个缓存的 Proxy，覆盖 listModels() 与 listProviders() 做过滤与重排；其余成员原样透传并 bind 回真实实例。

选这两个方法是因为 GUI 目录（buildModelCatalog）与提交校验（modelAvailable → selectModel / requireModel）都只经它们取目录——过滤一处即可同时挡住「显示」与「选择/提交」，重排一处即可决定选择器顺序。
核心路由不复用该目录，所以本插件是纯减法 + 重排：不新增模型、不改路由，resolveCallConfig() / stream() 仍走原始实例。

已知限制

- deepseek-account 与 deepseek-official 的顺序无法调整：客户端 orderModelProviders() 无条件把这两个排在最前， Host 侧怎么排都压不过。页面的排序说明里已写明。
- 已在会话中选中的模型被禁用后不会自动回退：菜单里消失、显示 fallback 标签，发消息时才报 session/model-unavailable，需要手动另选一个。
- 只收窄人的选择面，不阻断内部调用：已被 subagent、compaction 等组件显式指定的模型仍能运行。
- 依赖 internal/get 这个带 internal 前缀的 waterfall，它不是公开契约。DSH 大版本升级后若菜单不再隐藏/顺序不再跟随设置，说明该事件签名变了。
- 排序是纯显示层重排，不影响默认模型（默认模型由 profile 的 agent-default-model 行决定）。

许可

本项目采用 MIT License 开源。

DSH（DeepSeek Harness）插件，用来禁用模型 / 服务商，并自定义它们在模型选择器里的显示顺序。
禁用的模型或服务商会从对话模型选择器里隐藏，既不能选中，也不能提交。排序决定选择器里服务商的先后顺序，以及每个服务商内部模型的顺序。

本项目是开源项目，链接并认可 LINUX DO 社区。

功能

- 禁用单个模型：取消勾选后，它从选择器里消失，Host 也会拒绝选中或提交它。
- 禁用整个服务商：该服务商的所有模型都隐藏，它所在的分组也不再出现。
- 两级排序：
- 手动排序：每个服务商、每个模型都有「置顶 / 上移 / 下移」。
- 自动排序：可选按「名称」排序那些你没手动移动过的条目。
- 规则始终是 显式顺序 > 兜底策略 > 原始顺序，所以新加的模型会自动排在末尾——模型增删时不用重写配置。
- 所有设置立即生效，无需重启 DSH。

在哪里找到它

安装后，在 DSH 里打开 Settings → Models & ordering。

安装

需要 DSH 0.2.x（@deepseek-ai/dsh）和 Node >=22。

Install from this repository's directory into the web profile
dsh plugin --profile web add /path/to/dsh-model-guard

dsh plugin add 会把包写入配置档的 dependencies 和 dsh.profile.bundles，之后 HMR 会自动组合它。

如果以 link: 依赖安装，配置档的 package.json 必须在两处都列出它：

{
"dependencies": { "@local/dsh-model-guard": "link:/path/to/dsh-model-guard" },
"dsh": { "profile": { "bundles": [ / … */, "@local/dsh-model-guard" ] } }
}

link: 安装必须声明 peerDependencies（本包声明了 @deepseek-ai/cordis 和 @deepseek-ai/schemastery）。
只有当祖先 node_modules 把它们声明为 peer 时，DSH 的 ResolutionRouter.routeLinked() 才会通过拦截路由裸包名；否则解析会退回 Node 原生查找，而从插件目录向上查找时，找不到 DSH 安装目录里的这些包，结果就是 ERR_MODULE_NOT_FOUND。

改动何时生效

dsh-hmr 监听配置档的 cordis.patch.yml、$DSH_HOME/cordis.patch.yml，以及配置档 package.json 的 bundles 字段。
前两者按内容比较，所以单纯 touch 不会触发重新组合——内容必须变化。

配置

每个字段都能在设置页里改，也可以直接改配置档的 cordis.patch.yml：

- id: model-guard
config:
disabledModels: [] # "provider/model" — disable a single model
disabledProviders: [] # provider id — disable a whole provider
providerOrder: [] # provider display order (list of ids)
modelOrder: [] # model display order (list of "provider/model")
providerSort: natural # natural | name
modelSort: natural # natural | name

这些字段都是 volatile()，改动立即生效。

实现说明

这个插件不去改已发布的 DSH 包，而是以配置档层 bundle 的形式发布，在 internal/get waterfall 上拦截对 llm 服务的属性读取。它返回一个缓存的 Proxy，覆盖 listModels() 和 listProviders() 做过滤和重排；其余成员原样透传，并重新绑定到真实实例。

之所以选这两个方法作为拦截点，是因为 GUI 目录（buildModelCatalog）和提交校验（modelAvailable → selectModel / requireModel）都只通过它们读目录——在一处过滤就同时覆盖「显示」和「选择/提交」，在一处重排就决定选择器的顺序。核心路由不复用这份目录，所以这个插件是纯减法 + 重排：不加模型、不改路由，resolveCallConfig() / stream() 仍然走原实例。

已知限制

- deepseek-account 和 deepseek-official 的顺序改不了：客户端的 orderModelProviders() 无条件把这两个排在最前，Host 侧任何排序都覆盖不了。设置页也写明了这一点。
- 会话里已选中的模型被禁用后不会自动回退：它会从菜单消失并显示回退标签；只有你发消息时才会抛出 session/model-unavailable，所以需要你手动换一个模型。
- 它只收窄人的选择，不拦内部调用：子代理、压缩等组件显式请求的模型照常运行。
- 它依赖 internal/get waterfall（注意 internal 前缀），这不是公开契约。如果 DSH 大版本升级后菜单不再过滤、或顺序不再跟随设置，说明该事件的签名变了。
- 排序只是显示层重排，不影响默认模型（默认模型由配置档的 agent-default-model 行设定）。

许可证

基于 MIT License 发布。