在 Web 端进行开发调试时，终端功能往往受限于浏览器环境。DeepSeek Harness (DSH) 提供了插件化的扩展机制。dsh-cool-terminal 插件旨在弥补这一短板，它提供一个真实的 Shell 运行环境，并支持持久化状态。
插件简介¶
dsh-cool-terminal 是 DeepSeek Harness 的终端插件，由开发者 CoolTea 维护。它解决了 Web 端无法运行真实 Shell 命令的问题，允许用户在浏览器中执行本地命令，并保持工作目录、命令历史等状态。
核心功能¶
该插件包含以下功能：
- 按工作区分组：控制台会根据 DSH 的工作区自动分组，保持界面整洁。
- 持久化状态：Shell 会话、滚动缓冲区和当前路径在切换对话或页面刷新后会保留，无需重新进入目录。
- 独立命令历史：每个控制台维护独立的命令历史，按
↑键不会混入其他控制台的历史记录。 - 常用命令管理：支持添加、编辑、删除以及使用自定义的常用命令。
- 内联命令补全：输入命令时会出现补全提示，悬停或使用方向键选择后按
Enter填充命令行，不立即执行。 - 主题感知：渲染基于 DSH 主题变量，兼容大多数主题插件。
安装与启用¶
使用 DSH 的内置插件管理功能进行安装。
dsh add-plugin dsh-cool-terminal
本地开发与调试¶
若需自行构建或调试插件，可按以下步骤操作：
# 克隆项目
git clone https://github.com/CoolTea001/dsh-cool-terminal.git
cd dsh-cool-terminal
# 安装依赖
pnpm install
# 启动本地开发构建
pnpm run dev
# 启动 DSH 服务
dsh web
限制与注意事项¶
使用前需注意以下限制：
- 权限环境：控制台以 DSH 进程用户的真实身份运行 Shell，不是受限的沙箱环境，应视为本地受信任环境。
- 进程生命周期：控制台仅在 DSH 进程运行期间有效，DSH 重启后控制台状态会丢失。
- 固定大小：控制台大小在创建时固定，目前不支持调整窗口大小。
总结¶
该插件适合需要在 DSH 界面中保持真实 Shell 上下文、使用持久化历史和常用命令管理的开发者。项目源码地址：GitHub。
