前言¶

DSH 的模型是「按 API」配置的。连了好几个 provider 之后，要在对话里换一个模型，就得记得它的 id，手动敲一长串名字；收藏常用模型的话，也没有统一的地方。kinfxhk/dsh-model-shelf（DSH Model Shelf）就是来解决这件事的：它在左侧栏加一个「模型」页，把已经连上的模型按 API 分组摆出来，搜索、收藏、一键套用，不用再记 id。

这是什么¶

DSH 插件，维护者 Kinfxhk，分类客户端，许可证 MIT，package.json 版本 1.2.0。它没有额外依赖，只要 DSH 本身已经连到至少一个 provider 就有模型可选。

核心功能¶

• 侧栏新增「模型」页，模型按 API 分组，每张卡显示名称、id、上下文和 reasoning effort（如果有）。
• 搜索：支持按 API 名、模型名或 id 过滤。
• 收藏（bookmark）：收藏的模型会排在对话模型菜单所属 API 的最前面。
• 一键「套用」：默认修改部署默认值（之后新 session 都用）；收起「设为默认」就只切换指定 session。
• 某些 API 拿不到模型清单时，页面会显示 failures，不会静默失败。

另外，Agent 也可以通过 model_shelf 工具使用同一套操作：

catalog        列出 API／模型，可用 provider、query 筛选
bookmarks      读取收藏清单
bookmark / unbookmark  收藏／取消收藏一个 catalog model
use            套用模型：默认改部署默认；传 sessionId 就切换该 session；可加 reasoningEffort

收藏只存在 DSH 的 storage domain 里，不会离开本机。

安装与启用¶

需要 DSH 0.2.1-rc.5 或以上。先下载这个 repo（README 给出的方式是 git clone，或者 GitHub 页面的 Code → Download ZIP），然后在 DSH 里用 plugin_manager 安装，target 填文件夹的绝对路径：

plugin_manager(action: "install_bundle", target: "C:\\path\\to\\dsh-model-shelf")

重启 DSH，左侧栏就会出现「模型」页，卡片上带 dsh-client-ui-sidebar 的注入。

典型用法¶

1. 打开侧栏「模型」页，按 API 分组浏览已连上的模型。
2. 用搜索框按 API 名、模型名或 id 过滤。
3. 对常用的模型点 bookmark，它会排到对应 API 对话模型菜单的最前面。
4. 点「套用」：默认改部署默认值；把「设为默认」收起，就只切当前或指定 session。
5. 需要 Agent 代劳时，让它调用 model_shelf，例如 catalog 列出、use 套用。

适用场景与注意¶

适合连了多个 provider、常用模型经常切换的 DSH 使用者，尤其是不想反复敲 model id、希望收藏常用模型的人。

两点要注意：

• 插件以当前 dsh 进程的权限运行，安装前应打开源码核对，并留意其许可证（MIT）。
• 收藏数据只存在本地 storage domain，如果清理 DSH 存储，收藏会一并丢失；跨设备不同步。

结尾¶

DSH Model Shelf 的价值是把「模型选择」从手动记 id 变成侧栏里按 API 分组的浏览与收藏，顺带把选择能力暴露给 Agent。目录页在 https://www.skillhub.cn/plugins/Kinfxhk/dsh-model-shelf，源码在 https://github.com/Kinfxhk/dsh-model-shelf。