前言¶

在 DeepSeek Harness（DSH）里跑 Web 会话时，Composer 的模型列表往往来自多个 provider 的合并目录。目录一多，选模型会变成在长列表里翻找；有些模型你几乎不用，却仍会占位置；同一模型在不同会话里还要反复调 reasoning effort。DSH 本身可以单独配置 provider 和默认模型，但「当前会话里怎么快速选、怎么整理列表」并没有一套统一的 UI 策展能力。

yoggu 维护的客户端插件 dsh-model-picker 针对的是 Web profile：在 Plugins → Model Picker 页面里搜索、隐藏、固定和排序模型，并为每个模型保存默认 reasoning effort；还提供从已配置 provider 刷新模型目录的能力。它不替代 DSH 的 provider 凭证配置，也不负责新建会话的默认模型（那部分需用 agent-default-model 等插件单独设置）。

这是什么¶

dsh-model-picker 是 DSH 的 Web 端客户端插件，维护者为 yoggu，在 SkillHub 插件目录 中归类为「客户端」。一句话定位：为 DSH Web Composer 提供可搜索、可策展的模型选择器，并在你选中某模型时应用该模型持久化的 reasoning effort 默认值。

核心功能¶

以下能力均来自项目 README 与 package.json 中的说明。

模型选择与策展¶

• 在 Composer 中使用可搜索的模型选择器。
• 打开 Plugins → Model Picker，对可用模型进行 隐藏（hide）、固定（pin） 和 重排（reorder）。
• 为每个模型设置 持久化的默认 reasoning effort；在本会话里选中该模型时会应用该默认值。

与默认模型的边界¶

插件 不会 设置新建会话的默认模型。若需要全局或 profile 级的默认模型，请在 DSH 的 agent-default-model 插件设置里单独配置。

Provider 刷新与模型发现¶

Refresh providers 会重新加载 DSH 的目录，并可向已启用 provider 的 baseURL 查询 model ID。发现的新模型可能被追加到对应 provider 的设置中；调用前建议先核对 provider 端点。该操作 不会 创建 provider、凭证或推理路由。Composer 里能否看到某模型，仍取决于当前 DSH 会话所服务的目录。刷新过程可能提示某 provider 需要重启 DSH 后生效。

环境与要求¶

• DSH：0.1.7 或更新版本（含 0.2.x），并使用 web profile（若你实际运行的不是 web，安装与卸载命令中的 profile 应改成你正在用的那个）。
• 从源码开发 / link 安装时：Node.js ^22.19.0 或 >=24.0.0。
• package.json 中声明的 DSH 引擎范围：>=0.1.5-rc.1 <0.3.0-0；插件当前发布版本为 v0.1.1，许可证 MIT。

安装与启用¶

官方推荐从 GitHub 带 tag 的 release 安装到 Web profile：

dsh plugin --profile web add 'https://github.com/yoggu/dsh-model-picker.git#v0.1.1'

安装后如有需要，重启 DSH Web 并刷新页面。模型 provider 与凭证仍在 DSH 中单独配置，本插件不提供 provider。

卸载：

dsh plugin --profile web remove dsh-model-picker

本地 link 安装（可选）¶

若需要从源码 link，README 要求先安装依赖，且 link 期间需保持该 checkout 目录存在：

git clone --branch v0.1.1 --depth 1 https://github.com/yoggu/dsh-model-picker.git
cd dsh-model-picker
pnpm install
dsh plugin --profile web add "link:$(pwd)"

典型用法¶

1. 按上文命令安装插件，确认 DSH Web 已加载 web profile。
2. 在 DSH 中照常配置 model provider 与凭证（本插件不负责这一步）。
3. 打开 Plugins → Model Picker，搜索模型，将常用模型 pin，将不用的 hide，并按习惯 reorder 列表。
4. 为常用模型设置默认 reasoning effort；之后在 Composer 里选中该模型时，会话会应用对应默认值。
5. 当 provider 侧模型列表有更新时，在 Model Picker 相关流程中使用 Refresh providers 刷新目录；若出现需重启 DSH 的提示，按提示处理后再继续选模型。

新建会话希望固定某个默认模型时，去 agent-default-model 插件设置，不要指望 dsh-model-picker 承担该职责。

适用场景与注意¶

适合谁：主要在 DSH Web 上写 Composer 会话、且模型列表来自多 provider 的开发者；希望用固定顺序和 pin 减少重复点击，并用 per-model reasoning effort 减少每次手调参数的人。

运行方式：与其它 DSH 插件一样，插件随当前 DSH 进程加载；安装前建议阅读 GitHub 仓库 源码与 MIT 许可证，确认符合你的环境与安全策略。

目录与生态：DSH 社区插件目录（如 SkillHub）是独立站点，与 DeepSeek / 幻方无官方从属关系；选插件以仓库 README 与 release tag 为准。

结尾¶

dsh-model-picker 把 Web Composer 的模型列表从「纯目录展示」变成可搜索、可 pin/hide/排序，并带上 per-model reasoning effort 默认值；配合 DSH 自带的 provider 配置与 agent-default-model，可以分开处理「列表怎么好用」和「新会话默认用谁」两件事。

• 插件目录：https://www.skillhub.cn/plugins/yoggu/dsh-model-picker
• 源码与说明：https://github.com/yoggu/dsh-model-picker