Skip to main content

dsh-reasoning-effort

93Stars9Forks4Issues0Watchers

Add a Codex-style model and inference intensity slider control below

Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki
Language
TypeScript
License
MIT
Branch
main
deepseekdeepseek-harnessdsh-pluginreasoning-effort

Install

cmdweb profile
$ dsh plugin --profile web add dsh-reasoning-effort

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin HanaAyane/dsh-reasoning-effort for me: review the repository at https://github.com/HanaAyane/dsh-reasoning-effort first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

One-Line Description

Adds a Codex-style "Model + Current Reasoning Effort" button below the DSH Web input box. When opened, the top shows a reasoning effort slider with a radiation effect (gears automatically adapt to the current model), while the bottom still shows the native DSH model list. Enabled by default after installation, and the gear status shares the same session with the /model command.

Core Features

  • Injects a combined trigger button into the "model seat" slot below the input box (displays current model name + current gear name); clicking to expand the popover shows a reasoning effort slider at the top and the native DSH model list at the bottom
  • Slider gears are read entirely from the reasoning.efforts publicly exposed by the current model in the DSH model directory; when a model has fewer than two gears, the slider is hidden entirely with a message "Current model does not provide reasoning effort gears" — the plugin never invents new gears
  • When dragging the slider, the button moves continuously following the pointer position and snaps to the nearest gear only on release; on failure it automatically rolls back to the last confirmed gear and displays an error in the status bar
  • Gear submission goes through the DSH session interface, reading/writing to the same session directory as the /model command without conflicts; supports keyboard ←/→/Home/End for switching
  • The plugin includes an "Effort Declaration Guide" panel: for user-declared models with missing or inconsistent directory gears compared to the knowledge base, it provides a complete copyable YAML entry (including - id: line, preserving name/contextWindow/maxTokens); after replacing settings.yaml, DSH loads it automatically
  • Settings → General Settings adds two toggles: "Reasoning Effort Slider" (globally enable/disable) and "Chibi Thumb Slider" (replaces default white thumb with eight-frame running character); both are stored only in browser localStorage

Technical Implementation

  • Language: TypeScript (Host half src/index.ts, Client half src/client/index.tsx), build uses esbuild to bundle client modules, tsc outputs types and Node entry
  • Key Dependencies: @deepseek-ai/cordis (plugin runtime), @deepseek-ai/dsh-client-ui-model-selection (session model directory), @deepseek-ai/dsh-client-runtime + dsh-client-ui-slots (frontend slots), @deepseek-ai/schemastery (Host-side settings schema)
  • Architecture Pattern: Official Bundle Plugin — cordis.patch.yml synthesizes a reasoning-effort layer in the web Profile; the Host half injects settings, llm services via apply(ctx) and registers namespace dsh-reasoning-effort (read-only and diagnostic, never writes), while using ctx.inject(['connection']) to mount a loopback RPC channel /dsh-reasoning-effort only in web environment; the Client half registers to conversation.input.model and settings.general.item slots via ctx.slots.inject
  • Entry Files: src/index.ts (Host half, loopback RPC endpoints diagnose / store) + src/client/index.tsx (Client half, components + preference storage + slider canvas rendering)

Use Cases

Users who want to quickly switch reasoning effort gears like "Off / Low / Medium / High / Max" via slider/keyboard on DSH Web, without typing /model each time; and scenarios where using a custom provider model with missing directory gears need the plugin to provide a directly pasteable reasoningEfforts YAML fragment to complete the declaration. Gear switching status is fully interoperable with native /model, and the native model selector remains usable.

Prerequisites and Compatibility

DependencyMinimum VersionDescription
DeepSeek Harness0.1.0-rc.6peerDependencies lists seven host packages including @deepseek-ai/dsh-client-*, @deepseek-ai/dsh-api-remotes all require ^0.1.0-rc.6; DSH is still in developer preview, upstream UI/service changes may require plugin updates
Node.js>=22.19package.json#engines.node explicitly declares >=22.19, mainly used for building (tsc + esbuild)
React^18.2.0peerDependencies.react: "^18.2.0", client components based on React 18 Hooks
ProfileWeb onlypackage.json#dsh.client.platform: "web"; the Host half's RPC channel is mounted via ctx.inject(['connection')] only in Web Profile, terminal Profile won't trigger
Native ModulesNoneNo runtime dependencies on node-pty, node:sqlite or other native bindings; only uses browser Canvas / localStorage / fetch

Installation

