前言¶
DeepSeek Harness (DSH) 採用插件化架構。除了基於 Web 的 UI 外,開發者需要一個原生的終端界面。dsh-tui-app 提供了一個基於 Readline 的交互式終端配置文件包,保留 DSH 的核心服務(模型、Agent 預設、會話等)並覆蓋終端聊天表面。
是什麼¶
這是一個獨立的輕量級實現,用於在終端中運行 DeepSeek Harness。它保留模型、Agent 預設、會話、權限、命令和工具服務,並提供終端聊天界面。
核心功能¶
- 流式輸出:支持流式輸出助手文本、推理過程、工具調用結果以及 Codex 風格的佔位符。
- 多媒體輸入:原生支持 rc.1 圖片輸入(通過
--image/-i啓動參數或/image命令)和 MP4 視頻輸入(通過--video/-v啓動參數或/video命令)。在 macOS 上,使用 Control+V 可粘貼剪貼板圖片。 - TTY 組件:提供帶邊框的終端編寫器,支持命令補全、歷史記錄、窗口大小調整重排,以及管道環境下的回退機制。
- 會話管理:通過 DSH 的持久化會話存儲管理會話(新建、恢復、列表、刪除)。
- 預設與選擇器:支持空白會話 Agent 預設選擇、模型和推理策略選擇器,以及通過 Shift+Tab 循環切換權限預設。
- 命令與 Skill:集成 DSH 斜槓命令註冊表和用戶可調用 Skill。
- 審計集成:可選的審計集成功能,提供補救操作。
安裝與啓用¶
該插件需要 DeepSeek Harness 0.1.3-alpha.2 或兼容版本。
dsh plugin --profile tui add github:yhfgyyf/dsh-tui-app
dsh --profile tui
典型用法¶
dsh --profile tui --help
dsh --profile tui --preset minimal
dsh --profile tui -i diagram.png
dsh --profile tui --resume <session-id>
適用場景與注意¶
- 版本要求:必須安裝 DSH 0.1.3-alpha.2 或更高版本。
- 安全邊界:
!命令是一個顯式的人工操作 Shell 逃逸,直接在當前工作區啓動用戶 Shell,不經過 Agent 工具沙箱或審批策略。請僅運行信任的命令。 - 權限範圍:該插件以 DSH 進程的權限運行。
短結尾¶
這是一個獨立的輕量級實現。更多詳情見:GitHub