前言¶
对于已经在 WebUI 中使用 DSH 的开发者来说，检查版本、执行更新、重启服务这类动作如果不在页面上完成，往往需要额外打开终端处理。dsh-ops-console 把这个入口放到 DSH WebUI 的「设置」页中，提供检查更新、一键更新、重启和停止服务几个常用操作。
下面介绍它的定位、安装方式、典型用法，以及使用前需要注意的边界。
这是什么¶
dsh-ops-console 是一个 DSH WebUI 插件，由 DonnieTangzhili 维护。它的定位可以概括为：一键检查更新、一键执行更新（核心 npm + 插件 pnpm）、一键重启。
它使用 MIT 许可证。该插件可以在独立社区目录和 GitHub 仓库中查看；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
下面介绍已明确支持的能力：
- 在「设置」页一键检查更新，对比核心包与已安装插件的已安装版本和最新版本。
- 一键更新：生成更新计划并自动重启；更新命令在旧进程退出后执行。
- 重启 DSH：按原始启动命令精确重放并重新拉起，页面自动重连。
- 停止 DSH：终止进程且不自动重启。
安装与启用¶
先确认环境满足要求：
- 已安装 DSH WebUI，并且
dsh web能启动。 dsh、pnpm在 PATH 中。
执行下面的安装命令：
dsh plugin --profile web add github:DonnieTangzhili/dsh-ops-console
安装完成后，先完全退出 DSH，再重新运行：
dsh web
打开 WebUI，进入左下角「设置」，可以看到「更新与重启」页面。
典型用法¶
进入「更新与重启」页面后，按下面顺序操作：
1、打开 WebUI，进入左下角「设置」→「更新与重启」。
2、点「检查更新」，查看所有相关包的版本对比。
3、有更新时点「一键更新」。页面会提示已安排，随后自动重启；更新在重启过程中完成，页面自动重连。
4、任何时候点「重启 DSH」，可以按原始启动命令快速重启。
5、如需停止服务，点「停止 DSH」。进程会终止且不会自动重启；如需恢复，手动运行：
dsh web
可配置项¶
该插件提供以下可配置项：
profile：目标 profile 名，默认从启动命令自动推导。registries：检查更新使用的 npm registry 列表。
更新插件本身与卸载¶
更新插件本身：
dsh plugin --profile web update dsh-ops-console
卸载插件：
dsh plugin --profile web remove dsh-ops-console
故障排查¶
如果「一键更新」或「重启 DSH」后页面没有恢复，查看下面的日志位置：
%TEMP%\dsh-ops-restart-*.log
如果按钮失效，可以在终端运行兜底脚本：
node tools\dsh-restart-now.js
适用场景与注意¶
适合已经使用 DSH WebUI，并且希望从页面完成版本检查、核心与插件更新、服务重启的开发者。
该插件无外部依赖、无需构建，并说明与 DSH 版本无关，rc.6 / rc.7 / rc.8 均可。
注意：插件会在当前 dsh 进程权限下运行。安装前建议检查源码和 MIT 许可证；执行更新与重启前，确认 PATH 中的 dsh、pnpm 以及目标 profile 符合预期。
相关链接¶
- 目录页：https://www.skillhub.cn/plugins/DonnieTangzhili/dsh-ops-console
- GitHub：https://github.com/DonnieTangzhili/dsh-ops-console
