ARTICLE · 1394294
DeepSeek 宿主插件 dsh-purge 社区版实战:安装、自检与备份回滚

大家好。最近折腾 DeepSeek 生态的 AI 助手宿主时,绕不开一个高频词:dsh-purge。它是 DeepSeek Harness(下文简称 DSH)社区里热度很高的开源插件项目,GitHub 上 Star 已经过万,发行版迭代到了 1.7.20,主打「宿主兼容、状态诊断、提示词管理、更新与本机备份回滚」这套工程化能力。本文按「是什么 → 怎么装 → 怎么管 → 出问题怎么办」的顺序,把它的完整上手流程过一遍。无论你是刚接触 DSH 的新手,还是已经在用 CLI/Web 形态的老玩家,希望都能有所收获。
项目地址(命令与版本号以仓库最新 README 为准):
https://github.com/kingcharleslzy-ai/dsh-purge

一、它是什么:给 DSH 加一层「可观测、可回滚」的控制面
1.1 背景:DSH 与它的社区插件
DeepSeek Harness(DSH)是 DeepSeek 生态里的 AI 助手宿主,提供 Desktop、CLI、Web 等多种使用形态,并带有实验性的自定义插件市场。宿主负责跑模型、管会话、执行工具,插件则在宿主之上做附加能力。
dsh-purge Community 是这类插件中更新很勤的一个,由社区独立维护(上游项目署名小杨 / YuJunZhiXue,本仓库保留上游版权与 MIT 许可证)。社区里常把它称作「破甲」插件——按仓库 README 自己的解释,这个词指的是它把交互层面的确认与打断收敛起来,让 agent 能连续执行任务;它不改模型本身,也不改变你要做的事。
从仓库说明看,它把日常使用里最消耗注意力的几件事收敛到一处:
- 看清楚状态
:安装、补丁、注入到底有没有就绪,一条命令或一屏面板给结论; - 少一些往返
:把反复出现的确认与打断,收敛成一次设置; - 随时能回去
:应用、回滚、开关都留记录,操作前自动快照; - 方便做实验
:提示词、规则、预设集中管理,改坏了能撤。
1.2 设计原则:四条底线决定功能形态
这四条直接决定了它的功能形态——本文后面会看到,几乎所有能力都围绕「证据、快照、开关」三个词展开。
规模上,README 给出的口径是 86 条宿主补丁、25 层状态自检,兼容性表记录了在 DSH Desktop 0.2.2-rc.2 上 74 条补丁 applied、零漂移(macOS 回归通过)。最近的 1.7.18 版本把 14 条权限补丁改成默认开启并收成组开关,上下文管理单独成开关(默认关)。
二、安装:三条路线按场景选
先说结论:首次安装走官方入口,装过旧版用社区安装器原地迁移,不要先卸载。 另外,安装、应用宿主补丁、手动重启是三个独立动作,别混为一谈。

