DSH Plugin HubDSH 插件市场
mervyn-teo/dsh-plugin-terminal 预览 preview

mervyn-teo/dsh-plugin-terminal

Plugin插件 Native原生 ⭐ 2 MIT Dev Workflow开发与代码工作流

DeepSeek Harness Web 插件：一个真正的 PTY 终端，位于 VS Code 风格的可折叠底部面板中

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

A DSH plugin that adds a real interactive PTY terminal panel docked to the Web footer. It uses node-pty to spawn the system shell, streams output over a WebSocket, and renders it with xterm.js, supporting ANSI colors, 256-color output, full-screen apps, live resize, and a Ctrl+` shortcut, with theme, font, height, opacity, shell, and working directory configurable in settings. Use it when you need direct shell access inside DSH; note that xterm.js loads from a CDN on first use, though a plain streaming fallback works offline.

DSH 插件，在 Web 界面底部提供一个真实的 PTY 交互式终端面板。基于 node-pty 启动系统 shell，通过 WebSocket 推送至 xterm.js 渲染，支持 ANSI 配色、256 色、全屏程序与 Ctrl+` 快捷键，并可在设置中调整主题、字体、高度、透明度、shell 与工作目录。适用于需在 DSH 内直接执行命令的场景；首次渲染需联网加载 xterm.js，离线时回退至纯文本流。

View on GitHub在 GitHub 查看

Recommended强烈推荐 Send to your DSH发给你的 DSH 安装 
请帮我了解并安装插件：【dsh-plugin-terminal】【https://github.com/mervyn-teo/dsh-plugin-terminal】

Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装 

dsh plugin --profile web add github:mervyn-teo/dsh-plugin-terminal

把 mervyn-teo/dsh-plugin-terminal 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

3.9 KB · 缓存于 2026-08-23 03:42:19 · 3.9 KB

dsh-plugin-terminal

dsh-plugin-terminal banner — a real PTY terminal in the DeepSeek Harness footer

English | 中文

A DeepSeek Harness (DSH) Web plugin that adds a real interactive terminal — a VS Code-style collapsible panel docked to the footer. This plugin runs an actual shell in a PTY and streams the raw terminal bytes to the browser. It is a persistent bundle plugin (a host half plus a browser half) that loads on every boot.

Demo

dsh-plugin-terminal demo — a real terminal in the footer

What it does

  • Actual terminal — a real interactive shell (PowerShell on Windows, $SHELL//bin/bash elsewhere, by default) running in a PTY via the harness's subprocess.spawnTerminal primitive (node-pty).
  • Full terminal rendering — xterm.js renders ANSI colors, cursor movement, full-screen apps (vim, htop, top, …), and 256-color output.
  • VS Code-style footer panel — a collapsible bottom panel with a header, drag-to-resize top edge, restart button, and collapse toggle.
  • Keyboard shortcut — `Ctrl+ toggles the panel (the VS Code default).
  • Live resize — the PTY reflows when you resize the panel.
  • A Terminal settings card under Settings → Plugins configures theme, font size, panel height, opacity, start-collapsed, shell, and working directory at runtime.
  • Graceful fallback — if xterm.js cannot load (offline), a plain streaming view still exposes the real shell.

Files

File Purpose
lib/index.js Host half — spawns the PTY and bridges it over the /api/terminal WebSocket.
lib/client.js Browser half — the footer panel and the settings card.
cordis.patch.yml Composition patch that inserts the plugin row.
package.json Package metadata (dsh.bundle + dsh.client manifest).

Install

dsh plugin --profile web add github:mervyn-teo/dsh-plugin-terminal

Then restart dsh web — host bundles load at boot.

Defaults live in cordis.patch.yml. Change them there (or in the profile's own cordis.patch.yml) and restart, or adjust them at runtime from the settings card. The host half serves two same-origin routes the browser half uses: GET|POST /api/terminal/config and the /api/terminal WebSocket upgrade.

Requirements

  • DSH with the subprocess and webServer services mounted.
  • Network access to jsDelivr the first time the terminal renders xterm.js (the plain fallback works without it).

Settings

Settings → Plugins → Terminal exposes:

Setting Description
Theme dark or light terminal theme (applied live).
Font size Terminal font size in pixels (applied live).
Max height Maximum panel height in pixels.
Opacity Terminal background opacity 0–100% (100 = fully opaque).
Start collapsed Whether the panel starts collapsed.
Shell Shell executable for new sessions.
Working directory Default directory for new sessions (empty = home directory).

Shell and working directory apply the next time you open the terminal; theme, opacity, font size, and max height apply immediately.

Notes and limitations

  • The terminal renders xterm.js from the jsDelivr CDN; the first expansion requires network access. The plain fallback still works offline.
  • A session is process-local and does not survive a harness restart.
  • The WebSocket route is loopback-bound like the rest of the Web GUI.
  • Windows — on Windows the default shell is powershell.exe (set shell to cmd.exe for Command Prompt, with shellArgs: []). It needs a Windows-built node-pty (conpty/winpty) from the DSH host.

License

MIT

渲染基于仓库 mervyn-teo/dsh-plugin-terminal 的 README.md。 在 GitHub 查看原文 →

Related相关推荐

← 上一个 Prev dsh-workbench-layout 下一个 Next dsh-plugin-kit →