终端智能体界面nexlineai/dsh-tui

dsh-tui

一个面向 DeepSeek Harness 智能体运行时的全屏交互式终端 UI —— 将 Web UI 重新构想于终端之中。

npm
CI
license
platform

dsh-tui 在 Claude Code / opencode 风格的界面背后运行官方 DeepSeek Harness 智能体（工具、文件编辑、shell、子智能体、会话、权限、计划模式）—— 实时 token 流式输出、推理块、盒式工具卡片、提示历史，以及完整的斜杠命令套件。无需浏览器，无需 Electron，只需你的终端。

它不是模型封装器，也不是普通的聊天 REPL —— 它驱动的是真正的智能体运行时。

功能特性

- 实时流式输出 —— 答案随模型生成逐 token 渲染。
- 推理显示 —— thinking 块以暗色/斜体流式呈现，并支持逐轮次力度控制（/model  high）。
- 工具卡片 —— 盒式绘制的 ⏱ bash 块，带生命周期标记（● running → ✓ done / ✖ error）以及参数/结果预览。
- 完整智能体工具集 —— 智能体可以读取/编辑文件、运行命令、委派子智能体并执行计划。
- 会话管理 —— 列出并恢复任意已持久化的会话（/resume）。
- 权限模式 —— read-only / workspace-write / danger-full-access，可实时切换（/permissions）。
- 计划模式 —— 切换计划优先行为（/plan）。
- 压缩 —— 按需缩减对话（/compact）。
- 轨迹 —— 整个会话的过滤事件时间线（/trajectory）。
- 诊断 —— 环境 + 模型目录健康检查（/doctor）。
- 回滚 —— 鼠标滚轮 / PgUp / PgDn，并带 ↑ N 指示器。
- Markdown 渲染 —— 围栏代码块、行内代码、粗体、标题、列表。
- 跨平台 —— macOS 和 Linux 终端（iTerm2、Terminal.app、kitty、alacritty、xterm 等）。

安装

dsh-tui 是一个 DeepSeek Harness 插件。你需要先安装官方 dsh：

1. 安装官方 DeepSeek Harness（一次即可）
npx @deepseek-ai/dsh web --help   # 或：npm i -g @deepseek-ai/dsh

2. 创建 tui 配置文件并添加此插件
dsh plugin --profile tui add @nexlineai/dsh-tui

3. 运行它
dsh --profile tui

配置文件会在首次使用时初始化；dsh-tui 与 Web UI 一样，构建于同一个 @deepseek-ai/dsh-base 核心之上。

模型密钥

export DEEPSEEK_API_KEY=sk-...

TUI 使用与 harness 相同的凭据来源（DEEPSEEK_API_KEY / settings.yaml）。

演示
一份具有代表性的会话记录——流式回答、推理块、工具卡片、轨迹、doctor、模型选择器——位于 demo/session.md。

命令

| 命令 | 描述 |
|---|---|
| /help | 列出命令 |
| /model | 列出模型 + 推理强度；● active 标记当前项 |
| /model  [effort] | 实时切换，例如 /model deepseek-v4-pro high |
| /resume | 列出已持久化的会话（id、标题、日期） |
| /resume  | 以完整历史继续该会话 |
| /permissions | 列出权限预设 |
| /permissions  | 切换（read-only / workspace-write / danger-full-access） |
| /plan | 切换计划模式 |
| /compact | 立即压缩对话 |
| /trajectory | 显示会话事件时间线 |
| /settings | 一屏汇总模型/权限/计划/流式状态 |
| /doctor | 环境 + 模型目录健康检查 |
| /version | dsh-tui + 运行时版本 |
| /status | 会话、cwd、事件和轮次计数 |
| /reasoning on\|off | 显示/隐藏思考展示 |
| /stream on\|off | 切换实时 token 流式输出 |
| /clear | 清空对话区域 |
| /exit（或 q、quit、:q、Ctrl+D） | 退出 |

按键绑定

| 按键 | 操作 |
|---|---|
| Enter | 提交 |
| ↑ / ↓ | 提示历史 |
| ← / → | 移动光标 |
| Home / End（Ctrl+A / Ctrl+E） | 行首 / 行尾 |
| Backspace / Delete | 删除 |
| Ctrl+U / Ctrl+K | 删除至行首 / 行尾 |
| Ctrl+W | 删除前一个单词 |
| Esc | 清空输入行 |
| Tab | 补全斜杠命令 |
| Ctrl+C | 清空（为空时 → 退出） |
| Ctrl+D | 退出 |
| PgUp / PgDn / 鼠标滚轮 | 滚动对话 |

布局

┌ DeepSeek Harness TUI            deepseek-official/deepseek-v4-pro · session a1b2c3d4 ┐
│ ─────────────────────────────────────────────────────────────── 15:35:34 · 2s · 12→45 tok │
│ ❯ list the files                                                                     │
│ ✻ thinking                                                                            │
│   · a simple listing; I'll use bash ls                                                 │
│ This is the repository root — a plugin-based agent harness with pnpm workspaces...    │
│ ┌─ ⏱ bash ──────────────────────────────────────────────────────────────────────────┐ │
│ │ $ ls -la                                                                           │ │
│ └─ ✓ done ───────────────────────────────────────────────────────────────────────────┘ │
│ ❯ your input                                                                          │
│ ~/project · stream on · 1 turns · 500→120 tok                              ↑ /help  │
└───────────────────────────────────────────────────────────────────────────────────────┘

它与 Web UI 有何不同
同一个 agent，相同的权限，相同的会话——但一切都发生在你的终端里。dsh-tui 面向的是那些生活在终端中、想要键盘优先流程，或者通过 SSH / 在 herdr 或 tmux 之类的多路复用器内运行 harness 的人。

为什么要单独做一个 CLI？

官方的 dsh 提供了 web UI 和一次性的 headless 模式——没有交互式终端 agent。dsh-tui 作为一个可安装的插件填补了这一空白，而无需 fork 运行时。

贡献

欢迎提交 bug 报告、终端兼容性说明和 PR——请参阅
CONTRIBUTING.md。对于渲染问题，请附上你的
终端、$TERM，以及 /version 和 /doctor 的输出。

许可证

MIT——请参阅 LICENSE。与 DeepSeek AI 无关联；它所驱动的运行时在上游是 MIT 许可的。