前言¶

DeepSeek Harness（DSH）把智能体能力拆成可组合的插件，模型调用、工具执行、会话持久化都由核心服务承担。但对习惯在终端里写代码的开发者来说，官方 CLI 长期缺少一套「开箱即用、信息密度够高」的全屏 TUI 前端——纯文本输出能干活，却难以一眼看清上下文占用、推理进度和 Agent 当前在做什么。

社区插件 dsh-TUI（维护者 ccch1mneyyy）正是为了补上这块空缺：它以 Cordis 插件形式挂载，不改 DSH 核心代码，卸载即可还原；界面参考 Claude Code，在终端里提供鲸鱼顶栏、实时状态行、流式思考展示、上下文进度条与 TPS 仪表。该插件曾被 DeepSeek Harness 官方公众号作为「内测用户精选插件」收录，在 SkillHub 插件库 归类为客户端，GitHub 仓库 ccch1mneyyy/dsh-TUI 截至 2026 年 8 月已获得约 2490 个 Star（MIT 许可证）。

需要说明的是：SkillHub、dshfind 等目录站是社区维护的 DSH 插件索引，与 DeepSeek / 幻方无官方从属关系；安装前仍建议自行阅读源码与许可证。

这是什么¶

dsh-TUI 是一套面向 DSH Agent 的终端交互前端（TUI），npm 包名为 @deepseek-harness-tui/dsh-tui。它通过 dsh-tui profile 叠加在 dsh-base 之上，会话日志、模型路由、工具审批等能力继续走 DSH 官方链路，TUI 只负责呈现与输入。

一句话概括：零核心改动、纯插件挂载——装上就有 Claude Code 风格的终端体验，卸掉不留补丁。

核心功能与亮点¶

界面与交互¶

• 像素鲸鱼顶栏 + 双流光大字：品牌感明确，启动时有完整首屏体验。
• 实时工作状态行：配合生态插件 dsh-working-activity，在状态栏展示 Agent 正在执行的任务阶段。
• 流式 Markdown 与结构化工具卡：模型输出、工具参数与结果以卡片形式呈现，支持 Ctrl+O 展开/收起详情。
• 思考过程流式展开：推理内容可按需查看，不必等整段结束。
• 上下文进度条 + TPS 仪表：分段显示 token 占用，流式阶段附带 tokens-per-second 指示，长会话时心里有数。
• 时间线导航：右侧 rail 覆盖全部对话轮次（含折叠轮），点击刻度可跳转；空输入时双击 Esc 可发起会话 rewind/fork，相当于「时间回溯」。
• 文件与命令补全：支持 @ 文件引用（含 @路径#L12-14 行区间）、/ 命令菜单、历史搜索（Ctrl+R）等终端原生交互。
• 中英界面：/lang 或 /settings 可切换界面语言。

会话工作流¶

插件复刻了 Claude Code 风格的一整套 slash 命令，均走 DSH 官方服务，例如：

• /new、/resume、/compact、/export：新建、恢复、压缩与导出会话；
• /model、/preset、/effort：模型与 Agent 预设、推理强度；
• /rewind、/tree、/fork：回退、查看分叉树、复制会话分支；
• /btw <问题>：侧问，不打断主回合；
• /update：检测 registry 新版本并一键升级 profile。

模型工作时还支持三种投递语义：Enter 为 steer（注入边界不中断）、Tab 为 follow-up（排队到当前回合后）、Ctrl+Enter 为 interrupt（打断并立即发送）。

性能与工程化¶

面向长会话做了差分渲染、消息虚拟化、指纹缓存与 wrap/markdown LRU，避免渲染成本随历史消息线性膨胀。仓库提供完整架构文档、CI（Node 24 + pnpm 11）与 VS Code 配套扩展 dsh-tui-vscode（Marketplace 可搜）。

安装与启用¶

前置条件¶

• 可用的终端 TTY 与官方 dsh CLI；
• pnpm 10+（首次运行 dsh-tui 时会自动初始化 profile）；
• 运行模型需配置 DEEPSEEK_API_KEY（或通过 /provider 走订阅 OAuth 等路径）。

一键安装（推荐）¶

# 全局安装 CLI 与本插件
npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui

# 启动（首次会自动初始化 dsh-tui profile）
dsh-tui

手工挂载 profile¶

若已安装 dsh，也可在仓库根目录执行 install.sh，或手动添加插件：

dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui

之后 dsh-tui 与 dsh --profile dsh-tui 等价。dsh-tui --resume 可恢复上次会话；Windows 用户可使用仓库附带的 dsh-tui.cmd。

迁移提示：旧包 dsh-cc-tui / cc-tui profile 用户请按仓库 安装与快速开始 文档迁移到新包 @deepseek-harness-tui/dsh-tui。Git URL 安装不受支持，请使用 npm registry 包。

常用 CLI 子命令¶

典型用法示例¶

启动与恢复¶

# 新会话
dsh-tui

# 恢复上次会话
dsh-tui --resume

进入 TUI 后，可直接输入自然语言任务；需要引用代码文件时输入 @ 触发补全，例如 @src/main.ts#L10-20 只附加指定行区间。

会话内常用操作¶

/compact          # 压缩上下文，适合长对话
/export           # 导出 Markdown
/model            # 切换模型（会 fork 会话续聊，历史保留）
/rewind           # 回退选择器（等同空输入双击 Esc）
/doctor           # 会话内环境自检
/update           # 检测并安装新版本后自动重启

在 VS Code 中使用¶

在 VS Code 集成终端直接运行 dsh-tui 即可；若需接近 Claude Code 官方扩展的体验，可安装 companion 扩展 dsh-tui-vscode，详见仓库 VS Code 使用指南。

适用场景与注意事项¶

适合谁用¶

• 日常在终端里驱动 DSH Agent 写代码、改项目、跑工具链的开发者；
• 熟悉 Claude Code 交互范式、希望 DSH 也有同等密度 TUI 的用户；
• 需要观察上下文占用、TPS、缓存命中率等运行指标的长会话场景。

使用前请注意¶

1. 权限边界：dsh-TUI 不实现独立沙箱，而是以当前 DSH profile 的文件、Shell、sandbox 与 approval 策略为准。插件以当前 dsh 进程权限运行，在含敏感凭证或不可信仓库的环境中启动前，请先检查 profile 配置与源码。
2. 平台差异：非 Windows 平台 profile 默认工作区约束 + 审批；Windows 暂无对应沙箱后端，组合会退回到 danger-full-access 且不弹审批。
3. 依赖外部工具：Ctrl+V 粘贴剪贴板在 Linux 上需要 wl-paste/xclip/xsel 之一；macOS 自带 Terminal.app 对部分 ⌘ 快捷键支持有限，文档建议优先使用 iTerm2、kitty、WezTerm 等。
4. 已知限制：/model 切换走会话 fork 而非原位换模；/thinking 显示开关不持久化；/update 仅 dsh --profile 启动方式可用，回合运行中会拒绝。完整列表见仓库 架构与限制。

结尾¶

如果你已经在用 DeepSeek Harness，却总觉得终端里「看不清 Agent 在干什么」，dsh-TUI 是目前社区里完成度较高、Star 数也最高的 TUI 补位方案之一：装上 npm 包、敲 dsh-tui，就能把鲸鱼顶栏、状态行、上下文条和 TPS 仪表一次性搬进来。

• 插件目录页：https://www.skillhub.cn/plugins/ccch1mneyyy/dsh-TUI
• GitHub 仓库：https://github.com/ccch1mneyyy/dsh-TUI
• 项目主页：https://dshtui.com/