前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的架构。对于习惯在终端工作的开发者，直接使用 Web 界面或基础命令行在管理会话、切换模型和配置供应商时往往不够便捷。dsh-native-tui 是一个社区维护的 TUI 插件，它将 DeepSeek Harness 的核心能力封装在终端界面中，提供完整的会话、供应商、模型管理以及终端交互体验。
安装与启用¶
- 确保环境已安装 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。如果 ~/.local/bin/deepseek 已被占用，安装器会停止运行，不会覆盖原文件。
核心功能¶
会话管理¶
- 新建与继续：在当前目录新建会话，或继续最近一次会话。
- 历史恢复：从列表选择历史会话，或按 session ID 精确恢复。
- 持久化：所有消息持久化，恢复后按原事件顺序重放。
- 重命名：支持对会话进行重命名操作。
供应商管理¶
- 状态查看：查看供应商及其 active、configured、dormant 状态。
- 凭据录入：在 TUI 内遮罩录入 API Key，密钥写入 Harness 凭据服务，不写入普通设置。
- 手动刷新：支持手动刷新，并响应供应商、设置和凭据变更。
模型管理¶
- 浏览与切换：按供应商分组浏览模型，并切换当前使用的模型。
- 推理强度：支持在切换模型时调整推理强度（reasoning effort）。
- 持久化设置：模型选择结果写入默认设置，后续请求与新会话继续使用。
终端交互¶
- 官方标志：使用官方 DeepSeek Harness 渐变字标。
- 工具调用：工具调用渐进展开，支持递归工具树、diff、错误和完整结果查看。
- 布局模式：支持全屏模式（
PgUp/PgDn）和内联模式（终端原生滚动、选择、复制）。 - 输入增强：提供
/命令补全、@路径补全、输入历史和!本机命令。
Harness 能力¶
- Code Mode、Workflow：支持 Code Mode 和 Workflow。
- 子代理与 Jobs：查看子代理（agents）和后台任务（jobs）。
- HITL 交互：支持工具审批、批量提问、计划审阅等人工确认（HITL）交互。
- 上下文管理：支持 token、上下文占用和压缩状态查看。
- MCP 与附件：支持查看已加载的 MCP 服务和工具，以及附件列表和工作区文本预览。
使用方式¶
启动命令¶
deepseek . # 在当前目录新建会话
deepseek --continue . # 继续当前项目最近一次会话
deepseek --resume . # 打开历史会话选择器
deepseek --resume=SESSION_ID . # 精确恢复指定会话
TUI 内部命令¶
| 命令 | 作用 |
|---|---|
/new |
新建会话 |
/clear |
清空当前会话 |
/provider |
管理供应商和凭据 |
/model |
切换模型与推理强度 |
/permission |
切换权限预设 |
/context |
查看 token 与上下文明细 |
/agents |
查看子代理 |
/jobs |
查看后台任务 |
/tools |
查看工具 |
/theme |
切换并保存配色 |
/mcp |
查看已加载的 MCP 服务和工具 |
常用快捷键¶
Enter：发送消息或确认选择Alt+Enter：输入换行Tab/↑/↓：补全与历史选择Shift+Tab：打开权限选择器Esc：关闭弹窗或打断当前轮次PgUp/PgDn：全屏模式翻阅历史Ctrl+L：清屏Ctrl+C/Ctrl+D：打断或退出
注意事项¶
- 社区项目：
dsh-native-tui是社区项目，不是 DeepSeek 官方发行版，也不代表 DeepSeek。 - 许可证：项目采用 MIT 许可证。
- 运行机制：插件通过公开的 Harness service、event 和 presenter 接口运行，不修改 Harness 内核。
- 源码检查：建议在安装前查看源码与许可证。
结语¶
dsh-native-tui 提供了一个在终端中完整使用 DeepSeek Harness 的方案，适合需要在命令行环境下进行高效会话管理和模型调用的开发者。
