dsh-web-terminal
用于 DeepSeek Harness Web GUI 的本地终端插件：基于真实 node-pty shell 的多标签 xterm.js 面板，通过主机进程上的 WebSocket 路由进行流式传输。支持热插拔——通过 web profile bundle list 挂载，无需修改 dsh 源代码。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-web-terminal@0.1.1Web Terminal 以 dsh-web-terminal 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A local terminal plugin for the DeepSeek Harness web GUI. Adds a sidebar Terminal entry with a multi-tab xterm.js panel; every tab runs a real PTY shell on the host process via node-pty, streamed over a WebSocket route.
Features:
vim, top, htop), Ctrl-C, resize all work| Half | Entry | Responsibility |
|---|---|---|
| host (node) | lib/index.js (src/index.ts) | node-pty shell sessions, /api/dsh-terminal/info route, /api/dsh-terminal/terminal WebSocket upgrade, system-prompt announcement, settings namespace (shell/cwd) |
| client (browser) | lib/client.js (src/client/index.ts) | sidebar Terminal entry (DOM injection, self-healing), multi-tab terminal panel (React + xterm.js) |
Wire protocol (src/protocol.ts):
{type:"input",data}, {type:"resize",cols,rows}{type:"ready",shell}, {type:"output",data}, {type:"exit",code,error?}Security: all routes carry a loopback-only trust fence (same-origin + 127.0.0.1/localhost checks). The terminal executes commands with the host user's privileges — equivalent to direct shell access.
Option A — bundle list (recommended):
# 1) one-time: allow node-pty build scripts in ~/.dsh/profiles/web/pnpm-workspace.yaml
# allowBuilds:
# esbuild: true
# node-pty: true
# 2) add the dependency (adjust the path to your checkout)
cd ~/.dsh/profiles/web
pnpm add dsh-web-terminal@link:/path/to/dsh-web-terminal
# 3) append "dsh-web-terminal" to dsh.profile.bundles in package.json
# (the bundle's cordis.patch.yml inserts the id=terminal plugin row)
# 4) restart dsh web
Option B — manual patch row in ~/.dsh/profiles/web/cordis.patch.yml (with the package installed in the profile):
- insert:
- id: terminal
name: 'dsh-web-terminal'
- id: terminal
config:
enabled: true
announceToAgent: true
shell: /bin/zsh # default: $SHELL
cwd: /path/to/work # default: host process cwd (workspace root)
pnpm install # pnpm-workspace.yaml must allow esbuild / node-pty build scripts
pnpm run typecheck # tsc --noEmit
pnpm run build # esbuild: lib/index.js (host) + lib/client.js (ModuleLoader wrapper)
pnpm test # client bundle syntax + jsdom ModuleLoader simulation
node scripts/smoke.mjs # host WebSocket link smoke test
node scripts/browser-diag.mjs # Playwright: open the real GUI, click Terminal, type a command
The build script embeds node_modules/@xterm/xterm/css/xterm.css into src/client/xterm-css.ts (generated) because the ModuleLoader environment has no CSS loader.
@deepseek-ai/*) may stay external. @xterm/* must be bundled — otherwise the ModuleLoader reports require("@xterm/xterm") missed the module table (dsh-ssh bundles xterm too).[data-dsh-terminal-view] is an absolute container; its direct child .dshTermView needs height: 100% or the inner .dshTermPanel { height: 100% } resolves against an auto-height parent and the whole flex chain collapses (terminal squashed to a 2px strip).prebuilds/<platform>/spawn-helper may lose its executable bit (posix_spawnp failed); run pnpm run fix:spawn-helper (also runs automatically on pnpm install via postinstall). Note node-pty spawn is blocked inside the dsh file sandbox — run smoke tests against a real dsh process.curl http://127.0.0.1:3080/api/dsh-terminal/info
# {"shell":"/bin/zsh","platform":"darwin",...}
# browser: refresh the GUI → sidebar Terminal → new tab → type commands
MIT