← 返回条目

dsh-purge · 使用说明

中文版:依据官方 README 翻译整理,保留原有结构与命令

Purge Community

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

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

[](https://github.com/kingcharleslzy-ai/dsh-purge/releases)

[](https://github.com/kingcharleslzy-ai/dsh-purge/actions/workflows/community.yml)

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

1.6.48 修复自定义提示词被误判为默认值,以及安装别名导致版本对账与备份失败的问题;未知正文保留,真实安装错误继续显示。包含既有 Windows 链接清理修复,1.6.45 及以前请使用新版独立安装器升级。发行说明 · 市场安装与迁移指南。


搭配:本机出图(Qwen Studio)

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

配套插件 Qwen Studio(dsh-qwen-studio)把 Qwen Image 2.1 接进 DSH:

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

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

它是什么

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. 选择 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.50/dsh-purge-community-1.6.50.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=实际名称。不要照抄别人的路径。

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=名称 一致。

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

完整的实例选择、回滚与失败恢复步骤见 安装指南,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 快照 / 回滚插件

更新

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

兼容性

组件值
插件dsh-purge-community 1.6.50
已验证宿主DSH Desktop 0.2.1-rc.1 / 0.2.1-rc.2
其它宿主允许安装,自检会标「未验证」;先看 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

kingcharleslzy-ai

luowang-ui

heigit

OGHong

Wangxiaolu0716

wtfsb19

MingShi350

loLollipop

youki258

SimonQvQ

alexopenfan-xiaxin

0xnuu

21hbguo

cracer4869

fomaper

Kilig1058674225

Musan-34

qianxuno

TLcmmmm

Tofu707

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

内容取自仓库 README,未做删改性总结。命令与参数以原文为准。