English · 简体中文
dsh-keyboard-manager pixel-art control room routing Ctrl+Q, Ctrl+E, and Ctrl+S to native or plugin surfaces.
Keyboard shortcuts for the DeepSeek Harness (dsh) Web UI — three focused chords behind one listener, wired to whichever right-side surface is actually present.
Shortcuts
| Chord | Action |
|---|
Ctrl+Q | toggle the built-in left sidebar |
Ctrl+E | toggle the RIGHT sidebar — the dsh-better-sidebar panel (Files / git / terminal / browser…) when that plugin is loaded, otherwise the native conversation details panel |
Ctrl+S | open / close the Settings modal |
Rules that keep the bindings predictable:
- Strict chords only. Plain
Ctrl with no Cmd / Shift / Alt riders; Cmd variants stay with the browser or OS.
- Never fights the page. IME composition, key auto-repeat, and events another listener already consumed are left alone.
Ctrl+S yields inside dsh-better-sidebar. Its editor binds Ctrl/Cmd+S to save, so with focus inside that plugin's panel the chord passes through.Ctrl+E needs an active session. Both the plugin panel and the native details column are session-scoped surfaces.
Three keyboard chords route through one capture-phase listener to the native layout service, the optional plugin panel or native details fallback, and the Settings affordance.
Install
Defaults are Ctrl+Q / Ctrl+E / Ctrl+S. Physical key codes can be overridden in the profile patch; see Keymap configuration below.
dsh plugin --profile web add github:Aafff623/dsh-keyboard-manager
Then hard-refresh the browser (Ctrl+Shift+R). dsh.bundle.patch adds the plugin to the profile bundle — no profile file edits.
lib/ is committed on purpose: a git install works with zero build step. If you change src/, run npm run build and commit the refreshed lib/ together — CI fails on drift.
How it works
DSH's layout service exposes actions but no state reads, and the settings modal's open state is component-local. So the bindings ride on stable DOM markers and the shell's own affordances instead of React internals or hashed CSS classes. Every path degrades to a silent no-op when its marker is missing — it never misfires.
One capture-phase keydown listener validates a strict Ctrl chord, detects the available surface, and invokes the native service or the plugin's own button.
Ctrl+Q — pure service call (ctx.layout.toggleSidebar()).Ctrl+E — with dsh-better-sidebar loaded, clicks the right-panel switch in [data-dsh-toggle-cluster] (prefers a button whose aria-label or data-panel mentions right, otherwise the last button); otherwise calls ctx.layout.openDetails()/closeDetails(), deciding direction from the frame root's data-details-collapsed located via [data-shell-overlay].Ctrl+S — clicks the sidebar settings trigger (button[aria-haspopup="dialog"], the first one in frame document order) to open; dispatches a document-level Escape — exactly what the panel's close logic listens for — to close.
Keymap configuration
The defaults are KeyQ, KeyE, and KeyS. All three physical key codes are overridable through plugin config:
# ~/.dsh/profiles/web/cordis.patch.yml (the profile's own patch layer)
- id: dsh-keyboard-manager
config:
sidebar: KeyQ
rightPanel: KeyE
settings: KeyS
Key codes are validated against /^[A-Z][A-Za-z0-9]+$/, duplicate codes are rejected, and invalid input falls back to the defaults. Restart dsh and refresh the page to apply.
How the config reaches the browser: DSH's web boot mounts client halves without plugin config (loader.create({ name })), so the browser half's apply second argument is always undefined. The node half therefore serves the config as JSON on /plugin-config/dsh-keyboard-manager, and the browser half pulls it once at activation and hot-swaps the bindings. If the pull fails — or on headless profiles, where there is no web server — the defaults stay in effect.
DOM contract
The bindings rely only on the following stable, centrally-declared markers (verified against the dsh-client-ui-layout and dsh-better-sidebar sources):
| Marker | Source | Purpose |
|---|
[data-dsh-toggle-cluster] | dsh-better-sidebar | right-panel button cluster |
[data-dsh-panel-host] | dsh-better-sidebar | scope where Ctrl+S yields to the editor |
[data-shell-overlay] | dsh-client-ui-layout | native AppFrame anchor |
data-details-collapsed | dsh-client-ui-layout | native details panel collapsed state |
button[aria-haspopup="dialog"] | dsh-client-ui-settings-general | the settings trigger |
Development
npm install
npm run typecheck # tsc --noEmit
npm run build # esbuild → lib/index.js + lib/client.js (ModuleLoader-wrapped)
npm test # node:test, vm-isolated fake-DOM suite
Plugin layout follows the standard DSH dual-half shape:
src/index.ts — node / host half (serves the plugin config as a JSON route for the browser half to pull)src/client/index.ts — browser half (all keymap behavior)lib/client.js — the browser bundle wrapped in the window.__ModuleLoader__.load() factory shapecordis.patch.yml — the bundle insert that mounts the plugin
Dev overlay against a running web profile, without installing:
dsh web --patch D:/code/dsh-plugin/dsh-keyboard-manager/cordis.dev.yml
Compatibility
- Requires
@deepseek-ai/cordis ^4.0.2 and the DSH Web UI.
dsh-better-sidebar is optional: the right-panel chord falls back to the native details column when it is absent.- The
Ctrl+S save hand-off depends on dsh-better-sidebar's editor; the chord behaves globally everywhere else.
License
MIT
