# dsh-conversation-shortcuts

[中文](./README.md) · 🌏 English

A DeepSeek Harness WebUI plugin that adds keyboard shortcuts for managing conversations:

- `Control + Command + N` starts a new conversation by reusing the blank conversation in the current workspace. Without a workspace, it opens the new conversation view.
- `Command + B` toggles the sidebar.
- `⌘/Ctrl + ,` opens Settings.
- `⌘/Ctrl + 1` through `⌘/Ctrl + 9` open the first through ninth non-empty conversations in the left conversation list.

Shortcuts resolve conversations in the current left-sidebar DOM order, so they follow workspace groups, search results, and currently visible rows. Conversations inside collapsed groups are appended after visible rows and remain accessible with later number keys. The Settings page also includes a “Conversation Shortcuts” section describing these features.

> Chromium-based browsers usually reserve `⌘1` through `⌘9` for tab switching. If the browser intercepts the key combination first, the plugin cannot receive the event; use `Ctrl+1–9` or an alternative combination with `Option` instead.

## Installation

**Prerequisite**: Install DSH and make sure `dsh web` runs successfully.

Install the latest version from npm:

```sh
dsh plugin --profile web add dsh-conversation-shortcuts@latest
```

Then hard-refresh the WebUI (`Cmd/Ctrl + Shift + R`). Restart the Web process after changing the plugin host configuration or `cordis.patch.yml`.

### Install from source

```sh
git clone https://github.com/QChengW/dsh-conversation-shortcuts.git
pnpm exec dsh plugin --profile web add link:./dsh-conversation-shortcuts
```

Restart the Web process after changing the plugin so the profile patch and browser bundle are reloaded.

## Publishing

This project is published on both GitHub and npm:

- GitHub: <https://github.com/QChengW/dsh-conversation-shortcuts>
- npm: <https://www.npmjs.com/package/dsh-conversation-shortcuts>