dsh-plugin-terminal

Plugin Terminal

DeepSeek Harness Web GUI 的底部终端面板插件（由 node-pty 驱动，在 Windows 上通过 ConPTY 工作）

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add dsh-plugin-terminal@0.2.0

兼容性与来源证明

Plugin Terminal 以 dsh-plugin-terminal 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: web
发布来源: npm
Registry 更新时间: 2026/9/20

版本

0.2.0stable

2026/8/19

0.1.13stable

2026/8/17

0.1.12stable

2026/8/17

查看其余 6 个版本收起版本

0.1.11stable

2026/8/15

0.1.9stable

2026/8/14

0.1.3stable

2026/8/14

0.1.2stable

2026/8/14

0.1.1stable

2026/8/14

0.1.0stable

2026/8/14

README

dsh-plugin-terminal

Bottom terminal panel for the DeepSeek Harness (DSH) Web GUI — an interactive multi-tab shell pinned to the bottom of the page (ConPTY on Windows, openpty on Linux/macOS).

中文 · MIT

Install

dsh plugin --profile web add dsh-plugin-terminal && dsh web

Note: this is a DSH (DeepSeek Harness) plugin — do not use plain npm i dsh-plugin-terminal; it must be installed through dsh plugin to activate.

Screenshots

Collapsed	Expanded	Multi-tab
collapsed	panel	multitab

Features

Bottom panel pinned to the viewport, aligned with the conversation column; the input box always stays above the terminal
Configurable shortcut toggles (default Ctrl+``, e.g. Ctrl+J`); drag the top grip to resize (120px–78% viewport, remembered)
Multi-tab: + new, ✕ close, ⟳ restart; processes keep running on tab switch; live sessions restore after refresh or workspace switch
Every terminal remembers its working directory: new tabs start in the current DSH workspace; after a dsh web restart, ⟳ brings the process back in its original directory instead of the server launch directory
Terminals survive dsh web restarts: session metadata + scrollback are persisted live to $DSH_HOME/plugin-data/terminal/; after a restart they come back as "exited" history tabs (full screen replay, one-click restart of the process); tabs you closed stay closed
xterm.js 6: colors, blinking cursor, alternate screen, Unicode v11 (CJK width tables), 10000-line scrollback
WebSocket duplex channel to the PTY; dark terminal surface in both light and dark themes
Copy/paste: select with the mouse and release to copy, right-click to paste; Ctrl+V pastes, Ctrl+Shift+C / Ctrl+Shift+V copy/paste when the clipboard API is available
- ⚠️ When the GUI is opened over remote http (not https / not localhost) browsers disable navigator.clipboard (insecure context) - the plugin falls back to execCommand copy and lets the browser's native context-menu Paste through, so both still work

Configuration

Plugin behavior lives in the DSH settings document ($DSH_HOME/settings.yaml, section terminal), editable from the GUI at Settings → Plugins. Changes apply to sessions created afterwards — no restart needed; tabs that already exist keep the command they started with.

Field	Default	Meaning
`toggleShortcut`	`ctrl+``	Keyboard shortcut toggling the bottom panel. Format: `[ctrl
`shellCommand`	(empty — auto-detect)	Command line used to start new terminal sessions. Empty means the platform default (pwsh/powershell/cmd on Windows, `$SHELL` on POSIX).

Example — launch cmder on Windows and bind the panel to Ctrl+J:

terminal:
  toggleShortcut: ctrl+j
  shellCommand: cmd.exe /k "C:\cmder\vendor\init.bat"

Notes:

shellCommand is used verbatim (no flags are injected): the command line is split on spaces with double quotes honored, so quoted paths work.
If the shortcut is a key the terminal also consumes (Ctrl+J is the shell's line feed), a press while a terminal pane has focus goes to the shell instead of toggling the panel.
Operator override: the environment variables DSH_PLUGIN_TERMINAL_TOGGLE_SHORTCUT and DSH_PLUGIN_TERMINAL_SHELL_COMMAND take precedence over the settings document (and are the only way to configure headless compositions without the settings service).

Running codex / claude code in the panel

These AI coding CLIs are full-screen TUIs (ANSI escapes + alternate screen + truecolor) and demand a lot from the terminal link. The plugin is tuned for them:

Child env gets TERM=xterm-256color and COLORTERM=truecolor (when unset), plus LANG/LC_ALL=en_US.UTF-8 and PYTHONIOENCODING=utf-8 on non-Windows, preventing 256-color fallback and CJK mojibake
xterm.js 6 answers OSC 10/11/12 queries out of the box (Codex theme detection via background-color query just works)
unicodeVersion "11" keeps mixed CN/EN output aligned; drawBoldTextInBrightColors: false keeps true colors on bold text; CJK fallbacks in the font stack; 10000-line scrollback (500k-char server ring buffer)

If rendering still misbehaves:

Claude Code: run /tui fullscreen in the session (or CLAUDE_CODE_NO_FLICKER=1 claude) to switch to the flicker-free fullscreen renderer; /tui default reverts
Inside tmux: make sure TERM=tmux-256color and tmux >= 3.4, add set -ga terminal-overrides ',xterm-256color:RGB' if needed
Windows mojibake: use Windows Terminal, chcp 65001, enable the "Beta: Use Unicode UTF-8" system option; fall back to WSL if it persists
Update the CLI: most rendering bugs are regressions already fixed in newer versions

License

MIT

README

dsh-plugin-terminal

Bottom terminal panel for the DeepSeek Harness (DSH) Web GUI — an interactive multi-tab shell pinned to the bottom of the page (ConPTY on Windows, openpty on Linux/macOS).

中文 · MIT

Install

dsh plugin --profile web add dsh-plugin-terminal && dsh web

Note: this is a DSH (DeepSeek Harness) plugin — do not use plain npm i dsh-plugin-terminal; it must be installed through dsh plugin to activate.

Screenshots

Collapsed	Expanded	Multi-tab
collapsed	panel	multitab

Features

Bottom panel pinned to the viewport, aligned with the conversation column; the input box always stays above the terminal
Configurable shortcut toggles (default Ctrl+``, e.g. Ctrl+J`); drag the top grip to resize (120px–78% viewport, remembered)
Multi-tab: + new, ✕ close, ⟳ restart; processes keep running on tab switch; live sessions restore after refresh or workspace switch
Every terminal remembers its working directory: new tabs start in the current DSH workspace; after a dsh web restart, ⟳ brings the process back in its original directory instead of the server launch directory
Terminals survive dsh web restarts: session metadata + scrollback are persisted live to $DSH_HOME/plugin-data/terminal/; after a restart they come back as "exited" history tabs (full screen replay, one-click restart of the process); tabs you closed stay closed
xterm.js 6: colors, blinking cursor, alternate screen, Unicode v11 (CJK width tables), 10000-line scrollback
WebSocket duplex channel to the PTY; dark terminal surface in both light and dark themes
Copy/paste: select with the mouse and release to copy, right-click to paste; Ctrl+V pastes, Ctrl+Shift+C / Ctrl+Shift+V copy/paste when the clipboard API is available
- ⚠️ When the GUI is opened over remote http (not https / not localhost) browsers disable navigator.clipboard (insecure context) - the plugin falls back to execCommand copy and lets the browser's native context-menu Paste through, so both still work

