dsh-plugin-terminal

English | 中文

一个 DeepSeek Harness（DSH）Web 插件：在页脚添加一个 真实 的交互式终端 —— 一个 VS Code 风格的、停靠在底部 的可折叠面板。与早期版本（用内置 help/echo/ls 命令伪造输出）不同，本插件 在 PTY 中运行真正的 shell，并把原始终端字节流传输到浏览器。它是一个持久化的 bundle 插件（Host 半边 + 浏览器半边），每次启动都会自动加载。

演示

功能

• 真实终端 —— 在 PTY 中运行真正的交互式 shell（Windows 默认 PowerShell， 其他平台默认 $SHELL//bin/bash），底层使用 DSH 的 subprocess.spawnTerminal 原语（node-pty）。
• 完整终端渲染 —— xterm.js 渲染 ANSI 颜色、光标移动、全屏应用 （vim、htop、top …）以及 256 色输出。
• VS Code 风格页脚面板 —— 可折叠的底部面板，带标题栏、顶部拖拽调整大小、 重启按钮与折叠开关。
• 键盘快捷键 —— `Ctrl+ 切换面板（VS Code 默认快捷键）。
• 实时调整大小 —— 调整面板时 PTY 会重新换行。
• Terminal 配置卡片 —— 在 设置 → 插件 中实时配置主题、字号、面板高度、 不透明度、启动折叠、shell 与工作目录。
• 优雅降级 —— 当 xterm.js 无法加载时（离线），纯文本流式视图仍能使用真实 shell。

文件

文件	用途
lib/index.js	Host 半边 —— 创建 PTY 并通过 /api/terminal WebSocket 桥接。
lib/client.js	浏览器半边 —— 页脚面板与配置卡片。
cordis.patch.yml	插入插件行的组合补丁。
package.json	包元数据（dsh.bundle + dsh.client 清单）。

安装

dsh plugin --profile web add github:mervyn-teo/dsh-plugin-terminal

然后重启 dsh web —— Host bundle 在启动时加载。

默认配置在 cordis.patch.yml。可在那里（或 profile 自带的 cordis.patch.yml） 修改后重启，或在运行时通过配置卡片调整。Host 半边提供两个同源路由供浏览器半边 使用：GET|POST /api/terminal/config 与 /api/terminal WebSocket 升级。

依赖

• DSH 需要挂载 subprocess 与 webServer 服务。
• 终端首次渲染 xterm.js 时需要能访问 jsDelivr（纯文本降级视图无需网络）。

设置

设置 → 插件 → Terminal 提供：

设置	说明
主题	dark 或 light 终端主题（实时生效）。
字号	终端字号（像素，实时生效）。
最大高度	面板最大高度（像素）。
不透明度	终端背景不透明度 0–100%（100 = 完全不透明）。
启动折叠	面板是否在启动时折叠。
Shell	新会话使用的 shell 可执行文件。
工作目录	新会话的默认目录（留空 = 主目录）。

Shell 与工作目录在下次打开终端时生效；主题、不透明度、字号与最大高度立即生效。

说明与限制

• 终端从 jsDelivr CDN 加载 xterm.js；首次展开需要网络访问。纯文本降级视图离线 仍可用。
• 会话是进程本地的，重启 DSH 后不会恢复。
• 与 Web GUI 的其他部分一样，WebSocket 路由仅绑定回环地址。
• Windows —— Windows 上默认 shell 为 powershell.exe（将 shell 设为 cmd.exe、shellArgs 设为 [] 可切换为命令提示符）。需要 DSH 主机提供为 Windows 构建的 node-pty（conpty/winpty）。

许可证

MIT