前言¶
在 DeepSeek Harness（DSH）里配置多家模型供应商后，输入区若用平铺列表展示全部模型，条目会很长，切换时也容易看错行。宿主仍提供模型目录、会话选择与 /model 命令，但默认选择界面未必按「先供应商、后模型」组织。社区插件 dsh-model-picker-2level（维护者 weiYe-exployer，GitHub 仓库 weiYe-exployer/dsh-model-picker-2level）替换输入区的模型选择 UI：先选供应商，再选模型，并保留全局搜索与思考强度选择。下面介绍它的定位、能力与安装用法。
这是什么¶
dsh-model-picker-2level 是面向 DSH 的轻量客户端插件，npm 包名为 @codewei823/dsh-model-picker-2level（当前资料中版本 0.1.6）。它不新增供应商或 API Key 管理，只使用 Harness 已有的模型目录和会话选择能力，替换 Web 输入区的模型选择界面；内置 /model 命令保持可用。SkillHub 目录分类为「模型推理」，简介为：A two-level model picker for DeepSeek Harness.
核心功能¶
资料中明确列出的能力如下。
| 能力 | 说明 |
|---|---|
| 两级导航 | 供应商页显示模型数量与当前使用标记；模型页只列出该供应商下的模型 |
| 分层搜索 | 首页搜索跨全部供应商；进入某供应商后仅搜索本家；支持大小写无关与模糊匹配 |
| 思考强度 | 对支持推理的模型选择强度；成功选择的偏好在当前应用进程内按供应商与模型记忆 |
| 当前项提示 | 高亮当前供应商与模型，切换后同步更新输入区显示 |
| 键盘操作 | ↑↓ 移动，Enter 打开或确认，Esc 清空搜索、返回或关闭 |
| 界面适配 | 跟随宿主主题，窗口变化时重新定位，点击外部关闭 |
| 错误反馈 | 选择失败时保留菜单；目录不可用时提供诊断与重试入口 |
子代理会话中模型按钮会被禁用，不能从该入口切换模型。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前建议阅读仓库源码与 MIT License。DSH 社区插件目录在 SkillHub，与 DeepSeek / 幻方无官方从属关系。
通过 npm 安装（desktop 为 profile 示例，请换成你实际使用的 profile）：
dsh plugin --profile desktop add @codewei823/dsh-model-picker-2level
在插件源码目录内本地安装：
dsh plugin --profile desktop add .
或安装本地归档（路径替换为实际文件）：
dsh plugin --profile desktop add ./plugin.tgz
安装后需重启整个 Harness；客户端模块没有热重载。插件无需构建，本地安装不需要先安装开发依赖。
卸载：
dsh plugin --profile desktop remove @codewei823/dsh-model-picker-2level
卸载后同样重启 Harness，恢复宿主原有模型选择器。
典型用法¶
经过上面的安装与重启，可按 README 中的步骤操作：
- 点击输入区的模型按钮，查看供应商列表。
- 选择供应商，进入该供应商的模型列表；单纯浏览不会改变当前模型。
- 点击目标模型，成功后菜单关闭，输入区显示新选择。
- 需要调整推理强度时，在供应商首页打开「思考强度」，选择可用档位。
首页搜索跨全部供应商；进入供应商后搜索范围限定在本家。清空搜索会恢复当前页列表。供应商按宿主规则排列，账号和官方供应商优先，其余保持目录顺序。
键盘（节选）：
| 按键 | 行为 |
|---|---|
| ↑ / ↓ | 移动列表高亮，不提交选择 |
| Enter | 在模型按钮上打开菜单；进入高亮供应商或确认模型 / 强度 |
| Esc | 搜索有文字先清空；为空时返回供应商首页，首页则关闭 |
| Tab / Shift+Tab | 保留浏览器原有焦点行为 |
输入法组字确认不会触发选择。更细说明见仓库 用户指南。
适用场景与注意¶
适合谁：已在 DSH 中配置多供应商、经常在 Web 界面（含桌面客户端内嵌 Web UI）切换模型，且希望用两级列表缩小范围的开发者。
运行环境（资料声明）：DSH 运行时当前声明支持 0.2.1-rc.3，可通过 dsh --version 查看；界面面向 Harness Web。供应商与模型以 Harness 配置并暴露到模型目录的内容为准。其他运行时版本与平台的兼容性尚未声明。
常见问题摘要：
- 安装后界面无变化：确认插件装到当前 profile，并重启整个 Harness。
- 无需重新配置供应商或 API Key。
- 思考强度偏好仅在当前进程内有效；应用重启后会话实际选择以宿主恢复状态为准。
- 切换失败时菜单保留错误信息；「重试」行为分选择失败条（重载目录）与目录不可用诊断（重新解析目录服务）两种。
已知限制：无插件配置面板与打开 / 切层动画；读屏对高亮项宣布尚不完整；尚无独立「刷新全部目录」按钮；宿主升级可能影响兼容性。
结尾¶
dsh-model-picker-2level 在不改动 Harness 模型目录与凭证的前提下，把模型切换收成「供应商 → 模型」两步，并保留搜索与思考强度，适合多供应商日常开发。目录页：SkillHub · dsh-model-picker-2level；源码与文档：GitHub · weiYe-exployer/dsh-model-picker-2level。
