dsh-quick-backup
DeepSeek Harness 的仅限本地备份控制与工作流
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:SShiRkiT/dsh-quick-backup#1a9adc5968788a991a9f0c814550200f2fbaa9b0Quick Backup 以 dsh-quick-backup 发布，当前版本为 0.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
简体中文 · English
面向 DeepSeek Harness（DSH） 用户环境的本地 Git 增量备份工具，提供 设置 → 备份 面板。
本 GitHub 仓库只包含插件和工作流脚本。 你的 DSH profile、会话、凭据、API Key 和备份数据永远不会进入这个仓库。 备份保存在
setup.ps1创建的独立本地仓库中。
vYYMMDD.E.SSS[!WARNING] 如果开启“备份凭据与 APIKey”，数据仓库会把
.credentials.yaml和APIKey以明文保存在本地，而且 Git 历史永不遗忘。默认不备份这两项。若你主动开启，并把备份文件夹进行云同步、网盘同步、网络驱动器同步，或者转发给他人，由此导致的凭据或隐私泄露由你自行承担，作者不承担任何责任。
注意！v0.1 默认为开启保存密钥设置。 使用 v0.1 时请特别小心；建议升级到 v0.2 或更高版本。
C:\Program Files\Git\cmd\git.exe）>= 0.2.1-rc.2git clone https://github.com/SShiRkiT/dsh-quick-backup.git
cd dsh-quick-backup
备份路径默认是空的。 必须显式传入 -RepoPath：
powershell -ExecutionPolicy Bypass -File .\setup.ps1 -RepoPath "D:\DSH-Backups" -EnableAutostart
setup.ps1 会：
.dsh profile（默认 %USERPROFILE%\.dsh）backup.config.json-EnableAutostart）常用参数：
# 自定义 profile / 安装目录
.\setup.ps1 -RepoPath "D:\DSH-Backups" -DshProfile "$env:USERPROFILE\.dsh"
# DSH 安装在自定义目录
.\setup.ps1 -RepoPath "D:\DSH-Backups" -InstallRoot "D:\DSH\Desktop"
# 只复制脚本和配置，暂不复制 profile
.\setup.ps1 -RepoPath "D:\DSH-Backups" -SkipInitial
# 如需备份 .credentials.yaml 与 APIKey（默认不备份）
.\setup.ps1 -RepoPath "D:\DSH-Backups" -IncludeCredentials
打开 DSH 桌面端的 设置 → 插件，选择从仓库安装，填写：
https://github.com/SShiRkiT/dsh-quick-backup
然后重启 DSH，应该能看到 设置 → 备份。
私有仓库需要先完成 GitHub 登录；公开后不需要。 开发调试时也可以让 DSH 指向你本地的仓库目录。
打开 设置 → 备份。如果 setup 没有配置过备份路径，在 备份仓库路径 输入框中填写路径，然后点 保存路径。
| 控件 | 作用 |
|---|---|
| 备份仓库路径 | 设置或修改本地数据仓库路径 |
| 备份凭据与 APIKey | 默认关闭；开启后备份 .credentials.yaml 和 APIKey |
| 恢复旧 storages 缓存 | 从 .dsh.pre-restore-* 恢复 cost-meter / session 缓存；不进入 Git 历史 |
| 备份 | 增量备份（遵守 60 秒最小间隔） |
| 忽略间隔备份 | 立即强制备份 |
| 校验 / 深度校验 | 校验仓库与 Git 对象 |
| 历史版本 | 选择版本 |
| 复制恢复命令 | 复制安全的恢复命令 |
| 导出 | 将选定版本导出到新目录 |
| 启用 / 停用 | 安装/移除登录 watcher |
| 运行诊断 | 执行一次不备份的 watcher 检查 |
setup.ps1 会把选定路径写入 %LOCALAPPDATA%\dsh-quick-backup\config.json。DSH_BACKUP_REPO（优先级最高）和同一个配置文件。D:\DSH-Backups。setup.ps1 创建的数据仓库（包含 scripts\backup.ps1）。如果还没初始化，面板会显示“未就绪”并提示先运行 setup。.credentials.yaml 与 APIKey。-IncludeCredentials。备份会把 storages\cost-meter、storages\session_projcache、session_projcache.json 排除在 Git 历史之外，所以它们不能通过回档 tag 恢复。
在 设置 → 备份 → 恢复旧 storages 缓存 中：
.dsh.pre-restore-*）；留空会自动选择最新副本cost-meter、session_projcache、session_projcache.jsonworkspace.json、设置、插件、凭据state\storage-restore-*格式：vYYMMDD.E.SSS
| 段 | 含义 |
|---|---|
YYMMDD | 当前大环境基线建立日期 |
E | 该日期内第几次大环境变动（1、2……；跨天重置为 1） |
SSS | 该基线内第几次小变动（001……；大环境变动时重置） |
以下情况进位：
dsh-ops 或运行时更新示例：
v261025.1.001 基线
v261025.1.002 新对话
v261025.2.001 同一天更新插件
v261026.1.001 次日升级 DSH
详细规则见 docs/VERSIONING.md。
dsh-quick-backup/ # 本仓库（不含个人数据）
├─ package.json # DSH 插件包根配置
├─ lib/ # 插件 host + client
├─ cordis.patch.yml
├─ scripts/ # 会复制到数据仓库的工作流脚本
├─ setup.ps1 # 创建本地数据仓库
├─ docs/
└─ test/ # 插件自测
<你选择的路径>/ # 数据仓库（仅本地，绝不提交到这里）
├─ .git/ # 备份历史
├─ mirror/ # 当前 DSH 状态镜像
├─ state/ # 日志、每版本元数据（gitignored）
├─ backup.config.json # 本地配置（gitignored）
├─ version.txt
├─ VERSIONS.md
└─ scripts/
数据仓库是一个独立的 Git 仓库。本项目的 .gitignore 不会跟踪任何备份数据。
以下命令都在数据仓库中运行：
$B = "D:\DSH-Backups"
# 立即备份
powershell -ExecutionPolicy Bypass -File "$B\scripts\backup.ps1" -Trigger manual
# 查看版本
powershell -ExecutionPolicy Bypass -File "$B\scripts\restore-version.ps1" -List
# 回档（会关闭 DSH！）
powershell -ExecutionPolicy Bypass -File "$B\scripts\restore-version.ps1" v261025.1.002 -Force
# 只导出
powershell -ExecutionPolicy Bypass -File "$B\scripts\restore-version.ps1" v261025.1.002 -ExtractTo "D:\DSH-restore-261025-1-002"
# 校验
powershell -ExecutionPolicy Bypass -File "$B\scripts\verify.ps1" -Deep
以下内容会被有意排除，避免单纯重启就产生新版本：
.dsh\cache、.dsh\logsstorages\session_projcache*storages\cost-meter\（包括 ledger.json；成本历史不备份）studymate\reach\Cache、Code Cache、GPU*、logs、Local Storage、Session Storage、Network、Shared Dictionary、blob_storage、WebStorage、Preferences、LOG*、lockfile、Cookies*、DIPS*profiles\node_modules（失效 junction）会话正文（sessions、attachments）和设置会被备份。
.dsh.pre-restore-<时间戳>，而不是直接删除。install-info.txt）。push.default=nothing 和 pre-push 钩子会阻止误推送。.credentials.yaml、APIKey），请按敏感数据保管。详见 docs/SECURITY.md。
# 移除 setup 安装的登录 watcher
powershell -ExecutionPolicy Bypass -File "D:\DSH-Backups\scripts\uninstall-autostart.ps1"
# 移除插件
dsh plugin --profile desktop remove dsh-quick-backup
只有当你不再需要历史时才删除数据仓库。
dsh plugin --profile <name> list，然后重启 DSH。setup.ps1 -RepoPath <path>，或保存正确的路径。state\logs\backup.log、state\last-run.json。verify.ps1 -Deep。# PowerShell 语法检查（Windows PowerShell 5.1）
powershell -File .\scripts\verify.ps1 # 需要已有数据仓库
# 插件自测
node .\plugin\verify.mjs
test/verify.mjs 使用临时 fixture，不会接触你的 DSH 数据。
MIT，见 LICENSE。