dsh-model-select-collapse
A DSH (DeepSeek Harness) web UI plugin that makes every provider group in the model selector collapsible — so a long model list stops being one endless scroll.
English · 简体中文
What this plugin does
Once installed, the model selector in the DSH composer gets clickable group headers:
| Before | After |
|---|
| Every provider's models are listed at full length, one long scroll | Each provider is a group with a header row that can be folded away |
| No way to hide providers you are not using | Click a header to collapse / expand that provider |
| State is lost every time the menu closes | Collapsed state is remembered per provider |
Concretely:
- Every provider group gets a header row with the provider name and the number of models in that group.
- Clicking the header collapses or expands that group, and the chevron beside it rotates to show the state.
- The state is stored per provider id in
localStorage under the key dsh.modelSelect.collapsed, so it survives closing and reopening the menu and survives a page reload.
- A provider with no stored record starts expanded, so providers you import later need no configuration.
Everything else about the picker behaves as before: the two-level menu (model list and reasoning effort), keyboard navigation, the loading / error / warning states, the retry action when a directory fails to load, and the toast shown when a selection fails.
The problem it solves
DSH lists every provider's models in one flat menu. With five or six providers that is already a long scroll; with a dozen it becomes a wall of entries, and the two or three you actually switch between are buried in the middle. This plugin keeps the same layout and ordering but lets you fold away the providers you are not using right now.
Behaviour details
| Behaviour | Detail |
|---|
| Toggle | Click a provider group header |
| Default | Expanded; only groups you collapsed are recorded as collapsed |
| Storage key | dsh.modelSelect.collapsed in localStorage (a { providerId: true } map) |
| Scope | Per browser profile — local state, never synced anywhere |
| Newly imported providers | Start expanded (no stored record) |
| Keyboard | The header is a real button, so it is reachable with Tab and activated with Enter / Space |
| Accessibility | Each group is a role="group" section labelled by its header, and the header exposes aria-expanded |
DSH 0.1.7-alpha.2 compatibility
DSH 0.1.7-alpha.2 renamed every icon export in @deepseek-ai/dsh-client-ui-primitives:
| Name before 0.1.7-alpha.2 | Name in 0.1.7-alpha.2 and later |
|---|
IconChevronDownOutline14 | IconChevronDownOutlineRegular |
IconChevronRightOutline14 | IconChevronRightOutlineRegular |
IconCheckOutline16 | IconCheckOutlineRegular |
IconWarningOutline16 | IconWarningOutlineRegular |
The old names resolve to undefined on the new version, and using undefined as a React element type throws Element type is invalid. DSH's slot system then abdicates the crashed entry and the official model selector silently takes its place — which looks exactly like "the collapse button disappeared", not like a broken plugin.
lib/client.js therefore probes both namings when it loads and keeps whichever is present, falling back to a no-op component if an icon is missing entirely. The result is one release that runs on both older and newer DSH versions. Toast exists in both versions with a compatible signature and is treated as optional the same way.
Installation
From GitHub (recommended)
dsh plugin --profile web add github:banana770/dsh-model-select-collapse
From a local checkout
dsh plugin --profile web add /path/to/dsh-model-select-collapse
After installing, reload the DSH web UI (restart DSH, or hard-refresh the page) and open the model selector from the composer.
Manual installation
Four files matter:
package.json manifest: declares the client entry (dsh.client) and the bundle patch
cordis.patch.yml mounts the plugin into the profile's bundle roster (insert: model-select-collapse)
lib/index.js host half: an empty no-op that keeps the loader entry alive
lib/client.js the real logic: shadows the model selector seat and adds group collapsing
Drop the directory into the profile's install location and make sure the insert entry in cordis.patch.yml (id: model-select-collapse, name: @dsh-external/dsh-model-select-collapse) is active. There is no build step.
Uninstalling
Remove dsh-model-select-collapse from the Installed list on the sidebar Plugins page, then reload the UI. For a manual install, delete the matching insert entry from cordis.patch.yml and restart DSH.
How it works
- Seat shadowing. DSH's composer model picker is the
conversation.input.model slot. The official plugin registers it at the default priority 0; this plugin registers at -1, and the rule for a single slot is "lowest priority wins". The plugin's view therefore replaces the official one.
- No forked data layer. All provider and model data comes from DSH's own
modelDirectories service (directoryFor(sessionId) returns a SnapshotStore, consumed here through useSyncExternalStore) — the same source the official view uses. The plugin only re-renders it.
- Isolated styles. One stylesheet is injected into
document.head behind a data-plugin-css marker, and every class name is namespaced with an mse_ prefix, so nothing can collide with official DSH class names.
- No dictionary registration. The official model-selection plugin already registers the
zh / en dictionaries for the model namespace, and this plugin declares that same namespace when registering its seat so it reuses them — registering a duplicate namespace throws.
Customizing
| What you want to change | Where |
|---|
| Default state for providers with no stored record | loadCollapsed() in lib/client.js |
| Storage key | STORAGE_KEY in lib/client.js |
| Chevron direction when collapsed | .mse_groupChevronCollapsed in the css block |
| Width, spacing, colours | the css block in lib/client.js (built on --dsw-* theme variables) |
Privacy
- Nothing leaves the machine. The plugin makes no network requests of its own and contacts no third-party service; it reads and writes the same DSH model directory service that the official selector uses.
- No telemetry, no analytics, no accounts.
- No API keys are included in or requested by this plugin. Provider credentials stay wherever DSH already keeps them.
- One piece of local state is written: the
dsh.modelSelect.collapsed map in localStorage, which records which provider groups you folded away. It holds provider ids and booleans and nothing else; deleting it simply resets every group to expanded.
- No access to conversation content and no file access.
Compatibility
- Targets the DSH web profile (
platform: "web").
- Verified on DSH
0.1.7-alpha.2. Because the icon lookup probes both namings, it also runs on releases that still use the older icon names.
- Uses the
react that DSH itself provides (peerDependencies: >=18 <19), so a second copy is never installed.
- No build step:
lib/client.js is the final, directly mountable bundle.
License
BSD-3-Clause — use, modify and redistribute freely.
