在 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。 - 操作后刷新:重启或更新完成后,务必刷新页面,等待新实例接管端口。
- 权限与源码:安装插件意味着以你的权限运行第三方代码。本插件涉及停止、启动和更新服务进程,在重要环境部署前,请务必阅读源码。