dsh plugin --profile web add github:HanaAyane/dsh-reasoning-effort

Configuration Options

ConfigTypeDescriptionDefault
dsh-reasoning-effort.entries[] (Host settings.yaml)ArrayExtends gear knowledge base, each entry contains id, provider (* wildcard), model (* wildcard), note, efforts (gear name → endpoint actual value, null means not selectable), optional compat (required only for OpenAI-compatible endpoints, containing thinkingFormat and supportsReasoningEffort). Plugin only generates fragments and prompts, won't automatically writeentries: []
Browser localStorage dsh-reasoning-effort.enabledBooleanEnable/disable the entire reasoning effort slider enhancement; after disabling, popover immediately returns to native DSH model selectortrue
Browser localStorage dsh-reasoning-effort.chibi-thumbBooleanReplaces slider thumb with eight-frame running character animation; user preference takes priority over built-in defaulttrue (since 0.6.1)
Legacy key @dsh-external/dsh-reasoning-effort.enabledBooleanPreference under historic package name, automatically migrated to new key then cleared—

FAQ

Q: After installation, I don't see the "Model + Reasoning Effort" button below the input box. What should I do?

A: The plugin loads when the Web Host starts; you must quit and restart the DSH Web Host then refresh the page. If the button still doesn't appear, verify that "Settings → General Settings → Reasoning Effort Slider" is enabled, and the current model exposes at least two reasoning effort gears in the DSH model directory (fewer than two will show "Current model does not provide reasoning effort gears").

Q: The current model doesn't declare reasoning effort gears (e.g., GLM-5.3). What should I do?

A: The model menu will show "View Effort Declaration Guide"; clicking it provides a directly copyable reasoningEfforts full YAML (including - id: line, existing name/contextWindow/maxTokens will be preserved). Copy it, replace the corresponding entry in ~/.dsh/settings.yaml entirely and save — DSH loads automatically without restart. If the knowledge base also has no entry, it provides a general template based on endpoint documentation.

Q: How do I confirm the plugin has loaded?

A: Run dsh --profile web --dump-config; the parsed config should show a line name: dsh-reasoning-effort, corresponding to the bundle layer with id: reasoning-effort. You must manually restart the DSH Web Host after installation — plugins are not hot-loaded at runtime.

Q: How do I uninstall?

A: Run dsh plugin --profile web remove dsh-reasoning-effort, then restart the DSH Web Host again. The native model selector restores automatically; DSH's built-in model directory won't be modified.

Q: Where are the slider toggle and "Chibi Thumb Slider" stored? Will they失效 if I switch browsers?

A: Both toggles are stored only in the current browser's localStorage (keys are dsh-reasoning-effort.enabled and dsh-reasoning-effort.chibi-thumb), not in DSH config files. Switching browsers or clearing browser site data will revert to default state. Legacy key @dsh-external/dsh-reasoning-effort.enabled is automatically migrated.

Q: Alibaba Cloud Bailian endpoint declared gears but still reports 400 error. Why?

A: Alibaba Cloud Bailian's OpenAI-compatible endpoints (maas.aliyuncs.com / dashscope.aliyuncs.com) reject the developer message role; DSH's pi-ai detection treats it as standard OpenAI, and settings.yaml currently cannot override this behavior. The plugin will directly show a warning in the gear declaration guide panel and recommend using the built-in zai route instead.

Learning Curve

Beginner — just install it and you'll see two toggles in "Settings → General Settings" that you can use directly; when supplementing gears for custom providers, just paste according to the YAML template in the README, no coding required.

Known Issues and Limitations

  • DSH is still in developer preview (0.1.0-rc.6), upstream UI or service changes may require plugin updates
  • Only supports Web Profile; terminal/Cordis-only Profile won't load the Client half, and the Host half's RPC channel is also skipped
  • Slider gear count is limited to what the model publicly exposes in the DSH model directory's reasoning.efforts: hidden entirely when fewer than two gears; the plugin never invents new gears, models with only one gear in the directory (including intentionally sparse data from official) remain unchanged
  • Slider radiation effect depends on requestAnimationFrame; under system "Reduce Motion" settings it automatically stops at a stable frame; at high DPR (>2), canvas is cropped to 2x to control rendering cost
  • Host half ignores structurally invalid entries in dsh-reasoning-effort.entries (e.g., wrong efforts field type) during loading; it won't fail diagnostics due to single bad data, but users must self-verify against schema

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/HanaAyane/dsh-reasoning-effort)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory