前言¶
DeepSeek Harness（DSH）自带模型选择器，但展示层相对固定：Provider 顺序由宿主硬编码，模型名来自目录原文，也无法把不同 Provider 下的模型并排成一组。若部分模型走账号 Provider、部分走合作方 Provider，你日常想用的那份列表在界面上往往对不上。
社区插件 dsh-model-picker-control（维护者 qzz19970504，分类：客户端）在不动第三方插件源码的前提下，用独立设置页接管选择器的「显示」：重命名、分组、排序、隐藏、角标，以及跨 Provider 分区与模型文件夹等能力。下面介绍它是什么、能做什么，以及如何安装与典型用法。
这是什么¶
dsh-model-picker-control 是面向 DSH 的客户端插件，npm 包名同为 dsh-model-picker-control，当前资料中的版本为 0.4.2，许可证 MIT。它通过 Cordis patch 与客户端注入（@deepseek-ai/dsh-client-ui-model-selection 等）扩展宿主 UI，在 Settings 里新增 Model picker（模型选择器）页面，与内置 Models 页并列。
插件只改展示与本地配置，不从目录里删除模型；一键 Restore 可清空插件设置并恢复宿主默认。
核心功能¶
以下能力均来自项目 README 与 package 描述，按使用场景归纳。
重命名与后缀胶囊（Suffix capsules）¶
- 可改模型展示名、Provider 分组名，以及每个模型旁的短后缀胶囊（宿主原生 pill，可与宿主自带的
1017等标签并存）。 - 胶囊支持蓝、深红、青等预设，也可自定义颜色或全息边框；文本可为空（仅色块）。分区级 Capsule color 可一次性为分区内所有模型上色；Clear empty capsules 可去掉无文本的胶囊。
- 全息边框在
prefers-reduced-motion下会关闭旋转动画。
跨 Provider 分区（Cross-provider partitions）¶
- 可创建分区（例如 Free、Experimental），把任意 Provider 下的模型拖进同一分区，在选择器里渲染为一组。
- Provider 分组与分区均支持拖拽排序（手柄或聚焦后 ↑ / ↓）。
隐藏（Hide, don’t delete）¶
- 单个模型可用眼睛按钮隐藏；Provider 卡片上的眼睛可一次隐藏或显示该 Provider 下全部模型。目录数据仍在，只是不展示。
组内排序¶
- 可按目录顺序、模型名，或在预览里手动拖拽；可针对单个分组或全局设置。
模型文件夹（Model folders）¶
- 在预览卡片中，将同一分组内一行拖到另一行中间，可合并为文件夹（family）。文件夹在选择器占一行，可带胶囊；成员自上而下排列。
- 当请求因配额用尽、限流或鉴权失败而失败时，插件会按顺序切换到下一成员并像普通换模型一样重发请求；失败成员休息至本地午夜。手动隐藏的、或不在文件夹分组内的成员会被跳过。
- 文件夹提供的 reasoning 等级以顶部成员为准；自动切换后使用新成员的最高等级。README 说明该能力 standalone，不依赖其他插件。
预览与临时隐藏¶
- Picker preview 实时展示最终选择器样式：可拖拽排序、展开文件夹；对暂时耗尽的模型用眼睛隐藏会立即生效，无需点 Save。
草稿与保存、恢复¶
- 除预览页的即时隐藏外，其余编辑留在本地草稿，须点 Save 才写入；离开页面若有未保存改动会提示。
- Restore 一键清除插件设置，恢复宿主默认。
安装与启用¶
官方安装命令（README 原文）：
dsh plugin add dsh-model-picker-control
安装后重启 DSH。打开 Settings，在内置 Models 旁会出现 Model picker（模型选择器）。
运行环境（package.json engines）：Node >=20，DSH >=0.2.1-rc.1 <0.3.0。
典型用法¶
- 安装并重启后，进入 Settings → Model picker。
- 在 Groups & partitions 中拖拽 Provider 分组与分区顺序，重命名或隐藏某个 Provider，并创建跨 Provider 分区，把常用模型归入同一组。
- 在 Models 中重命名模型、填写后缀胶囊与颜色、将模型划入分区，或隐藏不用的条目；确认后点 Save。
- 在 Picker preview 中核对最终列表：拖拽组内顺序，必要时把两行合并为模型文件夹；对当前配额耗尽的模型可用眼睛临时隐藏（立即保存）。
- 若配置试乱或想回到出厂展示，使用 Restore。
README 截图示例展示了跨 Provider 的 Free、Fast、Flagship 分区、多种色调胶囊，以及带 Pool 标签的模型文件夹在配额失败时的接力行为；细节以仓库 docs/ 下截图为准。
适用场景与注意¶
适合谁： 多 Provider、多账号路由，且希望选择器按自己的认知排序、命名和分组；需要把免费/实验模型与旗舰模型分区展示；或希望用模型文件夹做同族模型的配额 failover，而不改上游插件。
权限与安全： 插件随当前 DSH 进程权限运行，会读写与展示相关的本地配置。安装前建议在 GitHub 查看源码与 MIT 许可证，确认符合你的环境策略。社区目录 SkillHub 插件页 与 DeepSeek / 幻方无官方从属关系，DSH 生态遵循「一切皆插件」，本插件为社区维护（GitHub 星标资料中为 1）。
结尾¶
dsh-model-picker-control 把模型选择器的展示收拢到一页设置里：重命名、跨 Provider 分区、排序、隐藏、后缀胶囊与模型文件夹，并区分草稿保存与预览即时隐藏。需要进一步了解实现与截图时，可查阅仓库 README（含 README_ZH.md）。
