前言¶
DeepSeek Harness (DSH) 採用插件化架構，所有功能均通過插件擴展。對服務器本身進行管理（如重啓、配置保活、安裝插件）通常需要終端訪問權限。dsh-server-admin 是一個 Web 管理面板插件，由 sunnywangzi 維護，遵循 MIT 許可證。它爲 DSH 提供了可視化的服務器管理能力，可以在 Web 界面完成原本需要 SSH 的操作。
核心功能¶
運行狀態監控¶
自動刷新顯示 DSH 進程 PID/PPID、資源佔用、版本及託管模式。
在線重啓/停止¶
根據託管模式（systemd/screen）自動執行對應命令，支持 5 秒倒計時確認。
systemd 一鍵保活¶
平滑遷移到 systemd 服務，支持崩潰自動重啓、開機自啓及日誌查看。
在線安裝插件¶
在設置面板直接執行安裝命令，支持 npm 包名和 GitHub 地址。
活躍會話¶
列出運行中的對話會話，默認摺疊。
命令終端¶
以 root 權限執行服務器命令，輸出實時回顯（限制 64KB）。
安裝與啓用¶
在終端執行以下命令安裝插件：
dsh plugin --profile web add dsh-server-admin
安裝完成後需要重啓 DSH 才能生效。
使用說明¶
- 登錄 DSH Web 界面，進入設置面板。
- 在設置面板左側導航中選擇「服務器管理」。
- 在「保活」卡片啓用 systemd 保活或回退到 screen。
- 在「在線控制」卡片點擊重啓或停止按鈕（需確認）。
- 在「運行狀態」卡片查看實時監控信息。
- 在「在線安裝插件」輸入包名或 GitHub 地址進行安裝。
- 在「命令終端」執行服務器命令。
注意事項¶
- API 安全：API 僅接受迴環（127.0.0.1/localhost）同源 POST 請求，方法白名單外一律 404，請求體限制 1MB。
- 權限範圍：插件運行在 root 權限上下文，具備服務器全部權限。
- 命令風險：命令終端執行任意命令且不做沙箱限制，操作前請自行確認命令內容。
- systemd 保護：若
/etc/systemd/system/dsh.service已存在且非本插件生成，拒絕覆蓋。 - 網絡暴露：若通過反向代理將 DSH Web 暴露到公網，請確保
/server-admin/api不被代理放行。
