前言¶
在 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
