dsh-models

dsh-models

实际效果 / Actual UI

推理层级 / Reasoning Effort

子代理路由 / Subagent Routing

主模型选择 / Main Model Picker

In one line

The model menu for the dsh web GUI — pick the model, its effort, and your subagents' model, all from the composer's model seat.

What it is

A renamed, maintained fork of ttmouse/dsh-model-picker (v1.18.0 baseline). The upstream picker replaces the composer's model seat with a search-first popup; this fork keeps that and adds the pieces a multi-model daily driver needs.

A three-zone trigger button splits three concerns into three popups:

Plus a settings-page 「模型选择」 card: discovery master switch, ignore/restore for discovered models, hidden-model management — linked live with the picker.

Fork attribution

Upstream: ttmouse/dsh-model-picker (MIT). This repo renames the package to dsh-models and maintains the enhanced build (subagent routing, dim bridge, settings card, zh/en locale, custom background color, theme readability fixes). Routes (/api/model-picker/…) and dsh.modelPicker.* storage keys keep their upstream names so existing preferences migrate seamlessly.

Install

Requires harness ≥ 0.2.0-rc.1 (verified on 0.2.0-rc.2; also running on 0.2.1-alpha.3).

curl -fsSL https://raw.githubusercontent.com/taxueseek/dsh-models/main/install.sh | sh
# restart dsh web

Manual equivalent:

dsh plugin --profile web add git+https://github.com/taxueseek/dsh-models.git
# restart dsh web

The npm package named dsh-models is an unrelated third-party placeholder — install only via the script or the git command above.

Compatibility

Requires Node.js ≥ 22.19 (the floor the picker is developed and tested on).

What was actually checked on 0.2.0-rc.2 (this code, pre-rename build):

• Surfaces still resolve: conversation.input.model, web-ui.plugin.item; every icon used exists in the official browser roster.
• Seats that died upstream are avoided: the alpha.2-removed settings.plugin.item seat is not used; the settings card renders as a plain section (no locale field — a localized seat entry renders invisible).
• Server settings channel is dead on current hosts (scope.set() resolves false), so card preferences live in localStorage (dsh.modelPicker.* + cross-tab event) instead of webUiSettings.

Configuration

No host-side config knobs yet — the bundle entry carries no config block. User preferences (discovery switch, ignored/discovered models, hidden models, background color, per-session subagent routes) are managed from the settings-page card and the picker itself.

The dim bridge (optional)

When a dim CLI is present (dim on PATH or ~/.local/bin/dim), the host merges its catalog into the model facts: price badges, maxOut/released facts, and discovery rows for models dim knows that the dsh directory does not (capped at 30 per provider, newest first). Without dim the picker works exactly like upstream — the bridge degrades to directory-only facts.

Tests & performance

• npm test — two pure-Node suites: scripts/host-route.mjs drives the real route handlers (facts cache, subagent route, error guards), scripts/interaction.mjs renders the picker in jsdom and drives open/search/favorite/effort/virtual-window — 92 checks total. They SKIP cleanly when the harness peer deps are absent, so the suite stays green on any machine.
• Non-blocking cold start — a cold /api/model-picker/models cache answers a fast 503 while the catalog refresh runs in the background (measured: first response ~3 ms, warm 200 within ~3 s); the client retries that 503 with backoff, so price badges appear as soon as the facts land. Warm caches are served stale-while-revalidate.
• Virtualized list — the popup mounts only the rows around the viewport (~13 of 310 live) and pads the remainder with two spacer divs, so total height, the scrollbar and every offset stay exact; the section label of the group the list stands in is pinned by a synthetic twin once its real header leaves the window. Measured live in the running web GUI: open 58.7 → 23.5 ms median, 310 → 13 rows mounted, 5506 → 1170 DOM nodes; in the real- browser bench, cumulative React render across a full interaction session 243 → 65 ms. Row heights follow whether a row shows its description line (38/50 px), so the scroll math never re-lays-out. The host's dim refresh went 60 s → 10 min — a model catalog that turns over in days no longer costs ~1.5 s of CPU per minute. Full details in the CHANGELOG.