dsh-spotlight

DSH Spotlight

简体中文 | English

A keyboard-first command palette for DeepSeek Harness Web. Open one palette to find native slash commands, recent sessions, visible UI actions, and installed plugin settings—without leaving the keyboard.

Features

• One shortcut: ⌘K on macOS, Ctrl+K on other platforms.
• Customizable: click the shortcut control in the footer, then press a new key combination. The setting is stored in the current browser.
• Native actions: discovers and triggers the actions already provided by DSH Web, and contributes one /spotlight command to the native slash menu instead of maintaining a second command registry.
• Fast search: deterministic fuzzy matching across slash commands, recent sessions, UI actions, and plugin settings.
• Keyboard navigation: Arrow Up/Down to select, Enter to run, Escape to close.
• Clean lifecycle: removes its event listeners, styles, and DOM nodes when unloaded.

Install

Install the bundle into your DSH Web profile. From npm:

dsh plugin --profile web add "@0xsline/dsh-spotlight"

Or from the Git source:

dsh plugin --profile web add "github:0xsline/dsh-spotlight#main"

The Git install runs the package's prepare lifecycle because generated lib/ files are not committed. It deletes and recreates only this package's lib/ directory with the repository-local TypeScript and tsdown executables; it does not access the network or write outside the checkout. If lifecycle scripts are disabled, install the npm release instead: it already contains the built lib/ files and does not run prepare during installation.

Then start DSH Web and press ⌘K or Ctrl+K:

dsh --profile web

Usage

1. Open Spotlight with the global shortcut, or type /spotlight in the DSH Web composer and pick the entry from the slash menu.
2. Type to filter commands and actions.
3. Use Arrow Up/Down and Enter, or click a result.
4. Click Shortcut in the footer to record a different key combination.
5. Click Reset to restore the platform default.

Shortcut preferences are local to the current browser origin and profile.

How it works

DSH Spotlight is a standalone Cordis bundle with a small Web client. The client mounts once the host's sessions, command-plane, plugin-inventory, and command-UI services exist — all standard in every stock DSH Web deployment — then reads recent sessions, slash commands, and the plugin inventory directly from those services. It also discovers actionable elements in the current page and delegates execution back to those native elements. A catalog RPC failure degrades only its own category. The plugin adds no server data channel and stores no durable server-side state.

src/index.ts             Loader metadata
src/client/index.ts      Web client activation and disposal
src/spotlight/           Host + DOM discovery, search, keyboard handling, and UI
cordis.patch.yml         DSH Web profile composition

Because part of the discovery follows the current DSH Web DOM, host UI changes may require updating the selectors in src/spotlight/discovery.ts.

Development

Requirements: Node.js ^22.19.0 || >=24.0.0 and pnpm 11.7.0.

git clone https://github.com/0xsline/dsh-spotlight.git
cd dsh-spotlight
pnpm install

pnpm run verify:self-contained
pnpm run typecheck
pnpm test
pnpm run build

Test a local checkout in DSH Web:

pnpm run prepare
dsh plugin --profile web add "link:$(pwd)"
dsh --profile web

Inspect the package contents before publishing:

pnpm pack --dry-run --json

License

MIT