DeepSeek Harness 終端 UI 插件：dsh-terminal

DeepSeek Harness（DSH）採用「一切皆插件」的架構。在終端環境中構建交互式界面需要插件機制來掛載 UI 行。dsh-terminal 是一個爲 DSH 提供終端 UI 的插件。它通過官方 profile 插件機制掛載在 dsh-base 之上，不包含宿主運行時。

核心功能¶

該插件僅提供 TUI 插件行（tui-startup/tui-runner）和元數據。它使用 adapter 邊界解耦 UI 與 driver，並將所有上游依賴聲明爲 peerDependencies。它還實現了上游版本契約校驗（pnpm run verify:contract）和會話持久化（存儲在 $DSH_HOME/sessions）。它提供斜槓命令補全菜單（例如 /permission、/effort）。

安裝與前置條件¶

前置條件包括：官方 dsh CLI、pnpm 10+、TTY 以及 DEEPSEEK_API_KEY（環境變量或 $DSH_HOME/.credentials.yaml）。

安裝命令如下：

dsh plugin --profile dsh-terminal add dsh-terminal

注意：如果版本號不變，pnpm 會跳過 add（Already up to date）。在重新安裝之前，必須先運行 remove 再 add。

使用方式¶

• 啓動新會話：

    dsh --profile dsh-terminal

• 恢復指定會話：

    dsh --profile dsh-terminal --resume <id>

• 恢復最近創建的會話：

    dsh --profile dsh-terminal -c

• 直接運行：

    node bin/dsh-terminal.js

會話持久化存儲在 $DSH_HOME/sessions（默認爲 ~/.dsh/sessions）。輸入 / 打開斜槓命令補全菜單（例如 /permission、/effort）。使用 ↑/↓ 選擇，Tab 或 Enter 補全並執行，Esc 關閉菜單但不打斷會話。

生態與維護¶

該插件支持 dev 與 release 雙變體打包，並包含源碼級邊界檢查（pnpm run verify:boundary）。查看 GitHub 倉庫 或 插件目錄 獲取更多信息。