资讯动态

dsh-purge 本机备份与回滚机制:快照、SHA256 校验与 rollback 完全指南

发布时间:2026/10/23 2:09:48 来源:尧图企业网站定制
【免费下载链接】dsh-purge让 AI 更专注地辅助学习与动手实验 —— DeepSeek Harness 附加组件状态自检 / 提示词管理 / 本机备份与回滚项目地址https://gitcode.com/gh_mirrors/dsh/dsh-purge点击查看免费下载dsh-purgePurge Community是一个跑在 DSH Desktop 上的自托管附加组件核心能力包括 25 层状态自检、提示词管理和本机备份与回滚。本文带你彻底搞懂它的备份回滚机制快照何时自动创建、SHA256 校验如何保证文件完整、一条rollback命令如何把插件安全退回旧版本——新手也能一步跟上。一、为什么 dsh-purge 写入前必先快照dsh-purge 的设计原则之一是「可回滚」应用、安装、回滚前都会自动打快照保留原文件与校验清单。安装、应用宿主补丁、重启是三个独立动作每一步动手前都有「后悔药」。触发场景快照原因reason说明手动执行backupmanual你随时可以主动打一份安装 / 更新插件before-update装新版前先存当前版本应用宿主补丁before-host-patches写补丁文件前保护 profile执行 rollbackbefore-rollback回滚前的保险快照防「回滚本身出错」所有维护操作都在maintenance.lock保护下串行执行避免两个备份/回滚同时写盘。相关实现见 lib/community.js。二、快照里到底有什么一个 manifest.json 说清楚快照统一存放在 DSH 数据目录下$DSH_HOME/dsh-purge-community/backups/id/manifest.json其中id是「ISO 时间戳 4 字节随机 hex」例如2026-10-22T05-30-00-000Z-a1b2c3d4保证全局唯一。每份快照包含两类内容plugins/已安装的 Purge 插件包本体dsh-purge、dsh-purge-panel、dsh-purge-communitysettings/profile 的package.json、cordis.patch.yml、pnpm-lock.yaml、注入提示词prompt-inject.md、Purge 状态目录与规则集rules。manifest.json是快照的「身份证」关键字段字段作用id/created_at/reason快照 ID、创建时间、触发原因profile/home绑定数据目录与 profile防跨实例误用plugins记录的插件名与版本sums每个文件的 SHA256 哈希清单blobs大文件去重对象的哈希索引complete快照是否完整未完成的不会被列出快照创建逻辑snapshot()见 lib/community.js失败时会留下failed.json便于排查而不是留下半份快照。三、SHA256 校验与内容寻址去重逐文件哈希快照写完文件后treeHashes()会对快照目录内每个文件计算 SHA256写入manifest.json的sums字段。回滚前会重算一遍逐一比对——任何文件被篡改或缺失都会直接报「备份校验失败」。大文件去重体积 ≥32KB 的文件采用内容寻址只按 SHA256 存一份到objects/sha256快照目录里记索引即可。同一份大文件出现在 8 个快照中也只占一份空间实现见 lib/community.js。清理快照时没有任何备份引用的去重对象会被自动回收。回滚前的强制验证verify()会做一连串检查见 lib/community.js备份路径不能是符号链接ID 必须合法home/profile必须与当前实例一致否则报「备份不属于当前数据目录或 profile」;实际文件集合与sums清单逐一比对blobs里的每个去重对象都要存在且哈希一致缺失报「去重对象缺失」。四、创建快照一条命令 backuppurge-community backup # 手动打一份快照随后自动清理 purge-community usage # 查看备份份数与磁盘占用 purge-community prune # 手动触发清理 purge-community audit # 查看最近的维护动作记录 自动清理策略prune 保留规则快照默认保留最近5 份其余按「每天最多留 1 份、最多保留 7 天」保留最后按200MB总上限从最旧的开始淘汰。当前正在回滚的目标快照受protect参数保护绝不会被误删。策略实现见 lib/community.js。五、回滚分步拆解rollback 到底做了什么purge-community rollback backup-id整个流程可以拆成 7 步源码 lib/community.jsverify先对目标快照做上文说的 SHA256 全套校验安全快照立刻打一份before-rollback快照作为回滚失败时的退路暂存还原把快照中的插件树物化到临时restored/目录并打包成 tgz不直接覆盖任何文件依赖检查点checkpointProfile先保存当前package.json、pnpm-lock.yaml和整个node_modules副本见 lib/rollback-transaction.js走官方通道安装用当前实例的 DSH CLI 安装快照里的插件包安装后校验包名、版本一致并在独立进程里导入入口文件确认可加载恢复启用入口只把 Purge 包写回package.json的dsh.profile.bundles不动你的提示词、规则和其他插件配置收尾清理检查点、按protect参数清理过期快照返回「需要手动重启 DSH」提示。 三个关键边界只回滚插件本体回滚后当前提示词、规则、其他插件设置原样保留不会整份覆盖 profile需要手动重启完成回滚后必须退出并重新打开 DSH 进程仅刷新浏览器页面不会加载新版后端插件加载不了时可改用另行校验过的发行包 CLI设置PURGE_DSH_CLI/DSH_HOME/DSH_PROFILE后执行node package/bin/community.js rollback id。详见 docs/MAINTENANCE.md。六、回滚失败怎么办依赖图自动恢复如果第 5 步安装或校验失败机制不会把你留在半截状态自动恢复checkpoint.restore()把回滚前保存的依赖图node_modules、锁文件原样放回去返回信息会写明「回滚前依赖、安装与清单已恢复」安全快照保留before-rollback快照始终保留可继续手动排查并发变更保护若检测到其他插件在回滚期间改了依赖恢复会拒绝覆盖并报「检测到并发配置变化」恢复快照保留在recovery目录供核对——宁停不误删。七、面板操作一键备份与回滚不想敲命令左侧「Purge → 维护」页有完整图形入口组件 maintenance.js立即备份等同purge-community backup备份下拉列表显示每份快照的创建时间与插件版本回滚插件选中目标后二次确认「只回滚 Purge 插件及其入口保留当前提示词和设置」随后执行最近动作 / 更新与备份占用审计日志与磁盘占用一屏可见。面板底部固定提示备份只保存在本机安装或回滚后需要重启 DSH 进程。八、常见问题速查现象原因与处理「已有维护操作或遗留锁」存在maintenance.lock先确认没有维护进程在跑不要盲目删锁「备份不属于当前数据目录或 profile」快照绑定其他实例用PURGE_PROFILE_DIR/DSH_PROFILE明确目标后再试「去重对象缺失」objects/中的大文件被误删该快照不可用换其他快照回滚多个 profile 时停止操作这是保护设计不会默认选 desktop显式指定 profile 即可回滚后面板没变化忘了重启需手动退出重开 DSH刷新浏览器无效⚠️ 最后提醒profile 里可能含私密连接信息不要公开分享整个备份目录。更多恢复细节见 docs/MAINTENANCE.md 与 docs/WEB-MAINTENANCE.md。赞分享【免费下载链接】dsh-purge让 AI 更专注地辅助学习与动手实验 —— DeepSeek Harness 附加组件状态自检 / 提示词管理 / 本机备份与回滚项目地址https://gitcode.com/gh_mirrors/dsh/dsh-purge点击查看免费下载相关推荐VirtualAPK插件版本回滚机制基于备份与校验的安全策略VirtualAPK插件版本回滚机制基于备份与校验的安全策略 回滚机制核心痛点与解决方案 插件化架构中版本更新失败可能导致功能异常甚至应用崩溃。Virtua移动开发插件系统Apache Kudu 快速入门指南如何在5分钟内搭建高性能数据存储平台Apache Kudu 快速入门指南如何在5分钟内搭建高性能数据存储平台 Apache Kudu是一款为快速分析实时变化数据而设计的开源数据存储引擎。如果你正分布式数据库列式数据库数据存储大数据FastCtx自更新详解npm与GitHub双通道校验、SHA256验证、原子替换与回滚机制FastCtx自更新详解npm与GitHub双通道校验、SHA256验证、原子替换与回滚机制 FastCtx 是一款面向 AI 编程代理的快速、上下文高效的仓上一篇Plex IPTV插件终极指南从零开始搭建直播电视系统下一篇革命性AI图像生成工具vq-vae-2-pytorch如何快速生成高保真多样性图像创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