dsh-native-tui

dsh-native-tui

经典、稳健的 DeepSeek Harness 终端界面。

dsh-native-tui 是一个社区 TUI 插件。它把会话、供应商和模型管理放进终端，同时保留 DeepSeek Harness 的工具调用、子代理、后台任务、人工确认和上下文压缩能力。

功能

会话管理

• 新建会话，或继续当前项目最近一次会话。
• 从列表选择历史会话，也可按 session ID 精确恢复。
• 重命名会话；所有消息持久化，恢复后按原事件顺序重放。
• 当前项目与全部会话分组展示，全程键盘操作。

供应商管理

• /provider 查看所有供应商及其 active、configured、dormant 状态。
• 查看凭据来源、模型目录和当前路由。
• 在 TUI 内遮罩录入 API Key；密钥写入 Harness 凭据服务，不写入普通设置。
• 支持手动刷新，并响应供应商、设置和凭据变更。

模型管理

• /model 按供应商分组浏览模型。
• 切换模型并选择 reasoning effort。
• 选择结果写入默认设置，后续请求与新会话继续使用。

终端交互

• 官方 DeepSeek Harness 渐变字标，紧凑的无边框对话布局。
• 工具调用渐进展开，支持递归工具树、diff、错误和完整结果查看。
• 全屏模式支持 PgUp / PgDn；内联模式使用终端原生滚动、选择和复制。
• dark、light、mono 三套配色。
• / 命令补全、@ 路径补全、输入历史和 ! 本机命令。

Harness 能力

• Code Mode、Workflow、子代理和 Jobs。
• 工具审批、批量提问、计划审阅等 HITL 交互。
• token、上下文占用和压缩状态。
• MCP 工具状态、附件列表和工作区文本预览。

界面

会话管理

供应商管理

模型管理

安装

需要 Node.js 22+ 和 npm。

git clone https://github.com/hanlinlibham/dsh-native-tui.git
cd dsh-native-tui
./install.sh
deepseek .

安装器会固定使用 @deepseek-ai/dsh@0.1.0-rc.6，创建 abletui profile，并把启动器安装到 ~/.local/bin/deepseek。重复运行 ./install.sh 即可更新；已有配置不会被覆盖。

首次使用时，运行 /provider，选择 DeepSeek 后按 k 录入 API Key。也可以编辑：

$EDITOR ~/.config/ablemind/config.env

如果 ~/.local/bin/deepseek 已被其他程序占用，安装器会停止，不会覆盖原文件。官方 dsh 命令保持不变。

启动

命令	作用
deepseek .	在当前目录新建会话
deepseek --continue .	继续当前项目最近一次会话
deepseek --resume .	打开历史会话选择器
deepseek --resume=SESSION_ID .	精确恢复指定会话

插件与 Web 管理仍使用官方命令：dsh plugin ...、dsh web ...、dsh --profile NAME ...。

常用命令

命令	作用
/new、/clear	新建或清空当前会话
/resume、/rename	恢复或重命名会话
/provider	管理供应商和凭据
/model	切换模型与推理强度
/permission	切换权限预设
/context	查看 token 与上下文明细
/agents、/jobs	查看子代理和后台任务
/tools、/tool、/open	查看工具、调用树和完整结果
/theme	切换并保存配色
/mcp	查看已加载的 MCP 服务和工具

按键	作用
Enter	发送消息或确认选择
Alt+Enter	输入换行
Tab、↑、↓	补全与历史选择
Shift+Tab	打开权限选择器
Esc	关闭弹窗或打断当前轮次
PgUp、PgDn	全屏模式翻阅历史
Ctrl+L	清屏
Ctrl+C、Ctrl+D	打断或退出

开发

npm ci
npm run check
dsh plugin --profile abletui add "$PWD"

npm run check 会依次执行 TypeScript 类型检查、测试和构建。

项目说明

这是社区项目，不是 DeepSeek 官方发行版，也不代表 DeepSeek。插件通过公开的 Harness service、event 和 presenter 接口运行，不修改 Harness 内核。

启动字标沿用上游 DeepSeek Harness TUI 曾发布的官方终端字标，实现依据为上游提交 d04ec5a。上游与本项目均采用 MIT 许可证。

License

MIT