前言¶

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。對於習慣在終端中工作的開發者來說，標準的 CLI 交互往往缺乏流暢的視覺反饋和操作體驗。dsh-omc-tui 是一個爲 DeepSeek Harness 設計的原生終端交互界面插件，旨在提供類似 Claude Code 的全功能 TUI 體驗。

該插件不替代 DSH 的核心能力，而是專注於終端側的渲染、輸入處理與工作流集成。

核心定位¶

• 名稱：dsh-omc-tui
• 定位：DeepSeek Harness (DSH) 原生全功能終端交互界面
• 維護者：ipromise2021
• 協議：MIT
• 當前版本：v0.2.17（適配 DSH v0.2.0-rc.2）

核心功能¶

1. 獨立視口與原生級終端體驗¶

插件採用終端備用屏幕與視口差分渲染技術。啓動後，交互在獨立的全屏視口中進行，退出時自動恢復原 Shell 畫面，並將會話內容寫回終端歷史。

• 順滑滾輪迴看與智能劃選：支持 SGR 鼠標協議，支持單擊、雙擊（中英文分詞）和三擊（整行）選區。複製時自動剝離 ANSI 樣式。
• 輸入恢復與健壯性：識別 CSI/OSC/DCS 等控制序列，對分片方向鍵、殘缺粘貼和待機後的終端模式丟失設有恢復路徑。

2. 雙模態視覺體系¶

• 原生直傳：支持在終端按 Cmd/Ctrl+V 粘貼圖片，或通過 iTerm2/Kitty 協議發送，通過 Harness 附件管道自動落盤。
• 自主 Sidecar：在純文本/代碼模式下，Agent 可自主判斷需要查看圖片，並自動觸發底層的 analyze_image 工具，在後臺拉起隔離的視覺子代理處理。

3. 沉浸式排版與代碼高亮¶

• Thinking 摺疊：流式階段顯示動畫與耗時，思考完畢自動收折。按 Ctrl+O 可原位展開思維鏈與工具組。
• 主題與高亮：內置 claude、deepseek、mono、light 四款主題，支持 Markdown、Diff 和代碼塊高亮。

4. 實時任務中心與 Plan 聯動¶

• Durable 狀態感知：全面接入 Harness 的 todo/write 持久化快照，任務狀態實時驅動面板與狀態欄。
• 會話恢復與 Jobs：支持從歷史會話恢復任務進度。運行中的 Shell 命令可用 Ctrl+B 放入後臺，或通過 /jobs 管理後臺任務。

5. 行內安全審批與原生看門狗¶

• 行級紅綠 Diff：文件修改與敏感命令執行前彈出結構化審批卡片，支持單鍵允許/拒絕與會話級權限提權。
• Danger Guard：在工具執行前攔截 rm -rf /、Fork 炸彈等危險指令，支持自定義規則。

6. 全景狀態欄 (HUD) 與效率工作流¶

• 4 行全景狀態欄：實時呈現模型、權限、Context 進度、Git 狀態與擴展信息。
• 無污染旁路提問：使用 /btw 命令在獨立臨時會話提問，不污染主會話上下文。
• 自動壓縮與回顧：達到 Context 閾值時自動觸發壓縮（/compact），支持 /recap 生成會話摘要。

安裝與啓用¶

在安裝前，請確保終端支持 ANSI 256 色且已安裝 Node.js（22.19+ 或 24.2+）。

1. 使用 DSH 的 tui profile 安裝插件：

npx --yes @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile tui add dsh-omc-tui@0.2.17

2. 啓動 TUI：

npx --yes @deepseek-ai/dsh@0.2.0-rc.2 --profile tui

典型用法¶

• 快捷鍵：
  • Enter：發送消息
  • Ctrl+O：展開/摺疊 Thinking
  • Ctrl+J：多行輸入
  • Ctrl+G：編輯 Prompt
  • @：瀏覽工作區
• 常用命令：
  • /model：選擇模型
  • /preset：切換預設
  • /vision：配置視覺模型
  • /plan：進入/退出 Plan 模式
  • /btw：旁路提問
  • /compact：壓縮上下文

適用場景與注意¶

該插件依賴 DeepSeek Harness 提供的 Agent 運行時、模型選擇、會話與權限管理。插件本身僅負責終端交互與渲染。

• 適配版本：當前版本嚴格適配 DSH v0.2.0-rc.2。
• 權限範圍：插件以當前 DSH 進程的權限運行，Agent 的安全沙箱由 DSH 控制。插件內置的 Danger Guard 提供額外的本地層攔截，但請務必檢查源碼與許可證。
• 環境要求：需要 Node.js 22.19+ 或 24.2+，支持 ANSI 256 色的終端。

總結¶

dsh-omc-tui 將 DeepSeek Harness 的能力封裝在一個高性能的終端界面中，通過原生視口、差分渲染和沉浸式排版，解決了傳統 CLI 交互體驗不足的問題。配合行內審批、全景狀態欄和雙模態視覺能力，適合需要在終端中高頻進行代碼操作與任務管理的開發者。

• 項目地址：GitHub - ipromise2021/dsh-omc-tui
• 插件目錄：SkillHub - dsh-omc-tui