dsh-better-model-picker

dsh-better-model-picker

An installable bundle for the DeepSeek Harness (DSH) Web GUI that replaces
the composer's model selector with an upgraded version. It shares the session's
model directory, so models picked here stay in sync with the /model popup.

Features

• Filter — a text box that narrows the model list as you type, using
  space-separated terms.
• Star-pin — an ☆/★ toggle on each model. Starred models stay pinned to the
  top under a "Starred" section with their provider headings, and persist
  across refresh and restart.

Install

pnpm install && pnpm run build      # produces lib/index.js + lib/client.js
dsh plugin --profile web add /path/to/dsh-better-model-picker

Then restart Deepseek Harness. dsh plugin add does both halves of the job because
this package declares dsh.bundle.patch: pnpm links it into the profile, and
the CLI appends it to that profile's dsh.profile.bundles layer stack. It is
the bundle's own cordis.patch.yml that inserts the plugin row.

Adding or removing the plugin only takes effect after restarting DeepSeek
Harness. The bundle layer is read at boot, so any change to the profile's
plugin set requires the harness process to be restarted before the new
configuration is reflected in the Web GUI.

Verify it landed without booting:

dsh --profile web --dump-config | grep -A2 better-model-picker

Uninstall

dsh plugin --profile web remove dsh-better-model-picker

As with installation, removal only takes effect after restarting DeepSeek
Harness.

Publish

prepare is intentionally omitted; run pnpm pack after pnpm run build to
ship prebuilt artifacts, or publish to a registry with lib/ built. Consumers
then need no build step:

dsh plugin --profile web add dsh-better-model-picker              # registry
dsh plugin --profile web add ./dsh-better-model-picker-0.1.0.tgz  # tarball

How it works

• A bundle ships a configuration layer (dsh.bundle.patch →
  cordis.patch.yml). A profile listing this package in dsh.profile.bundles
  applies that layer.
• One row serves as both halves. The loader mounts main (lib/index.js) as
  the host half (a no-op: selection rides the shipped session RPCs). The
  client-modules node half scans loader entries for packages declaring
  dsh.client and serves this one's browser bundle at
  /plugins/dsh-better-model-picker/client.js.
• The client half registers as the occupant of the conversation.input.model
  slot at priority: -1, shadowing the shipped ui-model-selection entry
  without disabling it. The shipped plugin keeps owning the /model popup
  and the model locale namespace, and both surfaces share one directory
  service (ctx.modelDirectories).

No web-shell rebuild is needed: plugin bundles are served per package from
lib/client.js and reach the page through window.__DSH_BOOT__ at boot.

Build

pnpm run build        # tsdown -> lib/index.js (ESM) + lib/client.js (CJS browser)
pnpm run typecheck    # optional; see tsconfig.json paths (needs a harness checkout)

The browser artifact is a CJS body wrapped in the
window.__ModuleLoader__.load({ id, factory }) closure the client module
system expects. react and the other shell-owned platform modules stay
external so the plugin shares the page's single React instance; everything else
is bundled. CSS Modules are inlined by lightningcss and inject a
<style data-plugin> tag at factory execution.

Layout

dsh-better-model-picker/
├── package.json                    # dsh.bundle (layer) + dsh.client (browser roster)
├── cordis.patch.yml                # the layer: inserts the plugin row
├── tsdown.config.ts                # both build faces
├── tsconfig.json                   # opt-in typecheck only
└── src/
    ├── index.ts                    # host half (no-op)
    └── client/
        ├── index.ts                # plugin body + slot registration
        ├── slots.ts                # ModelSelectInjected face
        ├── FilteredModelSelect.tsx # the component
        ├── FilteredModelSelect.module.css
        └── css-modules.d.ts