dsh-purge 安装避坑:如何装进 DeepSeek Harness 的完整步骤
dsh-purge 是装在本机官方 DeepSeek Harness 上的红队评测插件,把宿主侧拦截与模型自身拒绝拆成两层判定,让评测结论更干净。照本文操作,你能完成 dsh-purge 安装、应用补丁并通过自检,得到一个可随时还原和卸载的评测环境。
功能速览:装完能用的三件事
这三件事就是 dsh-purge 替你省下的地方:
- 清洗页:补丁按组查看,一键应用、还原、卸载,应用前自动备份;省掉手工记录改动与回滚路径。
- 提示词注入:不同模型配置可挂不同提示词,默认提示词面向国模「小码酱」;省掉逐模型重复写样板文案。
- 受控演练台:授权后查看资产与本机环境,技能库与知识库随包提供;省掉人工整理靶标与技能的成本。
演练台的本机资产视图长这样:
路径判断:你该走哪条安装路径
这一步只做一个动作:确认你在用哪个宿主,再决定跑哪一行的命令。
| 正在用的宿主 | 操作路径 |
|---|---|
终端里的官方 dsh web | dsh plugin --profile web add … |
| 官方桌面 EXE | dsh plugin --profile desktop add … |
只有 pnpm、没有 dsh 命令 | 在对应 profile 目录 pnpm add … |
| 命令行装不上、没有 git/pnpm | 手动克隆并改 profile 的 package.json(第 5 步分支) |
不确定就默认走官方 dsh web 一行;装完以会话标题旁的按钮核对是否装对了位置。
核心规则:web 与桌面是两份独立 profile,分开装、分开应用;只给正在使用的那一个宿主安装,装错 profile 要重来。
dsh-purge 安装前必须备齐的 4 个条件
先过一遍这四项,缺了任何一项,对应步骤都会卡住。
dsh命令在 PATH 中;缺了它,本机没有官方 Harness 可加载,插件无处生效。- 明确正在用的宿主是 web 还是桌面;装错一侧,「应用」对当前宿主不生效。
- 版本匹配:当前版本支持 DSH 0.2.1-rc.2 与 0.2.1-rc.5,0.2.0-rc.2 宿主用 1.1.40 及以上,0.1.x 不支持;对不上时补丁全部显示「跳过」,无法生效。
- 能找到
$DSH_HOME目录(通常是~/.dsh,内含profiles/);缺了它,手动路径无从改起,插件不加载。
dsh-purge 安装与应用补丁的 5 个操作步骤
第 1~3 步是主线,第 4、5 步是分支,需要时再进。
核心规则:装包、重启、应用是三个独立动作,漏掉任何一个,补丁都不会进入当前进程。
第 1 步:把插件装进正在用的 profile。
按判断表选对应路径执行:
# web 宿主
dsh plugin --profile web add https://codeload.github.com/HunYiSage/dsh-purge/tar.gz/refs/heads/master
# 桌面宿主,把 web 换成 desktop
dsh plugin --profile desktop add https://codeload.github.com/HunYiSage/dsh-purge/tar.gz/refs/heads/master
只有 pnpm 时先进 profile 目录,不要在仓库根执行;pnpm 拦安装脚本(ERR_PNPM_IGNORED_BUILDS)或你加了 --ignore-scripts 时,末尾补跑脚本:
cd "$DSH_HOME/profiles/web" # 桌面宿主改成 profiles/desktop
pnpm add https://codeload.github.com/HunYiSage/dsh-purge/tar.gz/refs/heads/master
node node_modules/dsh-purge/scripts/ensure-profile-bundle.mjs
装完后 postinstall 会把 dsh-purge 写进 dsh.profile.bundles,并在 cordis.patch.yml 补上本体 insert,缺了这两处宿主不加载插件、界面也没有按钮。
注意:压缩包只用 codeload 地址,github.com/.../archive 会 302 跳转,pnpm 常报 fetch failed;插件市场一键安装会报 already queued: dsh-purge,别用;npm 没有 dsh-purge 这个包名。
预期结果:该 profile 目录出现 node_modules/dsh-purge/package.json。看到即成功;没看到先看卡点排错。
第 2 步:完全退出并重新打开宿主。
把插件写进 profile 不等于改动 @deepseek-ai 包,补丁不进入当前进程。web 端:停掉 dsh web 再启动;桌面端:托盘一起退出后再启动 EXE。
预期结果:会话标题旁出现 dsh-purge 按钮。看到按钮即成功;没出现说明装到了另一份 profile。
第 3 步:应用补丁,让它进入进程。
点会话标题旁的 dsh-purge,打开「清洗」页,点「应用」。应用成功后宿主会自动重启一次,没完成应用不会重启。
注意:这一项不在宿主自己的设置页里,而在插件侧栏内;「应用」只对本宿主生效,不跨 web 与桌面。
预期结果:宿主重启一次,「清洗」页补丁状态变为已应用。看到自动重启且状态已应用即成功。
第 4 步(分支):还原与卸载。
所有改动都有后路。首次应用前每个目标文件自动备份为 <文件>.dshpurge.bak;「还原」用备份覆盖回去并删除备份;「卸载」不是只删文件:先还原已应用的补丁,再删除注入文件、规则库与插件本身,并把指向红队模式的预设默认值改回 standard,避免宿主因找不到预设而无法新建会话。
/purge revert # 对话内,还原
/purge uninstall # 对话内,完整卸载
dsh-purge --revert # 终端,还原
dsh-purge --uninstall # 终端,完整卸载
重复「应用」是幂等的,多次执行不会叠加。
预期结果:卸载后宿主重启一次且能正常新建会话;还原后 .dshpurge.bak 备份被恢复并删除。
第 5 步(分支):手动安装,命令行走不通时的退路。
只改正在用的那个宿主的 profile,不动另一个,不删原有 bundle。先把插件克隆到固定位置,目录名必须是 dsh-purge:
mkdir -p "$DSH_HOME/plugins"
git clone https://gitcode.com/GitHub_Trending/ds/dsh-purge "$DSH_HOME/plugins/dsh-purge"
再备份并修改该 profile 的 package.json,只追加两处:dependencies 增加 "dsh-purge": "file:../../plugins/dsh-purge";dsh.profile.bundles 末尾追加 "dsh-purge"。file: 不要改成绝对路径,patchReload 与版本号都不要动。然后只在该目录装依赖:
cd "$DSH_HOME/profiles/web" # 或 profiles/desktop
pnpm install
预期结果:出现 profiles/<web|desktop>/node_modules/dsh-purge/package.json。看到即成功;报 Could not resolve 就检查 file: 路径,JSON 解析失败就修逗号或还原备份,随后回到第 2、3 步。
注意:按钮没出现多半是改错了另一份 .dsh,回去核对 $DSH_HOME 是哪一份。
如何验证 dsh-purge 安装后补丁已生效
成功以三条可独立核验的判据为准,不靠感觉。
- 会话标题旁有 dsh-purge 按钮,「清洗」页能点「应用」。
- 聊天里发
/purge status(或终端跑dsh-purge --status),能打印出DSH_HOME与补丁列表,且路径正是你在用的那一份;没装的可选包显示「跳过」,不阻塞完成。 - 重新打开宿主后按钮仍在,补丁在启动时自动复查并重应用;npm 升级盖掉
node_modules之后也不用手改文件。
安装卡点排错:6 个常见问题的直接解法
只在某一步没达到预期结果时看这一节。
问:装完会话标题旁没有 dsh-purge 按钮?
profile 与实际宿主不匹配,回正在使用的那一侧。仍没有,就在对应 profile 跑 dsh --dump-config,看有没有 id: dsh-purge 的本体行。没有再补跑 ensure-profile-bundle.mjs,然后完全退出重开宿主。
问:点「应用」后没有任何变化?
缺了重启。应用成功后宿主会重启一次,补丁才进入进程;没完成应用不会重启。确认重启完成后再用 /purge status 自检。
问:插件市场一键安装报 already queued: dsh-purge?
别再点市场,改用 dsh plugin add 或 pnpm add 装压缩包。命令也提示已存在时,先 dsh plugin --profile <web|desktop> remove dsh-purge 再重新 add,然后重走重启流程。
问:为什么 pnpm add dsh-purge 装不上?
npm 仓库没有这个包名,只有压缩包和手动克隆两条路。不要花时间在别的包名上。
问:宿主升级后补丁对不上怎么办?
对不上的条目显示「跳过」,文件不被改动,本次应用仍算完成。等匹配版本后重新应用即可,无需手改文件。
问:web 端和桌面端会互相影响吗?
不会。两侧分开装、分开应用,各自的「应用 / 重启」只作用于自己的宿主,一端操作不动另一端。
收尾:下一步入口与合规边界
跑通后有两条路:在「清洗」页编辑 prompt-inject.md 定制自己的提示词,默认提示词内容见 presets/redteam/;或授权演练台——读声明、等倒计时、滚动到文末并勾选三项,再查看本机资产。
合规边界:本插件的补丁、注入、还原、卸载全部发生在你本机已安装的官方 Harness 上,不对任何公网主机或未授权系统发包。严禁用于未经所有者书面授权的目标、公网在线系统或任何违法用途;开源版攻击任务只放行本机回环与 RFC1918 私网,违者使用许可自动终止并依法独立承担责任。
延伸阅读:
- README.zh-CN.md:完整功能、使用与法律声明
- cordis.patch.yml:补丁与插件配置结构
- release-notes.md:版本变更记录
- lib/redteam/:演练台与清洗页源码目录
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考






