2860星的DSH终端界面火了！Claude Code同款鲸鱼顶栏，但这3个坑90%的人会踩

你有没有这种感觉：用 DeepSeek Harness 的时候，默认界面太朴素了——黑白终端，没有状态指示，不知道 AI 现在是在思考还是卡住了，上下文用了多少也看不到，想回到上一步操作只能重新输一遍指令。

直到我装上了 dsh-TUI。

这玩意儿是 DSH 生态里最火的终端界面插件，2860 个 Star，周下载量 12327，今天（9月7日）刚更新，还被 DSH 官方公众号收录了，上过 GitHub Trending 日榜第七。它把 Claude Code 那套终端美学搬了过来——像素鲸鱼顶栏、实时状态行、思考流式展开、双击 Esc 回滚、上下文进度条加 TPS 仪表。

但它不是装上就完事的。我研究了一下，有 3 个坑很容易踩，今天一次性说清楚。

它是什么

dsh-TUI（ccch1mneyyy/dsh-TUI）是 DeepSeek Harness 的终端用户界面插件。说人话就是：给 DSH 换了一套更好看、更好用的终端皮肤，而且不只是皮肤——它加了很多实用功能。

最关键的一点：零核心改动，纯插件挂载。意思是它不改 DSH 的核心代码，就是个外挂插件，装上就生效，卸载了干干净净，不会留下补丁把 DSH 搞坏。对于怕折腾的人来说，这一点很重要。

核心亮点

1. Claude Code 同款鲸鱼顶栏

顶部是像素风格的鲸鱼图标加双流光大字标题，视觉上跟 Claude Code 的终端界面几乎一模一样。从 Claude Code 迁移过来的用户会有熟悉感，不用重新适应界面布局。

2. 实时状态行，再也不用猜 AI 在干嘛

界面底部有一行实时状态，显示当前工作状态、TPS（每秒生成 token 数）、缓存命中率、推理等级、输入输出 token 数、Git 信息、会话信息。

以前用默认界面，AI 卡住了你不知道是网络断了还是模型在思考，现在看 TPS 仪表就知道——数字在跳就是在生成，不动了就是卡住了。

3. 双击 Esc 时间回溯

连续按两次 Esc，回滚到上一步操作。这个功能看起来简单，但长会话里太实用了——误删了内容、选错了选项、想回到之前的状态，双击 Esc 就行，不用重新输入一大段指令。

4. 蓝白上下文进度条

底部有个蓝白配色的进度条，直观显示当前会话已经用了多少上下文窗口。快满的时候你能提前看到，及时开新会话或者清理历史，避免上下文溢出导致回答质量下降。

5. 思考流式展开

AI 的思考过程是逐字流式展开的，你能实时看到它在推理什么，而不是等半天突然蹦出一大段答案。对于调试复杂任务很有帮助。

6. 会话管理和持久化

输入 /resume 可以浏览历史会话，按工作目录分类，支持搜索和预览。左键恢复会话，右键弹出操作菜单。还能固定常用会话，固定的分组置顶显示，持久化保存在 ~/.dsh-tui 目录，换电脑也能带走。

另外还有 /theme 切换主题、/font 调字体、/copy 复制输出、/save/load/export/import 导入导出会话等一整套命令。

安装步骤

第一步：装 dsh CLI 引擎（如果还没装）

npm install -g @deepseek-ai/dsh

第二步：添加插件

dsh plugin add ccch1mneyyy/dsh-TUI

第三步：重启 DSH

重启之后终端界面自动生效。输入 /theme 切换主题，/settings 配置命令折叠。

注意：如果第二步报错，看下面的避坑部分。

避坑提醒（重点！）

坑1：npm 上没有这个包，一键安装大概率失败

这是最大的坑。dsh-TUI 的 npm 包 @deepseek-harness-tui/dsh-tui 没有发布到 npm registry。你执行 dsh plugin add ccch1mneyyy/dsh-TUI 的时候，它会去 npm 找包，找不到就报错。

很多人卡在这里，以为是自己网络问题或者 dsh 版本不对，其实就是包没发。

解决方案：改用 GitHub 源安装或者从源码编译。

# 源码安装方式 git clone https://github.com/ccch1mneyyy/dsh-TUI.git cd dsh-TUI npm install npm run build # 然后 link 到 dsh 的插件目录

源码安装需要 Node 版本符合要求（见坑2），编译完成后 link 到 dsh 插件目录就能用了。

坑2：Node 版本卡得死，23 居然不行

package.json 里写的 Node 引擎要求是 ^22.19 || >=24。这个范围很刁钻：

• Node 22.19 以下不行

• Node 22.19 到 22.x 的最新版可以

• Node 23 不行（不在 ^22.19 范围内，也不到 >=24）

• Node 24 及以上可以

很多人电脑上装的是 Node 20 LTS 或者 Node 23，一装就报引擎不兼容。建议直接用 Node 22.19+ LTS 版本，最稳。

用 node -v 查一下当前版本，不对就用 nvm 切一下：

nvm install 22 nvm use 22

坑3：需要外网，国内裸连可能用不了

插件运行时要访问外部网络和远程 API（DeepSeek API 等）。如果你在国内没有代理或者外网环境，插件可能无法正常连接模型，表现为界面能打开但发消息没反应。

解决方案：确保终端可以访问外网，或者配置好代理环境变量（HTTP_PROXY/HTTPS_PROXY）。

额外提醒：依赖比较多

这个插件依赖 17 个 DSH/Cordis 模块，安装的时候如果 dsh 引擎版本太旧，可能出现依赖冲突。建议先把 @deepseek-ai/dsh 升级到最新版再装插件。

适合谁用

• 终端党、极客用户，喜欢键盘操作和黑窗口

• 从 Claude Code 迁移过来，习惯了那套界面的人

• 长会话重度用户，需要会话管理和上下文监控

• 想实时看 AI 运行状态（TPS、缓存命中率）的调试党

不适合：

• 纯图形界面用户，看到终端就头大

• 完全不懂命令行的纯小白（安装有门槛）

• 没有外网环境的用户

总结

dsh-TUI 解决的是 DeepSeek Harness 默认终端界面「太素、功能太少」的问题。2860 Star 和 12327 周下载量不是白来的——鲸鱼顶栏的颜值、实时状态行的实用、双击 Esc 回溯的贴心、上下文进度条的直观，每一项都击中了终端用户的痛点。

当前最大的问题是 npm 未发布导致安装不友好，以及 Node 版本要求刁钻。但对于终端党来说，花十分钟配好环境，换来的是每天用 DSH 时的体验升级，这笔账划算。

访问 dpharness.com 或搜索 DeepSeek Harness Hub 查看更多插件和汉化避坑指南。下一篇我们聊一个能让 DSH 同时管理多个 AI 智能体的插件，敬请关注。