xiaoyuyu6420/dsh-backup 预览 preview

xiaoyuyu6420/dsh-backup

使用一个命令备份DeepSeek Harness用户数据:/backup,支持定时自动备份、sha256校验和以及轮转。一键备份DSH数据,支持定时自动备份。

Project Overview项目介绍

dsh-backup is a native plugin built exclusively for DeepSeek Harness (DSH), designed to back up all DSH working data stored in the local ~/.dsh directory. To install the plugin, you can run the DSH CLI command dsh plugin --profile web add @xiaoyuyu6420/dsh-backup, then restart the DSH web instance to activate it. After activation, you can create a timestamped backup with SHA256 integrity check via the /backup slash command, or access a visual management panel from DSH’s settings menu to handle all backup-related operations. All configuration changes take effect immediately without requiring another restart of DSH.

This plugin is built for every DSH user, regardless of skill level, to avoid permanent data loss from common mishaps like accidental deletion, corrupted configuration after failed upgrades, or moving to a new machine. It automatically creates a snapshot before any DSH version upgrade, so you can roll back easily if the new version breaks your environment. It also includes a migration pre-check tool that scans your existing session logs to flag any compatibility issues before you upgrade, which helps you avoid unexpected outages after the update completes.

dsh-backup works across macOS, Linux, and Windows 10 or newer, and requires DSH version 0.1.1-rc.2 or higher to run correctly. By default, it stores all backup archives in the ~/Desktop/dsh-backups/ directory, and you can change the storage location and the maximum number of retained backups directly from the settings panel. It automatically redacts API keys and other sensitive credentials from backup archives, storing only plaintext credentials locally on your machine, and the entire project is released under the open source MIT license.

dsh-backup 是一款专为 DeepSeek Harness (DSH) 开发的原生备份插件,用于备份存储在 ~/.dsh 目录下的全部 DSH 工作数据。它支持通过 /backup 斜杠命令一键创建带 SHA256 校验的备份包,同时在 DSH 网页端的设置面板提供可视化界面,可完成备份列表查看、校验、恢复、删除和配置修改等操作。你可以通过 DSH 插件 CLI 命令 dsh plugin --profile web add @xiaoyuyu6420/dsh-backup 安装,安装后重启 DSH 网页端即可生效。

这款插件面向所有 DSH 用户,用于防范误删数据、升级失败、换机迁移等场景下的数据丢失风险。它支持在 DSH 版本升级前自动创建快照,可按设定策略自动轮换旧备份,升级前还能运行迁移预检扫描会话日志,预测升级后可能出现的兼容性问题。即使 DSH 无法启动,它也提供零依赖的救援控制台,不用依赖 DSH 网页端就能完成数据恢复操作。

dsh-backup 支持 macOS、Linux 和 Windows 10 及以上系统,要求 DSH 版本不低于 0.1.1-rc.2,默认将备份存放在 ~/Desktop/dsh-backups/ 目录,可通过面板修改保存路径和保留份数。它默认对 API 密钥等凭据进行脱敏处理,明文仅保存在本地 vault,不会进入备份包。该项目采用 MIT 许可证开源,用户安装时可能出现的 peer 依赖警告属于正常预期。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 23 stars - an early-stage project星标 23,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add @xiaoyuyu6420/dsh-backup

把 xiaoyuyu6420/dsh-backup 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-backup

dsh-plugin npm Downloads Publish to npm license Stars Listed on DSH Directory

English | 简体中文

你所有的 DeepSeek Harness(DSH)工作数据都在一个目录里:~/.dsh。一次升级失败、一次误删、一次换电脑——没有备份,会话、设置、技能全没了。dsh-backup 用一条命令把它们找回来。

dsh plugin --profile web add @xiaoyuyu6420/dsh-backup   # 安装
# 重启 dsh web,然后输入:
/backup                                                  # → 一份带校验的备份落在 ~/Desktop/dsh-backups/

v0.9.0 全新安装的真实输出:

备份完成: dsh-20260826-195150036.tar.gz
sha256: 8f9ae6322ef782d21554981cf4547220d5bb3e64d7964a883317415ad54e3cbb
轮换删除 0 份(保留 7 份)

不想敲命令也行:dsh web → 设置 → 插件 → 备份 里有可视化面板——列备份、校验、恢复、删除、改设置,全都立即生效不用重启。

备份面板

它替你挡掉哪些事

你担心的 dsh-backup 做的事
「升级把环境搞坏了」 宿主版本一变就自动拍 dsh-pre-upgrade- 快照——放心试新版,坏了随时回滚
「我误删 / 改坏了东西」 /backup restore latest --dry-run 先预览要恢复什么再动手;恢复失败自动回滚并给出结果回执
「DSH 根本起不来了」 每次备份都会往备份目录放一个零依赖的救援控制台(dsh-rescue / rescue.mjs,或双击「点我恢复」)——不依赖 DSH 的网页版恢复界面
「API Key 会被传到云上吗」 凭据默认脱敏,不进备份包;明文只存本机 vault,永不离开这台机器
「会话日志损坏了」 /backup doctor 体检并从备份定点修复;损坏文件先隔离再入档,防止轮换把好副本也带走
「升级后老会话打不开了」 /backup migrate-check 迁移预检:升级前静态扫描全部会话,预测哪些会被新宿主拒绝、挂在哪条规则;旧版扁平凭据文件在宿主改写前自动存底
「换新电脑了」 GitHub 同步:/backup github pull 拉回云端备份,restore --sync-deps 顺手重装插件
「备份悄悄坏了没人知道」 每份归档带 sha256,/backup verify all 随时体检;每日/每周分级保留,留得住有用的历史
「我会忘记备份」 /backup auto 12——每 12 小时自动跑,重启不中断,旧副本自动轮换(默认保留 7 份)

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-portable 下一个 Next dsh-robotic-harness →