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项目介绍

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,离线时回退至纯文本流。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

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

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.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

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