dsh-backup

DeepSeek Harness (DSH) 环境备份与恢复技能（Agent Skill）。

把 DSH 环境视为六类组件的集合（配置 / 插件 / 本地依赖 / 环境补丁 / 自定义脚本与插件状态 / 数据），按类别检测、选择、打包、对比、恢复。生成跨平台通用、自带 MANIFEST 自包含恢复指导的 ZIP，支持在无 DSH 的新环境按指导安装与恢复。

特性

• 六类环境模型：备份/恢复的检测、选项、清单、对比、恢复都按六类组织
• 环境补丁检测（三种形态）：
  • 本地源码目录未提交改动（git）
  • 运行部署层被改文件（index.html 内联 style / dist 与官方对比）
  • 已安装插件包内文件被改（npm pack 下载官方 tarball 逐一对比 hash，支持单包 / 全量两种粒度）
• 全新环境引导：无 Node / 无 DSH 的机器，按 MANIFEST 指导安装 Node（分平台）→ pnpm → 按来源版本安装 DSH
• 网络与代理处理：npm/pnpm 代理配置、镜像源、GitHub 依赖处理
• 插件状态恢复：如 dsh-pocket 的 token / 密码，恢复后免重新初始化
• 自包含 MANIFEST：含六类清单、恢复步骤、全新环境引导、网络处理、恢复执行规范（提问驱动 / 保守默认 / 每步验证）与验证清单——任何 agent（DSH / Claude Code / Codex 等）仅凭 MANIFEST 即可完整恢复
• 跨 agent 通用：提问驱动不依赖特定工具名（DSH 用 ask_user_question，其他环境用等效方式）
• 保存位置三选项：默认工作空间 / WebDAV（双输出：本地 + 远端）/ 自定义路径

安装

把本仓库的 SKILL.md 放到 DSH 的技能目录：

# 方式一：直接放入
mkdir -p ~/.dsh/skills/dsh-backup
cp SKILL.md ~/.dsh/skills/dsh-backup/

# 方式二：作为插件（可选，若需随插件管理）
dsh plugin --profile web add github:<your-org>/dsh-backup

DSH 会实时监听技能目录，新会话即可使用（无需重启）。

使用

对 DSH（或任何加载了本技能的 agent）说：

• 「备份 DSH / 备份配置」→ 备份模式
• 「恢复 DSH / 恢复配置 / 还原环境」→ 恢复模式
• 「迁移 DSH / 复刻环境 / 换机器」→ 自动进入对应模式

备份模式

1. 环境检测：按六类只读检测，产出环境状态报告（含补丁检测）
2. 选项提问：六类 + 凭据（含「全选」快捷选项）
3. 打包：staging → MANIFEST → ZIP（默认工作空间 / WebDAV / 自定义）
4. 校验：条目数、大小、SHA256

恢复模式

1. 目标环境检测：Node → DSH → pnpm 检测链；全新机器按引导安装
2. 对比取舍：按六类逐项提问（覆盖 / 保留 / 合并 / 路径重写）
3. 恢复执行：引导 → 适配 → 放置 → 重装插件 → 依赖 → 补丁 → 插件状态 → 脚本 → 凭据
4. 验证：按清单核对版本 / 插件 / 补丁 / 状态 / GUI

MANIFEST 自包含

备份包内的 MANIFEST.md 是自包含恢复指导：包含六类清单、恢复步骤、全新环境引导、网络与代理处理、恢复执行规范（提问驱动 / 保守默认 / 每步验证）与恢复完成验证清单。目标机器上即使没有本技能、用任何 agent，仅凭 MANIFEST.md 也能正确执行完整恢复。

要求

• DeepSeek Harness 0.1.x（备份端）；恢复端不限（任何能执行 shell 的 agent 环境）
• 打包使用 ZIP（主流系统原生支持）
• 备份与恢复需要网络（npm registry / GitHub）时，按 MANIFEST 的网络与代理处理配置

License

MIT