前言¶
在 DeepSeek Harness（DSH）里写对话或跑智能体时，输入框旁的模型入口是高频操作。官方默认菜单是「按供应商下钻」：先搜或点进某个 provider 文件夹，选完一个模型再退回才能换另一家，每行往往只有模型名，容量、能力、推理档位要另找地方看。模型多、供应商杂时，这一步会拖慢切换节奏。
社区插件 dsh-model-picker（维护者 Findly-qwb，分类：模型推理）把同一触发位置改成双栏对话框：左侧可搜的全量列表与分组，右侧是选中模型的详情与操作。下面介绍它做什么、数据从哪来、如何装进 profile。
这是什么¶
一句话：A two-pane model picker for DeepSeek Harness——用双栏界面替换 Composer 从模型 pill 打开的那套多层模型菜单。
插件接管的是 conversation.input.model 槽位（以较低槽位优先级注册），工具行上的触发器位置与当前模型名展示不变，点开后的交互换成自定义选择器。目录页：SkillHub 插件页。源码与说明：GitHub。许可证 MIT，当前 package 版本 1.0.0。
核心功能¶
与官方菜单的差异¶
| 之前 | 之后 |
|---|---|
| 多层下钻，进一个供应商、选一个、再退出来 | 一个对话框，所有供应商同时可见 |
| 每行只有模型名 | 供应商、模型名、能力标签、收藏星标同屏 |
| 看不到模型本身的任何信息 | 右栏给出容量、能力、推理档位与操作 |
| 没有收藏和最近使用 | 两者都置顶在供应商分组之前 |
左栏¶
- 跨模型名、供应商名、能力标签搜索。
- 分组：收藏、最近使用，之后按供应商分组。
- 每行：供应商首字母、模型名、能力标签、星标。
- 键盘：
↑/↓移动，Enter应用，Esc关闭。
右栏¶
- 模型名与收藏星标；下方
provider · providerId。 - 容量：上下文窗口、最大输出（仅当路由或模型条目声明时显示，未声明则留空）。
- 能力：文本 / 图像输入、推理；能力标签跟随你在 Harness 里的 provider 配置。
- 模型声明了推理档位时显示档位按钮。
- 说明与操作：使用此模型、设为默认、详情、模型 ID。
收藏与最近使用（最近 12 个）写在 Host 侧，重载后保留，多窗口共享。
数据从哪来¶
所有展示值来自 Harness llm 服务：llm.listModels() 与 llm.resolveModelInfo()，由各 provider 上报，插件不做推断、不读第二数据源。
不显示价格。 Harness 的 provider 接口没有价格字段（适配器侧也说明不读取 pi-ai 的 cost 元数据），详情会说明该模型无价格数据；真实费率需查供应商账单。
列表侧依赖官方包 @deepseek-ai/dsh-client-ui-model-selection 提供的 modelDirectories 客户端服务；缺少该包时插件保持沉默，官方菜单照常渲染。
安装与启用¶
在 Harness profile 工程里把包作为 bundle 安装：
pnpm add dsh-model-picker
将 dsh-model-picker 写入 profile package.json 的 dsh.profile.bundles，或在应用内插件管理器安装（会写入该条目）。安装后重载页面一次。
本地开发可链接目录：
pnpm add link:/绝对路径/dsh-model-picker
依赖：带 Web 客户端的 DeepSeek Harness，以及上述 @deepseek-ai/dsh-client-ui-model-selection。
插件无配置项；偏好与错误日志默认落在 $DSH_HOME/model-picker/（即 ~/.dsh/model-picker/）：
| 文件 | 内容 |
|---|---|
model-picker-prefs.json |
收藏与最近 12 个使用过的模型 |
client-errors.log |
客户端崩溃报告，仅在选择器抛错时写入 |
删除该目录可重置收藏与最近使用。
典型用法¶
- 在 Composer 工具行点击当前模型名（与改插件前同一入口），打开双栏对话框。
- 在左栏搜索或
↑/↓选中模型；需要时点星标加入收藏。 Enter或右栏「使用此模型」应用到当前会话；可选「设为默认」等操作。Esc关闭对话框。
开发时：client.js 可由 dsh-client-hmr 热替换（保存后约一秒内生效）；index.js 为 Host 侧 Node 插件，改后需重启应用。Host 注册 /api/model-picker/*（meta、prefs、report、default），仅允许 loopback 调用。
适用场景与注意¶
适合经常在 DSH Composer 里切换模型、需要一眼看到能力标签与上下文上限、并希望收藏与最近使用跨会话保留的开发者。
安装前建议自行查看 仓库源码 与 MIT 许可证。DSH 插件在当前 Harness 进程权限下运行，第三方 bundle 与官方核心同属你本机信任边界；社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系。
若模型支持图像但标签只显示文本，在 provider 配置里补上 input 声明（例如 input: [text, image]），标签才会与 schema 一致。
结尾¶
dsh-model-picker 把「下钻式模型菜单」收成可搜索的双栏选择器，数据严格跟 Harness 已解析的 provider 目录走，并明确不展示无来源的价格。需要安装说明与截图可见 GitHub README，在生态里检索可见 SkillHub 目录页。
