前言¶

DeepSeek Harness（dsh）默認給人看的是 Web UI：本機跑起來以後，瀏覽器打開 http://127.0.0.1:3080 就能對話、調工具、看會話。官方倉庫和文檔把這套框架的核心理念寫成「一切皆插件」——模型、工具、技能、會話、沙箱、存儲、循環、調度，以及界面本身，都可以在配置層替換，不必改核心源碼。

對習慣在 SSH、tmux 或純終端裏幹活的人來說，開瀏覽器並不是最短路徑。社區裏因此出現了多款終端界面插件。本文介紹的是目錄頁 slug 爲 dsh-tui-dsh-tui 的這一份：維護者組織 dsh-tui，倉庫 dsh-tui/dsh-tui，npm 包名 @dsh-tui/dsh-tui。它把 Claude Code / Codex 那種對話式終端界面，做成掛在官方 @deepseek-ai/dsh-base 之上的樹外 bundle。

同一份社區目錄裏還有另一款更常見、星標更高的 dsh-TUI（目錄頁是 /plugins/dsh-tui/，維護者不同）。兩者名字接近，安裝命令和能力邊界並不相同。下文只按 dsh-tui/dsh-tui 的目錄頁、GitHub README、package.json 和 LICENSE 覈實後的內容來寫。

社區插件目錄 deepseek-harness-plugin.com 是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係，不能當成官方應用商店。

這是什麼¶

dsh-tui 是一款界面增強插件，由 GitHub 組織 dsh-tui 維護。目錄頁給出的定位是：Claude Code 風格的 DeepSeek Harness 終端 UI，以獨立 dsh 插件包提供。

倉庫 README 寫得更具體：它是 DeepSeek Harness 智能體的交互式終端入口，基於 @earendil-works/pi-tui 構建，組合在官方 @deepseek-ai/dsh-base 之上。shell、文件系統工具、技能、子代理、工作流、沙箱審批，走的仍是官方 web 界面那一套插件生態，不 fork 核心。

來源也寫在倉庫裏。LICENSE 與 README 都說明：TUI 實現恢復自 DeepSeek Harness 倉庫歷史中的 packages/ui/tui（上游在 commit 10bb9cbf4a 移除），再移植到已發佈的 rc API。LICENSE 同時保留 DeepSeek（原始 @deepseek-ai/dsh-tui）與 OpenGuardrails 在 2026 年的版權聲明。package.json 當前版本是 0.1.2，許可證字段爲 MIT。目錄頁和 GitHub 的 SPDX 顯示爲 NOASSERTION，是識別結果與倉庫自述不一致，安裝前仍應直接讀 LICENSE。

截至本文覈對時（2026-08-18），目錄頁與 GitHub 倉庫均顯示 18 顆星；主要語言是 TypeScript；目錄收錄日期爲 2026-08-15。

核心功能¶

倉庫 README 列出的能力可以分成界面、交互和會話三塊。目錄頁「更多介紹」與其中斜槓命令、審批對話框兩項一致。

流式輸出與工具卡片¶

模型正文和思考過程按 Markdown 流式渲染。工具調用會做成卡片，渲染意圖分三種：terminal、diff、generic。Ctrl+O 在預覽、展開、隱藏三檔之間循環。

審批對話框和 ask_user_question 也做在終端裏，plan 模式評審包含在內。也就是說，智能體要跑命令、改文件或向你提問時，不必切回 Web UI。

引用、補全與斜槓命令¶

輸入框支持 @文件 路徑自動補全，以及 @session 會話引用卡片。斜槓命令方面，倉庫和目錄頁都列出：

• /model：切換模型，並可選推理力度
• /resume：恢復會話
• /compact：壓縮上下文
• /details
• /help

其他插件註冊進當前 profile 的命令，也會出現在這套界面裏。

狀態欄與主題¶

界面常駐 todo 面板，狀態欄顯示 token 用量和上下文壓力，會話有標題。主題可配置；是否啓用真彩色，按環境變量 COLORTERM 檢測。

bundle 自帶的 cordis.patch.yml 裏，默認 agent 使用 deepseek-official 提供方、deepseek-v4-pro 模型，並把 thinking 打開、reasoningEffort 設爲 max。密鑰和端點不寫死在這份補丁裏，運行時從 llm-deepseek 設置、憑據存儲和 DEEPSEEK_BASE_URL 解析。

安裝與啓用¶

目錄頁給出的安裝命令¶

社區目錄要求在 DeepSeek Harness 終端裏運行：

dsh plugin add github:dsh-tui/dsh-tui

需要可復現安裝時，按目錄頁說明固定 commit 哈希：

dsh plugin add github:dsh-tui/dsh-tui#commit

把 #commit 換成實際哈希。插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。裝之前應檢查源碼倉庫和許可證。

倉庫推薦的 profile 安裝¶

README 把常用路徑寫成：先裝 dsh CLI，再把插件加進名爲 tui 的 profile。環境要求是 Node ^22.19 || >=24，CLI 安裝命令爲：

