前言¶

DSH 强调“一切皆插件”，社区目录是独立站点，与 DeepSeek / 幻方没有官方从属关系。在 DSH 智能体开发里，常见的问题是：修改插件、调整 UI 或变更 DSH 控制文件后，Web profile 可能无法启动，需要一个可回退的已知状态。

Rollback Whale 针对这个问题，提供一个可单独安装的 DSH 插件：从当前 Git checkout 和 DSH 控制文件创建检查点，并在 Web profile 无法启动时提供独立的 CLI 入口。

这是什么¶

Rollback Whale 是一个可单独安装的 DSH 插件，定位为 an installable, out-of-process recovery plugin for DeepSeek Harness。

它提供两个主要入口：

• 在 sidebar 中增加一个紧凑的 power-style 菜单。
• 在 Settings 中提供完整的 checkpoint manager。

仓库地址：

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

社区目录页：

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

许可证：

MIT

核心能力¶

Rollback Whale 只覆盖 DSH checkout 和 DSH 控制文件层面的安全回滚，不是数据擦除式 factory reset。

已核实的能力如下：

• 从当前 Git checkout 和 DSH control files 创建 immutable checkpoints。
• 默认把 checkpoints 存储在 ~/.dsh-recovery 下，该位置在 checkout 和 DSH_HOME 之外。
• 在 restore 前使用 SHA-256 校验每一个 payload。
• 创建 automatic rescue checkpoint，然后关闭 DSH、离线恢复，并重启原来的 launcher。
• 当 Web profile 无法启动时，提供 boot-independent 的 rollback-whale CLI。
• 明确排除 credentials、conversations、attachments、storage data、workspaces 和 installed dependencies。

安装与启用¶

该插件面向 Web platform，并注入以下 client 模块：

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

先执行安装：

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

安装完成后，重启 Web profile。

如果 DSH 是从 Git checkout 启动的，Rollback Whale 会自动找到 source root。否则，需要在启动前设置：

DSH_SOURCE_HOME=/path/to/deepseek-harness

如果需要移除插件，执行：

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

典型用法¶

UI 发起的 restore 会由 detached guardian 处理 shutdown 和 restart。手动使用 rollback-whale restore 时，需要先停止 DSH。

下面的命令来自已核实的使用示例：

rollback-whale list

查看已有 checkpoints。

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

创建一个新的 checkpoint，并打上 label。

rollback-whale verify CHECKPOINT_ID

校验指定 checkpoint。

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

在 DSH 已停止的前提下，离线恢复指定 checkpoint。

适用场景与注意¶

Rollback Whale 适合以下情况：

• 需要回滚 DSH 的 Git checkout 和 DSH control files。
• 修改插件或 UI 后，希望保留一个可恢复的入口。
• Web profile 无法启动时，仍需要 CLI 级别的恢复能力。
• 不希望在回滚过程中处理 credentials、conversations、attachments、storage data、workspaces 或 installed dependencies。

使用前注意：

• 该插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 手动 restore 前需要先停止 DSH。
• checkpoints 默认存储在 ~/.dsh-recovery，不要把它误当作完整数据备份。
• 它提供的是 safe rollback，不是 data-erasing factory reset。
• 运行环境要求 Node >=20，并声明 packageManager pnpm@11.7.0。

链接¶

社区目录：

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

GitHub：

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

Rollback Whale 的价值在于给 DSH 增加一个独立于当前 Web profile 的检查点入口：可以创建、校验、离线恢复，并在 Web profile 不可用时继续通过 CLI 操作。