夜雨聆风学习资料网

ARTICLE · 1394294

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

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 官方界面 + 社区索引(首次安装推荐)

  1. 先打开 DSH 完成初始化,进入「插件」,点「实验性插件」旁的「更多」,启用「自定义插件市场」;
  2. 进入「发现 → 添加索引源」,填入社区索引地址:
https://kingcharleslzy-ai.github.io/dsh-purge/index.json
  1. 选择 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]
回答被中断时的单次重试开关
usage
 / prune
备份占用与清理
backup
 / rollback <id>
快照 / 回滚插件

四、备份与回滚:随时能回去

  • 应用、安装、回滚前都会自动快照,保留原文件与校验清单;
  • audit
     随时查看最近动作,谁在什么时候动了什么都有记录;
  • 回滚优先走「Purge → 状态 → 本机备份」,选本次改动前的备份;无界面时用 rollback <id>;
  • usage
     查备份占用,prune 清理旧快照。

更新机制同样克制:维护页把「自动检查」和「自动安装」分成两个开关,默认只检查、间隔 6 小时,安装完成也不会自动重启——什么时候重开由你决定。

五、面板与移动端

插件在 DSH 左侧栏占一整页设置:顶部一句话说明当前状态,主操作是「应用」,其余分区默认折叠、说明收进 ?,维护页可以看最近动作、备份占用和更新偏好。手机端通过 dsh-go 连接宿主后,在全局面板里打开 Purge 即可查看状态与操作记录(仓库标注:移动端目前只在 Android 15 ARM64 模拟器上做过只读验收,写入操作尚未验收)。

六、兼容性与使用边界

6.1 版本兼容

组件
说明
插件包
dsh-purge-community
,写作时最新发行 1.7.20
已验证宿主
DSH Desktop 0.2.2-rc.1 / rc.2 / rc.3,0.2.1-rc.1 / rc.2 / rc.3 / rc.5
其它宿主
允许安装,自检会标「未验证」,先跑 diagnose
Node
≥ 18(桌面版自带运行时即可)

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,欢迎在评论区聊聊你踩过的坑。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料