Introduction

DSH emphasizes “everything is a plugin,” and the community directory is an independent site with no official affiliation with DeepSeek or Flower. In DSH agent development, a common issue is that the Web profile may fail to start after modifying plugins, adjusting the UI, or changing DSH control files, requiring a known state to roll back to.

Rollback Whale addresses this problem by providing an installable DSH plugin: it creates checkpoints from the current Git checkout and DSH control files and provides an independent CLI entry when the Web profile cannot start.

What is it

Rollback Whale is an installable DSH plugin positioned as an installable, out-of-process recovery plugin for DeepSeek Harness.

It provides two main entry points:

  • Adds a compact power-style menu in the sidebar.
  • Provides a full checkpoint manager in Settings.

Repository:

https://github.com/ccbili30-collab/dsh-plugin-rollback-whale

Community Directory Page:

https://www.skillhub.cn/plugins/ccbili30-collab/dsh-plugin-rollback-whale

License:

MIT

Core Capabilities

Rollback Whale only covers safe rollback at the DSH checkout and DSH control files level, not a data-erasing factory reset.

Verified capabilities include:

  • Creating immutable checkpoints from the current Git checkout and DSH control files.
  • Defaulting to store checkpoints under ~/.dsh-recovery, a location outside of the checkout and DSH_HOME.
  • Using SHA-256 to verify every payload before restore.
  • Creating an automatic rescue checkpoint, then shutting down DSH, performing an offline restore, and restarting the original launcher.
  • Providing a boot-independent rollback-whale CLI when the Web profile cannot start.
  • Explicitly excluding credentials, conversations, attachments, storage data, workspaces, and installed dependencies.

Installation and Enablement

This plugin targets the Web platform and injects the following client modules:

@deepseek-ai/dsh-client-runtime
@deepseek-ai/dsh-client-locale
@deepseek-ai/dsh-client-ui-sidebar
@deepseek-ai/dsh-client-ui-settings

First, execute the installation:

dsh plugin --profile web add github:ccbili30-collab/dsh-plugin-rollback-whale

After installation, restart the Web profile.

If DSH is started from a Git checkout, Rollback Whale will automatically find the source root. Otherwise, it needs to be set before startup:

DSH_SOURCE_HOME=/path/to/deepseek-harness

If you need to remove the plugin, execute:

dsh plugin --profile web remove dsh-plugin-rollback-whale

Typical Usage

Restores initiated by the UI are handled by the detached guardian for shutdown and restart. When manually using rollback-whale restore, you need to stop DSH first.

The following commands come from verified usage examples:

rollback-whale list

View existing checkpoints.

rollback-whale create --source /path/to/deepseek-harness --label "before plugin install"

Create a new checkpoint with a label.

rollback-whale verify CHECKPOINT_ID

Verify a specific checkpoint.

rollback-whale restore CHECKPOINT_ID --confirm CHECKPOINT_ID --offline --source /path/to/deepseek-harness

Perform an offline restore of a specific checkpoint with DSH stopped.

Applicable Scenarios and Notes

Rollback Whale is suitable for the following situations:

  • Need to rollback DSH’s Git checkout and DSH control files.
  • After modifying plugins or the UI, wanting to keep a recoverable entry point.
  • Still needing CLI-level recovery capability when the Web profile cannot start.
  • Not wanting to handle credentials, conversations, attachments, storage data, workspaces, or installed dependencies during the rollback process.

Notes before use:

  • This plugin runs with the current dsh process permissions; check the source code and license before installing.
  • Need to stop DSH before manually restore.
  • Checkpoints are stored in ~/.dsh-recovery by default; do not mistake it for a complete data backup.
  • It provides a safe rollback, not a data-erasing factory reset.
  • Runtime environment requires Node >=20 and declares packageManager pnpm@11.7.0.

Community Directory:

https://www.skillhub.cn/plugins/ccbili30-collab/dsh-plugin-rollback-whale

GitHub:

https://github.com/ccbili30-collab/dsh-plugin-rollback-whale

The value of Rollback Whale lies in adding a checkpoint entry to DSH independent of the current Web profile: it can create, verify, and perform offline restores, and continue CLI operations even when the Web profile is unavailable.