2.1 方式一:DSH 官方界面 + 社区索引(首次安装推荐)
先打开 DSH 完成初始化,进入「插件」,点「实验性插件」旁的「更多」,启用「自定义插件市场」; 进入「发现 → 添加索引源」,填入社区索引地址:
https://kingcharleslzy-ai.github.io/dsh-purge/index.json选择 dsh-purge Community,核对来源为 kingcharleslzy-ai/dsh-purge、包名为dsh-purge-community,确认后安装。
界面和安装协议由 DSH 提供,索引与插件由社区维护,不同 DSH 版本的入口文字可能略有差异。
2.2 方式二:官方 CLI 直装发行包
适合已经在用 dsh 命令、profile 为 web 的 CLI/Web 用户。注意要用发行版的固定版本 URL,不是 npm install -g,也不是装裸包名:
dsh plugin --profile web add "https://github.com/kingcharleslzy-ai/dsh-purge/releases/download/v1.7.20/dsh-purge-community-1.7.20.tgz"两个注意点:--profile 必须与实际启动的 profile 一致;官方 CLI 安装不会执行社区安装器的 SHA256 比对与迁移快照,需要这两个能力就选方式三。
2.3 方式三:社区安装器(带备份与迁移)
先安装并打开一次 DSH 让 profile 初始化,然后下载仓库脚本、先校验再安装。以 Windows Desktop 为例(PowerShell 5.1/7 都可以,不要求管理员权限,路径含空格也支持):
$PurgeInstaller = Join-Path $env:TEMP ('purge-install-' + [guid]::NewGuid().ToString('N') + '.ps1')Invoke-WebRequest -UseBasicParsing -TimeoutSec 90 -Uri 'https://raw.githubusercontent.com/kingcharleslzy-ai/dsh-purge/master/scripts/install.ps1' -OutFile $PurgeInstallerpowershell -NoProfile -ExecutionPolicy Bypass -File "$PurgeInstaller" -DryRun
上一条退出码为 0、核对目标实例后,在同一个 PowerShell 会话里执行:
powershell -NoProfile -ExecutionPolicy Bypass -File "$PurgeInstaller"macOS Desktop 与 Linux 的对应脚本在仓库 README 的「安装」一节,流程同样是「下载 → dry-run → 正式安装」三步。找不到应用或有多个副本时,给两次命令都加 -DshExe(Windows)或 DSH_APP(macOS)指定实际路径;自定义数据目录用 -DshHome / DSH_HOME。
2.4 安装到底改了什么、怎么确认
这一节是我认为这个项目工程素养最足的地方,README 把「安装会改什么」写得非常直白:
安装器在迁移前先备份,再调用当前实例的官方 dsh plugin add,最后核对安装版本和入口;成功后记录一个 backup_id,此时应核对磁盘上的版本;运行中的 DSH 仍可能显示旧版,等你方便时手动退出重开; - 不自动应用宿主补丁、不自动重启、不改代理
、不动全局 npm 源、不清缓存; 命令退出码非零就视为失败,不要拿「dry-run 通过」当作安装成功的证据。
三、日常运维:自检、诊断、探针三板斧

装完只是开始,这个插件真正有价值的部分是它的状态工具链。
3.1 selfcheck:25 层状态自检
purge-community selfcheck --json逐层输出安装、补丁、注入各层的状态与证据,不适用的层会单独标注,而不是笼统报一个错。判断「到底装没装好」,看这一条命令就够了。
3.2 diagnose / reanchor:锚点漂移不再玄学
宿主升级后,插件补丁的落点可能整体位移,这就是「锚点漂移」。处理路径是两步:
purge-community diagnose # 给出漂移文件、行号与候选落点purge-community reanchor # 把确认过的新锚点钉成本地覆盖,可撤销
diagnose 的输出直接给到「文件、行号、候选落点」粒度,reanchor 支持撤销——漂移从一个模糊现象变成了可定位、可修复、可反悔的操作。
3.3 probe:确认注入真的送达
purge-community probe生成运行时探针,验证注入确实送达模型。「我以为生效了」和「生效了」之间的差距,就靠这一步补上。
3.4 常用命令速查

