MIT 许可的 Claude Code 风格终端 TUI，以纯插件挂载 dsh profile（dsh --profile dsh-tui），零核心改动，提供鲸鱼顶栏、实时状态、上下文进度条、TPS 仪表与双击 Esc 时间回溯。
DSH 适配
兼容
作者声明
安全审计
未审计
最后核验
2026-08-21
许可证
MIT
01它能帮你完成什么？
Run DeepSeek Harness coding-agent sessions in a Claude Code-style fullscreen terminal TUI
A polished TUI experience: pixel whale splash bar, dual flowing-glow title, real-time working status line, streaming thought expansion, double-Esc time rewind, blue-white context progress bar + TPS gauge
Developers who run the official dsh CLI in a terminal and want a beautiful, observable Claude Code-style TUI instead of plain output
Monitor agent state, token usage and context budget in real time during long DSH sessions
Live working status, segmented context progress, TPS, cache hit rate, reasoning level, input/output tokens and Git/session info in the status line, with virtualized rendering that keeps long sessions cheap
Power users and operators running long DeepSeek Harness sessions who need visibility into context budget and throughput
Manage full DSH session workflows — resume, rewind, fork, export — from the terminal
Session resume/new/compact/export, `/btw` side questions, model switching, and session rewind/fork via double-Esc; all local commands route through official DSH links
Everyday dsh users who want session resume, time rewind, fork and Markdown export workflows without leaving the terminal
02如何接入 DeepSeek Harness？
前置条件
- An available terminal TTY, the official `dsh` CLI, and `pnpm` 10+ (first run auto-initializes the dsh-tui profile, which needs pnpm)
- `DEEPSEEK_API_KEY` in order to run models
安装步骤
- 01
Install the CLI and the plugin globally: `npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui`
$ npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui
- 02
Launch with `dsh-tui` — the first run auto-initializes the dsh-tui profile; alternatively run `sh install.sh` (repo root, wraps the profile install with a pnpm pre-check) or `dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui`
$ dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui
验证接入成功
作者未说明
03DSH 适配与能力边界
Pure plugin mounted on a dsh profile — `dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui`, after which `dsh-tui` is equivalent to `dsh --profile dsh-tui`; zero core changes
Terminal-native interaction
Keyboard, mouse (optional fullscreen mode) and clipboard in a terminal TTY→Streaming Markdown, structured tool cards, `/` command and `@` file completion, image attachments (PNG/JPEG/WebP/GIF as persistent blocks), history search, message selection, inline/alternate-screen rendering and `/lang` CN-EN UI switching
Ctrl+V paste reads the system clipboard via platform tools (PowerShell Get-Clipboard on Windows, osascript/pbpaste on macOS, wl-paste/xclip/xsel on Linux); clipboard bitmaps are written into the attachment storeObservable agent state
Live session/event stream from the DSH services→Real-time working status, segmented context progress bar, TPS gauge, cache hit rate, reasoning level, input/output tokens and Git/session info
Session workflow: resume / rewind / fork / export
Existing DSH sessions and the current conversation→`/resume` session browser, `/new`, `/compact`, `/export` Markdown, `/btw` side questions, model switching, and double-Esc session rewind/fork
`/model` switching forks the session (DSH has no in-place model switch); the choice is persisted to `~/.dsh-tui/model.json`, and the default preset to `~/.dsh-tui/agent-preset.json`DSH official capability wiring
A dsh profile with the DSH services and command registry→Agent presets (standard/code/minimal/cordis + liangshen), Skills, MCP servers, Goals, Todos, sub-agents and `ask_user_question` questionnaires, all connected through existing DSH services or the registry
MCP servers are mounted via `@deepseek-ai/dsh-mcp-client` and register tools as `mcp__<server>__<tool>`After startup the TUI checks npm in the background for new versions; `/update` updates the runtime in the dsh-tui profile and restarts the session
04适合谁？何时不该用？
适合
- Developers who run the official dsh CLI in a terminal and want a beautiful, observable Claude Code-style TUI instead of plain output
- Power users and operators running long DeepSeek Harness sessions who need visibility into context budget and throughput
- Everyday dsh users who want session resume, time rewind, fork and Markdown export workflows without leaving the terminal
不适合
- dsh-TUI implements no sandbox of its own — it uses the current dsh profile's file, Shell, sandbox and approval policies; on Windows there is no sandbox backend, so the composition falls back to `danger-full-access` without approval prompts. Check the profile config before launching in environments with sensitive credentials or untrusted repos.
05兼容性、维护与安全提示
- The project is marked public beta (status badge in the README); behavior and interfaces may change between releases.
- dsh-TUI implements no sandbox of its own — it uses the current dsh profile's file, Shell, sandbox and approval policies; on Windows there is no sandbox backend, so the composition falls back to `danger-full-access` without approval prompts. Check the profile config before launching in environments with sensitive credentials or untrusted repos.
- `Ctrl+V` clipboard paste depends on external tools per platform (PowerShell Get-Clipboard on Windows, osascript/pbpaste on macOS, wl-paste/xclip/xsel on Linux); paste degrades or is unavailable when the tools are missing or the session is unreachable.
MIT · actively maintained (latest release v0.8.6, 2026-08-20)
06常见问题
dsh-TUI 如何接入 DeepSeek Harness——原生插件还是 MCP？
它是挂载在 dsh profile 上的纯插件：运行 `dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui`（或封装好的 `sh install.sh`），之后 `dsh-tui` 与 `dsh --profile dsh-tui` 等价。Agent preset、Skills、MCP、Goals、Todos、子代理都通过现有 DSH 服务和命令注册表连接——TUI 是前端界面，不是 MCP 封装。
需要什么前置条件？
可用的终端 TTY、官方 `dsh` CLI，以及 `pnpm` 10+（首次运行会自动初始化 dsh-tui profile，需要 pnpm）。运行模型还需要 `DEEPSEEK_API_KEY`。
它会修改 dsh 核心吗？
不会——零核心改动，纯插件挂载。安装插件即可启用，卸载后不会留下核心补丁。
模型调用和会话数据走哪里？
TUI 只负责交互与渲染，会话日志是对话真源；模型调用、工具执行、fork/resume、compaction 和持久化继续由 DSH 服务拥有。启动后 TUI 会在后台检查 npm 新版本，发现更新时输入 `/update` 可更新 profile 中的 runtime 并重启会话。
有什么主要限制？
项目处于公测阶段。dsh-TUI 不实现独立沙箱，沿用当前 dsh profile 的文件、Shell、sandbox 与审批策略；Windows 没有对应沙箱后端，会退回到 `danger-full-access` 且不弹审批。另外 `/thinking` 开关不持久化，minimal preset 下 `/compact` 不可用，模型切换以会话 fork 续聊方式实现。
07相关的 DSH 工作流
dsh-better-sidebar
作者 omdsh-dev
开放的侧边栏底座，支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 ｜ Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-tianshu-tui
作者 huiliyi37
官方 DeepSeek Harness 的交互式终端 UI 插件：自研 ANSI 极简交互渲染、流式 Markdown/工具卡、16+ 主题、slash 命令与选择器、输入历史与本地偏好持久化、LSP 诊断、memory记忆，很丝滑的开发体验。
dsh-popout-sidebar
作者 e2mcc
将侧边栏弹出为独立浏览器标签页，可拖到另一块屏幕使用
seektty
作者 hilbert-beinghappy
面向 DeepSeek Harness 的 Claude Code 风格终端界面，支持 Windows、macOS 与 Linux，兼容透明终端、VS Code 主题和自定义配色。
08数据与来源
零核心改动，纯插件挂载。安装插件即可启用，卸载后不会留下核心补丁。
sh install.sh # 或：dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui # 之后 dsh-tui 与 dsh --profile dsh-tui 等价
- **DSH 官方能力接入**：Agent preset、Skills、MCP、Goals、Todos、子代理、 `ask_user_question` 问卷都通过现有服务或注册表连接。
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-21。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。