前言¶
DeepSeek Harness (DSH) 採用插件化架構，旨在將所有功能封裝爲插件。現有的 Web 界面需要瀏覽器和手動選擇工作區，對於習慣終端操作的開發者，這種交互方式不夠直接。DSH 社區提供了多種 TUI 插件，其中 dsh-minitui 是一款輕量級的前端實現，旨在提供以鍵盤交互爲主的純文本界面。
插件定位¶
該項目由 AncientMoon114 維護，是一個專爲 DeepSeek Harness 設計的 TUI 前端插件。與依賴 Web 界面的方式不同，它完全摒棄了鼠標交互，通過鍵盤快捷鍵直接與 Agent 進行對話。界面設計參考了 OpenCode，保持乾淨簡潔，主要服務於後端代碼工作者。
核心功能¶
界面與交互¶
- 純鍵盤操作：界面中沒有任何鼠標可點擊區域，僅保留輸入框和對話監控區。
- 快捷鍵：
- 發送消息：
Alt + Enter - 換行輸入：
Enter - 文本補全：
Tab - 複製：
Ctrl + Shift + C - 粘貼：
Ctrl + Shift + V - 退出：
Ctrl + C
命令支持¶
- /session：用於切換或創建當前工作區目錄下的會話。注意：該命令不支持跨目錄切換，需先退出 TUI 切換目錄後再打開。
- /model：用於切換模型和推理等級。目前僅支持 Deepseek 本家模型，不支持外接模型。
配置與格式¶
- Markdown 支持：支持 Markdown 格式渲染。
- 自定義配置：首次運行會在插件根目錄生成
userconfig.json，可用於配置顏色和默認設置。若填寫錯誤值可能導致插件無法啓動。
安裝與啓用¶
由於該插件尚未發佈至 npm 倉庫，目前需通過源碼安裝。開發環境爲 Ubuntu 22.04。
- 克隆倉庫並安裝依賴：
git clone https://github.com/AncientMoon114/dsh-minitui
cd ./dsh-minitui-0.1.0/
npm install
- 編譯 TypeScript：
npx tsc
- 添加到 DSH 插件配置：
dsh plugin --profile minitui add link://這裏需要填入minitui的絕對路徑
典型用法¶
在項目目錄下打開 TUI 界面：
dsh --profile minitui
爲方便調用，建議在 ~/.bashrc 中添加別名：
alias dsh-minitui='dsh --profile minitui'
注意事項¶
- 環境依賴：依賴
neo-blessed、marked、marked-terminal、streammark等庫。其中streammark庫已手動打補丁，後續更新或全局環境變量更新可能導致衝突。 - 操作系統兼容性：開發環境爲 Ubuntu 22.04。Windows 用戶建議使用 WSL2，可能存在未知 bug。
- 功能限制：
/model命令目前僅支持 Deepseek 本家模型；/session僅限當前工作區目錄。
總結¶
dsh-minitui 提供了一種去瀏覽器化的 DSH 使用方式，專注於鍵盤交互和 Markdown 輸入。對於追求終端效率和簡潔界面的開發者，它是一個可行的替代方案。
