DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。在開發智能體或本地服務時，我們經常需要啓動並維持後臺進程（如數據庫、後端服務）。在 DSH 的 CLI 或舊式界面中，管理這些進程通常需要多個命令組合，日誌查看也不夠直觀。dsh-process-panel 插件將進程管理能力引入 Web GUI 側欄，讓你在圖形界面中直接操作這些進程，同時爲 AI 側提供了對應的工具集。
插件簡介¶
dsh-process-panel 是一個位於 DeepSeek Harness Web GUI 側欄的進程管理插件，由用戶 ALIWUER 維護。它解決了在圖形界面中管理長時後臺進程的需求，支持啓動、停止、重啓、查看實時日誌等操作，同時也爲 AI 側提供了對應的工具鏈。
核心功能¶
- 側欄入口與狀態顯示：側欄底部有「進程任務」入口，顯示運行中的任務數。面板支持運行中、孤兒進程、已失效、已停止、已退出、啓動失敗等多種狀態。
- 進程操作：支持重啓、停止、終止（針對孤兒進程）以及清除操作。列表頂部還有「清理已結束」按鈕。
- 日誌查看：日誌支持自動跟隨底部，手動滾動即可暫停跟隨，滾回底部恢復。
- AI 工具集成：提供
sv_start、sv_stop、sv_restart、sv_logs、sv_list、sv_clear工具，AI 可直接通過自然語言控制進程。 - 共享列表：所有會話與 GUI 面板共享同一份任務列表。
安裝與啓用¶
安裝前請確保環境滿足以下依賴：
* DeepSeek Harness 0.1.1-rc.2
* Node.js ^22.19.0 || >=24.0.0
* pnpm 11
執行以下命令安裝插件：
dsh plugin --profile web add github:ALIWUER/dsh-process-panel#v0.5.0
安裝完成後，重啓 DSH Web 進程（或刷新 GUI 頁面），側欄底部（設置旁邊）會出現「進程任務」入口。
典型用法¶
GUI 操作：點擊側欄底部的「進程任務」打開面板。左側列表顯示任務狀態，右側顯示實時日誌。選中任務後，可點擊「重啓」、「停止」等按鈕。
AI 命令：
* sv_start：啓動指定任務。
* sv_restart：重啓指定任務。
* sv_stop：停止指定任務。
* sv_logs：查看指定任務的日誌。
* sv_list：列出當前所有任務。
* sv_clear：清理已結束的任務。
適用場景與注意¶
依賴要求：插件依賴 DeepSeek Harness 0.1.1-rc.2。請確保宿主版本與插件依賴版本一致，否則可能無法正常工作。
進程權限：插件以當前 DSH 進程的權限運行，進程的輸出權限和端口占用受限於 DSH 的啓動配置。
孤兒進程處理：如果 DSH 進程被強制殺掉（kill -9），殘留的孤兒進程無法讀取輸出（管道已斷開），面板只能顯示 PID 並提供終止操作。
命令執行方式：sv_start 中的 command 參數是直接通過 spawn 執行的，不經過 shell 解析。如需管道或重定向，需自行通過 bash -c '...' 包裹命令。
該插件將進程管理的命令行操作轉化爲可視化的側欄交互，並打通了 AI 工具鏈，適合需要在 DSH 環境中頻繁管理後臺服務的開發者。更多細節請查看插件目錄或 GitHub 倉庫。
