前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的架構。對於習慣在終端工作的開發者，直接使用 Web 界面或基礎命令行在管理會話、切換模型和配置供應商時往往不夠便捷。dsh-native-tui 是一個社區維護的 TUI 插件，它將 DeepSeek Harness 的核心能力封裝在終端界面中，提供完整的會話、供應商、模型管理以及終端交互體驗。
安裝與啓用¶
- 確保環境已安裝 Node.js 22+ 和 npm。
- 克隆倉庫並運行安裝腳本。
git clone https://github.com/hanlinlibham/dsh-native-tui.git
cd dsh-native-tui
./install.sh
deepseek .
安裝器會固定使用 @deepseek-ai/dsh@0.1.0-rc.6，創建 abletui profile，並將啓動器安裝到 ~/.local/bin/deepseek。如果 ~/.local/bin/deepseek 已被佔用，安裝器會停止運行，不會覆蓋原文件。
核心功能¶
會話管理¶
- 新建與繼續：在當前目錄新建會話，或繼續最近一次會話。
- 歷史恢復：從列表選擇歷史會話，或按 session ID 精確恢復。
- 持久化：所有消息持久化，恢復後按原事件順序重放。
- 重命名：支持對會話進行重命名操作。
供應商管理¶
- 狀態查看：查看供應商及其 active、configured、dormant 狀態。
- 憑據錄入：在 TUI 內遮罩錄入 API Key，密鑰寫入 Harness 憑據服務，不寫入普通設置。
- 手動刷新：支持手動刷新，並響應供應商、設置和憑據變更。
模型管理¶
- 瀏覽與切換：按供應商分組瀏覽模型，並切換當前使用的模型。
- 推理強度：支持在切換模型時調整推理強度（reasoning effort）。
- 持久化設置：模型選擇結果寫入默認設置，後續請求與新會話繼續使用。
終端交互¶
- 官方標誌：使用官方 DeepSeek Harness 漸變字標。
- 工具調用：工具調用漸進展開，支持遞歸工具樹、diff、錯誤和完整結果查看。
- 佈局模式：支持全屏模式（
PgUp/PgDn）和內聯模式（終端原生滾動、選擇、複製）。 - 輸入增強：提供
/命令補全、@路徑補全、輸入歷史和!本機命令。
Harness 能力¶
- Code Mode、Workflow：支持 Code Mode 和 Workflow。
- 子代理與 Jobs：查看子代理（agents）和後臺任務（jobs）。
- HITL 交互：支持工具審批、批量提問、計劃審閱等人工確認（HITL）交互。
- 上下文管理：支持 token、上下文佔用和壓縮狀態查看。
- MCP 與附件：支持查看已加載的 MCP 服務和工具，以及附件列表和工作區文本預覽。
使用方式¶
啓動命令¶
deepseek . # 在當前目錄新建會話
deepseek --continue . # 繼續當前項目最近一次會話
deepseek --resume . # 打開歷史會話選擇器
deepseek --resume=SESSION_ID . # 精確恢復指定會話
TUI 內部命令¶
| 命令 | 作用 |
|---|---|
/new |
新建會話 |
/clear |
清空當前會話 |
/provider |
管理供應商和憑據 |
/model |
切換模型與推理強度 |
/permission |
切換權限預設 |
/context |
查看 token 與上下文明細 |
/agents |
查看子代理 |
/jobs |
查看後臺任務 |
/tools |
查看工具 |
/theme |
切換並保存配色 |
/mcp |
查看已加載的 MCP 服務和工具 |
常用快捷鍵¶
Enter：發送消息或確認選擇Alt+Enter：輸入換行Tab/↑/↓：補全與歷史選擇Shift+Tab：打開權限選擇器Esc：關閉彈窗或打斷當前輪次PgUp/PgDn：全屏模式翻閱歷史Ctrl+L：清屏Ctrl+C/Ctrl+D：打斷或退出
注意事項¶
- 社區項目：
dsh-native-tui是社區項目，不是 DeepSeek 官方發行版，也不代表 DeepSeek。 - 許可證：項目採用 MIT 許可證。
- 運行機制：插件通過公開的 Harness service、event 和 presenter 接口運行，不修改 Harness 內核。
- 源碼檢查：建議在安裝前查看源碼與許可證。
結語¶
dsh-native-tui 提供了一個在終端中完整使用 DeepSeek Harness 的方案，適合需要在命令行環境下進行高效會話管理和模型調用的開發者。
