boxeryao
dsh-mini-tui
DSH-TUI: a lightweight and fast terminal plugin connected directly to the DSH runtime.
- Stars
- 6
- Language
- TypeScript
- Created
- Aug 13, 2026
- Updated
- Aug 15, 2026
Introduction
DSH Mini TUI — DeepSeek Harness 极简终端插件
English | 中文
DeepSeek Harness(DSH) 的极简终端 UI 插件。它保留完整的 Agent 与工具能力,但默认把执行过程收进后台,让终端专注于你的输入和模型的最终回答。
界面、npm 包与 GitHub 仓库统一命名为 DSH Mini TUI / dsh-mini-tui:Mini 指更少的界面噪声,而不是更少的 Harness 能力。中文也可以昵称为 “单身汉 Mini TUI”,取自 DSH 的谐音。


Mini 的含义:少显示,专注回答
这版界面的设计原则很简单:工具照常工作,过程不必占满屏幕。 对终端用户来说,更少的状态信息意味着更清晰的上下文、更少的滚屏,也更容易连续阅读真正重要的回答。
- 渐变品牌标识 — 使用青蓝到深蓝的真彩色渐变展示
DEEPSEEK字标,形成清晰、统一的终端识别度。 - 紧凑运行信息 — 字标下方只显示当前模型、工作目录和
/help提示;不再堆叠 Session ID、平台版本、权限模式与快捷键说明。 - 深海配色体系 — 输入边框、状态标签、工作路径和思考提示共用低反差的海洋色板,长时间使用时更克制。
- 路径颜色标识 — 输出中的文件与目录路径会获得稳定的颜色,便于在日志和工具详情中快速定位引用目标。
- 回答优先的对话流 — 成功的工具调用默认不显示,终端主要呈现用户输入和模型回答;失败时只保留一行短提示,不让异常悄悄消失。
- 按需查看过程 — 极简不等于丢失信息。需要排查时,可用
/verbose查看后续工具输出,或用/tool N查看已保留的调用详情;完整记录仍由 DSH Session 持久化。 - 安全的思考提示 — 模型推理期间显示简洁的
[thinking]状态,但不会把内部 reasoning 内容输出到终端。
这是一种有意为之的取舍:Mini 是界面,不是能力。 DSH 的模型路由、工具执行、审批、Agent 生命周期及 Session 持久化机制保持不变。
插件特点
- 轻量 — 专注于终端展示层,不携带 Web 应用运行时。
- 快捷 — 多行输入响应迅速,键盘控制直接,工具活动默认不打断对话流。
- 深海视觉 — 启动仪表盘、状态标签、路径引用和思考状态使用统一的低反差深海色系。
- 原生衔接 DSH — 直接使用 DSH 的 scoped 工具、审批、Agent 生命周期和持久化 Session 日志。
快速安装
从 npm 将最新版 DSH Mini TUI 安装到 DSH 的 tui profile:
dsh plugin --profile tui add dsh-mini-tui@latest
dsh --profile tui
注意:npm 上的
deepseek-harness-tui属于另一个项目。本项目的正确包名是dsh-mini-tui。
环境要求
- Node.js 22.19 或更高版本,或者 Node.js 24+
- pnpm 11+
- 已安装 DeepSeek Harness
0.1.0-rc.6 - DSH 中已有可用的模型凭据,可由凭据服务保存,也可通过启动环境提供
从本目录开发
pnpm install
pnpm run build
pnpm test
dsh plugin --profile tui add .
dsh --profile tui
这里的 dsh plugin --profile tui add . 用于安装当前源码目录;普通用户应优先使用上面的 npm 快速安装命令。本包使用 npm 已发布的 0.1.0-rc.6 版 @deepseek-ai/* 包,不包含 monorepo 相对路径或 workspace:^ 依赖。
输入与命令
- Enter 发送当前消息。
- Shift+Enter 或 Ctrl+J 插入换行。
- Ctrl+V 接收 bracketed 多行粘贴;
/paste直接读取 Windows 剪贴板。 /cancel或 Ctrl+C 取消当前任务。/verbose切换后续调用的限长工具输出。/tool N显示编号为N的调用所保留的输入和结果。/help显示命令;/exit或/quit关闭会话。
工具调用默认静默;失败时只显示一行短提示。/verbose 会显示后续调用的编号摘要和限长详情,/tool N 可查看最近保留的输入和结果。toolDetailMaxLines 和 toolDetailMaxCharacters 默认限制为 80 行和 8,000 字符。toolDetailHistoryLimit 默认让 /tool N 保留最近 200 次调用;更早的详情会从进程内存淘汰,完整值仍保留在 DSH Session 日志中。
范围
本仓库只负责终端展示插件。模型路由、工具、权限、持久化和 Agent 执行由 DSH 提供。TUI 采用行式界面,不提供 Web 客户端的图形卡片、会话导航或全屏滚动区。