kingcharleslzy-ai/dsh-purge：社区版 · DeepSeek Harness 社区维护版：宿

技术解读

以下内容由 GitRead 中文社区编辑团队基于项目 README 与官方资料整理，结合中文开发者的常见使用场景补充技术选型建议。具体以项目官方文档为准。

dsh-purge 深度拆解：把「状态治理」做进 DeepSeek Harness 的本地运行时

项目背景与痛点

DeepSeek Harness 这类“模型运行时脚手架”有一个结构性问题：它并非独立服务，而是嵌在宿主里——IDE 插件、命令行、浏览器扩展，甚至 CI 容器。状态由此散落成多份：插件目录下的 config.json、用户级的 ~/.deepseek 缓存、以及项目内的 .dsh 文件。

版本一升级问题就暴露了：旧字段没清、新字段没写、用户改过的提示词又被模板静默覆盖。最终表现为“模型行为莫名其妙变了”，却没人能定位到是哪一层配置出了问题。这类故障最难排查，因为它不抛异常，只让输出缓慢劣化。

dsh-purge 正是针对这类状态问题而设计。名字里的 purge 容易被误读为“一键清理工具”，但看能力清单——宿主兼容、状态诊断、提示词管理、更新与本机备份回滚——它实质是一个本地状态治理层：先诊断，再计划，后执行，每步留痕。

核心技术揭秘

整体是三层结构加两段式执行：适配层收敛宿主差异，领域层做诊断与提示词管理，存储层负责快照与回滚。

graph TD A[CLI 与宿主入口] --> B[编排器 Orchestrator] B --> C[状态诊断引擎] B --> D[提示词仓库] B --> E[快照与回滚服务] C --> F[宿主适配层 Host Adapter] D --> F F --> G{"宿主类型判断"} G -->|"IDE 插件"| H[插件配置目录] G -->|"命令行"| I[用户级配置] G -->|"通用兼容"| J[文件系统直读] C --> K{"诊断结论"} K -->|"状态漂移"| L[生成修复计划] K -->|"状态干净"| M[输出结构化报告] L --> N[用户确认] N --> O[事务化执行] O --> E E --> P[内容寻址备份存储]

关键点一：宿主适配层是抽象，并非 if-else 堆砌。 宿主差异被收敛为 locate / read / write 三个能力位；核心逻辑不感知自己身处 VS Code 还是纯 CLI。对不可写宿主（部分插件禁止外部写入），适配器降级为只读模式，只输出报告——这种能力协商，而非硬编码降级，是它能在多宿主上不出错的前提。

关键点二：诊断引擎采用规则集模型，与 ESLint 思路相同，但治理对象从源码变成运行时状态。每条规则产出一个 Finding：严重级别、位置、证据片段、是否可自动修复。把“可修复性”作为一等字段带来一个好处：--dry-run 和 apply 可以使用同一套规则，不会出现“报告说有问题、修复却改不动”的错位。

关键点三：两段式执行。diagnose 与 plan 全程只读，只有 apply 才写；且 apply 前强制生成快照。这是数据库迁移工具（alembic / flyway）的经典范式——变更前先备份。写入采用“临时文件 + rename”的原子替换，避免宿主在回滚期间读到不完整状态。

关键点四：备份与回滚的语义。备份按内容寻址并附带 manifest，回滚采用“恢复 manifest 指向的那棵状态树”的做法；它并非逐文件覆盖。这种设计保证了即使宿主在备份后仍写入新文件，也能回到某个已知一致的切片，而不只是把几个文件还原成旧版本。

关键点五：提示词分层合并。base / overlay / patch 三层结构，合并时做三方比较（如同 git merge）：用户改动与上游模板更新冲突时显式报错，而不是静默取胜。这是提示词工程从“文本编辑”走向“配置管理”的分水岭。

功能亮点与差异

