Preface¶

For developers already using DSH in the WebUI, actions like checking versions, performing updates, or restarting the service often require opening a separate terminal if they are not done within the page. dsh-ops-console brings this entry point into the “Settings” page of the DSH WebUI, providing common operations such as checking for updates, one-click updates, restarting, and stopping the service.

Below, we cover its positioning, installation method, typical usage, and the boundaries to be aware of before use.

What This Is¶

dsh-ops-console is a DSH WebUI plugin maintained by DonnieTangzhili. Its positioning can be summarized as: one-click update check, one-click update execution (core npm + plugin pnpm), and one-click restart.

It is licensed under the MIT License. The plugin can be viewed in the independent community directory and GitHub repository; the community directory is a standalone site with no official affiliation to DeepSeek / High-Flyer.

Core Features¶

The following clearly supported capabilities are described:

• One-click update check on the “Settings” page, comparing installed versions and latest versions of the core package and installed plugins.
• One-click update: generates an update plan and automatically restarts; update commands run after the old process exits.
• Restart DSH: precisely replays the original startup command and brings the service back up, with the page automatically reconnecting.
• Stop DSH: terminates the process without automatic restart.

Installation and Enabling¶

First, ensure the environment meets the requirements:

• DSH WebUI is installed, and dsh web can start.
• dsh and pnpm are in the PATH.

Run the following installation command:

dsh plugin --profile web add github:DonnieTangzhili/dsh-ops-console

After installation, fully exit DSH, then run it again:

dsh web

Open the WebUI and go to “Settings” in the bottom-left corner to see the “Update and Restart” page.

Typical Usage¶

Once on the “Update and Restart” page, follow these steps in order:

1. Open the WebUI and navigate to “Settings” → “Update and Restart” in the bottom-left corner.

2. Click “Check for Updates” to view version comparisons for all relevant packages.

3. If updates are available, click “One-click Update”. The page will indicate it has been scheduled, followed by an automatic restart; the update completes during the restart, and the page reconnects automatically.

4. At any time, click “Restart DSH” to quickly restart using the original startup command.

5. To stop the service, click “Stop DSH”. The process will be terminated without automatic restart; to resume, run manually:

dsh web

Configurable Options¶

The plugin provides the following configurable options:

• profile: The target profile name, automatically derived from the startup command by default.
• registries: The npm registry list used for update checks.

Updating the Plugin Itself and Uninstalling¶

To update the plugin itself:

dsh plugin --profile web update dsh-ops-console

To uninstall the plugin:

dsh plugin --profile web remove dsh-ops-console

Troubleshooting¶

If the page does not recover after “One-click Update” or “Restart DSH”, check the following log location:

%TEMP%\dsh-ops-restart-*.log

If buttons become unresponsive, you can run the fallback script in the terminal:

node tools\dsh-restart-now.js

Applicable Scenarios and Notes¶

It is suitable for developers who already use DSH WebUI and want to handle version checks, core and plugin updates, and service restarts directly from the page.

The plugin has no external dependencies, requires no build step, and is stated to be independent of the DSH version, working with rc.6 / rc.7 / rc.8 alike.

Note: The plugin runs under the privileges of the current dsh process. Before installation, it is recommended to review the source code and the MIT License; before performing updates and restarts, confirm that dsh and pnpm in the PATH, as well as the target profile, match expectations.

Related Links¶

• Directory page: https://www.skillhub.cn/plugins/DonnieTangzhili/dsh-ops-console
• GitHub: https://github.com/DonnieTangzhili/dsh-ops-console