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 任務的開發者。