deepseekplugins

DeepSeek Harness plugin

dsh-backup-sync

DSH 备份/恢复与跨机同步插件：本地快照、WebDAV 增量推送/拉取、自动备份与失效归档清理

Tools & Capabilities
Jump to install

Source facts

Repository
csiroqa/dsh-backup-sync
Latest update
Aug 13, 2026
Category
Tools & Capabilities
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/csiroqa/dsh-backup-sync
Plugin: dsh-backup-sync
Author: csiroqa

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only
README language

dsh-backup-sync

![CI](https://github.com/csiroqa/dsh-backup-sync/actions/workflows/ci.yml)

DeepSeek Harness（DSH）的备份/恢复 + 跨机同步插件：一键把 $DSH_HOME 关键数据复制为本地快照（会话日志、工作区数据、配置层），通过 WebDAV 在机器间增量推送/拉取（换机迁移、异地备份），支持定时自动备份与失效归档清理。

English: README.en.md

功能

本地快照

  • 一键快照：/backup [快照名] 把 $DSH_HOME 的会话日志（sessions/）、工作区注册数据（storages/，如 workspace.json）、配置层（settings.yaml、cordis.patch.yml、各 profile 用户层）复制为时间点快照；可选附件（attachments/，体积大，默认关闭）
  • 清单可靠：快照带 meta.json 清单（文件路径/大小/修改时间），/backup list 查看时间、主机、文件数与大小，/backup prune [保留数] 清理旧快照

跨机同步

  • WebDAV 传输：Nextcloud / 坚果云 / 群晖 / S3 网关等，/backup push <快照名> 上传、/backup pull <快照名> 下载，远端布局 <baseUrl>/dsh-backup/<快照名>/
  • 增量传输：push/pull 按清单对比（大小 + 修改时间），未变化的文件跳过；拉取后恢复文件时间，二次同步零下载
  • 中断安全：清单 meta.json 最后上传——推送中断不会被另一台机器当成完整快照；重试天然幂等
  • 残留自清理：推送自动删除远端旧清单残留，拉取自动删除本地多余文件；/backup remote-prune <快照名> 删除整个远端快照

自动备份

  • autoIntervalMinutes 定时快照，autoKeep 只保留最近 N 份（自动清理）；恢复前自动对现状建 …-pre-restore 保险快照

失效归档清理

  • DSH 归档列表只记会话 id、不校验日志是否存在（幽灵归档）：restore 成功后自动清扫，或 /backup sweep-archives 手动执行

配置

插件行（cordis.patch.yml 的 backup-sync insert 行）支持以下可选 config：

键默认说明
backupRoot$DSH_HOME/backups本地快照根目录
includeAttachmentsfalse是否备份附件（体积大）
includeCredentialsfalse是否备份 .credentials.yaml（含明文密钥，默认关）
autoIntervalMinutes0自动备份间隔（分钟）；0 = 关闭
autoKeep10保留最近快照数；0 = 从不清理
remote.baseUrl空WebDAV 根地址（如 https://dav.example.com/remote.php/dav/files/user/dsh-backups）
remote.username / remote.password空留空时从凭据引用 WEBDAV_USERNAME / WEBDAV_PASSWORD 解析

> 不要把明文密码写进 cordis.patch.yml。.credentials.yaml 不会被默认备份。

安装

前置：Node.js >= 22、pnpm、本机 deepseek-harness 源码检出（依赖以 link: 指向其 @deepseek-ai/* 包，未发布到 npm）。

git clone https://github.com/csiroqa/dsh-backup-sync.git
cd dsh-backup-sync
pnpm install
pnpm build

# 安装进 web profile（link: 指向本目录）
dsh plugin --profile web add link:$(pwd)        # POSIX
dsh plugin --profile web add link:E:\path\to\dsh-backup-sync   # Windows

重启 dsh web，浏览器 Ctrl+F5 强刷。

（npx 方式亦可：npx --registry=https://registry.npmjs.org -y @deepseek-ai/dsh plugin --profile web add <本插件路径>——需显式官方 registry：镜像数据滞后且 npm 11 的 npx 锁校验会拒绝非官方源。）

使用

1. 对话输入 /backup 创建第一个快照；/backup list 查看（时间 / 主机 / 文件数 / 大小） 2. 配置 remote.baseUrl 与凭据后：/backup push <快照名> 推送到远端；换机后 /backup pull <快照名> + /backup restore <快照名> 完整迁移 3. /backup restore <快照名> [--all] 恢复：默认只还原会话日志与工作区数据（恢复前自动留保险快照）；--all 连配置一起还原（需重启生效） 4. /backup sweep-archives 清理失效归档；/backup prune 5 只保留最近 5 个

兼容性

  • 平台：Windows / macOS / Linux（Node >= 22）—— 构建与冒烟测试经 GitHub Actions CI 验证
  • 凭据：通过 DSH 凭据引用（WEBDAV_USERNAME / WEBDAV_PASSWORD，存于 $DSH_HOME/.credentials.yaml），不落配置库
  • 针对 DSH 0.1.0-rc.6（源码检出与 npm/npx 安装）实测可用
  • 客户端仅依赖平台模块表（react 等），不随 DSH SDK 版本漂移
  • 构建产物：tsdown（host 半区 lib/index.js + browser 半区 lib/client.js，标准 window.__ModuleLoader__.load 闭包工厂格式）

安全声明

  • 快照含你的全部会话与工作区数据：存放于 $DSH_HOME/backups/snapshots/，请勿把该目录暴露给不可信方；启用 includeCredentials 时还会包含明文密钥
  • 恢复会覆盖当前数据：restore 前会自动留保险快照可回退，但建议先在测试 profile 验证；--all 会回退其他插件的配置（需重启生效）
  • 远端凭据：WebDAV 用户名/密码建议走凭据引用；若写在 cordis.patch.yml，请勿把该文件入库或外发
  • 插件自身不做网络监听（纯命令 + 出站 WebDAV 请求）

许可与使用声明

MIT License（见 [LICENSE](LICENSE)）。

欢迎任何人使用、修改、引用、或把本项目收录进自己的插件合集，只需：

  • 保留 LICENSE 文件与版权声明
  • 标明出处（本仓库链接）

相关

  • DeepSeek Harness
  • 系列插件：dsh-schedule（定时任务 + 状态监控）、dsh-archive-viewer（归档增强：自动归档 / 文件夹 / 经验库 / 收藏便签）
  • 插件形态参考 dsh-web-ui（dsh.bundle.patch + dsh.client 声明 + 槽位注册 + tsdown 双半区构建）
Back to searchOpen GitHub repository

More related plugins

View category