前言¶
在 DeepSeek Harness（DSH）里做学习、写脚本或跑自动化实验时，助手常会卡在交互层：反复确认、提示词与宿主规则互相拉扯、改完设置不确定到底有没有生效。社区里常把针对这类摩擦的插件叫作「破甲」或「无限制模式」——指的是降低往返确认、让 agent 能连续执行任务，并不改变模型能力本身。
dsh-purge（维护者 cute-gugu）是跑在本机上的 Harness 附加组件，分类为 admin-security。当前发行版 2.0.0，README 写明适配 DSH Desktop 0.2.1-rc.3（rc.1 / rc.2 同样通过）。它把状态可见、宿主补丁、提示词注入、预设与备份回滚收到左侧栏整页设置里，并附带 80 条宿主补丁与 25 层状态自检。2.0.0 起已将 dsh-unrestricted 并入本插件，无需再单独安装后者。
本仓库基于 YuJunZhiXue/dsh-purge 独立维护，2.0.0 另合并 yexi-by/dsh-unrestricted（MIT），保留原作者署名与 MIT 许可证，并非原作者官方发行。
这是什么¶
dsh-purge 在本机运行，目标是把日常最耗注意力的事收敛到一处：
- 看清楚状态：安装、补丁、注入是否就绪，可用一条命令或一屏面板给出结论；
- 少一些往返：把反复出现的确认与打断，收敛成一次设置；
- 随时能回去：应用、回滚、开关留记录，操作前自动快照；
- 方便做实验：提示词、规则、预设集中管理，改坏了能撤。
package.json 中的描述为：DSH 指令权威性清洗一体化插件——运行时提示词注入、宿主补丁、预设与演练台；合并自 dsh-purge-community 1.6.55 与 dsh-unrestricted 0.2.4。
设计原则在 README 中归纳为：本机优先（不改云端账号、不上传提示词或配置）、可见（每个动作有状态与证据）、可回滚（应用 / 安装 / 回滚前自动快照）、不替你做决定（只减少摩擦，开什么由你确认）。
核心功能¶
状态与自检¶
- 左侧栏整页面板：顶部一句话说明当前状态，主操作是「应用」；其余分区可折叠，维护页可看最近动作、备份占用、更新偏好。
- 命令行：
purge-community selfcheck [--json]做逐层状态与证据；purge status查看宿主路径与计数；purge-community host-status只读查看安装布局与当前入口；purge-community diagnose做锚点漂移诊断；另有reanchor、probe等维护向命令（完整列表见仓库 README）。
宿主补丁与提示词注入¶
插件通过宿主补丁与运行时提示词注入，降低交互层面的摩擦。README 强调：不会自动应用宿主补丁、不会自动重启——安装、应用补丁、手动重启是独立动作，需在面板中确认「应用」。
2.0.0 合并版说明：dsh-unrestricted 与本插件曾改写同一段系统提示；并入后只吸收运行时注入指纹（attest）与状态端点形状，原 unrestricted 的融合链与设置卡片已移除，避免「看着是开的、实际没上去」。
按预设排除注入（excludePresets）¶
自 1.6.40 起支持 excludePresets：默认空列表；可将 roleplay、minimal 等预设排除在 Purge 提示词注入之外，仍保留命令、面板与工具。切换预设、并行会话与子 Agent 各自判断。这不会撤销全局宿主补丁；配置细节见仓库文档 按预设排除说明。
安装器与迁移¶
社区安装器在迁移前备份，调用当前实例的官方 dsh plugin --profile … add …，核对版本与入口，并保留提示词、规则、更新偏好及其他插件设置。1.6.54 起修复旧运行时链接迁移与应用失败详情：先备份、失败恢复，保留现有设置。
安装与启用¶
DSH 官方入口负责安装插件；社区安装器由本仓库维护，不是 DeepSeek 官方脚本。 已经装过旧版 dsh-purge 或独立面板时，宜用社区安装器原地迁移，不要先卸载。
方式一：DSH 官方界面（首次安装）¶
- 打开 DSH 并完成初始化。按官方文档进入「插件」，在「实验性插件」旁启用「自定义插件市场」，再进入「发现 → 添加索引源」。
- 添加社区索引：
https://kingcharleslzy-ai.github.io/dsh-purge/index.json。 - 选择 dsh-purge，核对来源为
cute-gugu/dsh-purge、包名为dsh-purge，确认后安装。
已有旧包时 README 建议改用方式三（社区安装器）。
方式二：DSH 官方 CLI（首次安装）¶
适用于已安装 dsh 命令且使用 web profile 的 CLI/Web 用户；桌面版用户优先用界面安装。
dsh plugin --profile web add "https://github.com/cute-gugu/dsh-purge"
web 须与实际启动的 profile 一致；自定义数据目录需沿用该实例的 DSH_HOME。README 明确：不要替换成 add dsh-purge 等裸包名；本项目通过 GitHub 发行。
方式三：社区安装器（备份、旧版迁移）¶
先安装并打开一次 DSH。以 Linux CLI/Web 为例：先 dry-run，再正式安装。
PURGE_INSTALL_DIR="$(mktemp -d)"
curl -fSL --connect-timeout 20 --max-time 90 "https://raw.githubusercontent.com/cute-gugu/dsh-purge/master/scripts/install.sh" -o "$PURGE_INSTALL_DIR/install.sh"
sh "$PURGE_INSTALL_DIR/install.sh" --dry-run
校验成功后，在同一终端执行：
sh "$PURGE_INSTALL_DIR/install.sh"
macOS Desktop、Windows PowerShell 的脚本 URL 与参数见 GitHub README 安装章节。安装成功应记录 backup_id 并核对磁盘版本；运行中的 DSH 可能仍显示旧版，需手动退出重开。
安装后怎么确认¶
- 社区安装器不会自动应用宿主补丁；装好后在左侧栏 Purge 面板点「应用」。
- 可用
purge-community selfcheck或面板内状态查看是否就绪。 - 回滚优先用「Purge → 状态 → 本机备份」，或按 安装指南 中的 CLI 回滚。
典型用法¶
状态自检¶
在终端（需能调用插件登记的 purge-community）执行：
purge-community selfcheck
需要机器可读输出时：
purge-community selfcheck --json
面板工作流¶
- 安装插件并重启 DSH（若安装器提示需要）。
- 打开左侧栏 Purge 整页设置，阅读顶部状态摘要。
- 确认备份与目标实例无误后，点击「应用」使宿主补丁生效。
- 维护页查看最近动作；出问题则从本机备份回滚。
与本机出图组合（可选）¶
README 提到可搭配社区插件 Qwen Studio（dsh-qwen-studio）在本机生图；破甲减少「要不要画」的反复确认，出图插件负责实际调用。该组合为可选生态说明，安装与硬件要求见 dsh-qwen-studio 文档。
适用场景与注意¶
适用：本机学习、个人项目、自动化实验与维护工作。README 要求在你拥有或已获授权的环境中使用；涉及他人系统应先取得许可。
权限与安全：插件以当前 DSH 进程权限运行，会修改 profile 下的插件布局，并在你确认后应用宿主补丁。安装前应自行阅读源码、MIT 许可证 与 NOTICE.md，理解补丁与提示词注入的范围。
生态说明：DSH 理念是「一切皆插件」；SkillHub 等社区目录与 DeepSeek / 幻方无官方从属关系，本插件索引由社区维护（kingcharleslzy-ai.github.io/dsh-purge）。
下载失败：独立安装器自 1.6.39 起会显示失败阶段与错误码，有限重试后可切换系统 curl；仍失败见 下载排查说明。安装器不会自动改代理或重启 DSH。
结尾¶
dsh-purge 把「有没有生效、能不能撤、少问多做」收进一套本机可见的自托管流程：官方市场或 CLI 可首次安装，旧版迁移与 SHA256 校验安装器适合已有实例；装完后记得在面板应用补丁并用 selfcheck 验收。
