前言¶
在 DeepSeek Harness(DSH)里做学习或动手实验时,常见摩擦来自几类问题:宿主补丁是否真正生效、会话里反复出现的确认打断、改坏提示词或规则后难以恢复。社区里常把 dsh-purge Community(俗称「破甲」或「无限制模式」插件)当作客户端侧的自托管控件——它不改模型本身,而是把安装与补丁状态、提示词与规则、应用与回滚收敛到左侧栏整页设置和一组 CLI,让助手更连贯地配合本机任务。
本仓库 kingcharleslzy-ai/dsh-purge 基于 小杨 / YuJunZhiXue 的 dsh-purge 独立维护;保留原作者署名、版权与 MIT 许可证,社区版并非原作者官方发行。当前资料中的版本为 1.6.60,已验证宿主为 DSH Desktop 0.2.1-rc.1 / rc.2 / rc.3。
这是什么¶
dsh-purge Community 是跑在你自己机器上的 DSH 附加组件(npm 包名 dsh-purge-community)。设计目标可以概括为四点:
- 看清楚状态:安装、补丁、注入是否就绪,用自检或面板给结论(资料称约 80 条宿主补丁、25 层状态自检);
- 少一些往返:把反复出现的确认与打断,收敛成一次设置;
- 随时能回去:应用、回滚、开关留记录,操作前自动快照;
- 方便做实验:提示词、规则、预设集中管理,改坏了能撤。
原则表里强调:本机优先(逻辑在本机运行)、可见(动作有状态与证据)、可回滚(快照与校验清单)、不替你做决定(只减摩擦,目标仍由你确认)。
核心功能¶
左侧栏面板¶
左侧栏一整页设置,不做悬浮按钮:顶部一句话说明当前状态,主操作是「应用」;其余分区可折叠,说明收进 ?;维护页可看最近动作、备份占用、更新偏好;支持隐藏不用的入口(例如回退按钮),只影响显示。
状态与宿主诊断¶
常用 CLI 入口为 purge-community(与包内 dsh-purge 并存)。资料中的命令包括:
| 命令 | 作用 |
|---|---|
purge-community selfcheck [--json] |
逐层状态与证据;不适用项单独标注 |
purge-community status |
宿主路径与计数 |
purge-community host-status |
只读查看安装布局与当前入口 |
purge-community diagnose |
锚点漂移诊断,给出文件、行号与候选落点 |
purge-community reanchor … |
把确认过的新锚点钉成本地覆盖,可撤销 |
purge-community probe [new] |
生成运行时探针,验证注入是否送达模型 |
提示词、预设与开关¶
purge-community preset [status\|install]:「无限制模式」预设落盘。purge-community boost [on\|off]:尾部强化段开关。purge-community retry [on\|off]:回答被中断时的单次重试开关。- 1.6.40 起
excludePresets:默认空列表;可将roleplay、minimal等预设排除在 Purge 提示词注入之外,保留命令、面板与工具(不会撤销全局宿主补丁)。细节见仓库 按预设排除说明。
备份、审计与更新¶
purge-community backup/rollback <id>:快照与回滚插件;界面路径为「Purge → 状态 → 本机备份」。purge-community audit [--limit n]:最近动作记录。purge-community usage/prune:备份占用与清理。- 维护页可分别设置「自动检查」与「自动安装」,默认只检查,间隔 6 小时;安装完成不会自动重启。
安装与启用¶
DSH 官方入口负责安装插件;社区安装器由本仓库维护,不是 DeepSeek 官方脚本。 安装、应用宿主补丁、手动重启是独立动作。插件以当前 DSH 进程权限运行,安装前应自行核对源码与 MIT 许可证。
方式一:DSH 官方界面(首次安装)¶
- 打开 DSH 并完成初始化。按官方文档进入「插件」,启用「自定义插件市场」,再进入「发现 → 添加索引源」。
- 社区索引:
https://kingcharleslzy-ai.github.io/dsh-purge/index.json。 - 选择 dsh-purge Community,核对来源为
kingcharleslzy-ai/dsh-purge、包名为dsh-purge-community,确认后安装。
已有旧包 dsh-purge 或旧独立面板时,应用方式三原地迁移,不要先卸载。官方市场说明见 DeepSeek Harness 插件市场文档。
方式二:DSH 官方 CLI(首次安装)¶
适用于已安装 dsh 命令且使用 web profile 的 CLI/Web 用户;web 须与实际启动的 profile 一致,自定义数据目录需沿用该实例的 DSH_HOME。
dsh plugin --profile web add "https://github.com/kingcharleslzy-ai/dsh-purge/releases/download/v1.6.60/dsh-purge-community-1.6.60.tgz"
资料明确:不要替换成 add dsh-purge 或 add dsh-purge-community 这类裸包名;也不是 npm install -g。官方 CLI 安装不会额外运行社区安装器的 Release SHA256 比对及迁移快照;需要这些能力时用方式三。
方式三:社区安装器(备份、旧版迁移、恢复)¶
先安装并打开一次 DSH,让实际 profile 初始化。从本仓库 master 下载脚本,先 --dry-run / -DryRun,校验通过后再正式安装。dry-run 成功只代表前置检查、下载和 SHA256 通过,不代表迁移或启动已通过;请先阅读下载的脚本。
macOS Desktop(默认 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=实际名称。
Linux · CLI / Web 同样使用上述 install.sh 流程;默认 PATH 中的 node / dsh 与 web profile,Node ≥18。
Windows Desktop 使用 scripts/install.ps1,PowerShell 中先 -DryRun 再正式执行;找不到或多个 DSH 副本时用 -DshExe 指定可执行文件完整路径。
安装成功后记录 backup_id,核对磁盘版本;运行中的 DSH 仍可能显示旧版,需手动退出重开。失败时回滚优先用面板「本机备份」或 安装指南中的 CLI 回滚。完整步骤见仓库 INSTALLATION.md。
典型用法¶
安装后确认是否就绪¶
先做逐层自检,需要机器可读输出时加 --json:
purge-community selfcheck
只看宿主路径与计数:
purge-community status
补丁或 DSH 升级后若怀疑锚点漂移,只读诊断:
purge-community diagnose
面板主流程¶
打开 DSH 左侧栏 Purge 整页:阅读顶部状态摘要 → 按需展开分区 → 确认后点击「应用」。资料说明不会自动应用宿主补丁;应用后是否重启由你决定。
与 Qwen Studio 组合(可选)¶
README 提到配套插件 Qwen Studio(dsh-qwen-studio)可在本机接 Qwen Image 2.1;破甲减少 Agent 反复确认,出图插件负责实际调用。此为生态组合说明,安装 dsh-purge 不依赖该插件。仓库:kingcharleslzy-ai/dsh-qwen-studio。
适用场景与注意¶
- 适合:本机学习、个人项目、自动化实验与维护工作;请在拥有或已获授权的环境中使用。
- 兼容性:插件 1.6.60 已在 DSH Desktop 0.2.1-rc.1 / rc.2 / rc.3 验证;其它宿主允许安装,自检会标「未验证」,可先跑
diagnose。 - 下载失败:1.6.39 起独立安装器会分阶段显示错误并有限重试、可切换系统 curl;仍失败见 下载排查说明。不会自动改代理或重启 DSH。
- 权限与安全:社区索引与 GitHub Releases 由维护者发布,与 DeepSeek / 幻方无官方从属关系;DSH 生态理念是「一切皆插件」,本文档中的市场入口属于社区目录,不是官方应用商店。
结尾¶
dsh-purge Community 把宿主兼容、状态诊断、提示词与规则管理、更新与本机备份回滚收到一处,面向希望在本机减少交互摩擦、又需要可验证、可回滚的 DSH 用户。