前言¶

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。