前言¶
在本地項目裏使用 DeepSeek Harness 時，終端使用通常不只是一次問答：需要在當前目錄開始會話，繼續追問，查看工具活動、審批問題、上下文窗口占用和權限狀態，之後關掉終端還能回到同一個工作區。orriduck/dsh-tui 面向這類單人日常使用場景，把 DeepSeek Harness 的終端交互集中在一個小型 TUI 裏。
這是什麼¶
dsh-tui 是一個小型、會話感知的終端 UI，倉庫爲 orriduck/dsh-tui，由 orriduck 維護，採用 MIT 許可。它圍繞 DSH 的 profile 使用方式做首次啓動引導，創建本地 tui profile 並註冊該 bundle。憑證、模型設置、會話、工具、沙箱和審批仍由 DSH 負責。
核心功能¶
- 流式文本與 reasoning。
- 工具活動與結果。
- 交互式審批和問題。
- 持久權限徽章，支持
/permission切換；切換僅限 idle，full access 需要確認。 - 上下文窗口使用與 token 總量。
- 已安裝 DSH 版本和可選 npm update hint。
- 技能發現、直接調用可見性與 Tab 補全。
- 持久會話、當前目錄延續，以及 TUI 內的 list/new/resume 命令。
- 一條命令完成 profile bootstrap。
- 在可用時自動上報 Herdr 生命週期。
安裝與啓用¶
先確認環境滿足：
Node.js 22+
pnpm
官方 DeepSeek Harness CLI
安裝 dsh-tui：
npm install -g github:orriduck/dsh-tui
進入目標項目目錄後啓動：
cd /path/to/your/project
dsh-tui
首次啓動會創建本地 tui profile 並完成註冊。
典型用法¶
先在一個項目目錄開始新會話：
dsh-tui
之後回到同一目錄繼續最近會話：
dsh-tui -c
也可以帶初始提示開始，或恢復指定 session：
dsh-tui "fix the failing test"
dsh-tui -r <session-id>
在 TUI 內，常用命令如下：
/sessions
/resume
/resume <session-id>
/new
/permission
/skills
/sessions 列出當前目錄保存的 10 個最近會話；/resume 打開編號選擇器，/resume <session-id> 直接切換到指定會話；/new 開始新會話。/permission 通過 DSH 官方命令切換當前會話權限，僅限 idle 狀態；選擇 full access 時需要輸入 FULL ACCESS 確認。/skills 列出用戶可調用的技能，輸入 /skill-name 可直接加載，slash 命令和技能支持 Tab 補全。
需要一次性覆蓋主題時，可以這樣運行：
DSH_TUI_THEME=dark dsh-tui
權限與會話¶
默認 DSH permission preset 是 workspace-write，並帶交互式審批。dsh-tui 不自行讀取或存儲 DeepSeek key，而是使用正常的 DSH credential chain。權限切換隻影響當前會話，且必須在 idle 時執行；full access 需要人工輸入確認。DSH 繼續負責 credentials、model settings、sessions、tools、sandboxing 和 approvals。
Herdr 集成¶
當 dsh-tui 運行在 Herdr 中時，會進行自動的 Herdr lifecycle reporting。Herdr 0.8.0 尚未包含原生 dsh agent kind，因此原生 Herdr launch/control 還不在當前範圍內；仍按普通 TUI 方式啓動和輸入即可。
版本與更新¶
狀態欄會顯示已安裝的 DSH 版本，並可能給出可選的 npm update hint。DeepSeek Harness 當前仍是 developer preview；相關版本固定在 0.1.0-rc.6，以避免上游破壞性變更被靜默帶入。
適用場景與注意¶
dsh-tui 適合在本地項目目錄中做單人日常 DSH 終端使用：開始會話、繼續會話、查看權限與上下文、管理技能調用，並在可用時向 Herdr 上報生命週期。
使用前注意：
- 它需要
Node.js 22+、pnpm和官方 DeepSeek Harness CLI。 - 它會以當前 DSH 進程的權限運行，並沿用 DSH 的憑證、沙箱和審批機制。
- 安裝前應檢查源碼、依賴和 MIT 許可證。
- 當前不包含：split panes、remote persistence、graphical cross-workspace session browser、image attachments、native Herdr launch/control、Web-client parity。
結尾¶
dsh-tui 把 DeepSeek Harness 的終端會話、權限、上下文、技能和 Herdr 生命週期信息放進一個輕量的 TUI，核心是“當前目錄開始、隨時繼續、狀態可見”。倉庫地址：
https://github.com/orriduck/dsh-tui
