前言¶

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/