1. 痛点突围：它究竟击穿了什么工程死穴？
在传统的 LLM 运行环境中，开发者经常将宿主系统的安全审批、沙箱隔离以及动态提示词重写等逻辑，误判为大模型本身的对抗性拒绝。DeepSeek Harness 在运行时封装了多层策略控制，当请求被拦截时，排查复杂度极高。dsh-purge 的出现直接切断了这种黑盒状态，它将控制权交还给开发者，通过在本地运行时注入清洗逻辑，把运行时的策略过滤层与模型推理层彻底拆开。这种设计让开发者得以在本地受控环境中，精准评估不同提示词对多模型输出的实际响应表现。
💡 架构核心洞见：通过插件化运行时拦截替代硬编码魔改宿主，在保留官方 Harness 基础能力的同时实现动态提示词重写与策略瘦身。
2. 核心架构与底层数据流向解析
dsh-purge 并非运行于云端的扫描器，而是直接挂载于使用者本机的官方 DeepSeek Harness 实例中。其执行链路不读取外部磁盘中的野外提示词，而是依赖插件内部维护的加密提示词模板。整个数据流在本地客户端、配置目录与运行时引擎之间形成闭环：
[ CLI / Desktop Client ] ---> [ dsh-purge Plugin Loader ] ---> [ Local Profile & $DSH_HOME ]
│
▼
[ Dynamic Prompt Injection ]
│
▼
[ Official DeepSeek Harness ]
在工程权衡方面，项目作者放弃了直接侵入修改核心宿主源码的做法，转而采用环境变量 $DSH_HOME、.dsh 启动器目录以及默认 ~/.dsh 的优先级回退策略。这种零硬编码盘符的设计增强了跨平台兼容性，使得 npm 升级覆盖 node_modules 后，清洗状态依然能够通过启动时检查自动恢复，消除了手动维护补丁文件的运维负担。
3. 技术选型与性能横向硬核对比
| 选型维度 | 本方案 (dsh-purge) | 传统远程 API 代理 | 源码硬编码魔改 | 纯前端油猴脚本 | 生产环境收益 |
|---|---|---|---|---|---|
| 运行环境 | 本机官方 Harness 进程 | 云端中转服务器 | 宿主源码仓库 | 浏览器沙箱 | 零数据外泄风险 |
| 策略解耦度 | 提示词与沙箱策略分离 | 仅代理传输不改逻辑 | 强耦合难维护 | 无法触及底层 CLI | 维护成本降低 80% |
| 升级兼容性 | 启动时自动再检查重写 | 协议对齐成本极高 | 每次发版全量冲突 | DOM 变动即失效 | 长期稳定性提升 |
| 网络开销 | 纯本地内存与文件读写 | 增加一次公网转发 | 本地计算 | 浏览器开销 | 消除额外网络延迟 |
该选型方案的核心优势在于本地化和零侵入。传统云端代理容易触发服务条款封禁，而源码魔改则会在官方发版时带来灾难性的合并冲突。dsh-purge 利用插件挂载机制，在保持官方客户端核心功能完整的同时，实现了细粒度的策略过滤与提示词替换。
4. 手把手极客实操：从零构建最小闭环
在开始操作前，需确保系统已安装 Node.js ≥18（若在 Windows 环境下运行无闪窗需求，则必须使用 Node.js ≥22）。官方 Web 端与桌面端需要独立安装，两者的插件配置文件不互通。
以下是通过 npm 快速将插件挂载到官方 Web 端的标准执行命令：
# 将 dsh-purge 插件注入到官方 Web profile 运行环境中
dsh plugin --profile web add dsh-purge
# 若在桌面端（官方 EXE）环境中，需指定 desktop profile 进行独立挂载
dsh plugin --profile desktop add dsh-purge
若当前工作目录为仓库源码根目录，则可将包名替换为本地路径：
# 使用本地源码进行快速挂载与联调
dsh plugin --profile web add .
当遇到国内网络环境下 npm 镜像源无法正常拉取时，可通过指定归档压缩包的 URL 进行安装：
# 从指定仓库归档直接加载对应版本的 tar.gz 包
dsh plugin --profile web add https://github.com/YuJunZhiXue/dsh-purge/archive/refs/heads/master.tar.gz
安装完成后，切记不要直接期望宿主自动识别。必须进入官方界面，点击会话标题旁的 dsh-purge，依次选择 清洗 与 应用。系统在检测到补丁完整后将自动重启并生效。
5. 生产落地踩坑指南与避坑建议 (Gotchas)
在实际部署与运行过程中，有几个由于版本迭代或运行环境差异带来的隐蔽陷阱需要特别规避。
⚠️ 避坑预警 1：版本不匹配导致的策略静默跳过 表现：当前版本严格限定适配 dsh 0.2（对应官方桌面 0.2.0-rc.2 或官方
dsh web）。如果宿主环境仍在使用旧版 dsh 0.1.7，新版补丁将直接跳过而不生效。解决方案是必须根据宿主版本切换至对应历史 Tag（如使用 1.1.39 及更早版本适配旧版）。⚠️ 避坑预警 2：桌面端与 Web 端配置隔离混淆 表现：部分开发者在 Web 端应用成功后，误以为桌面端客户端也同步完成了补丁加载。由于两者进程独立，必须分别为
web与desktop两个 profile 分别执行添加与应用操作，否则会造成行为表现不一致。⚠️ 避坑预警 3：合规红线与法律风险防范 表现：严禁将本项目用于中国大陆、香港、澳门网段及关联服务器的未授权扫描与探测。项目仅限使用者在自己合法拥有的本地官方 Harness 环境中进行防御性科研与鲁棒性评测，任何越权行为将自动终止开源授权并由行为人承担全部法律责任。