前言¶
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不被代理放行。