真正区别在于**“诊断先于修复”的克制**，功能多寡只是次要层面。大量清理类工具一上来就删，出问题只能重装；dsh-purge 把可观测性前置，报告本身就是产物。其次是回滚的一致性语义——多数备份工具做的是“文件级还原”，它做的是“状态树还原”。再次是提示词冲突显式化，这在社区维护版里尤其重要：上游模板持续演进，用户本地又各有定制，静默合并迟早会引发严重问题。

应用场景与落地建议

最适合两类场景：一是团队共享 harness 配置，把 diagnose 塞进 CI 作为准入检查，升级前后各跑一次对比；二是个人长期使用多宿主（IDE + CLI），用它统一状态基线。

落地注意三点：备份目录不要放在同步盘或提交进仓库，否则内容寻址失去意义；写操作必须幂等，被 CI 重复触发时不能累积副作用；升级上游版本前先 plan 看 diff 再 apply，别跳步。生产环境建议先在 staging 跑 --strict，让低级别 Finding 也阻断。

综合评价

优点：架构分层干净，适配层让宿主兼容性成为可扩展项而非负担；只读诊断与原子写入的组合，把“改坏配置”的风险压到很低；提示词三方合并是同类工具里少见的正确取舍。

缺点：诊断规则的覆盖度高度依赖社区跟进上游版本，规则集滞后会造成“假干净”；无 GUI，对非命令行用户门槛偏高；与 DeepSeek Harness 生态强耦合，脱离该生态价值骤降。

一句话：它更像是 harness 的版本控制加体检报告，并非一键清理脚本。值得放进工具链，但前提是你要接受“先看报告再动手”的工作节奏。

关于

agent-tools backup deepseek deepseek-harness dsh dsh-plugin jailbreak prompt-injection prompt-management purge-community rollback

MIT License
6.0k Stars
2.8k Forks
11 Watching

简要分析

热度分

11615

价值分

4449

活跃状态

活跃

GitHub

语言占比

CSS

JavaScript

PowerShell

Shell

Release

贡献者

dsh-purge Community

让 AI 更专注地辅助你的学习与动手实验。

给 DeepSeek Harness 的自托管控件（俗称「破甲」插件）· 86 条宿主补丁 · 25 层状态自检 · 左侧栏整页设置

当前版本 1.6.86 · 适配 DSH Desktop 0.2.2-rc.1（0.2.1-rc.1 / rc.2 / rc.3 / rc.5 同样通过） · English

1.6.86 为已授权测试入口增加一次性命令执行挑战，区分文件写入与命令执行。发行说明。

原项目与作者：基于小杨 / YuJunZhiXue 的 dsh-purge 独立维护。原仓库已恢复；保留原作者署名、版权与 MIT 许可证。社区版由本仓库维护，并非原作者官方发行。

搭配：本机出图（Qwen Studio）

破甲之后最直接的玩法，是把「生图」也搬到本机——不用网页、不用会员、不把提示词发到别人服务器。

配套插件 Qwen Studio（dsh-qwen-studio）把 Qwen Image 2.1 接进 DSH：

Apple Silicon Mac：MLX / MFLUX 本机推理，模型用时加载、空闲释放；
Windows / Linux + NVIDIA：连你自己的 GPU 网关（ComfyUI 或 vLLM-Omni 协议），也支持 SSH 按需拉起；
支持参考图编辑（按图改画风、换材质）、LoRA、ControlNet、蒙版、整套预设、图库与批量任务；
装好之后，会话里直接说「画一张…」或「把这张改成水彩」，Agent 调用 qwen_generate_image 并把图返回到对话里。

组合效果：破甲让 Agent 不再反复确认「要不要画」，出图插件让它真的画出来，全程在你自己的机器上完成。

仓库：kingcharleslzy-ai/dsh-qwen-studio · 下载：最新 Releases · 安装与硬件自查：docs/SETUP.md（先看「这台机器能不能跑」再动手）

它是什么

