Introduction

The web GUI of DSH is provided by a local dsh web process. Restarting this process is a common operation when modifying plugins, adjusting configurations, or refreshing the host. Manual restarts require confirming the current command line, port, profile, and workspace, and can easily interrupt the current session.

dsh-restart-fab is a web plugin for DSH: it adds a floating button in the bottom-right corner of the DeepSeek Harness web GUI. After confirming, it restarts the host in-place on the current page and automatically returns to the page after waiting for the new host to respond.

What is this

The basic information of this plugin is introduced below.

  • Plugin Name: dsh-restart-fab
  • Maintainer: miisaka19800
  • Platform: web
  • License: MIT
  • Function: Provides a one-click restart button in the bottom-right corner of the DeepSeek Harness web GUI, without relying on additional startup scripts.

Core Features

The following lists the capabilities of the plugin.

  • Floating button in the bottom-right corner: The first click is for confirmation, the second click triggers the restart.
  • Self-contained restart: The restarted host uses the same command line that started the current host, preserving the workspace, port, profile, and flags.
  • Cross-platform: Windows uses taskkill; macOS/Linux uses SIGTERM, followed by SIGKILL.
  • Fast restart: The old process is terminated about 1.6 seconds after confirmation, and the new host starts immediately.
  • Visual waiting: Displays a full-screen overlay, spinner, and elapsed timer during restart; the page polls the host every second and reloads automatically when the new host responds; a “refresh-now” fallback appears after 60 seconds.
  • Session recovery: DeepSeek Harness persists sessions, so sessions automatically recover after a restart.
  • Same-origin restriction: The restart route only accepts same-origin POST requests and rejects requests from other origins.

Installation & Enablement

The README provides three types of installation methods. If installing from npm, the README indicates it is for use after the package is published; it can also be installed directly from the GitHub repository or a local checkout.

Install from GitHub:

dsh plugin --profile web add github:miisaka19800/dsh-restart-fab

Install from a local directory:

dsh plugin --profile web add /path/to/dsh-restart-fab

If the package is published, the README provides:

dsh plugin --profile web add dsh-restart-fab

After installation, restart DeepSeek Harness once. The button will then be available in the web GUI.

Uninstall the plugin:

dsh plugin --profile web remove dsh-restart-fab

Typical Usage

After the above steps, the typical usage flow is as follows.

  1. Open the DSH web GUI, and a restart button appears in the bottom-right corner of the page.
  2. Click the button for the first time to enter the confirmation state.
  3. Click the button for the second time to trigger an in-place restart.
  4. The page displays a full-screen overlay and a timer, while checking every second if the new host is responding.
  5. The page reloads automatically when the new host responds; if no response is received after 60 seconds, the page provides a “refresh-now” fallback.

Restart Process & Boundaries

The restart target of this plugin is the current dsh web process. Upon confirmation, the old process is terminated, and then a new host is started using the same command line. DeepSeek Harness sessions rely on persistence for recovery rather than keeping the old process running.

It is necessary to distinguish between two scenarios:

  • Sessions can be recovered: DSH persists sessions, allowing the conversation to continue after restart.
  • Currently executing tasks will be interrupted: Restarting stops the current host process, and work running inside the process will not continue in the old process.

Applicable Scenarios & Notes

The following explains suitable use cases and items to confirm before installation.

Suitable for:

  • Developers who need to restart the host process in the DSH web profile.
  • Scenarios where you want to preserve the current port, profile, flags, and workspace without manually copying the startup command.
  • Scenarios where you only need a restart entry within the web GUI and do not require additional launchers.

Use with caution:

  • Work currently running in the host that cannot be interrupted or recovered.
  • Scenarios that require npm installation but have not confirmed whether the package has been published; in this case, use GitHub or local checkout commands.
  • The restart route only accepts same-origin POST; the plugin runs with the privileges of the current DSH process, which can terminate and restart the host process. Before installation, check the source code and confirm that it accepts the MIT license and that the runtime environment is trustworthy.

Links

  • Plugin directory page: https://www.skillhub.cn/plugins/miisaka19800/dsh-restart-fab
  • GitHub: https://github.com/miisaka19800/dsh-restart-fab