前言¶

DeepSeek Harness（DSH）的 profile、会话、插件与设置都落在本机目录里。手动复制文件夹很难区分「哪一次状态是对的」，也缺少可回溯的版本说明。常见做法是整包压缩或依赖云盘同步，前者没有结构化历史，后者容易把敏感目录一并上传。

下面介绍社区插件 dsh-quick-backup（维护者 SShiRkiT，分类：工作流）。它在 DSH 桌面端提供 设置 → 备份 面板，用本地 Git 仓库做增量镜像，不联网、不配置远程、不上云。GitHub 仓库只含插件与工作流脚本；你的 profile、会话、凭据与备份数据不会进入该仓库。

这是什么¶

dsh-quick-backup 是面向 DSH 用户环境的本地 Git 增量备份工具（简介：Local-only backup controls and workflow for DeepSeek Harness）。当前插件包版本为 0.3.0（MIT 许可证）。

备份数据保存在由 setup.ps1 在你指定路径创建的独立本地仓库中，与插件源码仓库分离。

环境要求¶

使用前需满足 README 中的条件：

• Windows 10/11
• PowerShell 5.1（系统自带）
• Git for Windows（脚本优先使用 C:\Program Files\Git\cmd\git.exe）
• DSH desktop >= 0.2.1-rc.2

核心功能¶

经 README 核实，插件与配套脚本提供以下能力：

1. 在 DSH 设置 → 备份 中一键增量备份（默认遵守 60 秒最小间隔，可强制忽略间隔）。
2. 本地 Git 历史，版本号格式为 vYYMMDD.E.SSS（大环境变动与小变动分段进位，详见仓库 docs/VERSIONING.md）。
3. 可选登录 watcher：DSH 启动时自动备份。
4. 查看历史版本、导出选定版本、复制安全的恢复命令（设置页不直接执行回档）。
5. 缓存感知：排除 .dsh\cache、Electron 缓存、部分 storages 等，避免单纯重启 DSH 就产生无意义版本。
6. 校验 / 深度校验仓库与 Git 对象；运行诊断（不备份的 watcher 检查）。
7. 恢复旧 storages 缓存：从 .dsh.pre-restore-* 等副本恢复 cost-meter / session_projcache 相关文件，不进入 Git 历史、不产生新版本。

默认不备份 .credentials.yaml 与 APIKey；可在面板或 setup 时显式开启（见下文风险说明）。

安装与启用¶

安装分两步：先在本地创建数据仓库，再在 DSH 中注册插件。

1. 获取插件源码并创建数据仓库¶

README 要求显式传入备份路径 -RepoPath（默认路径为空）：

git clone https://github.com/SShiRkiT/dsh-quick-backup.git
cd dsh-quick-backup

powershell -ExecutionPolicy Bypass -File .\setup.ps1 -RepoPath "D:\DSH-Backups" -EnableAutostart

setup.ps1 会检测 .dsh profile（默认 %USERPROFILE%\.dsh）、在指定路径初始化本地 Git 与首个基线、复制工作流脚本、写入 backup.config.json，并注册插件发现配置；-EnableAutostart 可选安装登录 watcher。

常用变体示例：

.\setup.ps1 -RepoPath "D:\DSH-Backups" -DshProfile "$env:USERPROFILE\.dsh"
.\setup.ps1 -RepoPath "D:\DSH-Backups" -InstallRoot "D:\DSH\Desktop"
.\setup.ps1 -RepoPath "D:\DSH-Backups" -SkipInitial

若需备份凭据与 APIKey（默认关闭）：

.\setup.ps1 -RepoPath "D:\DSH-Backups" -IncludeCredentials

路径配置还会写入 %LOCALAPPDATA%\dsh-quick-backup\config.json；环境变量 DSH_BACKUP_REPO 优先级最高。

2. 在 DSH 中安装插件¶

打开 DSH 桌面端 设置 → 插件，选择从仓库安装，填写：

https://github.com/SShiRkiT/dsh-quick-backup

然后重启 DSH，应出现 设置 → 备份。私有仓库需先完成 GitHub 登录；开发调试也可让 DSH 指向本地仓库目录。

卸载插件示例（README）：

dsh plugin --profile desktop remove dsh-quick-backup

典型用法¶

设置页操作¶

若 setup 未写入路径，在 备份仓库路径 填写本地绝对路径（例如 D:\DSH-Backups），点 保存路径。该目录必须是由 setup.ps1 创建的数据仓库（含 scripts\backup.ps1），否则面板显示「未就绪」。

数据仓库内命令行¶

以下命令在数据仓库目录对应的路径下执行（将 $B 换成你的路径）：

$B = "D:\DSH-Backups"

powershell -ExecutionPolicy Bypass -File "$B\scripts\backup.ps1" -Trigger manual
powershell -ExecutionPolicy Bypass -File "$B\scripts\restore-version.ps1" -List
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；当前 profile 会改名为 .dsh.pre-restore-<时间戳>。回档前请确认选定版本中的 DSH 程序版本与当前一致（仓库含 install-info.txt）。

版本号示例¶

v261025.1.001   基线
v261025.1.002   新对话
v261025.2.001   同一天更新插件
v261026.1.001   次日升级 DSH

大版本进位包括 DSH 升级、插件安装/更新/移除等；小版本包括会话、附件、设置等变动。

适用场景与注意¶

适合谁：在 Windows 上使用 DSH desktop，希望在本机保留可查询、可导出、可回档的 profile 与会话镜像，且明确不需要云备份的用户。

数据与密钥：README 强调，若开启「备份凭据与 APIKey」，.credentials.yaml 与 APIKey 会以明文进入本地 Git 历史且历史不会自动遗忘；勿将数据仓库云同步或外传。v0.1 默认曾开启保存密钥；资料建议升级到 v0.2 或更高（当前 package 为 0.3.0，默认不备份凭据）。关闭凭据开关只影响后续版本，旧历史中的副本需重建仓库或清理 Git 历史才能移除。

隐私：数据仓库仅本地；push.default=nothing 与 pre-push 钩子阻止误推送。不要把数据仓库上传到 GitHub 或网盘。成本历史（storages\cost-meter）等被有意排除，不进入备份历史。

插件权限：DSH 插件在当前 DSH 进程权限下运行。安装前应自行查看 GitHub 源码 与 MIT 许可证，确认符合你的安全策略。

生态说明：DSH 社区插件目录（如 SkillHub 上的条目）为独立站点，与 DeepSeek / 幻方无官方从属关系；本文事实以项目 README 与 package.json 为准。

结尾¶

dsh-quick-backup 把 DSH 日常状态收敛到本地 Git 增量备份：面板一键操作、可选启动 watcher、版本号可读、回档与导出由独立 PowerShell 脚本执行，并默认不把凭据写入历史。需要工作流类本地备份时，可按 README 先 setup.ps1 再装插件。

• 目录页：https://www.skillhub.cn/plugins/SShiRkiT/dsh-quick-backup
• GitHub：https://github.com/SShiRkiT/dsh-quick-backup