relay-dsh-plugin-terminal
适用于 DeepSeek Harness 中 Relay 工作台的提供商中立交互式终端插件。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add relay-dsh-plugin-terminal@0.2.3-rc.1Relay Dsh Plugin Terminal 以 relay-dsh-plugin-terminal 发布，当前版本为 0.2.3-rc.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Now supports DSH
0.1.2-rc.1while retaining0.1.2-alpha.3compatibility. Plugin0.2.2is verified on both releases. Install it from npm · Compatibility evidence.
Release channels:
latest→0.2.2;next→0.2.1-rc.1.
npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-workbench@0.2.3-rc.1 relay-dsh-plugin-terminal@0.2.3-rc.1 relay-dsh-plugin-codex@0.2.3-rc.1
npx @deepseek-ai/dsh@0.1.2-rc.1 web
English | 中文
npm package: relay-dsh-plugin-terminal
· All Relay DSH plugins
Live npm-installed Relay plugins in official DSH
Real npm-installed demo on official DSH: Terminal starts a live workspace shell and executes a command below the conversation. Watch the H.264 MP4.
relay-dsh-plugin-terminal adds an xterm-based bottom terminal panel to the
official DeepSeek Harness
(DSH) Web UI. It provides the browser terminal surface, bounded scrollback, and a
public provider registry for execution backends.
The plugin uses relay-dsh-plugin-workbench as its panel host. Install
Workbench in the same DSH Profile.
Relay Terminal bottom panel in DSH Web
The screenshot was captured from official DSH 0.1.1-rc.2 with Workbench,
Files, and Terminal installed. Terminal can load without a provider and shows a
clear provider-unavailable state; install a compatible backend when you want a
live shell.
Install this plugin when you want to:
relay-dsh-plugin-codex, as the
terminal transport;ctx.relayTerminalProviders registry.Terminal is provider-neutral. If you install only this package, DSH can load the panel but cannot start a live shell until another plugin registers a terminal provider.
The current development build has been validated with:
0.1.1-rc.2, commit
b150a551pnpm available on PATHDSH is a developer preview and may introduce compatibility-breaking changes.
Stop a running DSH Web process before changing Profile plugins.
Use this when you want the latest unreleased development build:
pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-workbench#main github:yangbobo2021/relay-dsh-plugin-terminal#main
For an interactive terminal through Codex, install both development plugins:
pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-workbench#main github:yangbobo2021/relay-dsh-plugin-terminal#main github:yangbobo2021/relay-dsh-plugin-codex#main
For a reproducible install, replace each #main with a tag or full commit SHA.
The Workbench package is listed explicitly because DSH's pnpm profile blocks
GitHub packages as transitive dependencies.
Install the published packages with:
pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-workbench@latest relay-dsh-plugin-terminal@latest
For an interactive terminal through a published Codex plugin:
pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-workbench@latest relay-dsh-plugin-terminal@latest relay-dsh-plugin-codex@next
pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 web
If you already have a dsh command installed, dsh web is equivalent. Restart
DSH Web after installing, updating, or removing plugins.
In DSH Web:
Terminal.If no compatible terminal provider is installed, the panel reports that no interactive terminal provider is available.
Terminal view in the Workbench bottom panelctx.relayTerminalProviders registryThis package does not spawn shells by itself. Shell execution is supplied by a provider plugin, currently including the Relay Codex DSH plugin.
With the Codex provider, each user-operated terminal explicitly requests
sandboxPolicy: { type: "dangerFullAccess" } for its shell. This allows ordinary
SSH connections and user-file writes without changing the shared Codex server
configuration or any Agent conversation's sandbox or approval policy. It does
not grant administrator privileges or bypass operating-system permissions.
Terminal access is equivalent to command execution as the DSH host user. Expose it only through trusted, authenticated access; a session ID is not an authentication credential. Do not expose this manual-terminal capability as an Agent tool. If the provider rejects the requested policy, startup fails without retrying with a different policy.
This plugin owns only terminal presentation and provider registration. It does not depend on Claude, Relay Events, or any private Relay runtime. Codex is an optional provider plugin, not a hard dependency of Terminal.
The repository is maintained as part of Relay, an open-source project for long-running agent work, external-event delivery, reusable DSH workbench views, and multiple conversation backends.
Stop DSH Web before changing plugins, then restart it afterward.
dsh plugin --profile web why relay-dsh-plugin-terminal
dsh plugin --profile web update relay-dsh-plugin-terminal
dsh plugin --profile web remove relay-dsh-plugin-terminal
For GitHub installs, pnpm records the package source inside the DSH Profile.
Run dsh plugin --profile web why relay-dsh-plugin-terminal to inspect it.
Restart DSH Web after installing the plugin. Then inspect the Profile:
dsh plugin --profile web why relay-dsh-plugin-terminal
If the package came from GitHub main, try pinning a known commit SHA.
This means Terminal loaded correctly, but no backend plugin registered a PTY
provider. Install a compatible provider such as relay-dsh-plugin-codex.
Create or select a DSH conversation that has a workspace directory. Terminal sessions start inside the active workspace.
Older plugin builds omitted the shell's sandbox policy and inherited the Codex server's default restrictions. Update the plugin, restart DSH Web, and create a new terminal. Existing shell processes retain the permissions they started with. If the error remains, check the host application's operating-system network permissions and any administrator-managed restrictions.
Install pnpm using the official guide: https://pnpm.io/installation.
git clone https://github.com/yangbobo2021/relay-dsh-plugin-terminal.git
cd relay-dsh-plugin-terminal
npm install
DSH_ROOT=/path/to/deepseek-harness npm run verify
npm pack
npm run verify runs type checking, tests, and the production build against an
official DSH checkout.
Report bugs and feature requests in this repository's issue tracker: https://github.com/yangbobo2021/relay-dsh-plugin-terminal/issues