Preface

In the DeepSeek Harness (DSH) Web interface, developers usually need more intuitive command-line interaction capabilities. The official UI currently lacks a native terminal view, which limits the Shell operating experience in a Web environment. The Relay DSH Terminal Plugin uses the plugin system to provide an xterm-based terminal panel at the bottom of the DSH Web UI, addressing this gap.

Plugin Overview

The Relay DSH Terminal Plugin is a provider-agnostic interactive terminal bottom-view plugin designed specifically for the DeepSeek Harness Workbench. It is maintained by user yangbobo2021 and is released under the MIT license.

Its core purpose is to add a browser-based terminal display layer to the official DSH Web UI, including bounded history scrolling, and to provide a public provider registry for connecting to underlying execution backends.

Core Features

This plugin provides the following capabilities:
1. Adds an xterm-based terminal panel at the bottom of the official DSH Web UI.
2. Provides a browser-based terminal display interface and bounded history scrolling.
3. Provides a public provider registry for execution backends.
4. Supports the versioned ctx.relayTerminalProviders registry.
5. Provides provider-agnostic connection logic for process spawning, input, resizing, output, and termination.
6. Integrates with the shared Workbench shell.

Installation and Enablement

This plugin depends on the Workbench plugin as its container. Make sure the Workbench is ready before installation. The installation command is as follows:

pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-workbench@latest relay-dsh-plugin-terminal@latest

After installation, restart the DSH Web process to activate the plugin.

Typical Usage

  1. Add the terminal panel: By using the installation command above, DSH Web will load the Terminal view in the bottom pane of the Workbench.
  2. Configure an execution backend: To start a live Shell, a compatible execution backend plugin must be installed (for example, relay-dsh-plugin-codex).
  3. Interact with the terminal: Switch to the Terminal view in the Workbench pane of DSH Web, and you can start entering commands.

Use Cases and Notes

Use Cases:
- Developers who need to add a terminal panel to the official DSH Web interface.
- Users who want to use compatible plugins (such as Codex) as the terminal transport channel.
- Developers who need to create new backend plugins and contribute terminal sessions through the ctx.relayTerminalProviders registry.

Notes:
- Provider dependency: This plugin does not create a Shell by itself. Another plugin must be installed to register a terminal provider before a live Shell can be displayed.
- Permission configuration: If using the Codex provider, each user-operated terminal must explicitly request sandboxPolicy: { type: "dangerFullAccess" }; otherwise, startup will fail.
- Security risk: Terminal access is equivalent to command execution permissions for the DSH host user. Enable this capability only through trusted access channels and never expose it as an Agent tool.

Summary

The Relay DSH Terminal Plugin fills the gap in terminal interaction in the DSH Web UI through a plugin-based architecture. Its provider-agnostic design allows terminal functionality to be flexibly connected to different execution backends, providing developers with a Web interaction experience closer to a local environment.

  • GitHub: https://github.com/yangbobo2021/relay-dsh-plugin-terminal
  • Catalog: https://www.skillhub.cn/plugins/yangbobo2021/relay-dsh-plugin-terminal