DeepSeek Harness 终端 UI 插件：dsh-terminal

DeepSeek Harness（DSH）采用「一切皆插件」的架构。在终端环境中构建交互式界面需要插件机制来挂载 UI 行。dsh-terminal 是一个为 DSH 提供终端 UI 的插件。它通过官方 profile 插件机制挂载在 dsh-base 之上，不包含宿主运行时。

核心功能¶

该插件仅提供 TUI 插件行（tui-startup/tui-runner）和元数据。它使用 adapter 边界解耦 UI 与 driver，并将所有上游依赖声明为 peerDependencies。它还实现了上游版本契约校验（pnpm run verify:contract）和会话持久化（存储在 $DSH_HOME/sessions）。它提供斜杠命令补全菜单（例如 /permission、/effort）。

安装与前置条件¶

前置条件包括：官方 dsh CLI、pnpm 10+、TTY 以及 DEEPSEEK_API_KEY（环境变量或 $DSH_HOME/.credentials.yaml）。

安装命令如下：

dsh plugin --profile dsh-terminal add dsh-terminal

注意：如果版本号不变，pnpm 会跳过 add（Already up to date）。在重新安装之前，必须先运行 remove 再 add。

使用方式¶

• 启动新会话：

    dsh --profile dsh-terminal

• 恢复指定会话：

    dsh --profile dsh-terminal --resume <id>

• 恢复最近创建的会话：

    dsh --profile dsh-terminal -c

• 直接运行：

    node bin/dsh-terminal.js

会话持久化存储在 $DSH_HOME/sessions（默认为 ~/.dsh/sessions）。输入 / 打开斜杠命令补全菜单（例如 /permission、/effort）。使用 ↑/↓ 选择，Tab 或 Enter 补全并执行，Esc 关闭菜单但不打断会话。

生态与维护¶

该插件支持 dev 与 release 双变体打包，并包含源码级边界检查（pnpm run verify:boundary）。查看 GitHub 仓库 或 插件目录 获取更多信息。