Back to home

2768651338

dsh-effort-slider

仿 Claude Code 推理等级滑块 DSH 插件

Stars
1
Language
TypeScript
Created
Aug 16, 2026
Updated
Aug 16, 2026

Introduction

dsh-effort-slider

A Claude Code–style reasoning-effort slider for DeepSeek Harness — click Effort in the model menu, drag without steps, snap on release, with a WebGL fire trail; any third-party model/provider gets real, working thinking-effort control.

License: BSD-3-Clause DeepSeek Harness version TypeScript React topic: dsh-plugin


中文

Click the Effort row (second row of the official model menu) instead of the built-in level list: an Effort slider panel pops up — OFF/MAX scale ticks, Low/Medium/High/Ultracode status shown live, and after the panel closes the effort value stays color-coded on the menu row and on the model-seat trigger button.

Features · Compatibility · Install / Uninstall · Quick Start · Configuration · Permissions & Data · How It Works · Troubleshooting · Development

Demo screenshots (menu-row coloring / model-seat trigger / Effort panel — effort level is color-coded):

Menu rowModel-seat triggerEffort panel
Effort menu row coloredModel-seat trigger coloredEffort slider panel

🔧 v0.2.5 — Fixed the real landing bug in universal effort provisioning: explicit models arrays are now replaced as a whole (dsh-settings path ops cannot traverse array nodes, otherwise models is corrupted, the schema rejects the write, and provisioning fails silently).

🔧 v0.2.4 — Fixed universal effort provisioning never landing when the pi-ai settings section registers late: provisioning now retries until the section is ready (registration happens after the adapter and does not emit settings/updated).

🆕 v0.2.3 — The model-seat trigger button (「model · effort」 above the composer) also color-codes its effort name, persistent after the menu closes.

🔧 v0.2.2 — Fixed menu-row coloring breaking on whole-tree menu remounts: painting now does a full scan and re-paints on any DOM change (throttled), and infers the color from the effort text when the panel has not reported one yet.

🆕 v0.2.1 — After the panel closes, the effort value on the model menu's Effort row keeps its level color (OFF rose-gray / Low amber / Medium blue / High purple / Ultracode bright purple with glow).

v0.2.0 — Any custom third-party model/provider gets working thinking-effort control (adapter metadata provisioning + pi-ai wire-level provisioning, hot-applied).

🎛️ v0.1.0 — Initial release: intercepts the official Effort menu and shows a Claude Code–style Effort slider panel.


Features

FeatureDescription
🎚️ Stepless draggingContinuous 0–100 dragging that writes reasoningEffort in real time (16 ms throttle, no request pile-up while dragging)
🎯 Snap on releaseSnaps to the nearest level on release / blur / keyboard end, with one confirmation write
🔥 WebGL fire trailThree-pass shaders (ignite → blur → composite); the fire front follows the thumb with spring damping
🏁 OFF/MAX ticksFirst/last levels always show OFF / MAX; middle levels show the API-returned name
🎨 Level statusEffort name shown in the panel header, colored/glowing per level; menu row and model-seat trigger keep the same color after closing (v0.2.3)
🌐 Universal effortThird-party models without reasoning metadata automatically get the universal 5-level scale; pi-ai models get wire-level dictionaries patched in, hot-applied (v0.2.0)

Only reasoningEffort is written — model selection is untouched. Models with no multi-level reasoning show 「当前模型不提供多档推理等级」 (no multi-level reasoning available).

Universal effort provisioning (v0.2.0)

Any custom third-party model/provider gets thinking-effort control that actually works on the wire:

  • Adapter metadata provisioning (host): models without reasoning metadata get the universal 5-level scale injected (off/low/medium/high/max → OFF/Low/Medium/High/Ultracode), so the official model menu and this panel are selectable and request validation passes;
  • Wire-level provisioning (host, pi-ai): for llm-pi-ai models missing reasoningEfforts, the dictionary and compat wire dialect are patched in (hot-applied, no restart); pi-ai translates the level into real wire fields (reasoning_effort / thinking / OpenRouter reasoning.effort, etc.);
  • Client fallback scale: if the directory returns no reasoning metadata, the panel still opens with the universal 5-level scale;
  • Existing user declarations (reasoningEfforts: false or a custom dictionary) are always respected and never overwritten.

Supported wire dialects for custom endpoints (set effort-slider.defaultDialect or routes.<route>):

DialectWire effect
effort (default)OpenAI-style reasoning_effort: low/medium/high/max
deepseekthinking:{type} toggle + reasoning_effort
openrouterreasoning: { effort } (OpenRouter normalized)
together / zaireasoning.enabled / thinking:{type} + optional effort
qwenenable_thinking toggle
string-thinking / ant-lingthinking / reasoning.effort strings

Compatibility

ItemValue
DSH versionOfficial installer, web profile (verified on Windows)
Install mechanismdsh plugin --profile web add (bundle patch + dual half)
Depends onclient runtime / connection / sessions channels of dsh-base / dsh-web-app

Install / Uninstall

# Install (recommended, same bundle mechanism as dsh-navbar)
dsh plugin --profile web add github:2768651338/dsh-effort-slider#main