npm i -g @deepseek-ai/dsh@next

然後：

dsh plugin --profile tui add @dsh-tui/dsh-tui
dsh --profile tui
dsh --profile tui --resume <session-id>

第一條把 npm 包 @dsh-tui/dsh-tui 裝進 tui profile；第二條在當前目錄開新會話；第三條按會話 id 恢復已持久化的會話。

若要跟蹤 GitHub 倉庫而不是 npm 發佈版，README 寫的是 add github:dsh-tui/dsh-tui。git 安裝會走 prepare 腳本構建，pnpm 默認攔截構建腳本。如果 add 失敗，按它打印的鍵名，在 ~/.dsh/profiles/tui/pnpm-workspace.yaml 裏放行後再跑一次：

allowBuilds:
  "@dsh-tui/dsh-tui": true

API 密鑰放在環境變量 DEEPSEEK_API_KEY，也可以寫在啓動目錄或 $DSH_HOME 下的 .env。

典型用法¶

在當前目錄開一輪對話¶

裝好 CLI 和插件、設好密鑰之後，進入要處理的項目目錄：

dsh --profile tui

之後按終端裏的對話、工具卡片和審批提示操作即可。倉庫說明：真實模型回合需要可達的 DeepSeek 兼容端點；組合、渲染、審批、/resume 這些發生在發請求之前的步驟，沒有 key 也能走通。

接本地或自部署端點¶

README 給出三種不改插件代碼的接法。

1. 環境變量，把基址指到本地 OpenAI 兼容接口：

export DEEPSEEK_BASE_URL=http://localhost:8000/v1
export DEEPSEEK_API_KEY=...

2. 寫 $DSH_HOME/settings.yaml，這項支持熱加載：

llm-deepseek:
  baseURL: http://localhost:8000/v1

3. 走 vLLM、SGLang 這類 OpenAI 兼容網關時，在 profile 補丁 $DSH_HOME/profiles/tui/cordis.patch.yml 裏聲明 llm-pi-ai 路由，再把默認模型指過去。具體字段以 dsh 的 providers 指南爲準，本文不展開未在本倉庫覈對過的鍵名。

開發構建（可選）¶

如果要改這份插件本身，倉庫給出的命令是：

pnpm install
pnpm build

pnpm install 會應用 patches/ 裏針對 pi-tui 的補丁。pi-tui 釘在 0.80.7，補丁打的是編輯器提示符前綴；構建結果打進 lib/，倉庫之外的安裝方拿不到未打補丁的副本。

適用場景與注意事項¶

適合已經在用 DeepSeek Harness、又希望把交互留在終端裏的人：SSH 遠程、tmux 分屏、不想開瀏覽器，或者要和本地 / 自部署的 DeepSeek 兼容端點一起用。它解決的是「界面怎麼畫、輸入怎麼收」，不是另做一套 agent 運行時。模型路由、工具執行、會話持久化仍由 dsh-base 和官方服務負責。

使用前注意下面幾條，都來自目錄頁或倉庫原文，不是使用建議式的發揮。

1. 權限與許可證。 插件以當前 dsh 進程權限運行，安裝可能執行代碼。裝之前看源碼和 LICENSE。倉庫自述爲 MIT，目錄頁 SPDX 爲 NOASSERTION，以你讀到的 LICENSE 爲準。
2. 依賴的是預發佈 rc。 README 寫明：項目對着 @deepseek-ai/dsh 的 pre-release rc 線開發，上游穩定前隨時可能不兼容；peer 依賴釘在驗證過的 rc（package.json 裏多數字段是 ^0.1.0-rc.6）。DeepSeek Harness 本身也處於開發者預覽，官方 README 同樣提示未來會有破壞性變更。
3. 測試套件尚未可跑。 倉庫裏的 tests/ 是移植前留下的，當前不能運行。不要把它當成已經有完整迴歸覆蓋的發行版。
4. 運行環境。 Node 需要 ^22.19 || >=24。真彩色依賴 COLORTERM。沒有可達的 DeepSeek 兼容端點，發不出真正的模型回合。
5. 同名插件。 目錄「相關插件」裏列出的 dsh-TUI（/plugins/dsh-tui/）是另一份項目。安裝命令、維護者和功能清單都不要混用。

小結¶

dsh-tui 把官方曾經放在 packages/ui/tui 裏的終端界面，做成可以獨立安裝的 dsh bundle：疊在 @deepseek-ai/dsh-base 上，用 Claude Code 風格的 TUI 驅動同一套工具、技能和審批。目錄安裝命令是 dsh plugin add github:dsh-tui/dsh-tui；日常更常見的是 dsh plugin --profile tui add @dsh-tui/dsh-tui，再用 dsh --profile tui 進入當前目錄。

它仍在對着 dsh 的 rc 線迭代，星標也不高。若終端是你的主界面，可以按上面的命令裝一份，先覈對源碼和許可證，再決定是否固定 commit。

目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-tui-dsh-tui/

GitHub：https://github.com/dsh-tui/dsh-tui