dsh-purge Community 是一个跑在你自己机器上的 Harness 附加组件。它把日常使用里最消耗注意力的几件事收敛到一处：

看清楚状态：安装、补丁、注入到底有没有就绪，一条命令或一屏面板给结论；
少一些往返：把反复出现的确认与打断，收敛成一次设置；
随时能回去：应用、回滚、开关都留记录，操作前自动快照；
方便做实验：提示词、规则、预设集中管理，改坏了能撤。

目标很简单：让助手更连贯地配合你的学习与动手实验，而不是每做一步都先停下来问一句。

社区里通常把它叫作「破甲」或「无限制模式」插件——指的是它降低了交互层面的摩擦，让 agent 能连续执行任务；它不改模型本身，也不改变你要做的事。

下载时报 `fetch failed`？

1.6.39 起，独立安装器会显示失败阶段和错误码，有限重试后可切换系统 curl；两条通道都保留来源、证书和 SHA256 校验。请先重新下载安装脚本再运行 dry-run，仍失败时提交脱敏诊断行即可。见下载排查说明。不会自动修改代理或重启 DSH。

让不同预设保留自己的提示词

1.6.40 新增 excludePresets：默认空列表，保持原有行为；可将 roleplay、minimal 等预设排除在 Purge 提示词注入之外，保留命令、面板与工具。切换预设、并行会话和子 Agent 各自判断，宿主兜底也遵守排除。配置示例、升级步骤与边界见按预设排除说明。这不会撤销全局宿主补丁。

设计原则

原则	含义
本机优先	全部逻辑在本机运行，不改云端账号、不上传提示词或配置
可见	每个动作都有状态与证据，不靠"应该生效了"这种判断
可回滚	应用 / 安装 / 回滚前自动快照，保留原文件与校验清单
不替你做决定	只减少摩擦，不改变你的目标；改什么、开什么，都由你确认

适用场景

本机学习、个人项目、自动化实验与维护工作。请在你拥有或已获授权的环境中使用；涉及他人系统时，先取得许可。

1.6.39 更新

修复独立安装器只显示 fetch failed 的问题：分阶段诊断、有限重试和系统 curl 备用下载，继续严格校验官方来源、证书和 SHA256。下载失败不触碰现有安装。发行说明 · 配置与验收

安装

DSH 官方入口负责安装插件；下面的社区安装器由本仓库维护，不是 DeepSeek 官方脚本。 首次安装可用官方界面或 CLI；已经装过 dsh-purge / 旧独立面板时，用社区安装器原地迁移，不要先卸载。安装、应用宿主补丁、手动重启是独立动作。

方式一：DSH 官方界面（首次安装）

先打开 DSH 完成初始化。按当前官方文档，进入「插件」，点击「实验性插件」旁的「更多」，启用「自定义插件市场」；然后进入「发现 → 添加索引源」。
本项目的社区索引：https://kingcharleslzy-ai.github.io/dsh-purge/index.json。
选择 dsh-purge Community，核对来源为 kingcharleslzy-ai/dsh-purge、包名为 dsh-purge-community，确认后安装。

界面和安装协议由 DSH 提供，索引与插件由社区维护。不同 DSH 版本的入口文字可能不同；第三方 dsh-market 也可能有额外的筛选与迁移限制。已有旧包时请使用方式三。官方市场说明

方式二：DSH 官方 CLI（首次安装）

下面命令适用于已经安装 dsh 命令、且使用 web profile 的 CLI/Web 用户，在 macOS/Linux 终端或 Windows PowerShell 中运行。桌面版用户优先用上面的界面；不要为了安装插件再用 npx 下载另一套宿主。

dsh plugin --profile web add "https://github.com/kingcharleslzy-ai/dsh-purge/releases/download/v1.6.86/dsh-purge-community-1.6.86.tgz"

