前言¶
DeepSeek Harness (DSH) 采用插件化架构，旨在将所有功能封装为插件。现有的 Web 界面需要浏览器和手动选择工作区，对于习惯终端操作的开发者，这种交互方式不够直接。DSH 社区提供了多种 TUI 插件，其中 dsh-minitui 是一款轻量级的前端实现，旨在提供以键盘交互为主的纯文本界面。
插件定位¶
该项目由 AncientMoon114 维护，是一个专为 DeepSeek Harness 设计的 TUI 前端插件。与依赖 Web 界面的方式不同，它完全摒弃了鼠标交互，通过键盘快捷键直接与 Agent 进行对话。界面设计参考了 OpenCode，保持干净简洁，主要服务于后端代码工作者。
核心功能¶
界面与交互¶
- 纯键盘操作：界面中没有任何鼠标可点击区域，仅保留输入框和对话监控区。
- 快捷键：
- 发送消息：
Alt + Enter - 换行输入：
Enter - 文本补全：
Tab - 复制：
Ctrl + Shift + C - 粘贴：
Ctrl + Shift + V - 退出：
Ctrl + C
命令支持¶
- /session：用于切换或创建当前工作区目录下的会话。注意：该命令不支持跨目录切换，需先退出 TUI 切换目录后再打开。
- /model：用于切换模型和推理等级。目前仅支持 Deepseek 本家模型，不支持外接模型。
配置与格式¶
- Markdown 支持：支持 Markdown 格式渲染。
- 自定义配置：首次运行会在插件根目录生成
userconfig.json，可用于配置颜色和默认设置。若填写错误值可能导致插件无法启动。
安装与启用¶
由于该插件尚未发布至 npm 仓库，目前需通过源码安装。开发环境为 Ubuntu 22.04。
- 克隆仓库并安装依赖：
git clone https://github.com/AncientMoon114/dsh-minitui
cd ./dsh-minitui-0.1.0/
npm install
- 编译 TypeScript：
npx tsc
- 添加到 DSH 插件配置：
dsh plugin --profile minitui add link://这里需要填入minitui的绝对路径
典型用法¶
在项目目录下打开 TUI 界面：
dsh --profile minitui
为方便调用，建议在 ~/.bashrc 中添加别名：
alias dsh-minitui='dsh --profile minitui'
注意事项¶
- 环境依赖：依赖
neo-blessed、marked、marked-terminal、streammark等库。其中streammark库已手动打补丁，后续更新或全局环境变量更新可能导致冲突。 - 操作系统兼容性：开发环境为 Ubuntu 22.04。Windows 用户建议使用 WSL2，可能存在未知 bug。
- 功能限制：
/model命令目前仅支持 Deepseek 本家模型；/session仅限当前工作区目录。
总结¶
dsh-minitui 提供了一种去浏览器化的 DSH 使用方式，专注于键盘交互和 Markdown 输入。对于追求终端效率和简洁界面的开发者，它是一个可行的替代方案。
