前言¶
在 DeepSeek Harness（DSH）里，一个 Profile 往往对应一套工作区配置、插件清单和 Cordis 相关补丁。换机器、做环境对齐或试改前先留底时，如果把整个 Profile 目录连同 node_modules 一起打包，体积大、路径也容易踩坑。整机备份或云盘同步能兜底，但通常粒度太粗，也不方便单独校验「这份归档里到底有哪些路径」。
下面介绍社区插件 dsh-profile-backup（维护者 lengrufeng2008，SkillHub 分类：记忆）。它做的是 仅配置 的 Profile 备份与恢复，明确排除 node_modules，并在归档侧做路径安全检查；需要覆盖已有 Profile 时，提供带 --force 的语义（见后文限制）。仓库：lengrufeng2008/dsh-profile-backup；目录页：SkillHub 插件页。
这是什么¶
dsh-profile-backup 是一个面向 DSH Profile 的快照小工具：备份、校验归档、再写回指定 Profile。README 写明它 不包含 session、密钥或包缓存；也 不能 替代整机备份。当前公开版本 v0.1.0（MIT 许可证），运行需要 Node.js >= 20。
DSH 生态强调「一切皆插件」；SkillHub 是社区目录站点，与 DeepSeek / 幻方无官方从属关系。安装前仍应自行查看仓库源码与许可证——插件与 CLI 均在当前 DSH / 用户权限下执行。
核心功能¶
依据 README 与 package.json 描述，已核实能力如下：
- backup：从
--home下的指定--profile生成配置归档（不含node_modules），输出到--out指定的.tgz。 - check：对已有归档做 path-safe 检查，避免在不安全或不符合预期的路径结构上盲目恢复。
- restore：将归档写回
--home与--profile；与 force-backup 相关语义配合时，覆盖已有目录会先按规则重命名（见限制）。 - DSH 插件形态：包内提供
plugin/index.js与 Cordis bundle patch（plugin/cordis.patch.yml），可在 DSH 内作为插件使用；命令行入口为bin/dsh-profile-backup.mjs。
安装与启用¶
SkillHub 目录页标注该插件 可安装，并提供「发送给 DeepSeek Harness 安装」的文案，开头为：
请安装 DSH 插件 lengrufeng2008/dsh-profile-backup。先读取..
完整安装说明以 SkillHub 插件页 为准；勿自行拼接未在官方资料中出现的 dsh plugin add … 命令。
插件安装或检出后，CLI 通过 Node 调用（package.json 中 bin 映射为 dsh-profile-backup → bin/dsh-profile-backup.mjs）。使用前确认本机 Node >= 20。
典型用法¶
README 给出的可复现示例如下。三条命令分别对应备份、校验归档、恢复。
备份 web Profile 到当前目录下的 web-backup.tgz：
node bin/dsh-profile-backup.mjs backup --home ~/.dsh --profile web --out web-backup.tgz
在恢复前检查归档是否通过路径安全校验：
node bin/dsh-profile-backup.mjs check --archive web-backup.tgz
将归档写回同一 home 下的 web Profile：
node bin/dsh-profile-backup.mjs restore --archive web-backup.tgz --home ~/.dsh --profile web
仓库内测试（维护者自用，非 DSH 运行时必需）：
npm test
适用场景与注意¶
适合谁
- 需要在多台机器或容器之间 对齐同一套 Profile 配置，又不想打包
node_modules的开发者。 - 希望在恢复前 先 check 归档，减少路径或结构异常带来的风险。
- 接受「只保配置、不保会话与密钥」边界，并另有密钥与 session 管理方案的团队。
务必知道的限制（README Limits）
- 仅配置：不含 sessions、secrets、package cache。
--force：会把已有 Profile 重命名为.bak-*；没有 自动回滚。- 恢复后 不会 对 Profile 做 boot-test。
- 不能 代替完整机器备份。
权限与安全
插件与上述 CLI 以当前 DSH 进程 / 执行用户的权限读写 ~/.dsh 等路径。安装或启用前请阅读 GitHub 仓库 源码与 MIT 许可证；归档文件本身仍可能含敏感配置，存放与传输需自行管控。
结尾¶
dsh-profile-backup 把 DSH Profile 的备份恢复收窄到「配置快照 + 归档校验 + 可预期的 force 覆盖语义」，适合作为日常 Profile 迁移的补充手段，而不是整机或密钥备份的替代品。
- 目录页：https://www.skillhub.cn/plugins/lengrufeng2008/dsh-profile-backup
- GitHub：https://github.com/lengrufeng2008/dsh-profile-backup