web 必须与实际启动的 profile 一致；自定义数据目录需要沿用该实例的 DSH_HOME。命令使用本次发行的固定版本 URL；不是 npm install -g，也不是安装裸 npm 包名。本项目通过 GitHub 发行，不要替换成 add dsh-purge 或 add dsh-purge-community。官方 CLI 的安装不会额外运行我们安装器的 Release SHA256 比对及迁移快照；需要这些功能时选方式三。官方 CLI 安装说明

方式三：社区安装器（备份、旧版迁移、恢复）

先安装并打开一次 DSH，让实际 profile 初始化。以下命令下载本仓库的脚本，先校验，再安装；dry-run 通过仅代表前置检查、下载和 SHA256 通过，不代表依赖安装、迁移或启动已通过。请先阅读下载的脚本。

macOS Desktop

默认应用位置 /Applications/DeepSeek Harness.app、数据目录 ~/.dsh、profile desktop。将下面两段放在同一个终端会话中执行：

PURGE_INSTALL_DIR="$(mktemp -d)"
curl -fSL --connect-timeout 20 --max-time 90 "https://raw.githubusercontent.com/kingcharleslzy-ai/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"

自定义应用或 home 时，先设置 DSH_APP / DSH_HOME；自定义 profile 对两次命令都加 --profile=实际名称。不要照抄别人的路径。 macOS 支持从 XML/二进制 plist 读取真实可执行文件名；元数据无效会停止，不会换用其他应用。详见定位边界。

Windows Desktop · PowerShell 5.1 / 7

脚本会尝试定位唯一的 DSH Desktop，默认 home 为用户的 .dsh。旧 Desktop CLI 默认 profile 为 desktop，带独立 dsh CLI 的新壳默认为 web；自定义 profile 用 -Profile 指定。不要求管理员权限；路径含空格也支持。

$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 $PurgeInstaller
powershell -NoProfile -ExecutionPolicy Bypass -File "$PurgeInstaller" -DryRun

上一条退出码为 0、核对目标实例后，在同一个 PowerShell 会话中执行：

powershell -NoProfile -ExecutionPolicy Bypass -File "$PurgeInstaller"

找不到应用或有多个副本时，对两次命令都增加 -DshExe '实际的 DeepSeek Harness.exe 完整路径'；自定义目录用 -DshHome、profile 用 -Profile。ExecutionPolicy Bypass 只作用于这次子进程，不修改持久执行策略；组织策略仍可能禁止执行，遇到时报告错误，不修改系统策略。

Linux · CLI / Web

先安装 Node ≥18 和 DSH CLI，并初始化实际使用的 profile。以下从下载开始，不要求已 clone 本仓库：

PURGE_INSTALL_DIR="$(mktemp -d)"
curl -fSL --connect-timeout 20 --max-time 90 "https://raw.githubusercontent.com/kingcharleslzy-ai/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"。默认使用 PATH 中的 node / dsh 与 web profile。自定义实例在两次调用中保持 DSH_NODE、PURGE_DSH_CLI、DSH_HOME、--profile=名称 一致。

安装会改什么，以及怎么确认

社区安装器在迁移前备份，调用当前实例的官方 dsh plugin --profile … add …，再核对安装版本和入口；保留提示词、规则、更新偏好及其他插件设置。
不是“完全不碰宿主目录”：解包桌面布局缺失/损坏 app/runtime 链接时，会保留旧链接并修复到该安装的 runtime；冲突则停止。Linux 系统宿主只读时可能创建用户副本，并在成功后切换用户启动器。详见安装指南。
插件加载前若市场安装失败（issue #7），插件本身尚未运行；先读脱敏错误、核对依赖来源，不能承诺安装器能修复所有市场或网络错误。
不自动应用宿主补丁、不自动重启、不改代理、不修改全局 npm 源或清空缓存。脚本和 bootstrap 从本仓库 master 下载；Release 包另做 SHA256 校验，这不是对下载脚本的独立签名验证。
命令退出码非零就视为失败。安装成功后记录 backup_id，核对磁盘版本；运行中的 DSH 仍可能显示旧版，待用户方便时手动退出重开。dry-run 成功、备份存在或市场卡片出现都不能替代安装成功证据。
回滚优先用「Purge → 状态 → 本机备份」，选择本次安装前的备份；无界面时按安装指南中的 CLI 回滚执行。不要假设 purge-community 已加入系统 PATH。

