DeepSeek Harness(DSH)采用插件化架构,开发者可以通过插件扩展 Agent 能力。但在终端中直接与 Agent 交互时,往往缺乏可视化的上下文管理和流式反馈。dsh-tui-en 是一个为 DSH 设计的终端原生用户界面插件,旨在提供 Claude Code 风格的交互体验,同时继续使用官方的 DSH Agent、模型和工具服务。
插件定位¶
这是一个 English-only fork of dsh-TUI(作者:raktim-mondol),提供 Claude Code 风格的对话、工具、会话和全屏终端体验。它不修补 DeepSeek Harness 核心,安装插件仅启用界面,移除后无遗留修改。
核心功能¶
- 终端原生交互:流式 Markdown、结构化工具卡片(折叠显示)、命令和文件补全、
@文件引用(支持行号)、历史搜索、消息选择、内联或备选屏幕渲染、英文 UI。 - 时间轴导航:Grok 风格的回合栏,覆盖所有回合(包括折叠的回合),点击折叠的回合可展开并滚动定位。
- 可见 Agent 状态:实时活动、分段上下文使用、TPS、缓存命中率、推理努力、输入/输出 Token、Git/会话元数据。
- 完整会话工作流:支持
/resume、/new、/workspace、/compact、/export、/btw、模型切换以及双Esc回溯会话分叉。 - 官方 DSH 集成:通过现有服务连接 Agent 预设、技能、MCP、目标、待办事项、子 Agent 和
ask_user_question。 - 长会话设计:事件驱动投影、差分输出、消息虚拟化、重放合并、有界缓存,防止渲染成本和内存无限增长。
安装与启用¶
先安装官方 CLI 和插件:
npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui
安装完成后,直接运行:
dsh-tui-en
典型用法¶
插件提供以下子命令:
| 命令 | 用途 |
|---|---|
dsh-tui-en |
启动界面 |
dsh-tui-en update |
更新配置和启动器 |
dsh-tui-en doctor |
环境检查(dsh/pnpm、配置文件、API Key) |
dsh-tui-en version |
查看版本 |
dsh-tui-en help |
查看帮助 |
dsh-tui-en --resume |
恢复最近选中的会话 |
注意事项¶
- 状态:当前处于 Public Beta 阶段,适合日常使用和扩展工作。
- 依赖限制:
pnpm >= 11会阻塞带有安装脚本的依赖(如@google/genai和protobufjs),建议在pnpm-workspace.yaml中添加allowBuilds配置,或使用dsh-tui-en update自动填充。 - 权限模型:请阅读
Architecture and limitations文档,了解其权限模型和终端特定行为。 - 兼容性:不修改 DSH 核心。
总结¶
dsh-tui-en 将 DeepSeek Harness 的能力封装在了一个现代化的终端界面中,解决了长会话管理和上下文可见性的问题。适合需要在终端中长时间运行 Agent 任务的开发者。