文章目录
- 一、先把话说明白
- 二、它到底解决了什么问题
- 它明确划出的使用边界
- 三、核心心智模型：五层，各管一件事
- 三个必须记住的推论
- 四、生命周期：装 → 应用 → 重开
- 什么时候需要再点一次「应用」
- 一个容易被忽略的红线
- 五、安装：三条路，别走错
- 5.1 三种方式怎么选
- 5.2 方式一：官方界面（首次安装）
- 5.3 方式二：官方 CLI（首次安装）
- 5.4 方式三：社区安装器（备份 + 迁移 + 恢复）
- macOS Desktop
- Windows Desktop（PowerShell 5.1 / 7）
- Linux CLI / Web
- 5.5 dry-run 到底验证了什么
- 5.6 安装会改什么，怎么确认
- 六、状态自检：25 层，以及五种状态的真实含义
- 6.1 五种状态，别混
- 6.2 三条排障纪律
- 6.3 逐文件明细：为什么需要 `patch_files`
- 6.4 一条命令的读法
- 七、运行时探针：证明"注入真的到了模型"
- 7.1 文件被改 ≠ 模型收到
- 7.2 探针给出的判定树
- 八、锚点漂移：宿主升级后最真实的痛点
- 8.1 补丁是怎么"钉"在宿主源码上的
- 8.2 `diagnose`：不只告诉你"找不到"，还告诉你"可能在哪"
- 8.3 `reanchor`：把确认过的新锚点钉成本地覆盖
- 8.4 新增一条补丁的四条规矩
- 8.5 `expect` 命中数契约：1.6.64 的关键升级
- 8.6 漂移判定：从"假绿"到"显式红"
- 九、注入组装：order 那个反直觉的坑
- 9.1 宿主 section 的 order 区间
- 9.2 强化段为什么默认放"最前"
- 9.3 两个开关别搞混
- 9.4 `complete` 模式的排序修正（1.6.64）
- 十、拒绝检测 + 单次重试：一个克制的钩子
- 10.1 它解决什么
- 10.2 实现（关键代码逻辑）
- 10.3 四个设计取舍，每个都值得学
- 10.4 排查口径
- 十一、权限、预设与"按预设排除"
- 11.1 权限配置只有两行，但很关键
- 11.2 `ask_user_question` 的等待语义（1.6.25 修的坑）
- 11.3 `unrestricted` 预设：它只改人格，不改闸门
- 11.4 `excludePresets`：给不同预设留出呼吸空间
- 一个必须理解的安全设计
- 十二、快照、回滚、维护锁与审计
- 12.1 快照里到底装了什么
- 12.2 回滚的精确语义
- 12.3 维护锁：不按超龄强删
- 12.4 审计：`audit.jsonl`
- 十三、命令全表：13 个命令 + 退出码语义
- 13.1 找不到命令怎么办
- 13.2 `host-status` 到底给了什么证据
- 十四、症状 → 动作：一张真正的排障决策树
- 14.1 三条"别做"的反向清单
- 14.2 `读取失败: timeout` 怎么理解
- 十五、Windows 密封宿主换包：最容易"假成功"的一环
- 15.1 它不再"自动退出、自动重开"
- 15.2 状态文件的读法（关键）
- 15.3 一个真实的"Electron 陷阱"
- 15.4 归档备份的命名与红线
- 15.5 macOS 同理：必须 ⌘Q
- 十六、六个"看起来没事、实际是坑"的细节
- 16.1 文件权限：0600 不能变 0644
- 16.2 Junction 递归删除会"越界"
- 16.3 用户正文不能被"默认值"覆盖
- 16.4 只读诊断不等于运行态
- 16.5 `!!js` 表达式绝不执行
- 16.6 命令重名：让位而不是抢占
- 十七、网络、更新与凭据：全部收在本机
- 17.1 更新偏好：检查与安装分开
- 17.2 凭据只去一个地方
- 17.3 代理的优先级链条
- 17.4 下载失败的分层诊断（1.6.39）
- 17.5 镜像缺版本：唯一允许"定向回退官方源"的场景
- 十八、两个兼容性深水区
- 18.1 预设迁移：`toolFilter` 不能只删除
- 18.2 插话语义：steer vs queue
- 十九、兼容性与验证：怎么自己确认"我真的装对了"
- 19.1 兼容矩阵
- 19.2 项目自己的五条验证命令
- 19.3 一条我认为最该学的测试纪律
- 二十、把 82 条补丁"读懂"的方法论
- 20.1 一条鲜明的架构立场
- 二十一、给不同读者的三条上手路径
- 21.1 第一次装：最短路径
- 21.2 已经装过旧包：迁移路径
- 21.3 宿主刚升级：修复路径
- 二十二、十个最容易误判的点（自检清单）
- 二十三、写在最后：为什么这套东西值得花钱学
装完插件发现模型还是不停追问、该拒还拒？问题不在插件，在于你只完成了三步里的第一步：安装 ≠ 应用 ≠ 生效。
本文拆解一个 82 条宿主补丁、25 层状态自检的开源 DSH 增强项目，讲透三件事：为什么"点完应用"必须退出重开；宿主升级后锚点漂移如何用诊断+重锚在几分钟内修回；以及一个反直觉结论——强化语放最前比放最后有效得多（实测 0/6 vs 2/6）。
附五层心智模型、症状排障决策树、10 条误判清单，以及"预期命中数契约"这套可直接复用到任何宿主改造项目的工程方法论。
一、先把话说明白
一句话结论：
dsh-purge Community不是一个"破解模型"的魔法补丁，而是一套跑在你自己机器上的 Harness 附加组件——它把"状态看不见、确认点不完、改坏了回不去"这三件事一次性收敛掉。理解它的关键，不是记命令，而是记住一句话：安装 ≠ 应用 ≠ 生效。
我在读这个项目的文档时，被一句话戳中了：
社区里通常把它叫作「破甲」或「无限制模式」插件——指的是它降低了交互层面的摩擦，让 agent 能连续执行任务；它不改模型本身，也不改变你要做的事。
这句话非常重要。因为 90% 的人第一次用
