dsh-terminal-panel
让命令、输出与当前工作区待在同一个界面。
实时输出 · 多标签 · Tab 补全 · 命令历史 · Ctrl+C 中断
终端面板：多标签、实时输出与命令补全
Command panel for DeepSeek Harness: streaming output, tabs and completion without leaving the workspace.
中文
前置要求
- dsh
>= 0.1.1-rc.2
pnpm 可用（dsh plugin 底层转发给 pnpm）
安装
最省事的办法是用插件市场：打开「发现」，搜 terminal，点「安装」。
命令行：
dsh plugin --profile <name> add @easytz/dsh-terminal-panel
<name> 是必填的 profile 名，不能省略——桌面版通常是 web，TUI 是 tui；不确定就看 $DSH_HOME/profiles/ 下的目录名。想钉死版本就写 @easytz/dsh-terminal-panel@0.2.7。
插件自带 dsh.bundle 层（cordis.patch.yml），dsh plugin add 会同时完成「装进去」和「注册激活」，不需要手写 patch。
装完重启 dsh，侧边栏底部出现终端按钮。
用法
点侧边栏底部的终端按钮打开面板。
敲命令. 最底下那行输入框，Enter 执行，输出实时往上刷（不是跑完才一次性给）。每条命令跑完会显示退出码，非零一眼看得出来。
当前目录. 命令默认在当前工作区根目录执行，面板底部状态栏显示用的是哪个 shell、当前在哪个目录。注意每条命令是独立进程，cd 不会跨命令保留——面板自己跟踪并展示当前目录，所以你 cd 之后下一条命令仍然在新目录里跑。
补全与历史. Tab 补全文件路径和 PATH 上的命令名，↑ / ↓ 翻命令历史。
多标签页. 标题栏的 + 开一个新标签（最多 8 个），标签上的 × 关掉。一个标签跑着长任务时可以开新标签干别的。
中断. Ctrl+C 中断正在跑的命令。命令跑着的时候输入框会提示「命令运行中 · Ctrl+C 终止」。
最大化. 标题栏的最大化按钮把面板铺满，再点一次还原。
跑不了的东西怎么办. 需要接管整个屏幕的交互式程序（vim、sudo 输密码、npm init 的问答）在这里跑不了，见下面「已知限制」。标题栏最左边那个按钮是在系统终端中打开，一键在系统自带终端里打开同一个目录，接着干。
卸载
dsh plugin --profile <name> remove @easytz/dsh-terminal-panel
<name> 与安装时一致。remove 会把包从 profile 依赖里移除，dsh 随后会把它从激活清单（dsh.profile.bundles）里撤掉。重启 dsh 后按钮消失。
如果你按旧版 README 手动往 $DSH_HOME/profiles/<name>/cordis.patch.yml 或 $DSH_HOME/cordis.patch.yml 里加过 - insert: 条目，卸载时把那段 YAML 一起删掉。
已知限制
- 它不是 PTY，是命令控制台。跑不了全屏交互程序：
vim、sudo 密码输入、npm init 问答这类需要终端接管屏幕的程序都无法使用——面板里明说了这一点，并提供「在系统终端中打开」作为替代。要做满血终端，正确路线是宿主侧接 node-pty，而不是往这个面板里塞。
- 每条命令是独立进程，
cd 不会跨命令保留（面板自己跟踪并展示当前目录）。
- Windows 上命令通过
pwsh -NoLogo -NoProfile -NonInteractive 执行；macOS 上是 bash -c（不读 rc 文件）——这是 dsh 内核按平台选择的执行器，不是插件的行为。
平台支持
已在 Windows 与 macOS 上验证；macOS 包含 GUI 启动场景的登录 shell PATH 探测兜底，Linux 使用同一套 POSIX 路径。
English
A third-party plugin for DeepSeek Harness (dsh) that adds a command console to the sidebar.
Requirements
- dsh
>= 0.1.1-rc.2
pnpm available (dsh plugin shells out to pnpm)
Install
Easiest path is the plugin market: open Discover, search terminal, hit Install.
From the command line:
dsh plugin --profile <name> add @easytz/dsh-terminal-panel
<name> is required — your dsh profile (usually web for the desktop/web UI, tui for the TUI). The package ships its own dsh.bundle layer, so dsh plugin add both installs and activates it.
Restart dsh — a terminal button appears at the bottom of the sidebar.
Usage
Click the terminal button to open the panel.
- Run a command. Type in the input at the bottom, press Enter. Output streams in live; the exit code is shown when the command finishes.
- Working directory. Commands run in the current workspace. Each command is its own process, so
cd doesn't persist at the process level — the panel tracks the current directory for you and shows it in the status bar.
- Completion and history.
Tab completes file paths and command names on PATH; ↑/↓ walk the history.
- Tabs. + in the header opens another tab (up to 8), useful while a long task runs in the first one.
- Interrupt.
Ctrl+C stops the running command.
- Maximize. The header button expands the panel to fill the window; click again to restore.
- Open in system terminal. The leftmost header button opens your OS terminal at the same directory — use it for anything interactive (see below).
Uninstall
dsh plugin --profile <name> remove @easytz/dsh-terminal-panel
Limitations
- Full-screen interactive programs (, password prompts, questionnaires) cannot run here. The panel says so and offers "open in system terminal" instead.
许可证 / License
MIT
