# dsh-deepseek-chat

English | [中文](README.md)

Adds a standalone "Ask DeepSeek" chat window to the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web UI.

> Already using DeepSeek successfully in DeepSeek Harness? Install the plugin and restart the Web UI. It works immediately and never asks for the API key again.

## Install

If the `dsh` command is available:

```bash
dsh plugin --profile web add github:lhenlihai-hub/dsh-deepseek-chat
dsh web
```

If you use the official `npx` quick start and do not have a global `dsh` command:

```bash
npx --yes --package @deepseek-ai/dsh --package pnpm dsh plugin --profile web add github:lhenlihai-hub/dsh-deepseek-chat
npx @deepseek-ai/dsh web
```

If the Web UI is already running, stop and restart it. No archive download, repository clone, or local build is required.

## Use

- Click "Ask DeepSeek" on the right edge of the page.
- Switch between the DeepSeek models configured by the user.
- Select text in the main conversation and choose "Quote & ask DeepSeek".
- Stream responses, view reasoning, stop generation, or start a new chat.
- Automatically matches the Harness language and light/dark theme.

Plugin chats are independent of the main Agent session. Closing or resetting the plugin chat never changes the main conversation.

## API and privacy

- The plugin has no API-key input.
- It never reads, stores, or sends an API key to the browser.
- Every request goes through dsh `ctx.llm` and uses the user's configured DeepSeek route and models.
- If DeepSeek is not configured, the plugin only directs the user to dsh **Settings → Models**.

## Uninstall

Open **Settings → Uninstall plugin → Confirm** in the plugin window, or run:

```bash
dsh plugin --profile web remove dsh-deepseek-chat
```

Without a global `dsh` command:

```bash
npx --yes --package @deepseek-ai/dsh --package pnpm dsh plugin --profile web remove dsh-deepseek-chat
```

Restart the Web UI to apply the change.

## Development

```bash
npm install
npm run typecheck
npm run build
```

The tracked `lib/` files are the prebuilt artifacts used for direct GitHub installation.

## License

[MIT](LICENSE)