dsh-tui 是什么?DeepSeek Harness 终端界面 DSH plugin 解析

概念与架构发布于 2026-10-12作者: DeepSeek Plugin 插件市场
DeepSeek HarnessDSH plugindsh-tui终端界面TUISSH
dsh-tui(dshtui)是 DeepSeek Harness 的 Ink 终端界面插件:以 opencode 风格接管整个终端,提供流式对话、可折叠工具卡片与对话框。本文讲它提供什么、怎么装与启动,以及什么时候它比 Web UI 更合适。

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 的取舍

核心特征是「接管整个终端」——一旦启动,整个终端窗口就是它的界面。 四个能力:

  1. Ink 终端界面 — 基于 Ink 构建,风格参考 opencode。预期:终端里出现结构化界面,而不是一行行裸日志。
  2. 流式对话与可折叠工具卡片 — 回复边生成边显示,工具调用收在可折叠卡片里。预期:长输出不刷屏,需要时再展开。
  3. 对话框与交互组件 — 提供对话框等交互元素,不必纯靠命令参数操作。预期:设置、确认这类动作在终端里也能点选。
  4. 界面贡献注册 API — 开放覆盖全部可见界面的注册接口。预期:其他插件或自定义代码能扩展它的界面。

与 Web UI 的取舍很清楚:Web UI 的能力面更全、可视化更强,代价是要起本地 Web 服务、浏览器访问,远程时还要处理认证与端口;dsh-tui 的优势是「终端在哪它就在哪」。 三者形态的完整对比见《网页版和桌面端怎么选》。

怎么装与启动这个 DSH plugin:全局安装加 dshtui 启动器

因为要接管整个终端,它的安装不是「市场里点一下」那么轻,按 README 两步走:

  1. 全局安装:
bash
npm install -g @xp266/dshtui
  1. 挂载进 profile 并启动:
bash
dsh plugin --profile add @xp266/dshtui
dshtui

预期:终端被 TUI 接管,出现对话界面。

若要从源码装,可用 dsh plugin --profile web add github:xp266/dsh-tui。界面类插件平时都在插件市场里按分类找,入口是 DSH Plugin Hub,但 dsh-tui 因需先全局安装再运行启动器,网页端难以一键代执行,所以以命令行安装为主。

DSH Plugin Hub 插件市场

它适合哪些场景:DeepSeek Harness 的纯终端与 SSH 环境

判断标准就一句:你日常在不在终端里。

  1. 纯终端工作流 — 习惯键盘操作、不想为一次对话开浏览器。预期:在一个窗口里完成全部交互。
  2. SSH 远程 — 远程服务器上只有终端可用。预期:不用端口转发、不用处理浏览器认证地址,直接连上就能用。
  3. 低环境依赖 — 不想额外起 Web 服务与占用端口。预期:只跑一个终端进程。
  4. 什么时候仍选 Web UI — 需要更强可视化、多窗口、或团队成员在浏览器里协作时。预期:界面能力优先,终端形态退居其次。

使用 dsh-tui 这个 DSH plugin 的注意事项

  1. 不是官方内置:dsh-tui 是第三方 DSH plugin,成熟度与活跃度以仓库状态为准。
  2. 装法特殊:需先全局安装再跑启动器,别只在市场里点安装就以为完事。
  3. 键位以 README 为准:TUI 的操作随版本变化,装后先跑一轮熟悉,别照搬旧教程。
  4. 与 profile 绑定:它以 bundle 插件形式挂载进 profile,切换 profile 时要确认是否已装。
  5. 多形态可并存:它与 Web UI、桌面端互不冲突,可以按场景切换使用。

来源:xp266/dsh-tui、dsh CLI README、dshplugin/dsh-plugin-hub

常见问题

dsh-tui 这个 DSH plugin 是什么,和 DeepSeek Harness 的 Web UI 有何不同?

dsh-tui(dshtui)是 DeepSeek Harness 的 Ink 终端界面 DSH plugin:它以 opencode 风格接管整个终端,把对话、工具卡片与对话框都放在命令行里渲染。 Web UI 在浏览器里跑,dsh-tui 则完全不依赖浏览器,适合纯终端与 SSH 环境。

在 DeepSeek Harness 里 dsh-tui 这个 DSH plugin 怎么安装和启动?

它是接管整个终端的 TUI,需要先全局安装再用启动器拉起:npm install -g @xp266/dshtui 后用 dshtui 启动,同时按 README 用 dsh plugin --profile add @xp266/dshtui 把它挂载进 profile。 因为要接管终端,网页端难以一键代执行,装法以命令行为主。

dsh-tui 这个 DSH plugin 支持哪些交互,有哪些常用操作?

核心是流式对话与可折叠的工具卡片,另有对话框与交互组件;它还把界面贡献注册 API 开放出来,允许覆盖全部可见界面。 具体键位以插件 README 为准,随版本会调整,建议装后在终端里先跑一轮熟悉操作。

什么场景下 dsh-tui 这个 DSH plugin 比 DeepSeek Harness 的 Web UI 更合适?

纯终端、SSH 远程、或不想开浏览器的时候。 dsh-tui 全程在终端内渲染,SSH 里只要终端可用就能操作;Web UI 需要启动本地 Web 服务并浏览器访问,远程时还要处理认证地址与端口。要不要换用,取决于你日常在不在终端里。

dsh-tui 是不是 DeepSeek Harness 官方内置的能力,还是第三方 DSH plugin?

不是,它是社区的第三方 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

来源