完整的实例选择、回滚与失败恢复步骤见安装指南，Agent 必须先读 AGENTS.md §12。

面板

左侧栏一整页，不做悬浮按钮：

顶部一句话说明当前状态，主操作是「应用」；
其余分区折叠，说明收进 ?，需要时再展开；
维护页可看最近动作、备份占用、更新偏好；
支持隐藏不用的入口（例如回退按钮），只影响显示。

常用命令

命令	作用
`purge-community selfcheck [--json]`	逐层状态与证据；不适用项单独标注
`purge-community status`	宿主路径与计数
`purge-community host-status`	只读查看安装布局与当前入口（不换包、不重启）
`purge-community diagnose`	锚点漂移诊断，给出文件、行号与候选落点
`purge-community reanchor …`	把确认过的新锚点钉成本地覆盖，可撤销
`purge-community probe [new]`	生成运行时探针，验证注入确实送达模型
`purge-community audit [--limit n]`	最近动作记录
`purge-community boost [on\|off]`	尾部强化段开关
`purge-community preset [status\|install]`	「无限制模式」预设落盘
`purge-community retry [on\|off]`	回答被中断时的单次重试开关
`purge-community usage` / `prune`	备份占用与清理
`purge-community backup` / `rollback <id>`	快照 / 回滚插件

更新

维护页分别设置「自动检查」与「自动安装」，默认只检查，间隔 6 小时。安装完成不会自动重启——你决定什么时候重开。

兼容性

组件	值
插件	`dsh-purge-community` 1.6.86
已验证宿主	DSH Desktop 0.2.2-rc.1 / 0.2.1-rc.1 / 0.2.1-rc.2 / 0.2.1-rc.3 / 0.2.1-rc.5
其它宿主	允许安装，自检会标「未验证」；先看 `diagnose`
Node	≥18（桌面版自带运行时即可）；红队工具需 ≥22.5（`node:sqlite`）

出问题怎么办

purge-community selfcheck --json     # 先看哪一层不是 ok
purge-community diagnose             # 锚点漂移时看候选位置
purge-community audit --limit 20     # 最近动作

面板打不开时，先确认版本一致，再按维护文档恢复；不要直接覆盖 Resources/app。

开发与验证

npm test                 # 单元与契约测试
npm run check:docs       # 版本与文档一致性
npm run check:client     # 面板 bundle 与源码一致
npm run test:electron    # 真实 Electron 环境（临时目录，不改安装）
npm run smoke            # 发行包冒烟

面向 AI agent 的操作说明在 AGENTS.md，两者冲突时以它为准。

关键词：破甲 · 无限制模式 · unrestricted · prompt injection · jailbreak · DSH 插件 · 状态自检 · 备份回滚

贡献者

感谢原作者、代码贡献者，以及提供问题复现、分析与验证的朋友。头像链接直达 GitHub 主页；具体贡献见贡献记录，第三方来源见 NOTICE.md。

_YuJunZhiXue	_{kingcharleslzy-ai}	_luowang-ui	_heigit	_OGHong	_{Wangxiaolu0716}
_wtfsb19	_MingShi350	_loLollipop	_youki258	_SimonQvQ	_{alexopenfan-xiaxin}
_Minervaowl7	_ShiTan-677	_Minggle	_{Steooenwolf-666}	_{a320583781-create}	_{longyanbo1224-debug}
_0xnuu	_21hbguo	_AkiraNyx	_cracer4869	_fomaper	_{Kilig1058674225}
_Legeo969	_LinyiAIGC	_lyufeng000	_Musan-34	_qianxuno	_TLcmmmm
_Tofu707