dsh-restart-backend

中文 | English

Adds a Restart Backend button to the bottom-left of the DeepSeek Harness (DSH) Web sidebar. Click it to restart the dsh web backend process in one step.

When the button is clicked, the Host side spawns a detached watchdog that waits for the current dsh web process to exit and release its port, then starts a fresh dsh web process with the same startup arguments. The old process exits gracefully through ctx.appExit.

Features

🔄 One-click restart	Restart the backend from the Web UI without opening a terminal
🧱 Watchdog restart	Detached process survives the old backend exiting, then relaunches with the same args
🔒 Loopback-safe by default	Only 127.0.0.1 / localhost can trigger a restart unless remote restart is enabled
📦 Install once, keep working	Auto-loads at DSH startup, survives restarts

Install

One-liner (recommended)

Windows (PowerShell)

irm https://raw.githubusercontent.com/woyeshishen/dsh-restart-backend/main/scripts/install.ps1 | iex

macOS / Linux

bash <(curl -fsSL https://raw.githubusercontent.com/woyeshishen/dsh-restart-backend/main/scripts/install.sh)

dsh plugin command

From npm

dsh plugin --profile web add @woyeshishen/dsh-restart-backend

From GitHub

dsh plugin --profile web add github:woyeshishen/dsh-restart-backend

After install, the plugin auto-mounts into the profile; restart DSH (or hard-refresh the page) to activate.

Usage

Once installed, open the DSH Web page. A circular ↻ Restart Backend button appears at the bottom-left of the sidebar.

Click it when you need to restart the backend. The page may disconnect briefly; after the backend comes back up, refresh the page if needed.

Configuration

The plugin exposes one optional setting:

Config	Type	Default	Description
allowRemoteRestart	boolean	false	Allow non-loopback/trusted-host sources to trigger a restart.

To enable remote restart, add a config block in your cordis.patch.yml:

- insert:
    - id: restart-backend
      name: '@woyeshishen/dsh-restart-backend'
      config:
        allowRemoteRestart: true

Requirements

• DeepSeek Harness

License

Apache-2.0