Introduction¶

DSH models are configured on a per-API basis. After connecting several providers, changing a model in a conversation requires remembering its ID and manually typing out the full name; there is no unified place to bookmark frequently used models. kinfxhk/dsh-model-shelf (DSH Model Shelf) is designed to solve this: it adds a “Models” page to the sidebar, grouping connected models by API, allowing for search, bookmarking, and one-click application without needing to remember IDs.

What is it¶

DSH plugin by maintainer Kinfxhk, category client, license MIT, package.json version 1.2.0. It has no extra dependencies; as long as DSH is connected to at least one provider, models are available for selection.

Core Features¶

• New Sidebar Page: A new “Models” page in the sidebar groups models by API; each card displays the name, ID, context, and reasoning effort (if applicable).
• Search: Supports filtering by API name, model name, or ID.
• Bookmarks: Bookmarked models are sorted to the top of the API group within the chat model menu.
• One-click “Apply”: Changes the deployment default (used by all new sessions); collapsing “Set as Default” switches only the specified session.
• Failure Handling: When the model list cannot be retrieved from certain APIs, the page displays failures instead of failing silently.

Additionally, Agents can also use the same set of operations via the model_shelf tool:

catalog        List APIs/models, filterable by provider, query, etc.
bookmarks      Read the list of bookmarks
bookmark / unbookmark  Bookmark / unbookmark a catalog model
use            Apply a model: changes the deployment default by default; passing a sessionId switches that session; accepts reasoningEffort

Bookmarks are stored only within DSH’s storage domain and do not leave the local machine.

Installation and Usage¶

Requires DSH 0.2.1-rc.5 or later. First, download this repository (the README suggests git clone, or use the GitHub page’s Code → Download ZIP), then install it within DSH using plugin_manager by filling target with the absolute path to the folder:

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

After restarting DSH, the “Models” page will appear in the sidebar, with cards injected via dsh-client-ui-sidebar.

Typical Usage¶

1. Open the sidebar “Models” page and browse the connected models grouped by API.
2. Use the search box to filter by API name, model name, or ID.
3. Click “Bookmark” on frequently used models; they will be sorted to the top of the corresponding API’s chat model menu.
4. Click “Apply”: changes the deployment default; collapsing “Set as Default” switches only the current or specified session.
5. When you need the Agent to handle this, instruct it to call model_shelf, for example catalog to list or use to apply.

Use Cases and Notes¶

Suitable for DSH users connected to multiple providers who frequently switch between common models, particularly those who don’t want to repeatedly type model IDs and wish to bookmark frequently used models.

Two points to note:

• The plugin runs with the permissions of the current DSH process. You should review the source code before installing and pay attention to its license (MIT).
• Bookmark data is stored only in the local storage domain. If DSH storage is cleared, bookmarks will be lost as well; they are not synced across devices.

Conclusion¶

The value of DSH Model Shelf is to transform “model selection” from manually remembering IDs into browsing and bookmarking grouped by API in the sidebar, while also exposing this selection capability to Agents. The directory page is at https://www.skillhub.cn/plugins/Kinfxhk/dsh-model-shelf, and the source code is at https://github.com/Kinfxhk/dsh-model-shelf.