selfcheck [--json] | |
status | |
host-status | |
diagnose | |
reanchor | |
probe [new] | |
audit [--limit n] | |
boost [on|off] | |
retry [on|off] | |
usageprune | |
backuprollback <id> |
四、备份与回滚:随时能回去
应用、安装、回滚前都会自动快照,保留原文件与校验清单; audit随时查看最近动作,谁在什么时候动了什么都有记录; 回滚优先走「Purge → 状态 → 本机备份」,选本次改动前的备份;无界面时用 rollback <id>;usage查备份占用, prune清理旧快照。
更新机制同样克制:维护页把「自动检查」和「自动安装」分成两个开关,默认只检查、间隔 6 小时,安装完成也不会自动重启——什么时候重开由你决定。
五、面板与移动端
插件在 DSH 左侧栏占一整页设置:顶部一句话说明当前状态,主操作是「应用」,其余分区默认折叠、说明收进 ?,维护页可以看最近动作、备份占用和更新偏好。手机端通过 dsh-go 连接宿主后,在全局面板里打开 Purge 即可查看状态与操作记录(仓库标注:移动端目前只在 Android 15 ARM64 模拟器上做过只读验收,写入操作尚未验收)。
六、兼容性与使用边界
6.1 版本兼容
dsh-purge-community | |
diagnose | |
6.2 使用边界(值得认真读一遍)
仓库 README 对适用场景写得毫不含糊:本机学习、个人项目、自动化实验与维护工作;请在你拥有或已获授权的环境中使用,涉及他人系统时先取得许可。配合「本机优先」原则——不改云端账号、不上传提示词或配置——这个项目的边界意识在同类项目里算相当规范的。也提醒一句:插件行为与你所用平台服务条款的匹配度,需要自己在部署前确认,自己的环境自己负责。
七、踩坑与排查
坑 1:下载时报 fetch failed。 1.6.39 起独立安装器会显示失败阶段和错误码,有限重试后可切换系统 curl,两条通道都保留来源、证书和 SHA256 校验。处理顺序:重新下载安装脚本 → 跑 dry-run → 仍失败就按文档提交脱敏诊断行。注意它不会自动改代理、不会重启 DSH。
坑 2:把 dry-run 当安装成功。 dry-run 只代表前置检查、下载和 SHA256 通过,不代表依赖安装、迁移或启动已通过;市场卡片出现、备份存在同样不能替代安装成功证据。认准退出码和磁盘版本核对。
坑 3:面板打不开就直接覆盖安装目录。 README 明确警告不要直接覆盖 Resources/app,先确认版本一致,再按仓库维护文档恢复。
出问题通用三板斧:
purge-community selfcheck --json # 先看哪一层不是 okpurge-community diagnose # 锚点漂移时看候选位置purge-community audit --limit 20 # 最近动作
FAQ
Q1:安装后会自动改我的宿主吗? 不会。安装、应用宿主补丁、重启是三个独立动作,插件不会自动应用补丁、不会自动重启,改什么都要你确认。
Q2:升级宿主后插件异常怎么办? 先 selfcheck --json 看哪层异常,锚点漂移走 diagnose + reanchor,最后 audit 核对最近动作。
Q3:会不会把我的提示词或配置传到云端? 按 README 的设计原则,全部逻辑在本机运行,不改云端账号、不上传提示词或配置。
Q4:CLI 装的和安装器装的有区别吗? 官方 CLI 不做发行包 SHA256 比对与迁移快照;需要备份、旧版迁移、恢复能力就用社区安装器。
Q5:不同预设能保留各自的提示词吗? 1.6.40 起支持 excludePresets 配置,可以把指定预设排除在注入之外(默认空列表、保持原有行为),命令、面板与工具不受影响。
Q6:装完界面看着没变化? 正常。运行中的 DSH 仍显示旧版,手动退出重开即可;重开后仍异常,回到三板斧排查。
总结
dsh-purge Community 是 DSH 生态里工程化程度很高的社区插件:86 条宿主补丁、25 层自检、全程快照可回滚; 安装认准「官方入口首次装、社区安装器迁移装」,dry-run 通过不等于安装成功; 日常运维三板斧: selfcheck --json、diagnose/reanchor、probe;大改动前自动快照, audit全程留痕,rollback随时能回去;使用边界:自有或已授权环境、本机优先、不上传配置。
参考资料:
dsh-purge Community 仓库(见文首项目地址),安装指南与维护文档在仓库 docs/ 目录 DSH 自定义插件市场官方说明(见仓库 README「安装」一节引用的官方文档)
写在最后:这类宿主插件的价值不只在「减少了多少次打断」,更在于它把「改了什么、能不能回去」做成了看得见的证据链。如果你也在折腾 DSH,欢迎在评论区聊聊你踩过的坑。















































































