# DSH Question Navigator

[中文文档](./README.zh-CN.md)

A lightweight navigation plugin for long [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) conversations. Jump to your latest question, then move backward through previous questions without manually searching through long assistant responses.

## Features

- **Latest question**: jump directly to your most recent user message.
- **Previous question**: click repeatedly to walk backward through your questions.
- **Native control integration**: appears beside DSH's built-in **Back to bottom** button without duplicating it.
- **Auto-hide at bottom**: follows the native control and stays out of the way at the conversation tail.
- **Existing-history support**: works with user messages already rendered when the plugin is installed or a previous conversation is opened.
- **Long-history support**: tracks message identities when earlier paginated history is loaded.
- **Responsive UI**: text labels on desktop and compact icon controls on mobile.
- **Bilingual UI**: automatically follows Chinese or English browser language.
- **Theme-aware**: uses DeepSeek Harness design tokens for light, dark, and custom themes.
- **No DSH source patching**: integrates through the public `shell.overlay` slot.

## Requirements

- DeepSeek Harness Web `0.1.0-rc.6` or later.
- Node.js 20 or later.
- A DSH Web profile. The examples below use the profile name `web`.

## Install from GitHub

Add the repository to your Web profile:

```bash
cd ~/.dsh/profiles/web
dsh plugin --profile web add github:Cocowwy/dsh-plugin-question-navigator
```

Restart the existing DSH Web process, then refresh the browser:

```bash
dsh web --profile web
```

If your profile has another name, replace both occurrences of `web` with that profile name.

## Update

```bash
cd ~/.dsh/profiles/web
dsh plugin --profile web update dsh-plugin-question-navigator
```

Restart DSH Web and refresh the page after updating.

## Uninstall

```bash
cd ~/.dsh/profiles/web
dsh plugin --profile web remove dsh-plugin-question-navigator
```

Restart DSH Web after removal.

## Usage

1. Open a new or existing conversation containing at least one user message.
2. The navigator is hidden at the conversation bottom. Scroll upward slightly to reveal it.
3. Click **Latest question** to place the newest question at the top of the reading area.
4. The control changes to **Previous question**. Click it repeatedly to navigate backward.
5. At the first question, the control reads **No earlier question** and becomes disabled.
6. Use DSH's native **Back to bottom** button or manually scroll to the bottom. The navigator hides and resets to **Latest question** for the next upward scroll.

### Existing conversations and older history

The plugin scans all user messages currently rendered in the active conversation, including messages created before the plugin was installed. It is not limited to new messages. DSH may keep very old messages outside the page until you click **Load earlier**; once DSH renders those messages, the plugin detects them automatically and adds them to backward navigation.

## Local development

```bash
git clone https://github.com/Cocowwy/dsh-plugin-question-navigator.git
cd dsh-plugin-question-navigator
npm run check
cd ~/.dsh/profiles/web
dsh plugin --profile web add link:/absolute/path/to/dsh-plugin-question-navigator
```

Restart DSH Web after changing the local plugin. The distributed plugin is plain JavaScript and requires no build step.

## Compatibility notes

The plugin uses the public DSH overlay slot and stable conversation DOM markers:

- `[data-conversation-scroll]`
- `[data-chat-flow]`
- `[data-chat-flow-kind="user"]`
- `[data-chat-anchor-key]`

If a future DSH release changes these markers, the plugin may need a compatibility update.

## Search keywords

DeepSeek plugin, DeepSeek Harness plugin, DSH plugin, chat navigation, conversation navigation, latest question, previous prompt, AI chat productivity.

## License

[MIT](./LICENSE)