前言¶
DSH 的理念是「一切皆插件」：模型、會話、工具調用等能力都可以按 profile 組合。若你更想在終端裏直接和 DeepSeek Harness 的模型對話，而不是切到瀏覽器或額外 Web 界面，deepseek-harness-tui 提供了一個可選的 TUI 插件。
它是一個社區項目，MIT 許可，獨立於 DeepSeek 和 TokenDance，不是對 harness 的重新實現，而是約 800 行 UI 的薄插件。
這是什麼¶
deepseek-harness-tui 是 gxinxing/deepseek-harness-tui 倉庫提供的 DeepSeek Harness（dsh）交互式終端聊天 TUI。
它的定位是終端原生：基於 Ink 構建，把會話轉錄、工具調用、思考過程、Markdown 渲染放進終端界面。通過 cordis.patch.yml，它會把 llm-deepseek 路由到 TokenDance gateway。
核心功能¶
- 基於 Ink 的終端聊天 UI
- 底部錨定的 live transcript，尾部始終可見
- 工具調用摺疊爲 cell，顯示 active / completed / error 狀態，並截斷輸出
- 通過 OSC 11 探測終端背景，推導 message tints 和 code chips
- 用
ctrl + t摺疊 thinking/reasoning trace - 用
esc中斷正在運行的 turn - Markdown 渲染保留 headers、fenced blocks、inline code，並處理 CJK/emoji 寬度
- 通過
cordis.patch.yml將llm-deepseek路由到 TokenDance gateway
安裝與啓用¶
需要先有 Node.js ≥ 20 和 DeepSeek Harness CLI。下面先安裝 harness，再克隆並安裝插件依賴：
npm install -g @deepseek-ai/dsh
git clone https://github.com/gxinxing/deepseek-harness-tui
cd deepseek-harness-tui && pnpm install
然後把這個插件掛到 tui profile。這裏使用本地路徑，不把倉庫名直接拼成遠端插件地址：
dsh plugin --profile tui add @deepseek-ai/dsh-headless
dsh plugin --profile tui add /path/to/deepseek-harness-tui
如果 clone 目錄不在 /path/to，請把它替換爲實際路徑。
典型用法¶
先準備 TokenDance API key。可以臨時導出，也可以放到 ~/.dsh/.credentials.yaml（文件權限建議 0600）：
export TOKENDANCE_API_KEY=sk-...
啓動 TUI：
dsh --profile tui
進入 TUI 後，常用的操作是：
ctrl + t：摺疊 thinking traceesc：中斷正在運行的 turn/help：查看所有 keys 和 commands
如果只想固定一個背景色做測試，可以設置 DSH_TUI_BG：
DSH_TUI_BG=#ffffff
然後再運行：
dsh --profile tui
適用場景與注意¶
它適合需要在終端裏使用 DSH 對話、工具調用和 Markdown 輸出的開發者，尤其是希望界面貼近終端本身、避免額外 Web 外殼的場景。
使用前建議注意：
- 它是 MIT 許可的獨立社區項目，不與 DeepSeek 或 TokenDance 存在官方從屬關係。
- 插件會隨當前
dsh進程運行；安裝前建議檢查倉庫源碼、package.json和許可證。 package.json中聲明private: true，並且要求engines.node >= 20。- TokenDance 的工具調用 deltas 需要一次對
@deepseek-ai/dsh-llm-deepseek的補丁；補丁位於全局dsh安裝中，dsh升級後會丟失，需要重新應用。 - 不要把這裏的安裝命令理解爲官方應用商店入口；社區目錄是獨立站點，實際可安裝內容以倉庫和目錄頁當前說明爲準。
結尾¶
deepseek-harness-tui 的價值在於把 DSH 的終端體驗收斂到一個薄插件裏：底部錨定轉錄、工具調用摺疊、thinking 摺疊、OSC 11 背景探測和 Markdown 渲染都圍繞終端使用場景組織。若你想在自己的 dsh 安裝裏嘗試，可以從上面的安裝步驟開始，並根據本地路徑完成 profile 綁定。
GitHub 倉庫：https://github.com/gxinxing/deepseek-harness-tui
目錄頁：請以你正在使用的社區目錄頁當前鏈接爲準。
