# Plugin Manager for DeepSeek Harness

[![npm version](https://img.shields.io/npm/v/relay-dsh-plugin-manager?label=npm)](https://www.npmjs.com/package/relay-dsh-plugin-manager)
[![CI](https://github.com/yangbobo2021/relay-dsh-plugin-manager/actions/workflows/ci.yml/badge.svg)](https://github.com/yangbobo2021/relay-dsh-plugin-manager/actions/workflows/ci.yml)
[![npm downloads](https://img.shields.io/npm/dm/relay-dsh-plugin-manager?label=downloads)](https://www.npmjs.com/package/relay-dsh-plugin-manager)
[![GitHub stars](https://img.shields.io/github/stars/yangbobo2021/relay-dsh-plugin-manager?style=flat)](https://github.com/yangbobo2021/relay-dsh-plugin-manager/stargazers)
[![MIT license](https://img.shields.io/github/license/yangbobo2021/relay-dsh-plugin-manager)](LICENSE)
[![DSH compatibility](https://img.shields.io/badge/DSH-0.1.1--rc.2-2f7d68)](https://github.com/deepseek-ai/deepseek-harness)
[![npm trusted publishing](https://img.shields.io/badge/npm_trusted_publishing-enabled-2f9e44)](.github/workflows/release.yml)

English | [中文](README.zh.md)

**npm package:** [`relay-dsh-plugin-manager`](https://www.npmjs.com/package/relay-dsh-plugin-manager)
· [Relay DSH plugin catalog](https://github.com/yangbobo2021/Relay/blob/codex/relay-foundation/docs/dsh-plugins.md)

`relay-dsh-plugin-manager` lets you discover and manage DSH plugins directly
from a DeepSeek Harness Chat conversation. Ask for the capability you need, or
ask DSH to install, update, enable, disable, or remove a plugin. DSH shows a plan
and waits for confirmation before changing your Profile.

## Install

If you installed official DSH yourself, stop DSH Web and install the published
npm package with the DSH CLI:

```bash
dsh plugin --profile web add relay-dsh-plugin-manager@latest
```

Then start or restart DSH Web:

```bash
dsh web
```

The plugin appears under **Settings > Plugins > Plugin marketplace**. This page
is a short help view; plugin management itself happens in Chat.

### Installed by KeySync

When you use [KeySync](https://sublang.ai/keysync/download/) to install DSH with
its one-click setup, this plugin is included and installed automatically. You do
not need to install it again. The command above is for standalone official DSH
installations or Profiles where the plugin was removed.

## Use

Describe what you want in ordinary language:

```text
Find a plugin that connects to Lark
Find DSH plugins owned by GitHub user yangbobo2021
Install relay-dsh-plugin-codex
Install relay-dsh-plugin-codex, relay-dsh-plugin-files, and relay-dsh-plugin-terminal together
List my installed plugins and their status
Disable example-dsh-plugin
Remove example-dsh-plugin
```

You can also use the single `/plugins` command:

```text
/plugins find a workspace file browser
/plugins search owner:yangbobo2021
/plugins install relay-dsh-plugin-files
```

Search and inspection are read-only. Installation, update, removal, enablement,
disablement, and restart always show a plan. You can confirm with DSH's choice
UI, or explicitly approve in a later Chat message.
When you request multiple installs together, DSH shows one ordered plan and any
missing companion peers, waits for one confirmation, and runs the installs in
sequence. Completed changes that still need restart are reported explicitly as
restart-required or waiting for a manual restart.

## Real Install Demo

[![Plugin Manager installs relay-dsh-plugin-codex successfully in DSH](https://raw.githubusercontent.com/yangbobo2021/Relay/codex/relay-foundation/docs/media/dsh-plugin-manager-codex-install-success.png)](https://github.com/yangbobo2021/Relay/blob/codex/relay-foundation/docs/media/dsh-plugin-manager-codex-install-demo.en.mp4?raw=1)

Watch the [40-second real DSH run](https://github.com/yangbobo2021/Relay/blob/codex/relay-foundation/docs/media/dsh-plugin-manager-codex-install-demo.en.mp4?raw=1):
search, planning without changes, separate confirmation, installation, and the
final `succeeded` status. It was recorded against official DSH commit
[`b150a551`](https://github.com/deepseek-ai/deepseek-harness/commit/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e)
with Plugin Manager `0.1.0-rc.3` and Codex plugin `0.1.2`. DSH reports when a
restart is required after installation.

## Part of Relay

This plugin is developed in the
[Relay](https://github.com/yangbobo2021/Relay) integration workspace and is
published as an independently installable DSH plugin. Relay explores durable
Agent work, external-event delivery, reusable DSH views, and multiple
conversation backends.

Other Relay DSH plugins:

- [Codex conversations](https://github.com/yangbobo2021/relay-dsh-plugin-codex)
- [Claude Code conversations](https://github.com/yangbobo2021/relay-dsh-plugin-claude)
- [Workbench panels](https://github.com/yangbobo2021/relay-dsh-plugin-workbench)
- [Workspace files](https://github.com/yangbobo2021/relay-dsh-plugin-files)
- [Terminal](https://github.com/yangbobo2021/relay-dsh-plugin-terminal)

See the [complete Relay DSH plugin guide](https://github.com/yangbobo2021/Relay/blob/codex/relay-foundation/docs/dsh-plugins.md)
for installation combinations and compatibility notes.

## Feedback

Report bugs and feature requests in the
[issue tracker](https://github.com/yangbobo2021/relay-dsh-plugin-manager/issues).