Model picker control for DSH — rename, regroup, sort, hide and badge every model in one place.
cross-provider partitions · rename models & groups · drag-to-reorder · hide a provider or a single model · suffix capsules · model folders with quota failover · one-click restore
dsh plugin add dsh-model-picker-control
---
## Why
DSH ships a good model picker, but the display is fixed: providers come in a hard-coded order, model names are whatever the catalog says, and there is no way to put two models from different providers side by side. If you route some models through an account provider and others through a partner provider, the list you actually want never exists.
This plugin gives you one settings page — sitting next to the built-in **Models** page — that owns the *display* of the picker, without patching a single third-party plugin. Hide the models you never touch, rename the rest into something you can recognise at a glance, drag the groups into the order you think in, and merge models from different providers into a partition such as **Free** or **Experimental**.
## Features
| | |
|---|---|
| **Rename anything** | Model display names, provider group names, and a short suffix capsule per model. |
| **Cross-provider partitions** | Create a partition and drop models into it from any provider — they render as one group. |
| **Drag to reorder** | Reorder provider groups and partitions with a handle (or focus it and press ↑↓). |
| **Hide, don't delete** | Hide a single model with the eye button; the eye on a provider card hides or shows all of its models at once. Nothing is removed from the catalog. |
| **In-group order** | Catalog order, by model name, or manual (drag in the preview). Per group or globally. |
| **Suffix capsules** | A host-native pill after the name — blue, dark red, cyan, any custom color or a holographic border — that sits beside the host's own `1017` tag. The text may be empty (a color-only chip). Per section, **Capsules** paints every model in it at once, and **Clear empty capsules** removes the text-less ones. |
| **Model folders** | In the preview card, drag a row onto the middle of another row of the same group to merge them into a folder (a "family"). The folder takes one row in the picker, can carry a capsule, and its members run top to bottom: when a request fails with an exhausted quota, rate limit, auth error, network error or a provider refusal (HTTP 400/403/404), the next member takes over and the request is resent as a normal model switch; a failed member rests until local midnight (quota, auth), 10 minutes (network) or 1 hour (refusal). Members you hid by hand, or that are hidden or outside the folder's group, are skipped. The folder offers the reasoning levels of its top member; after an automatic switch the highest level of the new member is used, and a level the model does not offer is fitted before the request instead of failing the turn. Standalone, no other plugin needed. |
| **Section headings** | A bold serif heading (embedded Playfair Display for Latin text) on a dark band that fades from left to right. **Settings → General → Styled section headings** turns it off and restores the original DSH heading. |
| **Preview & temporary hide** | A live preview card shows the picker as it will render: drag models into order, expand folders, and use the eye button to hide exhausted models for now (saved at once, no **Save** needed). |
| **Draft & save** | Every edit stays local until you press **Save**; leaving the page with changes asks first. |
| **Restore** | One click clears the plugin's settings; the host default returns. |
## Screenshots
The screenshots are rendered from this plugin's real build with sample data (the host UI is simulated, the plugin code is not). The picker shows cross-provider **Free**, **Fast** and **Flagship** partitions, a suffix capsule on most names in every tone (blue, red, cyan, custom color, holographic), a color-only capsule, and a **model folder** (`DeepSeek V4.1 Flash`, tagged `Pool`) that stands for several models and relays between them when one runs out of quota.
The holographic capsule is a dark violet pill with a rainbow border that turns slowly, a small pale catch-light that drifts around that border the other way, and a violet and a cyan glow that breathe on their own rhythm. The glow stays within a few pixels so it fits the composer row. Hover gives the border one extra turn and brightens the glow without making it bigger. Keyboard focus draws a light ring. With `prefers-reduced-motion` it keeps the static gradient border and drops the motion:
**Settings → Groups & partitions** — drag the groups into your own order, rename or hide a provider, and create a partition that pulls models in from any provider:
**Settings → Models** — rename a model, type a suffix capsule and pick its tone, drop it into a partition, or hide it. Nothing is written until you press **Save**:
**Settings → Picker preview** — the picker as it will render. Drag a row to reorder it, drop it on the middle of another row to merge both into a folder, and use the eye button to hide an exhausted model for now (applied at once, no **Save** needed):
## Install
```
dsh plugin add dsh-model-picker-control
```
Then restart DSH. Open **Settings** — a new page, **Model picker** (模型选择器), appears next to the built-in **Models** page.
Prefer a local build?
```bash
git clone https://github.com/qzz19970504/dsh-model-picker-control.git
cd dsh-model-picker-control
npm install
npm test
npm pack # produces dsh-model-picker-control-.tgz
dsh plugin add ./dsh-model-picker-control-.tgz
```
## Quickstart
1. Open **Settings → Model picker**.
2. Under **Groups and partitions**, press **New partition** and name it, for example, `Free`.
3. In the **Models** table, pick `Free` in the partition dropdown of the models you want there — from any provider.
4. Drag the groups into the order you like, hide what you don't use, and give the important ones a suffix capsule such as `NEW` or `cheap`. To color a whole partition at once, use **Capsules** on its row.
5. Optional: in the preview card, drag one model onto the middle of another in the same group to make a folder that fails over from top to bottom.
6. Press **Save**, then open the model picker in the composer. It matches immediately; no restart needed.
## Configuration
Everything is stored under this plugin's own row in your profile config (`config.picker`), written through the host settings service:
```yaml
- id: model-picker-control
name: 'dsh-model-picker-control'
config:
picker:
version: 1
enabled: true # false = restore the host display, keep the settings
sectionOrder: [p:free, deepseek-official, workbuddy]
providers:
deepseek-account: { name: DeepSeek Account, hidden: false }
models:
deepseek-official/deepseek-pro: { name: DeepSeek-V4.1-Pro, suffix: { text: cheap, tone: red }, partition: p:free }
workbuddy/step-5-preview: { suffix: { text: NEW, tone: cyan }, partition: p:free, hidden: false }
partitions:
- { id: p:free, name: Free }
sort: { default: name, bySection: { workbuddy: catalog } }
order: { p:free: [deepseek-official/deepseek-pro] } # used when the sort is manual
tempHidden: [] # the eye button in the preview
badges: { show1017: true }
headings: { art: true }
```
| Key | Type | Notes |
|---|---|---|
| `enabled` | boolean | `false` restores the host's own picker but keeps your edits. |
| `sectionOrder` | string[] | Section ids: a provider id, or `p:`. |
| `providers[id].name` | string | Group heading. Empty = the catalog name. |
| `providers[id].hidden` | boolean | Hide the whole provider. |
| `models["provider/model"].name` | string | Display name. Empty = the catalog name. |
| `models["provider/model"].suffix` | `{text, tone, color?}` | `tone` is `blue`, `red`, `cyan`, `custom` (needs `color`, `#rrggbb`, default `#ffffff`) or `holo`. Up to 20 characters; `text` may be empty for a color-only chip. |
| `models["provider/model"].partition` | string | `p:` to move it into a partition. |
| `models["provider/model"].hidden` | boolean | Hide this single model. |
| `partitions[]` | `{id, name}` | A partition merges models from different providers. |
| `sort.default` | `catalog` \| `name` \| `manual` | In-group order. |
| `sort.bySection` | map | Per-section override. |
| `order` | map | Per-section list of `provider/model` keys, used by the manual order. |
| `tempHidden` | string[] | Models hidden with the preview eye button; folder failover skips them too. |
| `badges.show1017` | boolean | Show or hide the host's `1017` tag next to a model. |
| `headings.art` | boolean | Styled section headings (serif face on a fading band). `false` restores DSH's own section heading. |
| `families[]` | `{id, name, section, suffix?, members: [{provider, model}]}` | Ordered members, top first. Failover triggers: quota/auth codes (`QUOTA`, `ACCOUNT_QUOTA`, `RATE_LIMIT`, `AUTH`), network codes (`TRANSPORT`, `SERVER`, `TIMEOUT`) and provider refusals (HTTP 400/403/404). |
## How it works
```
composer ──► slot conversation.input.model (single, session scope)
│
├─ host @deepseek-ai/dsh-client-ui-model-selection priority 0
└─ this dsh-model-picker-control priority -1 ← wins, host seat goes inactive
│
│ ctx.modelDirectories.directoryFor(sessionId)
▼
catalog groups ──┐
your config ─────┴──► src/pipeline.js ──► sections (order, names, hidden, partitions)
│
┌────────────────┴────────────────┐
▼ ▼
picker menu + trigger /model popup rows
│ │
└────────► directory.select() ◄───┘
```
- The picker seat `conversation.input.model` is a single, session-scoped slot. The plugin registers it at priority `-1`, which shadows the host seat at priority `0`; disabling the plugin brings the host seat straight back. Selecting, reasoning effort, search, keyboard navigation, the pending state and the “not available in subagent sessions” behaviour are all ported from the host picker and use the host's own `model` translations.
- The `/model` popup builds its rows through the same pipeline, so names, groups, order and hidden models match the picker. Row ids stay `provider/model`, so the host's own select handler is still what switches models.
- The model list itself is never modified. The plugin reads `ctx.modelDirectories.directoryFor(sessionId)` and renders a section list derived from the catalog plus your config; choosing a model still goes through `directory.select()`.
- Hiding only changes what is displayed. A saved selection that becomes invisible is left untouched — the trigger falls back to “Select model” and you can pick another one.
- Writes are revision-checked by the settings service, rolled back on failure, and only ever touch this plugin's row — the rest of `cordis.patch.yml` is never rewritten.
- Folder failover runs in the plugin's host half. It listens to `agent/request-error`; it parks the failing member and switches the session with the host's own `selectModel` (so the usual "model changed" notice is added) and returns `{kind: "retry"}` so the request is resent. How long a member stays parked depends on the failure: `QUOTA`, `ACCOUNT_QUOTA`, `RATE_LIMIT` and `AUTH` until local midnight; `TRANSPORT`, `SERVER` and `TIMEOUT` (seen only after the host's own retries are spent) for 10 minutes; a provider refusal with HTTP 400/403/404 (`PROVIDER_HTTP_ERROR` or `INVALID_REQUEST`, status read from the field or from a leading `400:` / `HTTP 400` in the message) for 1 hour. Context-window overflow and every other code never relay. If every member of the folder refuses the same request, the 10-minute and 1-hour parkings are undone so a bad request cannot lock the folder. Each request is retried at most once per member. Folder bindings and parked members are saved in `/state/dsh-model-picker-control.json` (not in the `picker` config, because a config write makes the host reload its model catalog), so they survive a restart; they clear when the parking ends or with the **Restore now** button on an exhausted member. With the plugin switched off, failover does nothing.
- The picker keeps the last good model list and each session's last model in the browser's `localStorage` (`dsh-model-picker-control/catalog`). After a full restart it paints that at once while the host rebuilds its catalog, which can take many seconds because every provider adapter lists its models over the network. The cache is display only and is replaced as soon as the live list arrives.
- The page is available in Chinese and English, following the GUI language.
## FAQ
**Does this patch other plugins?** No. It only registers slots and wraps the host's `/model` contribution in memory, and restores it on dispose.
**I hid the model I was using.** Your saved selection is kept; the trigger shows “Select model” and the picker offers whatever is still visible.
**Where are the settings?** In your DSH profile config, under the plugin's row: `config.picker`. **Restore all defaults** clears them.
**Can I keep the `1017` tag and add my own capsule?** Yes, they coexist — the tag and the capsule are separate slots.
**Does it work in subagent sessions?** The picker behaves as the host does there: it is shown as unavailable, matching host behaviour.
## Development
```bash
npm install
npm run build # concatenates src/ into lib/client.js (no bundler required)
npm test # pure pipeline tests (node:test)
npm pack
```
The source is plain ESM + `h()` calls — `src/pipeline.js` is pure data transformation and is what the tests cover; `src/client/` holds the slot code.
## License
[MIT](./LICENSE)
