前言¶
對於已經在 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