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