ccch1mneyyy/dsh-TUI

dsh‑TUI – DeepSeek Harness 的 Claude 風終端 UI

是什麼

• 一個插件，為官方 dsh CLI（DeepSeek Harness）添加一個豐富、具圖形感的文本使用者介面（TUI）。它不修改核心引擎，僅在現有 DSH 服務之上疊加一個 UI 層。
• UI 模仿 Claude Code 的外觀：像素藝術鯨魚橫幅、發光標題、即時狀態欄、進度條、TPS（每秒令牌數）儀表、支援串流 Markdown、工具卡片與影像附件。

為何重要

• 讓長時間執行的 AI 代理會話可在終端中使用——你可以即時查看模型令牌數、快取命中率與目前「代理」狀態。
• 提供完整的指令集（/new、/resume、/model、/audit 等），與 DeepSeek Harness 的功能一致，包含工具執行、子代理、審核流程等，全部在同個視窗內完成。
• 面向低資源環境設計：虛擬捲動確保即使在極長對話中，渲染成本也維持在 O(可見視窗) 等級。

主要功能（如 README 所述）

功能	你將獲得
原生終端互動	串流 Markdown、結構化工具卡片、指令/檔案補全（含 @-檔案引用）、影像附件處理、歷史搜尋、內聯/備用螢幕渲染、語言切換（/lang）。
可觀測的代理狀態	即時工作狀態列、上下文段進度條、TPS 儀表、快取命中率、推理層級、令牌數、Git/會話資訊。
完整的會話工作流程	新建/恢復/壓縮/匯出會話指令，側邊問題（/btw）、模型切換、雙 Esc 時間回溯/分叉。
DeepSeek Harness 集成	存取代理預設、技能、MCP（遠端工具伺服器）、目標、待辦事項、子代理，以及 ask_user_question 問卷流程。
長會話設計	事件驅動投影、基於差異的終端輸出、訊息虛擬化、有界快取，防止記憶體爆炸。
主題系統	自動偵測終端背景，內建亮色/暗色/ANSI 主題，以及放置於 ~/.dsh‑tui/themes/ 中的自訂 JSON 主題。
鍵盤與滑鼠快捷鍵	完整的熱鍵清單（Enter、Ctrl‑C、Esc、Ctrl‑O、Ctrl‑R 等）以及滑鼠拖曳複製、捲動、點擊選擇功能。
插件生態系統	擴充開發文件、社群倉儲（dsh‑tui‑ecosystem）與範本啟動器。

安裝與快速入門

# 安裝核心 DSH CLI 和 TUI 插件（全域）
npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui

# 啟動 – 首次執行會自動建立設定檔
dsh-tui

• 需要 TTY 終端、pnpm 10+，以及用於模型呼叫的 DEEPSEEK_API_KEY。
• Windows 使用者可執行封裝的 dsh-tui.cmd。
• 命令 dsh-tui --resume 可恢復上一次會話；/update 可就地更新插件。

內部運作原理

1. dsh 加載一個 設定檔，鏈式呼叫基礎 DSH 實作 → dsh‑TUI Cordis 补丁 → 選定的代理預設。
2. 會話事件透過程序內事件流從 DSH 後端流向 TUI。
3. UI 使用移植的 Ink/Yoga 渲染器，透過增量差異更新與佈局虛擬化，保持效能穩定。
4. 所有持久化（聊天記錄、工具結果等）仍由 DSH 服務負責；TUI 僅負責狀態顯示。

典型工作流程

• 啟動 dsh-tui → 觀察鯨魚橫幅與狀態列。
• 輸入提示（Enter 發送，Shift-Enter 換行）。模型串流回傳 Markdown；工具卡片內聯顯示。
• 使用 /model 選擇不同模型，/preset 切換代理模式，或 /new 開始全新對話。
• 在空行上按雙 Esc 可 回溯 會話（從之前某點分叉出新分支）。
• 使用 /export 匯出整個對話（Markdown）或使用 / 搜尋歷史。

社群與支援

• 在 DeepSeek Harness 公測 WeChat 頻道中正式推薦。
• 提供專用 QQ 群（572549239）與 WeChat 群組，用於快速協助。
• 文件涵蓋安裝、設定、主題自訂、互動細節、架構、VS Code 集成、插件開發與貢獻指南。

許可證

• MIT – 可自由使用、修改與再分發。

---

以上所有資訊均直接取自倉儲的 README；未推斷任何額外功能。