dsh-tui 是什么?DeepSeek Harness 终端界面 DSH plugin 解析
dsh-tui(dshtui)是 DeepSeek Harness 的 Ink 终端界面 DSH plugin:它以 opencode 风格接管整个终端,提供流式对话、可折叠工具卡片与对话框(来源)。 这篇只解析这一个插件,按三个方向讲:它提供什么、怎么装与启动、以及什么时候它比 Web UI 更合适。
概览:一句话定位 dsh-tui 这个 DSH plugin
它给 DeepSeek Harness 加了「第三种界面形态」——不开浏览器的终端界面。 前面已有网页版与桌面端两种形态,dsh-tui 把交互搬回命令行,全程在终端里渲染。
| 维度 | 说明 |
|---|---|
| 解决的问题 | 纯终端 / SSH 环境下也想有完整交互界面 |
| 核心形态 | Ink 渲染的 TUI,接管整个终端 |
| 交互 | 流式对话、可折叠工具卡片、对话框 |
| 启停方式 | 先全局装,再用 dshtui 启动器拉起 |
这个 DSH plugin 提供什么:接管终端的 Ink 界面,与 Web UI 的取舍
核心特征是「接管整个终端」——一旦启动,整个终端窗口就是它的界面。 四个能力:
- Ink 终端界面 — 基于 Ink 构建,风格参考 opencode。预期:终端里出现结构化界面,而不是一行行裸日志。
- 流式对话与可折叠工具卡片 — 回复边生成边显示,工具调用收在可折叠卡片里。预期:长输出不刷屏,需要时再展开。
- 对话框与交互组件 — 提供对话框等交互元素,不必纯靠命令参数操作。预期:设置、确认这类动作在终端里也能点选。
- 界面贡献注册 API — 开放覆盖全部可见界面的注册接口。预期:其他插件或自定义代码能扩展它的界面。
与 Web UI 的取舍很清楚:Web UI 的能力面更全、可视化更强,代价是要起本地 Web 服务、浏览器访问,远程时还要处理认证与端口;dsh-tui 的优势是「终端在哪它就在哪」。 三者形态的完整对比见《网页版和桌面端怎么选》。
怎么装与启动这个 DSH plugin:全局安装加 dshtui 启动器
因为要接管整个终端,它的安装不是「市场里点一下」那么轻,按 README 两步走:
- 全局安装:
npm install -g @xp266/dshtui
- 挂载进 profile 并启动:
dsh plugin --profile add @xp266/dshtui
dshtui
预期:终端被 TUI 接管,出现对话界面。
若要从源码装,可用 dsh plugin --profile web add github:xp266/dsh-tui。界面类插件平时都在插件市场里按分类找,入口是 DSH Plugin Hub,但 dsh-tui 因需先全局安装再运行启动器,网页端难以一键代执行,所以以命令行安装为主。

它适合哪些场景:DeepSeek Harness 的纯终端与 SSH 环境
判断标准就一句:你日常在不在终端里。
- 纯终端工作流 — 习惯键盘操作、不想为一次对话开浏览器。预期:在一个窗口里完成全部交互。
- SSH 远程 — 远程服务器上只有终端可用。预期:不用端口转发、不用处理浏览器认证地址,直接连上就能用。
- 低环境依赖 — 不想额外起 Web 服务与占用端口。预期:只跑一个终端进程。
- 什么时候仍选 Web UI — 需要更强可视化、多窗口、或团队成员在浏览器里协作时。预期:界面能力优先,终端形态退居其次。
使用 dsh-tui 这个 DSH plugin 的注意事项
- 不是官方内置:dsh-tui 是第三方 DSH plugin,成熟度与活跃度以仓库状态为准。
- 装法特殊:需先全局安装再跑启动器,别只在市场里点安装就以为完事。
- 键位以 README 为准:TUI 的操作随版本变化,装后先跑一轮熟悉,别照搬旧教程。
- 与 profile 绑定:它以 bundle 插件形式挂载进 profile,切换 profile 时要确认是否已装。
- 多形态可并存:它与 Web UI、桌面端互不冲突,可以按场景切换使用。
常见问题
dsh-tui(dshtui)是 DeepSeek Harness 的 Ink 终端界面 DSH plugin:它以 opencode 风格接管整个终端,把对话、工具卡片与对话框都放在命令行里渲染。 Web UI 在浏览器里跑,dsh-tui 则完全不依赖浏览器,适合纯终端与 SSH 环境。
它是接管整个终端的 TUI,需要先全局安装再用启动器拉起:npm install -g @xp266/dshtui 后用 dshtui 启动,同时按 README 用 dsh plugin --profile add @xp266/dshtui 把它挂载进 profile。 因为要接管终端,网页端难以一键代执行,装法以命令行为主。
核心是流式对话与可折叠的工具卡片,另有对话框与交互组件;它还把界面贡献注册 API 开放出来,允许覆盖全部可见界面。 具体键位以插件 README 为准,随版本会调整,建议装后在终端里先跑一轮熟悉操作。
纯终端、SSH 远程、或不想开浏览器的时候。 dsh-tui 全程在终端内渲染,SSH 里只要终端可用就能操作;Web UI 需要启动本地 Web 服务并浏览器访问,远程时还要处理认证地址与端口。要不要换用,取决于你日常在不在终端里。
不是,它是社区的第三方 DSH plugin,需要自己安装。 DeepSeek Harness 本体提供命令行与 Web UI,dsh-tui 属于第三方补充的终端界面形态;它的成熟度与活跃度以插件页与仓库状态为准,装前先看兼容标注。
相关术语
- dsh-tui
- dsh-tui(dshtui,npm 包 @xp266/dshtui)是 DeepSeek Harness 的 Ink 终端界面插件,以 opencode 风格接管整个终端,提供流式对话、可折叠工具卡片与对话框。— https://github.com/xp266/dsh-tui
- TUI(Terminal User Interface)
- TUI 指在终端里渲染的文字界面,用字符与键位完成交互,不依赖浏览器;dsh-tui 就是 DeepSeek Harness 的 TUI 形态插件。— https://github.com/xp266/dsh-tui
- Ink
- Ink 是用 React 编写命令行界面的库,dsh-tui 基于它构建终端界面,因此可以像组件一样组织对话框、卡片等元素。— https://github.com/xp266/dsh-tui
- bundle 插件
- bundle 插件指带 dsh.bundle 声明、被 dsh plugin add 安装后挂载进 profile 的插件形态;dsh-tui 以这种形式挂载到 dsh profile,随启动生效。— https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/README.md
来源
- xp266/dsh-tui GitHub 仓库· xp266
- dsh CLI README· deepseek-ai
- dshplugin/dsh-plugin-hub GitHub 仓库· dshplugin