dsh‑TUI：开源DeepSeek Harness终端TUI增强插件

什么是 dsh‑TUI

dsh‑TUI 是一款开源的 DeepSeek Harness（dsh）终端TUI界面插件，它本身不实现模型调用、工具执行、会话存储等底层能力，完全挂载在 dsh CLI 底层之上，仅负责终端层的界面渲染与用户交互，不会修改 dsh 核心源码，卸载无残留。旧包名为 dsh‑cc‑tui，正式包名更改为 @deepseek‑harness‑tui/dsh‑tui，当前主流版本为 v0.8.0，已经被 DeepSeek Harness 官方公众号、dshfind 插件目录收录。

简单理解：dsh 是AI后端内核，dsh‑TUI 给原始命令行套上一套功能完备、交互友好的终端可视化界面，对标 Claude‑Code 的终端交互效果。

功能特色

1. 终端对话交互能力

• 流式Markdown渲染，支持@引用本地文件、发送图片附件；提供消息、命令Tab自动补全。

• 快捷键体系完善：Shift+Enter实现输入框换行，适配macOS Command修饰键；支持鼠标选区复制、鼠标滚轮滚动会话。

• 丰富斜杠内置命令：/new新建会话、/resume恢复历史会话、切换模型、token用量统计、环境自检、MCP工具管理、代码审计评审、/update一键更新；双击Esc可以回溯会话并fork出新对话分支。

• 内置/lang命令切换中英双语界面；支持调用外部编辑器编辑输入内容，模型问卷交互、工具审批弹窗确认。

2. 状态可视化顶栏UI

采用像素风格鲸鱼顶栏UI，状态栏实时展示当前模型、TPS生成速率、缓存命中率、token消耗、上下文窗口进度条、Git会话信息；TPS速率会根据生成速度做颜色动态变化，运行状态一目了然。

3. 预设、主题与扩展能力

• Agent预设模板：自带standard、code、minimal、cordis，包含社区知名liangshen（梁神模式），空白会话使用/preset快速切换预设。

• 主题系统：/theme切换主题，可通过OSC11协议自动读取终端背景，自动适配亮色/暗色模式，支持加载本地JSON自定义主题文件。

• 支持MCP协议工具接入；配套VS Code扩展dsh‑tui‑vscode，可在VS Code内置终端获得接近Claude Code的操作体验。

• 配套社区插件生态仓库dsh‑tui‑ecosystem，提供模板仓库，降低自定义插件开发门槛。

技术细节

1. 事件驱动+消息虚拟化渲染：采用增量差分渲染机制，只渲染终端屏幕可视区域内容。长对话场景不会一次性加载全部历史消息，大幅降低内存占用，解决大会话下终端卡顿问题。

2. OSC11终端色彩探测：读取终端背景色，自动适配亮/暗主题，无需手动配置。

3. 跨平台剪贴板适配：兼容 Windows、macOS、Linux；Linux平台剪贴板依赖系统外部工具。

4. 业务与UI解耦架构：UI层只做展示交互，会话日志作为唯一数据源；模型调用、工具执行全部交给 dsh 内核处理，插件和底层逻辑完全分离。

5. 构建环境：CI流水线使用 Node24 + pnpm10；仓库附带完整文档集合，覆盖安装、配置、主题定制、架构说明、插件开发、VS Code使用指南。

应用场景

1. 本地终端AI编程助手：服务器、本地终端环境，不打开GUI客户端，直接在终端完成代码编写、代码评审、bug排查。

2. 服务器无GUI环境：Linux远程服务器，SSH终端内直接使用DeepSeek大模型，做脚本生成、日志分析、运维排错。

3. 开发者本地开发工作流：搭配VS Code内置终端扩展，把AI对话嵌入开发流程，文件引用、代码修改、MCP工具调用一站式完成。

4. 高阶终端AI爱好者：喜欢终端TUI交互，想要自定义主题、自定义Agent预设，二次开发扩展插件。

使用方法

前置依赖

需要具备：TTY交互式终端环境、dsh CLI工具、pnpm10+，配置环境变量DEEPSEEK_API_KEY。

安装命令

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

启动使用

# 启动全新会话
dsh‑tui

# 恢复历史会话
dsh‑tui --resume

Windows系统可直接执行dsh‑tui.cmd；也可运行仓库内install.sh脚本写入profile配置。

基础操作示例

• /preset liangshen：切换梁神Agent预设

• /theme：打开主题切换面板

• /lang en：切换英文界面

• /update：更新插件版本

竞品对比

常见问题解答

切换模型之后为什么没有直接修改当前会话？

dsh‑TUI切换模型本质是fork生成一条全新会话分支，底层dsh不支持在已有会话原地替换模型，旧会话会完整保留，需要注意区分新旧会话。

Linux下复制粘贴剪贴板失效怎么办？

Linux平台剪贴板功能依赖系统剪贴板工具，需要手动安装xclip或者wl‑copy等对应工具，否则复制功能无法正常工作。

Windows环境使用会有什么限制？

Windows没有沙箱后端，工具执行会回退到完全访问模式，工具权限管控能力会减弱，使用时留意命令执行风险。

部分CC兼容命令提示占位，无法执行是什么原因？

部分兼容命令仅做提示占位，对应的能力在dsh底层内核尚未实现，并非dsh‑TUI插件bug。

dsh‑TUI安装完成运行报错，提示找不到dsh？

需要确认已经全局安装@deepseek‑ai/dsh，并且dsh CLI可以在终端正常调用，同时确认Node版本、pnpm版本满足最低要求。

自定义主题如何生效？

准备JSON格式主题文件，使用/theme命令加载本地主题文件路径，格式需要遵循项目主题文档规范。

相关链接

• 项目GitHub仓库：https://github.com/ccch1mneyyy/dsh‑TUI

• 社区插件生态仓库：https://github.com/ccch1mneyyy/dsh‑tui‑ecosystem

• DeepSeek Harness官方项目仓库：https://github.com/deepseek‑harness/harness

总结

dsh‑TUI 面向DeepSeek Harness用户提供了一套功能丰富的终端TUI交互层，它不改动底层内核，通过虚拟化渲染解决长会话性能痛点，搭配MCP工具、Agent预设、自定义主题、VS Code扩展等能力，让开发者可以在SSH服务器、本地终端环境获得流畅完整的AI对话与编程辅助体验，是dsh生态中实用性很强的社区开源增强插件。