前言¶
DeepSeek Harness（dsh）的 headless 形態適合提交即跑、結果進 stdout 的一次性任務。當需要持續會話、審查工具執行、隨時插話追問時，直接使用瀏覽器會打斷終端流。dsh --profile tui 插件提供了一個終端交互客戶端，將 DeepSeek Harness 的核心能力帶入命令行。
核心定位¶
這是一個 out-of-tree profile bundle，由 TheMcSwift 維護，使用 MIT 許可證。它通過掛載 tui profile，爲 dsh 增加終端聊天界面，與官方 web 客戶端共享同一套智能體狀態、設置和插件，不經過 HTTP 中轉，無功能降級。
核心功能¶
- 渲染能力：支持流式 Markdown、推理塊分級着色、代碼高亮、TeX 數學公式、Mermaid 圖表。
- 工具執行可視化：展示工具執行卡片，包括終端卡（退出碼）、Read 高亮卡、grep/glob 分組卡、web_search 引用卡以及
run_code子調用樹。產物文件支持 OSC 8 鏈接（Cmd 點擊打開）。 - 交互方式：全鍵盤驅動，支持 Tab 焦點環與 Enter 展開/收起，支持會話級面板（goal / todo / jobs / workflow）。
- 內置文檔：安裝即自帶
/tui操作手冊技能，可通過/菜單或/skills查看。 - 兼容性：本版本對齊 dsh 0.1.2-alpha.5 的破壞性更新（session 事件序列/日誌偏移重構、settings 新註冊面、user-questions waterfall 等）。
安裝與啓用¶
前置要求：Node ≥ 22.19、pnpm。
安裝插件：
dsh plugin --profile tui add @mcswift/dsh-tui
安裝即用，不修改 dsh 本身源碼，不打依賴補丁。渲染引擎 pi 以 vendor 快照形式內嵌，版本固定爲 0.84.1。
典型用法¶
啓動新會話：
$ dsh --profile tui
恢復指定會話或最近會話：
$ dsh --profile tui --resume <id>
$ dsh --profile tui -c
切換視圖模式：
$ dsh --profile tui --fullscreen
常用的斜槓命令包括：
- 會話控制：
/new、/quit、/clone - 推理與配置：
/effort（推理強度）、/lang（語言）、/rate（評分）、/export（導出會話日誌） - 模型與權限：
/model [provider/model]、/permission [preset] - 系統查看：
/config（供應商管理）、/status、/tokens、/cost、/tui（操作手冊）
適用場景與注意¶
- 適用場景：在終端中與智能體持續對話，審查工具執行過程，需要快速切換上下文或查看會話狀態。
- 運行限制：本 TUI 只跑在
dsh安裝本機，無遠程模式。 - 渲染模式：默認 regular 渲染，主屏輸出留在終端 scrollback，應用內搜索跳轉/滾動不可用（可用終端原生 Cmd+F 搜索）。
--fullscreen切回視口模式（舊的默認模式）。 - 功能降級：瀏覽器能力（圖像/拖拽/設置表單）以終端形態降級（圖片→佔位行，設置頁→
/config）。 - 版本維護：pi 版本固定（0.84.1 vendor 快照），上游修復需手動跟進。
結尾¶
DeepSeek-TUI 是在終端環境中使用 DeepSeek Harness 的一個補充方案。它通過複用 dsh 的核心邏輯，提供了與 Web 客戶端對齊的交互體驗，適合習慣在終端工作的開發者。
