在 Web 端進行開發調試時,終端功能往往受限於瀏覽器環境。DeepSeek Harness (DSH) 提供了插件化的擴展機制。dsh-cool-terminal 插件旨在彌補這一短板,它提供一個真實的 Shell 運行環境,並支持持久化狀態。
插件簡介¶
dsh-cool-terminal 是 DeepSeek Harness 的終端插件,由開發者 CoolTea 維護。它解決了 Web 端無法運行真實 Shell 命令的問題,允許用戶在瀏覽器中執行本地命令,並保持工作目錄、命令歷史等狀態。
核心功能¶
該插件包含以下功能:
- 按工作區分組:控制台會根據 DSH 的工作區自動分組,保持界面整潔。
- 持久化狀態:Shell 會話、滾動緩衝區和當前路徑在切換對話或頁面刷新後會保留,無需重新進入目錄。
- 獨立命令歷史:每個控制台維護獨立的命令歷史,按
↑鍵不會混入其他控制台的歷史記錄。 - 常用命令管理:支持添加、編輯、刪除以及使用自定義的常用命令。
- 內聯命令補全:輸入命令時會出現補全提示,懸停或使用方向鍵選擇後按
Enter填充命令行,不立即執行。 - 主題感知:渲染基於 DSH 主題變量,兼容大多數主題插件。
安裝與啓用¶
使用 DSH 的內置插件管理功能進行安裝。
dsh add-plugin dsh-cool-terminal
本地開發與調試¶
若需自行構建或調試插件,可按以下步驟操作:
# 克隆項目
git clone https://github.com/CoolTea001/dsh-cool-terminal.git
cd dsh-cool-terminal
# 安裝依賴
pnpm install
# 啓動本地開發構建
pnpm run dev
# 啓動 DSH 服務
dsh web
限制與注意事項¶
使用前需注意以下限制:
- 權限環境:控制台以 DSH 進程用戶的真實身份運行 Shell,不是受限的沙箱環境,應視爲本地受信任環境。
- 進程生命週期:控制台僅在 DSH 進程運行期間有效,DSH 重啓後控制台狀態會丟失。
- 固定大小:控制台大小在創建時固定,目前不支持調整窗口大小。
總結¶
該插件適合需要在 DSH 界面中保持真實 Shell 上下文、使用持久化歷史和常用命令管理的開發者。項目源碼地址:GitHub。