前言¶
DeepSeek Harness 的插件生態允許用戶擴展 Web UI 的功能。在開發智能體或處理複雜任務時,模型啓動的後臺 Shell、子代理等進程往往在界面中不可見,難以管理和監控。這個插件通過在 Web UI 中註冊一個獨立的標籤頁,將這些後臺和前臺進程轉化爲可視化的列表,提供了實時狀態、輸出查看和進程控制的能力。
這是什麼¶
這是一個爲 DeepSeek Harness Web UI 設計的插件,由 bbboy31 維護。它的核心作用是將模型運行的命令(包括後臺和前臺)轉化爲可視化的終端視圖,提供進程管理、狀態監控和一鍵關閉的能力。
核心功能¶
該插件提供以下已覈實功能:
- 真實的標籤頁:插件通過官方的
conversation.view座位註冊,與 Chat / Trajectory 處於兄弟節點,由框架管理選擇。 - 實時標籤:標籤文本基於宿主機推送的
jobsBySession鏡像重新解析,顯示當前會話運行的後臺 Shell 和子代理數量。 - 中文意圖標題:使用本地啓發式字典將命令映射爲簡短的中文短語(例如
cd映射爲“打開文件夾”),子代理顯示爲“子代理任務”。 - 前臺命令捕獲:即使是在毫秒級完成的
pwsh/bash調用,也會被記錄下來,與後臺任務一起展示。 - 可摺疊主體:命令顯示一行截斷文本,點擊可展開查看完整內容。
- 實時輸出:展開後臺行會打開一個由私有 tee 提供的暗黑滾動回顯,支持自動跟隨最新輸出。
- 計時功能:顯示開始時間和每秒更新的經過時間(秒 -> 分秒 -> 時分)。
- 一鍵關閉:通過 Node 端的 HTTP 路由殺死作業。
安裝與啓用¶
使用官方安裝命令添加插件:
dsh plugin --profile web add github:bbboy31/dsh-terminal-tabs
安裝完成後,刷新 Web 頁面即可看到新增的 Terminals 標籤頁。
典型用法¶
打開 Terminals 標籤頁後,會看到一個管理頁面,每行代表一個正在運行的命令。該頁面包含:
* 中文目的標題。
* 可摺疊的一行命令體。
* 開始時鐘加上每秒更新的經過時間。
* 實時輸出窗格。
* 關閉按鈕。
適用場景與注意¶
該插件適合需要在 Web UI 中集中管理和監控進程的場景。
注意事項:
* 權限限制:插件以當前 dsh 進程的權限運行。
* 啓動時機:在包裝器掛載前啓動的後臺作業,沒有捕獲的輸出。
* 會話限制:持久 PTY 終端會話 (ctx.terminals) 不通過此通道;跨會話請求被拒絕。
* 卸載清理:卸載會移除路由、標籤頁和樣式表,無殘留。
* 開發提示:Loader 會按包名緩存導入的模塊。編輯 Node 端代碼需要重命名包或重啓進程;編輯客戶端端代碼只需刷新頁面。
短結尾¶
通過可視化和集中管理,該插件降低了在 Web UI 中監控和調試進程的門檻。
插件目錄:https://www.skillhub.cn/plugins/bbboy31/dsh-terminal-tabs
GitHub:https://github.com/bbboy31/dsh-terminal-tabs