dsh purge 安装教程：从 dsh plugin add 到第一次跑规则、权限确认与结果核对

dsh purge 的安装不是「装完就能用」：装进 profile、执行 Apply、重启、核对状态，四步都过才算第一次跑通。 它也不是缓存清理工具，名字里的 purge 容易让人误解。

先澄清：dsh-purge 不是清理工具

dsh-purge 是红队安全评估插件，不是缓存清理或卸载工具。 它把「模型拒绝」与「宿主层拦截」分开观察，并提供面板、规则与回退能力（来源）。

名字里的 purge 指的是策略层面的处理，不是删文件。 如果你在找「清缓存」「清残留」的命令，这篇不对口；卸载与清理另有文章。

用途决定安装方式。 评估类插件需要写宿主策略，所以必须装到实际使用的 profile，并执行 Apply；普通插件装完重启即可，步骤更少。

选版本：先看来源，再谈变体

社区里存在多个同名或近名版本，例如 dsh-purge、dsh-purge-flash、dsh-purge-community。 名字相近不代表功能相同。

1. 先看 owner 与仓库。 同名插件由不同作者维护，实现与维护状态差异很大。
2. 再看插件说明。 说明里会写适用场景、profile 要求与风险边界；没有说明的，不要装。
3. 最后看更新时间。 长期不更新的版本，可能不适配当前核心。
4. 不要按名字假设功能。 flash 不一定更快，community 不一定更全，以说明为准。

选定一个版本后，不要同时装多个。 多个同类插件同时写策略，容易出现覆盖顺序问题，排查成本很高。

记录版本号。 安装前把包名与版本写进记录，回滚和对照都要用；只记显示名，过几天就分不清装的是哪个。

安装三步：装对 profile 是第一步

安装动作本身只有一条命令，难的是装到正确的位置。 三步走完再谈 Apply。

1. 确认 profile： 你用 Web 端就装 web，用桌面端就装桌面端对应 profile；不确定时先 dsh plugin --profile web list 看当前列表。
2. 执行安装： Hub 里搜索并安装，或执行 dsh plugin --profile web add <包名>；安装后确认列表里有该包。
3. 双端分别装： Web 与桌面端是两个 profile，要两边都用，就两边各装一次，不要指望自动同步。

装错 profile 的典型表现是「面板在 A 端有、B 端没有」。 这不是插件坏了，是装到了另一个环境；回到对应 profile 再装一次即可。

安装完成后先不要急着 Apply。 先确认包在列表里、版本正确，再进入下一步；装错版本后 Apply，会多一次回退。

第一次运行：Apply 的顺序

Apply 是把规则写入宿主并触发重启的动作，顺序错了会得到「已安装但未生效」。 按下面的顺序走。

1. 打开插件面板，确认当前状态是「已安装」而不是「已应用」。
2. 阅读当前规则与提示，确认评估范围与授权边界。
3. 执行 Apply，等待写入完成与重启提示。
4. 重启后新开一个会话，不要复用旧会话；旧会话可能仍带着旧策略。
5. 回到面板确认状态变为「已生效」。

新开会话是必要动作。 注入发生在会话初始化阶段，旧会话不会自动重新加载；只在旧会话里验证，容易误判为失败。

Apply 后不要立刻改规则。 先跑一次基准，确认状态与行为符合预期，再做调整；否则改动与初始问题混在一起，无法区分。

结果核对：四个状态

dsh-purge 的状态不止「装没装」，至少有四个。 四个状态对应四种处理。

「已安装」与「已生效」之间隔着 Apply 与重启。 只看到面板就认为成功，是最常见的误判。

「待重应用」不是故障。 升级覆盖 node_modules 后，插件会在启动时自检并尝试恢复；恢复不了再回面板 Apply，不要直接改文件。

安装常见失败

安装阶段的失败集中在四处，每一处都有明确判据。

1. 列表里没有包。 装错 profile、包名写错或安装中断；回到对应 profile 用 list 确认。
2. 面板有但状态不动。 没执行 Apply，或 Apply 被权限拦截；看面板提示与系统日志。
3. Apply 成功但行为不变。 没重启或没新开会话；按顺序补做，不要重复 Apply。
4. 升级后状态异常。 文件被覆盖，状态变「待重应用」；等待自检或重新 Apply。

四种失败的共同排查入口是面板状态与日志。 先看状态，再看日志里的写入与重启记录，最后才怀疑版本。

回滚点：装之前就要留

评估类插件的回滚，不是卸载重装，而是 Restore 到官方默认。 回滚点要在安装前就准备好。

1. 记录安装前状态： 当前 profile、插件列表、核心版本，写进同一份记录。
2. 确认 Restore 可用： 面板里能看到 Restore 入口，说明官方默认副本已就绪。
3. 回滚顺序： 先 Restore，再重启，再新开会话验证；不要用删目录或覆盖文件替代。
4. 回滚后复查： 插件可以保留，但策略已回默认；确认行为恢复后再决定是否卸载。

回滚的目标是恢复行为，不是删除痕迹。 把插件卸了但策略还在，问题依旧；Restore 才是针对策略的动作。

下一步

先确认用途，再装版本，最后按 Apply 顺序跑通。 想了解 Apply、Restore 的日常用法，看《dsh-purge 怎么用》；想管多套规则，看《dsh-purge 的规则集怎么管》；想区分清理与卸载，看《dsh purge 到底清什么》。

来源：dsh-purge 插件页（YuJunZhiXue）、dsh-purge 插件页（mmparko）、DeepSeek Harness 官方文档 - 插件与生命周期、dsh CLI README