前言¶
如果你在用 DeepSeek Harness（DSH）做智能體開發，可能會遇到這樣一個空檔：官方 dsh 自帶 web 界面和一次性的 headless 模式，但沒有一個可交互的終端界面。對長期泡在終端裏、習慣鍵盤操作，或者通過 SSH 在 tmux 裏跑 harness 的人來說，要麼開瀏覽器，要麼接受單次調用，缺一箇中間形態。
DSH 的理念是一切皆插件。dsh-tui 就是社區補上這個空檔的插件：不 fork 運行時，以可安裝插件的形式提供全屏終端 UI。下面介紹它的定位、功能、安裝方法和使用注意事項。
這是什麼¶
@nexlineai/dsh-tui 由 nexlineai 維護，MIT 許可，當前版本 0.1.1。一句話定位：DeepSeek Harness agent 運行時的全屏交互式終端 UI——把 web UI 重新做進了終端。
要強調的是，它不是模型包裝器，也不是普通的聊天 REPL。它驅動的是真正的 agent 運行時：工具調用、文件編輯、shell、子代理、會話、權限、計劃模式，全部在。實現上，它複用與 web UI 相同的 @deepseek-ai/dsh-base 核心——同一個 agent、同一套權限、同一批會話，只是呈現和交互發生在終端裏。
核心功能¶
只列已覈實的能力，按交互層次說明：
輸出與推理展示
- 即時流式輸出：回答隨模型生成逐 token 渲染。
- 推理顯示：
thinking塊以暗色斜體流式呈現，並支持每輪推理力度控制，如/model <id> high。 - Markdown 渲染：圍欄代碼塊、行內代碼、粗體、標題、列表。
工具調用可視化
工具調用以框線的 bash 塊形式呈現，帶生命週期標記（● running → ✓ done / ✖ error）和參數、結果預覽，一眼能看到命令在做什麼、跑到哪一步。
完整的 agent 能力
- agent 可讀/編輯文件、運行命令、委派子代理、執行計劃。
- 會話管理：列出並恢復任意已持久化會話（
/resume）。 - 權限模式：
read-only/workspace-write/danger-full-access，可經/permissions即時切換。 - 計劃模式：
/plan切換先規劃後執行。 - 壓縮會話：
/compact按需收縮對話。 - 軌跡查看：
/trajectory顯示整個會話的過濾事件時間線。 - 診斷：
/doctor做環境與模型目錄健康檢查。
終端交互細節
- 滾動回看：鼠標滾輪 /
PgUp/PgDn，帶↑ N指示。 - 斜槓命令 Tab 補全，
↑/↓翻提示歷史，Esc清空輸入行。 - 退出方式：
/exit、q、quit、:q或Ctrl+D。
界面佈局上，頂部顯示模型、會話 id 與耗時 / token 計數，底部狀態行顯示工作目錄、stream 開關、輪次等信息，輸入行常駐底部。
安裝與啓用¶
前提：需要先安裝官方 dsh，本插件以插件方式運行在其上。
1、安裝官方 DeepSeek Harness（一次性）：
npx @deepseek-ai/dsh web --help # 或: npm i -g @deepseek-ai/dsh
2、創建 tui profile 並添加本插件：
dsh plugin --profile tui add @nexlineai/dsh-tui
3、運行。profile 會在首次使用時初始化：
dsh --profile tui
4、配置模型密鑰。憑據來源與 harness 相同，DEEPSEEK_API_KEY 環境變量或 settings.yaml：
export DEEPSEEK_API_KEY=sk-...
環境要求：Node >= 20.19.0。
典型用法¶
切換模型與推理力度——/model 不帶參數可列出模型與推理力度檔位，當前項標記 ● active；帶參數則即時切換：
/model deepseek-v4-pro high
恢復會話——/resume 列出已持久化會話（id、標題、日期），選編號即可帶着完整歷史繼續：
/resume <n>
切換權限預設——/permissions 列出預設，帶名稱即切換：
/permissions workspace-write
控制展示行爲——顯示/隱藏思考塊、開關即時流式輸出：
/reasoning on|off
/stream on|off
其他常用命令：/help 列出全部命令，/settings 一屏彙總模型/權限/計劃/流式狀態，/version 顯示插件與運行時版本，/status 顯示會話、工作目錄與事件、輪次計數，/clear 清空對話區域，/doctor 做健康檢查。
適用場景與注意¶
適合誰：以終端爲主工作環境、偏好鍵盤優先操作流的人，以及在 SSH 會話或 tmux 這類多路複用器裏跑 harness 的場景。官方 dsh 沒有交互式終端模式，dsh-tui 以插件形式補上，不需要 fork 運行時。
幾點注意：
- 平臺僅支持 macOS 與 Linux 終端（README 平臺徽章爲 macOS | Linux），iTerm2、Terminal.app、kitty、alacritty、xterm 等已列入；Windows 終端未列出支持。
- 權限模式包含
danger-full-access（完全訪問），且可即時切換。實際使用時建議按需降檔，避免長期停在完全訪問。 - 與所有第三方 DSH 插件一樣，插件以當前
dsh進程的權限運行。安裝前建議先查看源碼與許可證（本項目爲 MIT），確認無誤再啓用。 - 該項目與 DeepSeek AI 無隸屬關係，其驅動的上游運行時同爲 MIT 許可。
- 遇到渲染問題時，按項目貢獻指南，附上你的終端類型、
$TERM，以及/version和/doctor的輸出，便於定位。
結尾¶
dsh-tui 做的事情很剋制：不重造 agent，不另起運行時，只把已有的 web UI 能力原樣搬進終端，補上官方 CLI 缺失的交互式形態。如果你日常就在終端裏工作，值得一試。
- 插件目錄頁：https://www.skillhub.cn/plugins/nexlineai/dsh-tui
- GitHub 倉庫：https://github.com/nexlineai/dsh-tui
