boxeryao/dsh-mini-tui

DSH Mini TUI — DeepSeek Harness 极简终端插件

DeepSeek Harness（DSH） 的极简终端 UI 插件。它保留完整的 Agent 与工具能力，但默认把执行过程收进后台，让终端专注于你的输入和模型的最终回答。

界面、npm 包与 GitHub 仓库统一命名为 DSH Mini TUI / dsh-mini-tui：Mini 指更少的界面噪声，而不是更少的 Harness 能力。中文也可以昵称为 “单身汉 Mini TUI”，取自 DSH 的谐音。

DSH Mini TUI — Welcome to DeepSeek

新版 DeepSeek Harness TUI 启动界面

DSH 与 Mini TUI 的关系

DSH Mini TUI 是 DeepSeek Harness 的终端表现层插件，不是独立的 Agent 框架。 它决定用户在终端里如何输入、查看状态和阅读回答；模型与 Agent 如何运行，仍由 DSH 负责。

DSH Mini TUI 与 dsh-TUI 同属 DeepSeek Harness 的社区终端界面生态，二者是独立的插件实现。

dsh --profile tui
│
▼
DeepSeek Harness（运行时与插件系统）
│
├── 模型路由与凭据
├── standard Agent preset
├── 工具执行与权限审批
├── Session、日志与持久化
└── dsh-mini-tui（终端表现层）
├── 输入框与流式回答
├── answer-first 工具输出
├── 活动状态与失败提示
└── 窗口重绘、标题和终端交互

| DeepSeek Harness 负责 | DSH Mini TUI 负责 |
| --- | --- |
| 模型选择、路由与调用 | 启动界面、输入框与回答渲染 |
| Agent 生命周期与 standard preset | answer-first 对话布局与活动状态 |
| scoped 工具、审批与取消 | /verbose、/tool N 等终端命令 |
| Session 日志和完整执行记录 | resize 重绘、窗口标题与 Windows 终端体验 |
| DSH 插件生态与能力组合 | 将这些能力以克制的 TUI 形式呈现 |

因此，安装或移除 Mini TUI 改变的是 DSH 的交互界面，不会把 DSH 替换成另一套 Agent，也不会削减 DSH 的模型、工具或 Session 能力。

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。

Windows 资源管理器右键启动

DSH Mini TUI 内置当前用户级别的右键菜单安装器。安装后，可以在目录空白处、目录本身或磁盘驱动器上直接启动：

- Open DSH TUI here — 使用标准权限模式打开当前目录。
- Open DSH TUI full access — 以 danger-full-access 模式打开当前目录；只有主动选择该菜单时才会启用。

从 npm 安装到默认 tui profile 后执行：

& "$HOME\.dsh\profiles\tui\node_modules\dsh-mini-tui\scripts\install-dsh-tui-context-menu.cmd"

从源码目录开发时执行：

.\scripts\install-dsh-tui-context-menu.cmdmarkdown
卸载右键菜单：

.\scripts\uninstall-dsh-tui-context-menu.cmd

安装和卸载只修改 HKEY_CURRENT_USER，不需要管理员权限。右键命令最终运行 dsh --profile tui，因此模型、Agent 和工具仍由 DSH 提供。

环境要求

- 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 客户端的图形卡片、会话导航或全屏滚动区。

许可证

MIT