Configuration

Field	Default	Meaning
`toggleShortcut`	`ctrl+``	Keyboard shortcut toggling the bottom panel. Format: `[ctrl
`shellCommand`	(empty — auto-detect)	Command line used to start new terminal sessions. Empty means the platform default (pwsh/powershell/cmd on Windows, `$SHELL` on POSIX).

Example — launch cmder on Windows and bind the panel to Ctrl+J:

terminal:
  toggleShortcut: ctrl+j
  shellCommand: cmd.exe /k "C:\cmder\vendor\init.bat"

Notes:

shellCommand is used verbatim (no flags are injected): the command line is split on spaces with double quotes honored, so quoted paths work.
If the shortcut is a key the terminal also consumes (Ctrl+J is the shell's line feed), a press while a terminal pane has focus goes to the shell instead of toggling the panel.
Operator override: the environment variables DSH_PLUGIN_TERMINAL_TOGGLE_SHORTCUT and DSH_PLUGIN_TERMINAL_SHELL_COMMAND take precedence over the settings document (and are the only way to configure headless compositions without the settings service).

Running codex / claude code in the panel

These AI coding CLIs are full-screen TUIs (ANSI escapes + alternate screen + truecolor) and demand a lot from the terminal link. The plugin is tuned for them:

Child env gets TERM=xterm-256color and COLORTERM=truecolor (when unset), plus LANG/LC_ALL=en_US.UTF-8 and PYTHONIOENCODING=utf-8 on non-Windows, preventing 256-color fallback and CJK mojibake
xterm.js 6 answers OSC 10/11/12 queries out of the box (Codex theme detection via background-color query just works)
unicodeVersion "11" keeps mixed CN/EN output aligned; drawBoldTextInBrightColors: false keeps true colors on bold text; CJK fallbacks in the font stack; 10000-line scrollback (500k-char server ring buffer)

If rendering still misbehaves:

Claude Code: run /tui fullscreen in the session (or CLAUDE_CODE_NO_FLICKER=1 claude) to switch to the flicker-free fullscreen renderer; /tui default reverts
Inside tmux: make sure TERM=tmux-256color and tmux >= 3.4, add set -ga terminal-overrides ',xterm-256color:RGB' if needed
Windows mojibake: use Windows Terminal, chcp 65001, enable the "Beta: Use Unicode UTF-8" system option; fall back to WSL if it persists
Update the CLI: most rendering bugs are regressions already fixed in newer versions

License

MIT

Plugin Terminal

兼容性与来源证明

版本

相关插件

Plugin Terminal

README

dsh-plugin-terminal

Install

Screenshots

Features

Configuration

Running codex / claude code in the panel

License

兼容性与来源证明

版本

相关插件

相关插件

README

dsh-plugin-terminal

Install

Screenshots

Features

Configuration

Running codex / claude code in the panel

License

相关插件