前言¶
在 DeepSeek Harness（DSH）裏跑 Agent，終端界面往往承擔兩件事：接收你的輸入，以及把模型回答和工具執行過程展示出來。官方與社區已有多種 TUI 實現，其中 dsh-TUI 等功能完整，但工具調用、狀態欄和 Session 信息會佔去不少屏幕空間。如果你更希望在終端裏優先閱讀模型回答，只在需要時再展開工具細節，DSH Mini TUI（npm 包名 dsh-mini-tui）是一個專門面向這一需求的終端表現層插件。
下面介紹它的定位、核心能力、安裝方式與典型用法。事實均來自項目 README 與 package.json（當前版本 0.2.1）。
這是什麼¶
DSH Mini TUI 由社區維護者 boxeryao 開發，歸類爲 DSH 客戶端插件。它不是獨立的 Agent 框架，而是 DeepSeek Harness 的終端 UI 插件：模型路由、Agent 生命週期、scoped 工具、權限審批和 Session 持久化仍由 DSH 負責；Mini TUI 只決定你在終端裏如何輸入、查看狀態和閱讀回答。
名稱裏的 Mini 指更少的界面噪聲，而不是更少的 Harness 能力。工具照常執行，成功的調用默認不顯示；失敗時保留一行短提示，完整記錄仍在 DSH Session 日誌中。
與 DSH 的關係¶
啓動 dsh --profile tui 後，DSH 運行時加載 tui profile 下的插件。Mini TUI 作爲其中的終端表現層，與 dsh-TUI 同屬社區終端界面生態，二者是獨立實現。
| DeepSeek Harness 負責 | DSH Mini TUI 負責 |
|---|---|
| 模型選擇、路由與調用 | 啓動界面、輸入框與回答渲染 |
Agent 生命週期與 standard preset |
answer-first 對話佈局與活動狀態 |
| scoped 工具、審批與取消 | /verbose、/tool N 等終端命令 |
| Session 日誌和完整執行記錄 | resize 重繪、窗口標題與 Windows 終端體驗 |
安裝或移除 Mini TUI 改變的是 DSH 的交互界面，不會替換底層 Agent，也不會削減模型、工具或 Session 能力。
核心功能¶
answer-first 對話流¶
界面設計原則是：工具照常工作，過程不必佔滿屏幕。 終端主要呈現用戶輸入和模型最終回答；成功的工具調用默認靜默，失敗時只顯示一行短提示，避免異常被悄悄吞掉。
需要排查時，可用 /verbose 切換後續調用的限長工具輸出，或用 /tool N 查看編號爲 N 的調用所保留的輸入和結果。toolDetailMaxLines 和 toolDetailMaxCharacters 默認限制爲 80 行和 8,000 字符；/tool N 在進程內存中保留最近 200 次調用詳情，更早的完整值仍在 DSH Session 日誌中。
剋制的終端視覺¶
- 啓動界面使用青藍到深藍的真彩色漸變展示
DEEPSEEK字標。 - 字標下方只顯示當前模型、工作目錄和
/help提示，不再堆疊 Session ID、平臺版本等信息。 - 輸入邊框、狀態標籤、工作路徑和思考提示共用低反差的深海色板；輸出中的文件與目錄路徑有穩定顏色標識。
- 模型推理期間顯示簡潔的
[thinking]狀態，但不把內部 reasoning 內容輸出到終端。
輸入與終端命令¶
- Enter 發送當前消息；Shift+Enter 或 Ctrl+J 插入換行。
- Ctrl+V 接收 bracketed 多行粘貼；Windows 下可用
/paste直接讀取剪貼板。 /cancel或 Ctrl+C 取消當前任務。/help顯示命令；/exit或/quit關閉會話。
Windows 右鍵菜單（可選）¶
Mini TUI 內置當前用戶級別的右鍵菜單安裝器。安裝後可在目錄空白處、目錄本身或磁盤驅動器上直接啓動：
- Open DSH TUI here — 使用標準權限模式打開當前目錄。
- Open DSH TUI full access — 以
danger-full-access模式打開；只有主動選擇該菜單時纔會啓用。
安裝和卸載只修改 HKEY_CURRENT_USER，不需要管理員權限。右鍵命令最終運行 dsh --profile tui，模型、Agent 和工具仍由 DSH 提供。
安裝與啓用¶
環境要求¶
- Node.js 22.19 或更高版本，或者 Node.js 24+
- pnpm 11+（僅源碼開發時需要）
- 已安裝 DeepSeek Harness
0.1.0-rc.6 - DSH 中已有可用的模型憑據
從 npm 安裝¶
先做插件安裝，再啓動 tui profile：
dsh plugin --profile tui add dsh-mini-tui@latest
dsh --profile tui
注意：npm 上的 deepseek-harness-tui 屬於另一個項目。本插件的正確包名是 dsh-mini-tui。
安裝 Windows 右鍵菜單¶
從 npm 安裝到默認 tui profile 後執行：
& "$HOME\.dsh\profiles\tui\node_modules\dsh-mini-tui\scripts\install-dsh-tui-context-menu.cmd"
卸載右鍵菜單：
& "$HOME\.dsh\profiles\tui\node_modules\dsh-mini-tui\scripts\uninstall-dsh-tui-context-menu.cmd"
典型用法¶
安裝完成後，在目標工作目錄啓動：
dsh --profile tui
進入會話後，直接輸入問題並按 Enter 發送。若某次工具調用失敗，終端會顯示一行短提示；需要查看後續工具輸出時，輸入 /verbose 開啓限長詳情，或用 /tool N 查看指定編號的調用輸入與結果。
從源碼目錄開發時，可先構建並本地安裝：
pnpm install
pnpm run build
pnpm test
dsh plugin --profile tui add .
dsh --profile tui
這裏的 dsh plugin --profile tui add . 用於安裝當前源碼目錄；普通用戶應優先使用 npm 快速安裝命令。
適用場景與注意¶
適合誰
- 已在 DSH 上跑 Agent，希望終端界面更剋制、回答更易連續閱讀的用戶。
- 需要在 Windows 資源管理器中右鍵啓動 DSH TUI 的開發者。
- 接受「過程默認隱藏、按需展開」交互方式，而不是即時滾動查看全部工具輸出。
需要注意
- 本倉庫只負責終端展示插件，不提供 Web 客戶端的圖形卡片、會話導航或全屏滾動區。
- 插件以當前
dsh進程的權限運行；安裝前應閱讀 源碼 與 MIT 許可證，確認符合你的安全要求。 - DSH 社區目錄 SkillHub 是獨立站點，與 DeepSeek / 幻方無官方從屬關係；插件發現與安裝以各項目 README 爲準。
結尾¶
DSH Mini TUI 把 DeepSeek Harness 的完整 Agent 與工具能力保留在運行時，只在終端層做 answer-first 的界面取捨：更少噪聲、更快讀到回答，需要時再 /verbose 或 /tool N 展開過程。