# Build locally and install (clone this repository)
pnpm build
dsh plugin --profile web add file:./dsh-effort-slider

After installing, restart DeepSeek Harness and press Ctrl+F5 once in the web page. The lib/ artifacts are committed, so GitHub installs need no local build.

ActionCommand
Upgradedsh plugin --profile web update dsh-effort-slider (or re-run add), then restart DSH
Uninstalldsh plugin --profile web remove dsh-effort-slider, then remove its row from cordis.patch.yml if any

Quick Start

  1. Install the plugin, restart DSH, press Ctrl+F5.
  2. Open the model menu above the composer → click Effort → the Effort slider panel appears.
  3. Drag to choose a level; it snaps on release. After the panel closes, the effort value keeps its color on the menu row.
  4. For custom models with no thinking effort, the panel opens with the universal 5-level scale; pi-ai models get their wire dictionaries patched on the host side (hot-applied).

A [effort-slider] intercept row: ... line in DevTools Console means interception is working.

Configuration

ItemDetails
Plugin optionseffort-slider settings section (written to ~/.dsh/settings.yaml, hot-applied)
Defaultsenabled: true, defaultDialect: effort
Environment variablesNone of its own; follows DSH's DSH_HOME resolution
Sensitive itemsNone — no keys, tokens, or credentials are read or stored
effort-slider:
  enabled: true          # provisioning master switch
  defaultDialect: effort # global default wire dialect
  routes:
    my-gateway: deepseek # per-route override

Permissions & Data

ScopeWhat it touches
Files (read)None — no user files are read or written (settings go through DSH's settings service)
NetworkNone — the browser half only talks to the local DSH /api RPC endpoint
CredentialsNever read
User dataNot read (no access to conversation content/messages/prompts; only the current session's reasoningEffort via the sessions channel)

How It Works

HalfFileRole
Hostlib/index.jsUniversal effort provisioning: adapter metadata wrapping (universalReasoning) + pi-ai wire patches (buildProvisionOps, idempotent, respects user declarations) + the effort-slider settings section; listens to llm/adapters-updated / settings/updated for hot application
Browserlib/client.jsCaptures clicks on the model menu's Effort row → shows the Effort panel; throttled selectModel({ reasoningEffort }) writes; a MutationObserver keeps the menu-row level color alive after the panel closes

The browser half follows the official external-plugin convention: classic script + window.__ModuleLoader__.load factory; react / react-dom/client / react/jsx-runtime are platform externals; effort.module.css is hashed and inlined by lightningcss, injected as <style data-plugin> when the factory runs.

Troubleshooting

SymptomFix
No Effort row in the model menuThe model declares no reasoning metadata and host provisioning is not in effect — confirm DSH was restarted and check effort-slider.enabled in ~/.dsh/settings.yaml
Panel says 「当前模型不支持思考强度调节」Universal fallback not active — upgrade to v0.2.0+ and restart
Dragging has no effectCheck whether the target endpoint's wire dialect matches (see the dialect table) or set defaultDialect for that route
Conflicts with other skin pluginsIf another skin that intercepts the Effort row is installed (e.g. the aurora skin of dsh-ui-web), disable its interception to avoid double panels
Version still shows old after restartfile: installs are snapshot copies — use the github: spec or re-run add before restarting
Where are the logs?Host errors: DSH startup log; client errors: browser DevTools (F12) Console

Project Structure

src/
  index.ts                  host half: universal effort provisioning (adapter metadata + pi-ai wire + settings section)
  effort-core.ts             pure logic: dialect → wire mapping, provisioning patches (unit-tested)
  client/
    index.ts                browser half: intercept the Effort row + panel anchor + menu-row coloring
    css-modules.d.ts
    effort/
      EffortPanel.tsx       Effort panel (levels / ticks / slider / glow)
      useWebglFire.ts       WebGL2 three-pass fire loop (spring follow + idle sleep)
      shaders.ts             vertex / ignite / blur / composite shaders
      effortColors.ts        level → color mapping (panel and menu row share it)
      effort.module.css      panel styles (inlined via lightningcss)
cordis.patch.yml           bundle patch (inserts the ui-effort-slider row)
lib/                        built artifacts (client.js ships with sourcemap)
test/                      host.spec.mjs unit tests + host-apply.spec.mjs + client.smoke.mjs

Development

pnpm install
pnpm build   # tsdown → lib/index.js (host half) + lib/client.js (browser half)
pnpm test    # host unit tests + apply integration test + jsdom smoke (intercept/render/snap/fallback/coloring/teardown)

Contributing. Fork → change → pnpm build → run pnpm test → open a PR against main. Small fixes (docs, tests) are welcome without prior discussion; report issues with the DSH version and the exact error.

License & Security

License: BSD-3-Clause — see LICENSE. The UI implementation references the aurora skin of the community dsh-ui-web project (BSD-3-Clause); full upstream notices and license texts are in THIRD_PARTY_NOTICES.md.

Security: this plugin reads no credentials and sends nothing over the network (only talks to the local DSH). To report a security issue privately, use GitHub's Report a vulnerability on the Security tab — do not open a public issue with exploit details.


BSD-3-Clause © 2768651338