dsh-admin: DeepSeek Harness Web GUI 管理插件

DeepSeek Harness (DSH) 是一個用於智能體開發的框架。在開發過程中，重啓服務或檢查版本更新是常見需求。下面介紹 dsh-admin，一個提供這些功能的 Web GUI 插件。

這是什麼¶

dsh-admin 是一個 DeepSeek Harness Web GUI 管理插件。由 xiaokang6 維護。它旨在解決手動重啓和自動版本檢查的問題，通過嵌入 UI 集成到 Web 界面中。

核心功能¶

手動重啓¶

在會話頭部（會話日誌旁邊）提供一個按鈕。點擊後，它會執行 systemd-run + dsh-plugin-op restart，按照本地慣例腳本停止 systemd、清理 :3080 的孤兒實例、啓動服務並進行健康檢查。

自動版本檢查¶

插件會自動比較已安裝的 @deepseek-ai/dsh 與 npm latest 標籤。檢查在加載時進行，隨後每 6 小時進行一次。面板顯示當前/最新/上次檢查的版本，以及一個狀態點（綠色=最新，黃色=有更新，紅色=檢查失敗）。

一鍵更新¶

當有新版本可用時，會出現一個藍色的“更新到最新”按鈕。它運行 npm install -g @deepseek-ai/dsh@latest（使用 --allow-scripts 以處理原生依賴），然後自動重啓服務。

嵌入式 UI¶

插件沒有獨立的頁面：
- 頂部右側的頭部按鈕 🟢 0.1.1（會話頭部工具槽）-> 點擊打開懸浮面板（z-index 9999）：版本狀態、檢查按鈕、更新按鈕（如果可用）、服務信息和重啓按鈕。
- 設置 -> DSH Admin 全頁視圖。

安裝與啓用¶

使用插件管理器安裝：

dsh plugin --profile web add xiaokang6/dsh-admin

安裝後，確保 ~/.dsh/profiles/web/cordis.patch.yml 包含 dsh-admin 插入，以便插件加載。

典型用法¶

1. 通過 UI 檢查： 點擊頭部按鈕 🟢 0.1.1 打開懸浮面板並檢查狀態。
2. 通過設置： 導航到設置 -> DSH Admin 查看完整頁面視圖。
3. 通過 API： 使用 POST /plugin/dshadmin/update 配合 body {"confirm":true} 進行更新。

適用場景與注意¶

• 依賴： 需要 DeepSeek Harness (@deepseek-ai/dsh) 通過 npm 安裝以及 Linux + systemd。
• 重啓優先級：
  1. systemd-run + dsh-plugin-op restart（隔離 cgroup）
  2. 普通 dsh-plugin-op restart
  3. systemctl --no-block restart dsh
  4. socket-pid kill + 重新啓動
• 熱重載： 客戶端更改通過 HMR 自動拾取；主機更改需要服務重啓。
• 權限： 插件以當前 dsh 進程權限運行。安裝前請檢查源碼與許可證。

總結¶

dsh-admin 通過手動重啓、自動版本檢查和一鍵更新簡化了 DSH 的維護。相關目錄和源代碼可在 GitHub 上找到。