前言¶

DSH 的理念是「一切皆插件」，社區目錄是獨立站點，不是官方應用商店。對於經常在公司跳板機、無桌面服務器、高延遲 SSH 會話裏使用 DeepSeek Harness 的開發者來說，界面不需要瀏覽器、鼠標或重量級終端框架，只要能穩定跑在支持 ANSI 的終端裏，就夠了。

dsh-ssh-tui 面向這類場景：它把模型思考、工具調用、子代理、計劃模式、會話狀態等信息放進純終端畫面中，適合慢速或遠程 SSH 使用。下面介紹它的定位、核心功能、安裝方式和需要注意的配置項。

這是什麼¶

dsh-ssh-tui 是一個 DeepSeek Harness 終端插件，維護者是 cyjyyd，許可證爲 MIT。

它的一句話定位是：給跳板機、無桌面服務器、高延遲 SSH 用的 DeepSeek Harness 終端。

它使用純終端渲染，無需瀏覽器、鼠標或重量級終端框架。對於只有鍵盤的遠程會話，它把 DSH 運行過程中的關鍵信息壓縮到終端窗口內展示，而不是要求用戶切到瀏覽器或桌面環境。

核心功能¶

思考流與回覆¶

• 模型思考流默認摺疊，並顯示思考動畫。
• 思考結束後摺疊爲「已思考」。
• 已摺疊的思考內容可以單獨展開。

工作區 Markdown¶

工作區支持 Markdown 渲染，包括：

• 多級標題
• 粗體
• 斜體
• 行內代碼
• 代碼塊
• 列表
• 引用
• 鏈接

提示詞注入卡片¶

系統提示詞、system-reminder、AGENTS.md 等注入內容會摺疊爲卡片，默認收起。

按下 Enter 可以展開看全文。

工具調用展示¶

工具調用以卡片化方式展示：

• 編輯工具展示 git 風格 diff。
• shell 命令、路徑和 JSON 參數/結果可讀化。
• 工具調用狀態可見，便於在終端裏判斷哪一步已經完成、哪一步失敗。

轉錄區回看¶

轉錄區支持：

• PgUp / PgDn
• 鼠標滾輪迴看
• 點擊思考或工具標題行展開、收起

底欄狀態¶

底欄顯示：

• 鏈路芯片
• 會話數字
• 活動詞
• 工作目錄

會話恢復¶

歷史會話啓動選擇器可以先選會話再進入。

恢復舊會話時，會切到該會話記錄的工作目錄。

終端窗口狀態¶

終端窗口標題欄會顯示運行狀態。

任務完成時，可以響終端鈴。這個終端鈴可以用 DSH_TUI_NO_BELL=1 關閉。

審批、提問、計劃與子代理¶

dsh-ssh-tui 支持以下交互和狀態展示：

• 審批
• ask_user_question
• 計劃模式
• 子代理進度
• /mode
• /model
• /resume
• /disconnect

每個子代理都是獨立可摺疊卡片，運行中帶旋轉動畫。

計劃模式、待審計劃、提問用戶也會顯示對應卡片和底部提示。

安裝與啓用¶

環境要求¶

使用前需要：

• Node.js ≥ 22.19
• DeepSeek Harness CLI
• pnpm
• 支持 ANSI 的終端

dsh-ssh-tui 必須在真實終端或 SSH 會話裏運行。無 TTY 時，TUI 會直接退出。

安裝命令¶

推薦先確認當前 DSH CLI 可用，然後使用 profile 安裝命令：

dsh plugin --profile tui add dsh-ssh-tui@latest

安裝完成後啓動：

dsh --profile tui

當前 dsh 需要帶 --profile。如果寫成不帶 profile 的插件添加命令，可能會報缺選項。

更新命令¶

更新時必須帶 @latest：

dsh plugin --profile tui add dsh-ssh-tui@latest

如果不帶 @latest，可能會沿用 pnpm-lock.yaml 中已經釘死的版本。已覈實資料中提到，常見情況是 pnpm-lock.yaml 停在 0.3.7，而 package.json 顯示版本爲 0.4.1。

卸載命令¶

卸載時使用：

dsh plugin --profile tui remove dsh-ssh-tui

典型用法¶

啓動與新建會話¶

默認啓動：

dsh --profile tui

顯式新建會話：

dsh --profile tui --new

指定模型：

dsh --profile tui --model deepseek-v4-flash

指定 provider：

dsh --profile tui --provider <id>

關閉顏色：

dsh --profile tui --no-color

恢復歷史會話¶

打開歷史會話選擇器：

dsh --profile tui --resume

恢復指定會話：

dsh --profile tui --resume <session-id>

選擇器可以先選擇歷史會話再進入。恢復舊會話時，會切到該會話記錄的工作目錄。

常用按鍵¶

• Esc：取消選擇、回底部或取消當前輪次
• Ctrl+C：中斷當前輪次；空閒狀態下連按兩次退出
• Ctrl+D：退出
• Ctrl+L：重繪整個畫面

斜槓命令¶

已覈實的斜槓命令包括：

/help
/find
/model
/provider
/language
/view
/disconnect
/submodel
/subeffort
/mode
/resume
/status
/subagents
/usage
/setup
/clear

適用場景與注意¶

適合誰¶

適合這些場景：

• 公司跳板機
• 無桌面服務器
• 高延遲 SSH
• 慢速鏈路
• 只依賴鍵盤和終端的遠程會話

如果你的工作環境需要瀏覽器、鼠標或桌面級佈局，這個插件不是主要目標。

會話鎖與 Host 進程¶

同一個 sessionId 不能同時開第二份 Host。

鎖文件位置：

$DSH_HOME/tui-locks/

顯示通道位置：

$DSH_HOME/tui-socks/

斷線策略¶

默認情況下，斷線會暫停當前輪次。

如果希望 Host 在後臺繼續跑完當前輪次，可以使用：

/disconnect continue

也可以配置：

ssh-tui.disconnect: continue

或者設置環境變量：

DSH_TUI_DISCONNECT=continue

當無顯示器且空閒超過 6 小時時，Host 會自行退出。空閒閾值由以下配置控制：

DSH_TUI_DETACHED_IDLE_MS

其他配置¶

關閉終端鈴：

DSH_TUI_NO_BELL=1

關閉啓動更新檢查：

DSH_TUI_NO_UPDATE_CHECK=1

訂閱配套¶

SuperGrok / X Premium 訂閱需要另行安裝配套插件：

dsh-llm-xai-oauth

access token 約 1 小時過期。

安裝前檢查¶

dsh-ssh-tui 會加入 DSH profile 的依賴，並隨當前 DSH 環境啓動。由於它可能執行與當前 DSH 進程權限相關的操作，安裝前應檢查源碼和 MIT 許可證，確認版本、依賴和命令行爲符合預期。

鏈接¶

目錄頁：

https://dshfind.com/zh/plugins/cyjyyd/dsh-ssh-tui

GitHub 倉庫：

https://github.com/cyjyyd/dsh-ssh-tui