DSH-TUI：给 DeepSeek Harness 换上一套真正好用的终端界面

项目地址：DSH 官方首推的 TUI 插件，高性能低占用，可爱像素鲸鱼，流畅鼠标交互，npm 一键安装

dsh-TUI 是一款面向 DeepSeek Harness（DSH） 的交互式终端 UI，为原本偏命令行的 AI Agent 工作流提供更完整的可视化交互体验。项目提供像素鲸鱼、流式 Markdown、任务状态、上下文进度、TPS、侧边栏、会话管理、鼠标操作等功能，同时通过 DSH 的公开接口工作，不需要直接修改 DSH 核心代码。

简单理解：

dsh-TUI 就是给 DeepSeek Harness 加上一套更现代、更直观的终端操作界面。

界面预览

它能做什么？

dsh-TUI 最大的价值不是单纯“把终端做漂亮”，而是把 AI Agent 工作过程中各种状态集中展示出来。

1. 更直观地查看 AI Agent 工作状态

界面能够展示：

• 实时工作状态
• Streaming Thinking 流式思考
• Context 上下文进度
• TPS
• Token 信息
• 缓存命中率
• Session Cost 费用估算
• Git 与 Session 状态

这样在执行比较复杂或者耗时较长的任务时，不再只是面对不断刷新的终端文字。

2. 更完整的终端 UI

项目支持流式 Markdown、Tool Cards、/ 和 @ 自动补全、历史搜索，以及中文/英文 UI。

同时还支持鼠标交互，包括时间线点击、侧栏操作、滚动以及拖动调整侧边栏宽度等。

3. 图片、公式和 Mermaid

dsh-TUI 对终端内容的展示也做了不少增强，例如：

• Kitty / Sixel 图片预览
• 图片缩放和平移
• Mermaid 图表显示
• LaTeX 数学公式显示

所以它并不是简单给 DSH 套了一层菜单，而是在尝试让终端成为一个比较完整的 AI Agent 工作环境。

4. 会话管理

项目将 /resume、/home、/agentview、/bg 等能力整合进会话管理，同时支持：

• 新建 Session
• 恢复 Session
• 压缩上下文
• 导出
• 模型热切换
• Fork
• Rewind
• 全屏草稿编辑等

对于需要频繁使用 AI Agent 编程的人，这部分比单纯的界面美化更实用。

怎么使用？

1.npm 安装

首先准备：

• Node.js
• DeepSeek Harness

项目目前给出的全局安装方式是：

npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui

安装完成以后运行：

dsh-tui

或者短代码

dst

dst 与 dsh-tui 启动的是同一个 TUI。首次运行时会自动初始化对应 Profile。

2.Windows 一键安装

直接前往项目 Releases 下载对应版本程序，然后运行安装程序即可。

对于只是想体验一下的 Windows 用户，我更建议直接采用这种方式。

怎么用？

第一次启动 dsh-TUI 会进入引导流程，主要帮助你完成：

1. 账户与模型
2. 语言和主题
3. 模型与工作目录
4. 快捷键

之后如果想重新执行初始化，可以使用：

/setup

账户/API 配置则可以通过：

/provider

或者

/auth

进入界面以后，就可以像正常 AI Agent 一样直接输入任务，例如让它分析项目、修改代码或者完成其他开发任务。

常用交互命令

dsh-TUI 内置了比较完整的 / 命令体系，日常使用主要记住下面这些即可。

其中 /dsh、/codex、/claude 与 /kernel 中选择相应后端效果一致，会记住选择并重启进程进入新 Session；如果当前任务仍在运行，则不能切换。

其他交互命令详见： github文档

已知限制

1. 不同后端的功能并不完全一致

dsh-TUI 目前不仅能使用 DSH，还提供实验性的 Claude、Codex 后端，但切换后端并不意味着所有功能完全一致。

例如 Claude 后端不提供部分 DSH 专属命令，包括：

/tree
/preset
/provider
/workspace
/agentview
/bg

而且一个进程只运行一个 Backend，使用 /kernel 切换时会通过重启进入新的 Session。

2. Claude 和 Codex 后端仍属于实验性功能

项目目前将 Claude Backend 和 Native Codex Backend 都明确标记为 Experimental。Codex 后端以 0.160.1 为协议基准，最低版本为 0.144.0，项目也明确说明其他版本可能出现协议差异。

所以如果主要追求稳定使用，建议把 DSH 后端作为主力，Claude/Codex 后端则根据实际需求尝试。

3. pnpm 11+ 安装机制需要留意

如果采用 npm/Node.js 方式安装，新用户需要注意：pnpm 11 及以上默认会阻止带安装脚本的依赖，并可能看到：

ERR_PNPM_IGNORED_BUILDS

项目已经针对更新和不同平台的原生依赖做了相应处理，但遇到这个错误时不要简单理解成 dsh-TUI 本身安装失败。

4. 后台 Session 有后端差异

在 DSH 后端中，/bg 可以把当前 Session 放到后台继续执行，然后打开 Session Manager。

但这些后台 Session 只存在于当前 dsh-TUI 进程中，退出 TUI 后后台 Session 会停止，不过日志会保留。Claude/Codex 后端中的对应入口则只会打开 Session Manager，并不会将当前 Session 后台化。

5. 同一个 Session 存在单写入者保护

如果恢复 Session 时提示另一个 DSH 进程仍然占有 Writer，需要先在对应进程中释放 Session，再重新尝试。

项目明确不建议通过删除 Session 或 Lock 文件的方式强行绕过这个保护。