前言¶
如果需要在終端裏使用 DeepSeek Harness（DSH）的模型、Session、命令、審批、工具和 subagents，同時希望交互方式更接近 Claude Code，下面介紹 cogine-ai/dsh-claude-tui。
它是一個非官方的 DSH TUI 客戶端，包描述爲：
Unofficial, high-fidelity Claude Code-style TUI for DeepSeek Harness, verified against real PTY captures
先做本地安裝，再進入終端界面，之後就可以用 DSH 的真實模型和 Session 繼續工作。
這是什麼¶
dsh-claude-tui 由 cogine-ai 維護，MIT 許可證，當前包版本爲 0.1.5。
它解決的是一個比較具體的問題：把 DSH 的運行時能力放進一個終端界面裏，讓用戶在命令行中完成模型選擇、會話恢復、輸入編輯、審批確認、工具觀察和 subagents 管理。
需要注意：這是一個獨立社區項目，不與 Anthropic 或 DeepSeek 有從屬、背書或贊助關係。項目中的 “Claude Code” 用於標識版本固定的交互目標，不包含 Anthropic 源代碼。
核心功能¶
終端界面¶
TUI 提供以下界面元素：
- Claude-shaped welcome panel
- prompt
- menus
- transcript
- status rows
- approvals
- questions
- Agent states
歡迎面板會顯示實際運行時信息：
- TUI 版本
- Harness 版本
- bundled 或 system runtime
- DSH Home
- tool mode
DSH 運行時能力¶
這個 TUI 讀取並展示 DSH 側的能力，而不是把模型、effort、憑證或審批行爲硬編碼在界面裏。
已覈實的能力包括：
- DSH-owned models
- durable Sessions
- commands
- approval policies
- tools
- structured questions
- subagents
- Provider/model catalog
- advertised effort levels
- saved defaults
- masked API-key entry
- credential-source visibility
輸入與執行信息¶
輸入側支持：
- Multiline editing
- image paste
- submit or steer
- cancellation
- history search
- slash completion
- bounded
@file mentions
執行側可以看到：
- Reasoning and tool activity
- compact/expanded results
- cache hit rate
- token totals
- TTFT
- throughput
- turn outcome
Session 和 Agent 流程方面，支持：
- New or resumed Sessions
- graceful flush
- foreground/background subagents
- an active-agent roster
安裝與啓用¶
運行環境要求 Node.js 22.19+ 或 24+。
一次性啓動：
npx --yes --legacy-peer-deps dsh-claude-tui
legacy-peer-deps 是一個臨時的 npm 安裝繞過，用於處理 rc2 的 dense upstream peer graph。
如果需要固定本次發佈版本：
npx --yes --legacy-peer-deps dsh-claude-tui@0.1.5
反覆使用時，可以全局安裝：
npm install --global --legacy-peer-deps dsh-claude-tui@0.1.5
然後運行：
dshtui
典型用法¶
先啓動 TUI：
npx --yes --legacy-peer-deps dsh-claude-tui
如果需要真實模型請求，需要先爲選中的 DSH provider 提供憑證。
檢查或輸入憑證：
/provider
切換 DSH 暴露的模型和 effort levels：
/model
也可以使用快捷鍵：
Option+P
Alt+P
恢復 Session：
dshtui --resume
恢復指定 Session：
dshtui --resume <session-id>
切換 plan mode：
Shift+Tab
該快捷鍵會執行 DSH 的 /plan 或 /plan off 命令。
粘貼圖片：
Ctrl+V
它會讀取一張桌面剪貼板圖片，並添加 Claude 的 [Image #N] composer marker。
圖片提交路徑會驗證並持久化字節，寫入 rc2 的：
ctx.attachments
並走 attachment-aware 的：
execute(agent, line, images, signal)
適用場景與注意¶
適合以下場景：
- 需要把 DSH 的模型、Session、工具和審批流程放進終端
- 需要熟悉 Claude Code 風格的輸入、查看和執行反饋
- 需要在命令行中恢復 Session、查看 subagents、處理 approvals
- 希望在不脫離 DSH runtime 的前提下完成日常 agent 工作
使用前需要注意：
- 這是一個獨立社區項目，不是 Anthropic 或 DeepSeek 官方項目。
- 它以當前 DSH 進程權限運行。安裝前應檢查源碼、許可證和依賴鎖定。
- 許可證爲 MIT。
- 真實模型請求需要所選 DSH provider 的憑證。
- 本版本把 bundled runtime 固定到 DeepSeek Harness
0.1.1-rc.2，外部 runtime 要求爲>=0.1.1-rc.2 <0.1.2。 - 不要對同一個
$DSH_HOME併發運行不同 Harness 版本。 - 除非 DeepSeek Harness 文檔說明了支持的遷移路徑，不要降級 Home。
結尾¶
dsh-claude-tui 的價值，是把 DSH 的模型、Session、命令、審批、工具和 subagents 放進一個更貼近 Claude Code 的終端工作流裏。它不是官方客戶端，也不是對 Claude 雲服務的模擬，而是面向 DSH 運行時的非官方 TUI。
- GitHub：https://github.com/cogine-ai/dsh-claude-tui
- 插件目錄頁：https://www.skillhub.cn/plugins/cogine-ai/dsh-claude-tui
