前言¶
在 DSH 的插件化擴展方式裏，終端客戶端不只是包裝一個聊天窗口。很多實際任務會同時涉及長期 Assistant、多個項目會話、當前計劃、運行狀態、模型信息和上下文佔用。dsh-tui-pro 就是針對這種場景的一個多會話終端工作臺：它把 durable Assistant 和 active project sessions 放進同一個 full-screen TUI，讓會話切換、運行控制和上下文查看發生在同一塊屏幕裏。
這裏的插件目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係，也不應理解爲官方應用商店。dsh-tui-pro 屬於社區插件線索裏的終端工作臺。
這是什麼¶
dsh-tui-pro 是一個面向 DeepSeek Harness 的多會話終端工作臺。
- 倉庫與插件名：
lk251066/dsh-tui-pro - npm 包名：
@lk251066/dsh-tui - 維護者：
lk251066 - 許可證：
MIT - 定位：DSH 終端工作臺 / 客戶端
- 形態：out-of-tree dsh plugin bundle，包含
cordis.patch.ymlprofile layer，不是 DeepSeek Harness 的 fork - 基礎：基於 DeepSeek Harness 的原始 TUI 實現
一句話概括：它讓一個 durable Assistant 和若干 active project sessions 在同一個全屏 TUI 中持續可用。
核心功能¶
持久 Assistant 與項目會話¶
dsh-tui-pro 把 Assistant 作爲一個 durable session 使用，它可以跨啓動保留。項目會話則按 workspace 分組，顯示在固定 sidebar 中。
Assistant 可以管理 active project sessions，也可以讀取這些會話中已完成的 user/assistant dialogue。需要注意的是：hidden reasoning、tool traffic 和 unfinished output 不會跨會話暴露。
全屏 TUI¶
這個工作臺提供 full-screen TUI，內容包括：
- transcript
- editor
- current plan
- live status
- model
- context usage
- active sessions
這樣做的目的是把常用信息放在同一視覺區域，減少在終端輸出、狀態欄和會話列表之間來回切換。
會話管理命令¶
常用會話命令包括：
/new：在當前項目創建另一個會話/new <path>：爲另一個項目創建會話/assistant：返回固定 Assistant/switch：切換 active project session/quit：關閉當前項目會話，保留其歷史，並返回 Assistant/sessions：瀏覽完整歷史/exit：關閉 TUI
除了命令，也可以通過 Alt+Left、Alt+Right 或點擊 sidebar 切換 active project session。
交互控制¶
在運行中的 turn 裏，dsh-tui-pro 提供了幾類控制：
Enter：當 turn 正在運行時，發送 immediate steeringTab：queue 下一輪 turnEsc：在 cancellation 前恢復最近一條 queued message- 雙擊
Esc：瀏覽當前 conversation 的 checkpoints Ctrl+O：切換 tool 和 context body detailCtrl+R：展開 settled reasoning
這些控制主要服務於運行過程中的轉向、排隊、恢復和查看細節。
文件補全與圖片附件¶
輸入側支持 workspace 文件補全和剪貼板圖片附件：
@：補全 workspace filesAlt+V：當 selected model 聲明支持 image input 時，附加剪貼板圖片
剪貼板圖片附件在不同系統上有依賴：
- Windows：使用 PowerShell
- macOS：需要
pngpaste - Linux：需要
wl-paste或xclip
記憶控制¶
Assistant 默認啓用 memory。相關命令包括：
/memory/memory on/memory off
其中 /memory off 會把 memory 從該 session 的 model context 中移除，但不會刪除它。
安裝與啓用¶
前置條件¶
安裝和運行前需要滿足：
Node.js ^22.19.0 || >=24.0.0
DEEPSEEK_API_KEY
ANSI-capable terminal
DEEPSEEK_API_KEY 需要在倉庫外部配置。
使用 dsh CLI 安裝¶
先安裝插件及其 profile layer：
dsh plugin --profile tui add @lk251066/dsh-tui
經過上面的步驟後，可以從任意項目目錄啓動：
dsh --profile tui
這個包同時包含 TUI 插件和 cordis.patch.yml profile layer，不需要再安裝第二個 bundle package。
不安裝全局 dsh¶
如果沒有全局 dsh CLI，可以用 npx 走同一個 profile：
npx -y @deepseek-ai/dsh@latest plugin --profile tui add @lk251066/dsh-tui
npx -y @deepseek-ai/dsh@latest --profile tui
典型用法¶
從項目目錄啓動¶
在目標項目目錄執行：
dsh --profile tui
啓動後，可以先確認當前 Assistant 和當前項目會話是否按預期顯示，再進行後續操作。
創建與切換會話¶
常用流程如下：
1、在當前項目裏創建新會話：
/new
2、爲另一個項目路徑創建會話：
/new /path/to/project
3、回到固定 Assistant：
/assistant
4、切換 active project session：
/switch
也可以使用 Alt+Left、Alt+Right，或者直接點擊 sidebar。
關閉與退出¶
關閉當前項目會話並返回 Assistant：
/quit
/quit 會保留當前項目會話的歷史。
瀏覽完整歷史：
/sessions
關閉 TUI：
/exit
控制運行中的對話¶
如果當前 turn 還在運行：
1、用 Enter 發送 immediate steering。
2、用 Tab queue 下一條 turn。
3、用 Esc 在 cancellation 前恢復最近一條 queued message。
如果需要查看當前 conversation 的 checkpoints，可以雙擊 Esc。
查看工具與推理¶
Ctrl+O：切換 tool 和 context body detailCtrl+R：展開 settled reasoning
這兩個控制適合在工具輸出較多、推理內容較多時使用。
使用文件補全和剪貼板圖片¶
在輸入處使用 @ 補全 workspace files。
如果 selected model 聲明支持 image input，可以使用：
Alt+V
附加剪貼板中的圖片。
控制 Assistant memory¶
查看或切換 memory 狀態：
/memory
/memory on
/memory off
/memory off 隻影響該 session 的 model context，不會刪除 memory。
適用場景與注意¶
適合誰¶
dsh-tui-pro 適合以下用戶：
- 希望在一個終端裏維護多個項目會話
- 需要一個長期可用的 Assistant
- 希望同時看到 transcript、editor、current plan、live status、model 和 context usage
- 使用 DeepSeek Harness，並希望通過 DSH plugin 擴展終端體驗
終端要求¶
這個 TUI 要求 ANSI-capable terminal。
另外：
- 當終端 inner columns 低於 65 時，sidebar 會隱藏
- 建議終端高度至少爲 24 rows
權限與安全¶
dsh-tui-pro 作爲 DSH plugin 運行時，會跟隨當前 dsh 進程的權限。安裝前建議檢查源碼、依賴和許可證。該項目許可證爲 MIT。
發佈與兼容性¶
dsh-tui-pro 跟隨 developer-preview dsh release line。每個 release 會在發佈前經過 source、packed npm artifact、clean public dsh profile 和 real Linux PTY 的檢查。
跨會話可見性¶
Assistant 可以讀取 active project sessions 中已完成的 user/assistant dialogue，但 hidden reasoning、tool traffic 和 unfinished output 不會跨會話暴露。
相關鏈接¶
- GitHub：https://github.com/lk251066/dsh-tui-pro
- 目錄頁：建議以倉庫 README 提供的外部目錄入口爲準，具體以實際頁面信息爲準
