厂商优先模型选择器 cjc-github/dsh-model-provider-picker

dsh-model-provider-picker

为 DeepSeek Harness 提供厂商优先的模型选择器，以及一套按厂商/模型隐藏的可见性设置。

官方模型选择器把所有厂商的模型平铺在一个列表里，按厂商分组显示标题。本插件把它改成两级结构：先看厂商，点开展开该厂商的模型，选中模型后再选推理等级；同时把「哪些厂商/模型不该出现」交给用户自己决定。

界面预览

| composer 的模型位 | 两级列表（默认只显示厂商） |
| 触发器 | 两级列表 |

| 点厂商，在下方展开模型 | 选中模型后选推理等级 |
| 展开厂商 | 推理等级 |

设置面板里的「模型选择器」分区：

设置页

截图取自真实运行环境。为便于阅读，截图会话里隐藏了桌宠贴纸、并把菜单的毛玻璃材质换成了实底（headless 环境渲染不出 backdrop-filter）。

功能

1. 两级模型列表

composer 的模型位显示 模型名 推理等级（等级用更小更淡的字体），点击后弹出选择器：

选择模型 点厂商展开模型 ──────────────────────────────────────── Raccoon 4 MiniMax 国内 2 SenseNova 3

默认只显示厂商。点厂商整行，在它下方展开该厂商的模型：

Raccoon 4
DeepSeek-V4.1-Flash 开启 sn-... ✓ Kimi K3 sn-kimi-k3 MiniMax-M3 sn-minimax-m3 GLM-5.2 sn-glm-5.2

2. 选中模型后再选推理等级

点一个有推理等级的模型，选择器切到第二屏：

← 选择推理等级 DeepSeek-V4.1-Flash ──────────────────────────────────────── ● 关闭 ● 开启

- 提供等级的模型 → 进这一屏选等级
- 不提供等级的模型 → 点一下直接选中，不弹第二屏

推理等级严格绑定到「厂商 + 模型」：同名模型（例如 deepseek-chat 同时出现在「DeepSeek 账号」和「开放平台」）各自保留自己的档位，互不串台。

3. 搜索

选择器顶部的搜索框支持三类关键词：

| 搜索 | 行为 |
| 模型名 / 模型 id | 列出命中的模型，并保留其厂商 |
| 厂商名 | 展开该厂商的全部模型 |
| 推理等级名（如 max） | 列出提供该等级的模型 |

搜索期间厂商自动展开，折叠状态被忽略。

4. 可见性设置

设置面板里新增一个 「模型选择器」 分区：

- 每个厂商一个主开关 —— 关掉后该厂商及其全部模型都不出现在选择器里
- 展开厂商后，每个模型一个独立开关 —— 可以只藏掉某一个模型
- 每个模型旁边标注「N 档强度」，隐藏前就能看到它有没有推理等级

规则立即写回 Host，选择器实时同步。

安装

本插件是一个 DSH profile 插件（Host 半身 + Client 半身），通过 profile 的 package.json 与 cordis.patch.yml 挂载。

方式一：直接引用本地目录（开发用）

在 DSH 的 profile 目录（通常是 <DSH_HOME>/profiles/web）执行：

pnpm add link:/path/to/dsh-model-provider-picker

然后把包名加进 package.json 的 dsh.profile.bundles：

{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-model-provider-picker"
]
}
}
}

link: 会建立 junction/符号链接，改源码后重启 Harness 即可生效，不必重新安装。

方式二：打包安装

pnpm pack
pnpm add file:/path/to/dsh-model-provider-picker-1.0.0.tgz

激活

重启 Harness（关闭并重新打开 DSH Desktop，或重启 dsh web 进程）。
插件列表里出现 dsh-model-provider-picker 即为加载成功；设置面板里会出现「模型选择器」分区。

Client 半身是 window.__ModuleLoader__.load(...) 形式的 bundle，改代码后需要重启宿主进程并刷新页面才能拿到新 bundle —— 桌面版的 HMR 只监听配置层，不做模块热替换。

数据存储

