Skip to main content
K

dsh-purge

kingcharleslzy-ai/dsh-purge

Community-maintained dsh-purge fork with host-policy patches, prompt and rule settings, diagnostics, separate update-check and install controls, and local backup/rollback.

Install

dsh plugin --profile web add github:kingcharleslzy-ai/dsh-purge

README

dsh-purge Community

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

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

Release Checks

当前版本 1.6.55 · 适配 DSH Desktop 0.2.1-rc.3(rc.1 / rc.2 同样通过) · English

1.6.54 修复旧运行时链接迁移和应用失败详情:先备份、失败恢复,保留现有设置。发行说明 · 市场安装与迁移指南。

原项目与作者:基于 小杨 / 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 官方界面(首次安装)

  1. 先打开 DSH 完成初始化。按当前官方文档,进入「插件」,点击「实验性插件」旁的「更多」,启用「自定义插件市场」;然后进入「发现 → 添加索引源」。
  2. 本项目的社区索引:https://kingcharleslzy-ai.github.io/dsh-purge/index.json。
  3. 选择 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.55/dsh-purge-community-1.6.55.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、profile 为 desktop。不要求管理员权限;路径含空格也支持。

$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.55
已验证宿主DSH Desktop 0.2.1-rc.1 / 0.2.1-rc.2 / 0.2.1-rc.3
其它宿主允许安装,自检会标「未验证」;先看 diagnose
Node≥18(桌面版自带运行时即可)

出问题怎么办

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
YuJunZhiXue
kingcharleslzy-ai
kingcharleslzy-ai
luowang-ui
luowang-ui
heigit
heigit
OGHong
OGHong
Wangxiaolu0716
Wangxiaolu0716
wtfsb19
wtfsb19
MingShi350
MingShi350
loLollipop
loLollipop
youki258
youki258
SimonQvQ
SimonQvQ
alexopenfan-xiaxin
alexopenfan-xiaxin
0xnuu
0xnuu
21hbguo
21hbguo
cracer4869
cracer4869
fomaper
fomaper
Kilig1058674225
Kilig1058674225
Musan-34
Musan-34
qianxuno
qianxuno
TLcmmmm
TLcmmmm
Tofu707
Tofu707

名单合并 GitHub 提交者与人工鸣谢记录,自动每日刷新并保留历史贡献者。头像顺序不代表贡献排名,也不将问题报告者误记为代码作者。

Related plugins