在 DeepSeek Harness (DSH) 的 Web 界面开发或调试过程中,有时需要重启宿主进程(例如更新配置或修复卡顿)。手动切换到终端或使用 systemctl 往往需要中断当前操作并寻找启动窗口。dsh-restart-button 插件在设置中提供了一键重启入口,解决了这一操作断层问题。
是什么¶
这是一个客户端插件,由 AllenLogo 维护。它为 DSH 的 Web 界面设置页面的 General 区域添加了一行重启功能,允许用户通过点击按钮重启宿主进程并自动刷新页面。
核心功能¶
- 设置页新增重启行:在 General 设置中添加了重启按钮。
- 自动刷新页面:宿主进程重启后,浏览器页面会自动刷新。
- 适配不同运行环境:
- systemd 管理下:执行优雅退出,由 systemd 负责重启。
- 无监督模式:使用 detached helper 辅助重启。
- 恢复检测:通过轮询 boot id 确认宿主进程已恢复运行。
- 客户端降级:非 loopback 客户端会自动将重启行降级为只读状态。
安装与启用¶
- 进入 Web profile 目录:
cd ~/.dsh/profiles/web
- 安装插件:
pnpm install
- 重启 DSH 以使插件生效。
典型用法¶
安装完成后,在 DSH 设置 -> General 中找到重启按钮。点击按钮,宿主进程重启,页面自动刷新。
适用场景与注意¶
- 版本要求:需要 DSH >= 0.1.5-rc.1 支持,且依赖 webServer 和 connection 服务。
- 会话中断:重启会保留
~/.dsh/sessions中的会话文件,但当前正在进行的轮次和审批会被中断。
该插件通过在 Web 界面提供原生重启能力,降低了运维和调试的门槛。更多细节可参考社区目录或 GitHub 仓库。