跳到正文

xiaoyuyu6420/dsh-backup

31最近提交 2026年8月15日

dsh-backup DSH 插件

dsh-backup 是一个 DSH 插件，用于备份和恢复整个 ~/.dsh 目录（会话、设置、凭据、技能、插件配置），排除 node_modules。支持手动备份、定时自动备份、归档完整性校验、GitHub 同步以及 DSH 设置 → 插件选项卡中的可视化 Web 面板。

developer-toolsskills-workflows

如何安装 dsh-backup DSH 插件

dsh plugin --profile web add dsh-backup

复制不会执行命令。安装 dsh-backup DSH 插件前请核对仓库和版本。

dsh-backup DSH 插件数据来源

dsh-backup DSH 插件快照日期：2026年8月16日

discovered

dsh-backup DSH 插件能做什么

  • 立即备份 ~/.dsh 到桌面上的带时间戳的 tar.gz 归档。
  • 从任何归档恢复，具有完整性校验和路径遍历保护。
  • 定时自动备份（每 N 小时，1–720），支持轮换（24 小时内保留 3 份，其余保留 7 份），重启后依然有效。
  • GitHub 同步：将归档推送到私有 Git 仓库，使用 force-with-lease 和凭据隔离。
  • Web 面板（备份选项卡）支持一键备份、验证、下载和恢复，带 dry-run 预览。
  • 通过命令列出已有备份（名称+大小）、校验和、自动备份状态。

dsh-backup DSH 插件适合哪些场景

  • 在尝试有风险的插件或配置更改前定期备份 DSH 环境。
  • 系统崩溃或重装后恢复完整的 DSH 设置。
  • 将夜间备份自动化到 GitHub 私有仓库，实现异地冗余。
  • 在恢复前验证备份完整性，确保数据未损坏。
  • 使用 Web 面板可视化管理备份，无需记忆命令。

dsh-backup DSH 插件适合谁

  • 频繁自定义 DSH 插件的深度用户，希望保护自己的配置。
  • 在部署 DSH 到生产环境或多实例场景中需要可靠备份工作流的开发者。
  • 任何希望为 DSH 数据提供简单、自动化备份解决方案的用户，跨平台可用。

dsh-backup DSH 插件的限制

  • 备份包含明文凭据——切勿同步到公共仓库或不受信任的位置。
  • 自动备份仅在配置的机器上工作；GitHub 同步需要私有仓库并通过环境变量设置 token。
  • 恢复会完全替换当前 ~/.dsh——不支持合并；当前状态会被移走作为快照。
  • 需要系统的 tar 命令（Windows 使用 bsdtar 或 Git Bash 的 GNU tar）。
  • GitHub 同步时会跳过大于 90 MB 的归档并给出提示。

dsh-backup DSH 插件的仓库 README 摘录

以下文字摘自 dsh-backup DSH 插件的上游仓库 xiaoyuyu6420/dsh-backup 的 README，版权归原作者，仅作引用。

One-command backup **and restore** for DeepSeek Harness user data — sessions, settings, credentials, skills, and plugin config under `~/.dsh`, excluding reinstallable `node_modules` — with sha256 checksums, integrity verification, automatic rotation, and scheduled auto-backup that survives restarts. Works on macOS, Linux, and Windows. ## Commands - **`/backup`** — immediately back up `~/.dsh` to `~/Desktop/dsh-backups/dsh-<timestamp>.tar.gz` - **`/backup list`** — list existing backups (name + size) and auto-backup status - **`/backup verify [prefix|all]`** — validate archive checksums (default: the newest) - **`/backup restore <prefix|latest> [--dry-run]`** — restore `~/.dsh` from an archive - **`/backup auto <N>|off|status`** — auto-backup every N hours (1–720; keeps 3 copies below 24h, 7 otherwise; persisted across restarts) - **`/backup --keep N`** — override the rotation count (default 7) - **`/backup github status|sync`** — GitHub sync status / push now - **`backup_dsh` tool** — same capability for the model (`mode=backup|list|verify|restore|auto`) ## GitHub sync With `config.githubRepo` set, every backup (manual, automatic, or panel) is also pushed to a Git repository —

阅读完整 README仓库许可: MIT

dsh-backup DSH 插件常见问题

如何安装 dsh-backup？

在终端中运行 `dsh plugin --profile web add dsh-backup`，然后重启 `dsh web` 激活插件。安装后可以在聊天中执行 `/backup` 命令，或打开设置 → 插件中的备份选项卡来验证。

备份默认保存在哪里？

默认备份保存在 `~/Desktop/dsh-backups/` 目录。您可以通过在 cordis 配置文件中设置 `destination` 选项来更改路径，例如 `config: { destination: '~/Backups/dsh' }`。

能否设置每小时自动备份？

可以，使用 `/backup auto <N>` 命令，N 为小时数（1–720）。例如 `/backup auto 1` 设置每小时备份一次。自动备份状态会持久化，重启后仍然有效。您可以通过 `/backup auto status` 查看状态。

出问题时如何恢复备份？

首先执行 `/backup list` 查看可用备份，然后使用 `/backup restore <前缀|latest>` 恢复。建议先加 `--dry-run` 参数预览恢复内容。恢复过程会先校验哈希，检查路径遍历，快照当前 ~/.dsh，然后解压归档。恢复后请重启 `dsh web` 使更改生效。

使用 GitHub 同步安全吗？

GitHub 同步将备份推送到私有仓库。您必须设置私有仓库，并通过环境变量 `DSH_BACKUP_GITHUB_TOKEN` 或 `GITHUB_TOKEN` 提供令牌。备份包含明文凭据，请勿使用公共仓库。插件使用 `--force-with-lease` 推送，凭据仅存储在工作目录的凭证文件中，不会出现在进程参数中。