前言¶
在 DeepSeek Harness（DSH）里跑 Agent，终端界面往往承担两件事：接收你的输入，以及把模型回答和工具执行过程展示出来。官方与社区已有多种 TUI 实现，其中 dsh-TUI 等功能完整，但工具调用、状态栏和 Session 信息会占去不少屏幕空间。如果你更希望在终端里优先阅读模型回答，只在需要时再展开工具细节，DSH Mini TUI（npm 包名 dsh-mini-tui）是一个专门面向这一需求的终端表现层插件。
下面介绍它的定位、核心能力、安装方式与典型用法。事实均来自项目 README 与 package.json（当前版本 0.2.1）。
这是什么¶
DSH Mini TUI 由社区维护者 boxeryao 开发，归类为 DSH 客户端插件。它不是独立的 Agent 框架，而是 DeepSeek Harness 的终端 UI 插件：模型路由、Agent 生命周期、scoped 工具、权限审批和 Session 持久化仍由 DSH 负责；Mini TUI 只决定你在终端里如何输入、查看状态和阅读回答。
名称里的 Mini 指更少的界面噪声，而不是更少的 Harness 能力。工具照常执行，成功的调用默认不显示；失败时保留一行短提示，完整记录仍在 DSH Session 日志中。
与 DSH 的关系¶
启动 dsh --profile tui 后，DSH 运行时加载 tui profile 下的插件。Mini TUI 作为其中的终端表现层，与 dsh-TUI 同属社区终端界面生态，二者是独立实现。
| DeepSeek Harness 负责 | DSH Mini TUI 负责 |
|---|---|
| 模型选择、路由与调用 | 启动界面、输入框与回答渲染 |
Agent 生命周期与 standard preset |
answer-first 对话布局与活动状态 |
| scoped 工具、审批与取消 | /verbose、/tool N 等终端命令 |
| Session 日志和完整执行记录 | resize 重绘、窗口标题与 Windows 终端体验 |
安装或移除 Mini TUI 改变的是 DSH 的交互界面，不会替换底层 Agent，也不会削减模型、工具或 Session 能力。
核心功能¶
answer-first 对话流¶
界面设计原则是：工具照常工作，过程不必占满屏幕。 终端主要呈现用户输入和模型最终回答；成功的工具调用默认静默，失败时只显示一行短提示，避免异常被悄悄吞掉。
需要排查时，可用 /verbose 切换后续调用的限长工具输出，或用 /tool N 查看编号为 N 的调用所保留的输入和结果。toolDetailMaxLines 和 toolDetailMaxCharacters 默认限制为 80 行和 8,000 字符；/tool N 在进程内存中保留最近 200 次调用详情，更早的完整值仍在 DSH Session 日志中。
克制的终端视觉¶
- 启动界面使用青蓝到深蓝的真彩色渐变展示
DEEPSEEK字标。 - 字标下方只显示当前模型、工作目录和
/help提示，不再堆叠 Session ID、平台版本等信息。 - 输入边框、状态标签、工作路径和思考提示共用低反差的深海色板；输出中的文件与目录路径有稳定颜色标识。
- 模型推理期间显示简洁的
[thinking]状态，但不把内部 reasoning 内容输出到终端。
输入与终端命令¶
- Enter 发送当前消息；Shift+Enter 或 Ctrl+J 插入换行。
- Ctrl+V 接收 bracketed 多行粘贴；Windows 下可用
/paste直接读取剪贴板。 /cancel或 Ctrl+C 取消当前任务。/help显示命令；/exit或/quit关闭会话。
Windows 右键菜单（可选）¶
Mini TUI 内置当前用户级别的右键菜单安装器。安装后可在目录空白处、目录本身或磁盘驱动器上直接启动：
- Open DSH TUI here — 使用标准权限模式打开当前目录。
- Open DSH TUI full access — 以
danger-full-access模式打开；只有主动选择该菜单时才会启用。
安装和卸载只修改 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 中已有可用的模型凭据
从 npm 安装¶
先做插件安装，再启动 tui profile：
dsh plugin --profile tui add dsh-mini-tui@latest
dsh --profile tui
注意：npm 上的 deepseek-harness-tui 属于另一个项目。本插件的正确包名是 dsh-mini-tui。
安装 Windows 右键菜单¶
从 npm 安装到默认 tui profile 后执行：
& "$HOME\.dsh\profiles\tui\node_modules\dsh-mini-tui\scripts\install-dsh-tui-context-menu.cmd"
卸载右键菜单：
& "$HOME\.dsh\profiles\tui\node_modules\dsh-mini-tui\scripts\uninstall-dsh-tui-context-menu.cmd"
典型用法¶
安装完成后，在目标工作目录启动：
dsh --profile tui
进入会话后，直接输入问题并按 Enter 发送。若某次工具调用失败，终端会显示一行短提示；需要查看后续工具输出时，输入 /verbose 开启限长详情，或用 /tool N 查看指定编号的调用输入与结果。
从源码目录开发时，可先构建并本地安装：
pnpm install
pnpm run build
pnpm test
dsh plugin --profile tui add .
dsh --profile tui
这里的 dsh plugin --profile tui add . 用于安装当前源码目录；普通用户应优先使用 npm 快速安装命令。
适用场景与注意¶
适合谁
- 已在 DSH 上跑 Agent，希望终端界面更克制、回答更易连续阅读的用户。
- 需要在 Windows 资源管理器中右键启动 DSH TUI 的开发者。
- 接受「过程默认隐藏、按需展开」交互方式，而不是实时滚动查看全部工具输出。
需要注意
- 本仓库只负责终端展示插件，不提供 Web 客户端的图形卡片、会话导航或全屏滚动区。
- 插件以当前
dsh进程的权限运行；安装前应阅读 源码 与 MIT 许可证，确认符合你的安全要求。 - DSH 社区目录 SkillHub 是独立站点，与 DeepSeek / 幻方无官方从属关系；插件发现与安装以各项目 README 为准。
结尾¶
DSH Mini TUI 把 DeepSeek Harness 的完整 Agent 与工具能力保留在运行时，只在终端层做 answer-first 的界面取舍：更少噪声、更快读到回答，需要时再 /verbose 或 /tool N 展开过程。