隐藏规则存在 Host 设置文档的 model-provider-picker 命名空间下，由 lib/index.js 的 volatile Config 声明：

model-provider-picker:
hiddenProviders: [raccoon] # 整厂商隐藏
hiddenModels: [raccoon/sn-glm-5.2] # 单模型隐藏（provider/model）
两组都是字符串数组，因此 DSH 的 settings 表单能安全地投影、编辑与持久化它们。厂商被整体隐藏后，它下面的模型规则自然失效。

开发

npm test # 跑规则引擎 + 原型的逻辑测试

也可以直接用浏览器打开 prototype/index.html 看交互原型 —— 它和 lib/client.js 里的实现共用同一套规则语义，是调 UI 时最快的反馈回路。

重新生成界面截图

README 里的截图由 docs/screenshot.mjs 驱动真实 GUI 生成（playwright-core + 系统 Edge，不下载额外浏览器）：

npm i -D playwright-core
node docs/screenshot.mjs

脚本会从 Harness 日志里读当前启动的 GUI 地址，登录后依次操作：点模型位 → 展开厂商 → 打开推理等级屏 → 打开设置面板，输出到 docs/screenshots/。它会在截图会话里临时隐藏桌宠、并把菜单换成实底，避免遮挡和 headless 下的毛玻璃失真。

目录结构

├── lib/
│ ├── index.js # Host 半身：声明可见性 Config 命名空间 │ └── client.js # Client 半身：选择器 + 设置页（手写 ModuleLoader bundle） ├── prototype/ │ └── index.html # 可交互原型（纯前端，无需 DSH） ├── test/ │ ├── visibility.test.mjs # 可见性规则引擎 │ └── prototype.test.mjs # 原型交互逻辑 ├── docs/ │ ├── screenshot.mjs # 驱动真实 GUI 生成截图 │ └── screenshots/ # README 引用的界面图 ├── cordis.patch.yml # 把 Host 半身插进 profile 的 loader └── package.json

实现要点

Client 半身没有构建步骤。 它是一份手写的 window.__ModuleLoader__.load({ id, factory }) bundle，只 require 平台已经提供的静态模块（react、@deepseek-ai/dsh-client-store、@deepseek-ai/dsh-client-ui-primitives）。改代码无需打包，重启宿主即可。

遮蔽 composer 的模型位。 官方 @deepseek-ai/dsh-client-ui-model-selection 把模型位注册在 conversation.input.model 这个 single slot 上（priority 0）。本插件注册同一个 slot 但 priority 为 -10——DSH 的 slot 按 priority 升序取第一个存活条目，因此本插件排前面并遮蔽官方实现。官方的注册仍留在 ledger 上，它声明的子 slot conversation.input.model.label 因此继续可用。

复用官方的会话目录。 目录与提交都走官方插件提供的 modelDirectories 服务（directoryFor(sessionId) → store / load() / select()），所以本插件的选择器与官方 /model 命令读到的是同一份事实，唯一区别是多了一层可见性过滤。服务缺席时选择器那一段保持等待，不会拖垮整个插件。

注入的两个坑。 DSH 的 slot inject 只有在 hooks 字段内的 observable 才会被渲染层转成 use<Name> 选择器 Hook；平铺返回的 observable 只是普通 prop，组件拿不到订阅。另外 Hook 必须无条件调用，因此代码里用 useEmptyRules / useEmptyCatalog 兜底，而不是在调用点做条件判断。

已知限制

- 只影响 Web / 桌面 GUI。 纯 Host 侧的模型路由不受影响；被隐藏的模型仍可通过直接构造请求使用。
- 依赖官方 model-selection 插件。 若上游移除 conversation.input.model slot 或 modelDirectories 服务，本插件的选择器会等待而不再渲染（设置页仍可用）。
- 不做键盘导航。 当前支持鼠标点击、搜索与 Esc 关闭；官方实现里的 ↑/↓ 循环、Tab 焦点移交等尚未移植。
- 规则是这台机器上的偏好。 存在 Host 设置文档里，随 profile 走，不跨设备同步。

许可证

MIT