前言¶

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 操作。