终端面板EasyTZ/dsh-terminal-panel

dsh-terminal-panel
让命令、输出与当前工作区待在同一个界面。
实时输出 · 多标签 · Tab 补全 · 命令历史 · Ctrl+C 中断

面向 DeepSeek Harness 的命令面板：无需离开工作区即可获得流式输出、多标签与补全。

中文

前置要求

- dsh >= 0.1.1-rc.2
- pnpm 可用（dsh plugin 底层转发给 pnpm）

安装

最省事的办法是用插件市场：打开「发现」，搜 terminal，点「安装」。

命令行：

dsh plugin --profile  add @easytz/dsh-terminal-panel

是必填的 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  remove @easytz/dsh-terminal-panel

与安装时一致。remove 会把包从 profile 依赖里移除，dsh 随后会把它从激活清单（dsh.profile.bundles）里撤掉。重启 dsh 后按钮消失。

如果你按旧版 README 手动往 $DSH_HOME/profiles//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 可用（dsh plugin 会调用 pnpm）

安装

最简单的方式是通过插件市场：打开 Discover，搜索 terminal，点击 Install。

从命令行安装：

dsh plugin --profile  add @easytz/dsh-terminal-panel

是必填的——你的 dsh 配置文件（桌面/网页 UI 通常是 web，TUI 则是 tui）。该包自带 dsh.bundle 层，因此 dsh plugin add 会同时安装并激活它。

重启 dsh——侧边栏底部会出现一个终端按钮。

使用方法

点击终端按钮打开面板。

- 运行命令。 在底部的输入框中输入，按 Enter。输出会实时流式显示；命令结束时显示退出码。
- 工作目录。 命令在当前工作区中运行。每条命令都是独立的进程，因此 cd 不会在进程层面保留——面板会为你跟踪当前目录，并在状态栏中显示。
- 补全与历史记录。 Tab 补全文件路径和 PATH 中的命令名；↑/↓ 浏览历史记录。
- 标签页。 标题栏中的 + 可打开另一个标签页（最多 8 个），当第一个标签页中有长时间运行的任务时很有用。
- 中断。 Ctrl+C 停止正在运行的命令。
- 最大化。 标题栏按钮可将面板展开以填满窗口；再次点击可恢复。
- 在系统终端中打开。 最左侧的标题栏按钮会在同一目录下打开你的操作系统终端——用于任何交互式操作（见下文）。

卸载

dsh plugin --profile  remove @easytz/dsh-terminal-panel

限制

- 这是命令控制台，不是 PTY。 全屏交互式程序（vim、sudo 密码提示、npm init 问卷）无法在此运行。面板会提示这一点，并提供“在系统终端中打开”的选项。
- 每条命令都是独立的进程，因此 cd 不会在进程层面保留（面板会自行跟踪并显示目录）。
- 在 Windows 上，命令通过 pwsh -NoLogo -NoProfile -NonInteractive 运行；在 macOS 上通过 bash -c 运行（不加载 rc 文件）。这是 dsh 内核的按平台执行器，而非本插件。
- 仅在 Windows 上验证过；macOS 有登录 shell 的 PATH 回退机制，但未经测试。欢迎反馈。

许可证 / License

MIT