Preface¶

When debugging in the DSH Web UI, you often encounter situations where you need to restart dsh web: the page state needs to be reset, local changes need to be reloaded, or you simply want to avoid switching back to the terminal to execute commands. dsh-web-restart consolidates these operations into a single button in the UI: a circular restart button added at the bottom of the sidebar, next to Settings, which restarts the dsh web process with a single click.

What This Is¶

dsh-web-restart is a small plugin designed for the DeepSeek Harness Web UI. It adds a restart entry point at the bottom of the Web sidebar for restarting the dsh web process with one click, without a confirmation step. The plugin is installed as a bundle-layer plugin, so when it triggers a DSH restart, the button itself remains intact.

The repository address is:

https://github.com/1123762794/dsh-web-restart

The license is:

MIT

Core Features¶

• Adds a small circular restart button at the bottom of the sidebar, next to Settings.
• Clicking the button restarts the dsh web process with no confirmation step.
• Displays feedback while the restart is in progress; if a restart has not yet completed, a second click will be rejected.
• The plugin persists—as a bundle-layer plugin, it survives the DSH restarts it triggers.
• The plugin displays DSH liveness/status, polling the following endpoint:

GET /dsh-health

The polling interval is 5 seconds.

Installation and Activation¶

Installing from GitHub¶

The verified installation command uses the placeholder YOUR_OWNER, which must be replaced with the actual repository owner before execution. The repository address given in this article is:

https://github.com/1123762794/dsh-web-restart

The installation command is:

dsh plugin --profile web add github:YOUR_OWNER/dsh-web-restart

After execution, you need to restart dsh web once more to load the bundle layer.

Manually Editing the Profile File¶

If you prefer not to use the command-line installation, you can also manually edit the web profile file.

1. Add the dependency to the following file:

~/.dsh/profiles/web/package.json

{
  "dependencies": {
    "dsh-web-restart": "github:YOUR_OWNER/dsh-web-restart"
  }
}

2. Add the plugin insertion line to the following file:

~/.dsh/profiles/web/cordis.patch.yml

- insert:
    - id: dsh-web-restart
      name: dsh-web-restart

3. Install dependencies in the profile directory:

pnpm install

4. Restart dsh web once more.

Typical Usage¶

After installing and restarting dsh web, you will see the restart button at the bottom of the sidebar in the Web UI. Clicking the button will restart the dsh web process; the page typically disconnects for approximately 15–20 seconds, after which you can refresh the page to restore it. The documentation indicates that sessions are saved to disk and automatically restored.

When debugging local changes, you can check the following two files:

node --check lib/index.js
node --check lib/client.js

Components and Files¶

The verified files and their responsibilities are listed below.

lib/index.js
lib/client.js
cordis.patch.yml

• lib/index.js: Host-side file responsible for triggering the restart. The documentation indicates that the host side starts the restart script under the danger-full-access sandbox policy.
• lib/client.js: Client-side file responsible for registering the sidebar button and polling GET /dsh-health.
• cordis.patch.yml: Bundle-layer insertion line used to mount the plugin into the web profile.

Applicable Scenarios and Notes¶

Version and dependencies:

DeepSeek Harness 0.1.0-rc.6
@deepseek-ai/cordis ^4.0.1

Suitable for the following scenarios:

• Using the DeepSeek Harness web profile.
• Wanting to move the dsh web restart action into the Web UI to reduce terminal switching.
• Needing to see basic DSH liveness/status to avoid mistakenly assuming the page is still functional.

Things to note before use:

• This plugin is Windows-oriented: the restart starts dsh web through a separate hidden PowerShell process so that the script can continue running after the harness process is terminated.
• The restart script path is hardcoded to the author’s machine as:

D:\1\dsh-web-host.ps1

If your environment differs, you will need to fork the repository and adjust the path, or replace the command in lib/index.js.

• The host side starts the restart script under the danger-full-access sandbox policy. Since such operations are triggered from the dsh host side, treat it as running with the permissions available to the current dsh process; it is recommended to inspect the source code, review the license, and confirm you trust the repository before installing.
• During the restart, the page will disconnect for approximately 15–20 seconds; you will need to refresh the page afterward. Sessions are saved to disk and automatically restored.

Conclusion¶

dsh-web-restart moves the dsh web restart action from the terminal to the Web UI sidebar: trigger with a single click, receive in-progress feedback, the button remains after restart, and it can display DSH liveness/status. The license is MIT, and the repository address is:

https://github.com/1123762794/dsh-web-restart

If searching through an independent community directory, you can look it up by the plugin name dsh-web-restart; this article does not provide a verified directory page link.