在 DeepSeek Harness(DSH)的使用過程中,Web 界面是調試和監控的主要入口。日常開發往往需要在終端和瀏覽器之間頻繁切換,以執行重啓、停止或更新操作。wiyi/dsh-web-service-manager 插件通過設置面板提供了這些能力,使 Web 服務的管理更加直觀。
插件定位¶
該插件由開發者 wiyi 維護,屬於 admin-security 類別。它本質上是一個服務管理面板,允許用戶在不打開終端的情況下,查看服務狀態、執行版本檢查、重啓服務、停止服務以及進行一鍵更新。
安裝與啓用¶
安裝該插件需要使用 DSH 的插件管理命令,目標 profile 設定爲 web:
dsh plugin --profile web add github:wiyi/dsh-web-service-manager
安裝完成後,請重啓一次 Web 服務,然後打開 設置 → DSH Web 服務。
核心功能¶
- 狀態面板:在設置面板中可以實時查看服務的運行狀態、當前版本號、監聽端口、進程 ID (PID) 以及會話運行時長。
- 重啓服務:插件會先將替換實例放入獨立的進程會話中,再退役當前進程。這種機制確保新服務在舊進程進行優雅清理(SIGTERM → fiber dispose)時不受影響,從而存活下來。
- 停止服務:終止當前服務,同時關閉面板所在的 GUI 窗口。
- 版本檢查:將當前運行版本與 npm 倉庫進行比對,確認是否存在更新。
- 更新與重啓:通過
npx拉取最新的@deepseek-ai/dsh包,並自動重啓服務。
使用示例¶
- 若需重啓服務,可以在終端執行命令,隨後打開 設置 → DSH Web 服務 查看狀態變化。
- 執行重啓或更新操作後,等待新實例接管端口,需要手動刷新瀏覽器頁面以加載新版本。
注意事項¶
- 停止服務的影響:點擊停止會終止當前服務,並關閉你正在使用的 GUI 窗口。若需重新啓動,需在終端執行
npx @deepseek-ai/dsh web。 - 操作後刷新:重啓或更新完成後,務必刷新頁面,等待新實例接管端口。
- 權限與源碼:安裝插件意味着以你的權限運行第三方代碼。本插件涉及停止、啓動和更新服務進程,在重要環境部署前,請務必閱讀源碼。