开源评测：dsh-purge｜给AI客户端装上状态自检与补丁控制面，社区代号「破甲」
专栏系列：GitHub本周最热开源独立评测｜Valhalla SafeNet 取证审计
标签：AI客户端DeepSeek Harness补丁管理Agent控制面前端注入开源审计
文章等级：深度技术评测｜证据驱动型，适配精选、原力计划
作者：Valhalla Matrix治理实验室
⚠️【前置风险声明】
本文仅基于固定commit源码快照做静态取证分析，不推荐、不引导生产环境部署。dsh-purge通过asar替换、补丁注入方式修改DeepSeek Harness（DSH Desktop）客户端本体，大概率违反DSH官方EULA与用户协议；项目社区代号「破甲」，具备弱化人机确认弹窗的能力，会改变Agent交互安全基线；内置market插件分发目录存在供应链风险。仅适合技术研究、架构学习。本文不提供任何安装、注入实操指导，不承担协议违规、客户端崩溃、数据泄露等相关责任。
摘要
本周GitHub热榜第6名dsh-purge，是面向DeepSeek Harness（DSH Desktop）的补丁管控与状态自检控制面，社区俗称「破甲」。
项目内置80条宿主补丁、25层逐级状态自检链路，核心解决补丁注入场景里最头疼的问题：无法可靠判断补丁是否真正生效，区分读取失败与未安装两种状态；同时配套Qwen Image生图接入能力、插件市场分发体系。
一个极具辨识度的指标：它的Fork/Star比值高达0.551，远高于常规开源项目，侧面反映项目高度依赖二次定制、社区分发形态特殊。
本文基于Valhalla SafeNet合规浅克隆快照（固定commit：27919a3），从设计原理、自检链路、兼容矩阵、生态特征、合规风险、落地决策清单完整拆解，同时提炼可复用的插件系统工程设计思路。
一、项目基础档案
| 项目项 | 详情 |
|---|---|
| 仓库地址 | kingcharleslzy-ai/dsh-purge |
| 本周热度 | GitHub热榜第6名 ⭐2729，Fork 1503 |
| 取证Commit | 27919a3（2026-10-25推送） |
| 主语言 | JavaScript / MJS |
| 开源协议 | MIT（LICENSE + NOTICE.md 权属声明完整） |
| 当前版本 | 1.6.60 |
| 适配宿主 | DSH Desktop 0.2.1-rc.3，兼容 rc.1 / rc.2 |
| 取证方式 | SafeNet合规浅克隆：git clone --depth 1 --filter=blob:none --no-checkout --no-tags |
| 快照核验 | 30个抽样文件Blob全核验，证据覆盖率100%，SHA256 manifest绑定 |
一句话定位：为DSH桌面AI客户端构建一套可观测补丁生命周期控制面，包含自检、补丁注入、配置预设、插件分发、第三方模型接入能力；社区俗称「破甲」，核心争议点在于弱化原生人机确认校验流程。
二、技术深潜：区别于普通插件的核心设计
市面上绝大多数AI客户端插件，只关注「能不能注入功能」，很少解决「注入之后如何确认状态」。dsh-purge的核心创新，就是把补丁的生命周期做成可观测闭环。
2.1 25层状态自检：解决补丁工具最大痛点
常规插件的通病：执行注入脚本后，用户分不清三类情况：
- 补丁成功生效
- 补丁写入失败
- 读取状态接口报错（程序读不出来，不等于补丁没装）
项目的三层核心设计：
✅25层逐级自检链路：分层校验注入锚点、asar替换、缓存、配置、宿主版本、权限、进程状态，不是单一布尔判断；
✅陈旧缓存隔离：主动规避上一次运行遗留的旧状态证据，防止缓存污染导致误判；
✅状态语义分离：严格区分「读取失败」和「未安装」两种状态，避免用户无意义反复重装。
这一套设计，是它和普通注入脚本最大的分水岭：把模糊的“改没改好”，变成可查询、可输出、可命令行读取的标准化状态结论。
2.2 宿主版本兼容矩阵
目标宿主：DeepSeek Harness Desktop
- 主推版本：0.2.1-rc.3
- 向下兼容：rc.1、rc.2
- 项目版本：1.6.60
对asar替换、内部DOM/JS锚点注入类工具，RC版本之间内部结构经常变动，能同时维护3个RC版本兼容，说明作者主动维护适配矩阵，而非一次性hack。但只要宿主官方升级，补丁锚点随时失效。
2.3 「少一些往返」：效率提升背后的安全权衡
项目文档标注的能力：收敛重复确认弹窗，减少交互打断。
从用户视角：Agent执行任务时不用反复点击确认，使用流畅度提升；
从安全视角（重点）：这就是「破甲」名字的来源——削弱原生客户端自带的人机确认屏障。
确认弹窗是不可逆操作（文件写入、网络请求、API调用）的安全门禁，一旦绕过，风险会直接传导到Agent侧。这个能力本身中性，但安全基线会明显下移。
2.4 配套扩展：Qwen Image 2.1 生图接入（dsh-qwen-studio）
仓库自带生图适配组件，按硬件平台自动选择推理后端：
- Apple Silicon：MLX / MFLUX 本地推理，按需加载、闲置自动释放显存；
- Windows / Linux + NVIDIA：对接自建GPU网关，兼容 ComfyUI、vLLM-Omni 协议；
- 支持SSH远程拉起推理服务。
显存按需释放是非常务实的设计，本地文生图模型显存开销巨大，空闲卸载是桌面端AI工具的刚需方案。
2.5 仓库结构与测试设计亮点
dsh-purge/ ├── lib/ # 核心补丁逻辑、状态自检主链路 ├── packages/ # 子包依赖 ├── presets/ # 补丁预设配置包 ├── skills/ # Agent技能扩展 ├── market/ # 第三方插件分发市场 ├── bin/ # CLI命令行入口 ├── test/ # 单元测试 ├── docs/ + scripts/ + .github/文件统计：.js124 /.mjs108 /.md97，全仓库385个文件。
测试用例是工程亮点：
anchors.test.mjs（注入锚点匹配校验）、asar-swap-fallback.test.mjs（asar替换失败回滚逻辑）。
很多同类hack项目几乎没有边界用例，只验证正向happy-path；而这个项目专门覆盖注入失败、回滚、锚点不匹配这类高危边界场景，工程质量值得参考。
三、生态趋势研判：异常高Fork比背后的信号
本周热榜第6，Fork 1503，Star 2729，Fork/Star = 0.551。
对比同批次其他项目参考：
- aerial-tv：0.083
- free-my-tv：0.164
常规开源项目fork比大多落在 0.05~0.2 区间，0.551属于断层偏高。
三种合理解释：
- 使用门槛高：绝大多数用户需要Fork之后，自行修改补丁、配置、适配自己的宿主环境，无法直接clone即用；
- 批量镜像分发：社区存在批量fork，用于镜像分流、离线分发；
- 社区沟通习惯：使用者在fork分支下留言讨论，替代官方Issue。
👉 工程评估结论：该项目不是开箱即用标准化软件，而是高度定制化的补丁脚手架。大量fork会带来生态碎片化：版本四散、补丁分叉、故障难以复现，官方维护者很难统一支持。
生态归类：和leanrea、REA-Prompts组成本周「Agent工具层」主题簇，合计Star 8043，反映社区对AI客户端扩展、Agent能力增强工具的旺盛需求。
四、风险与合规分级（重点审核板块）
🔴 一级风险（最高）
- 修改宿主本体，违反客户端EULA
项目基于asar替换、JS注入方式修改DSH Desktop内部代码，属于修改第三方闭源客户端。绝大多数桌面AI软件用户协议，禁止逆向、修改、注入客户端本体。一旦违规，存在账号、服务权限风险。 - 安全屏障弱化风险
绕过原生确认弹窗，Agent可静默执行更多操作。如果Agent存在幻觉、指令注入，会直接放大数据、操作风险。
🟠 二级风险
- 版本强绑定，升级即失效
全部80条补丁依赖宿主内部锚点，DSH官方一次版本更新，锚点就可能全部失效，甚至引发客户端崩溃。虽然自带回滚备份，但升级运维成本很高。 - 插件市场供应链风险
market/目录作为第三方插件分发入口，外部插件无强制审计流程，引入恶意脚本、窃取本地对话数据的风险不可忽视。
🟡 三级风险
- 生态碎片化风险
超高fork比，大量分支独立修改补丁，社区版本分裂，遇到问题没有统一基线，很难排障。 - 权属边界
NOTICE.md明确标注：社区版并非DeepSeek官方发行版本，属于第三方扩展，不要混淆为官方功能。
五、SafeNet 取证审计信息（Valhalla体系专属）
- 代理路由：GH Proxy Primary
- 获取策略：禁止全量抓取，浅克隆+blob过滤
- 固定快照完整哈希：
27919a326b6615b1968661a3e749760cec3a2e07 - 抽样策略：有界检出，30个关键文件Blob哈希核验
- 证据覆盖率：100%，Manifest SHA256校验通过
- 浅克隆体积：136 KB
- 审计引擎：Valhalla-SafeNet-Accelerator + Matrix Alchemy Lab
审计说明：本文为静态源码快照审计报告，审计团队未在本地安装、注入、运行该插件；所有功能描述、风险判断均来自仓库源码、README、测试用例。合规提示仅为技术视角风险提示，不构成法律意见。
- 批次账本链头：
8ac3a5fc3a78f053e2d9a472c3e1ad0d716215bd16fe00ca12b2351371093e63
六、落地决策清单（P0/P1/禁止，直接复用）
✅ P0 强制前置（只要打算研究）
- 环境隔离：仅在独立隔离配置文件、隔离虚拟机、非主力设备上测试；
- 协议自查：先阅读DSH官方EULA，确认是否允许客户端修改；
- 版本锁定：固定宿主版本，关闭DSH自动更新，提前备份原始asar包，保留回滚链路；
- 插件白名单：market目录插件只加载可审计源码的可信插件，拒绝来源不明脚本。
✅ P1 参考学习（不部署也可以吸收）
- 参考这套25层自检架构，移植到自研插件系统，解决「补丁状态不可观测」痛点；
- 学习区分「读取异常」和「目标不存在」的状态设计；
- 参考按需加载、空闲释放显存的本地生图后端调度逻辑。
❌ 禁止动作
- 企业办公、生产环境、存储敏感业务数据的主机部署；
- 直接给Agent开放关闭确认弹窗的能力，不额外增加独立审批网关；
- 打包该工具随商业产品分发。
七、结语
dsh-purge最有价值的地方，并不是“破甲”这个绕过确认的能力，而是它给补丁注入类工具提供了一套完整的状态可观测框架。
绝大多数同类注入脚本，只关心“能不能插进去”，不关心状态校验、失败回滚、缓存污染、错误语义区分。而它把补丁生命周期做成可自检、可查询、可回滚的控制面，这套架构思路，对自研客户端插件平台有很强借鉴意义。
但风险同样清晰：它建立在修改第三方闭源客户端的基础之上，安全基线、合规约束都需要使用者自行承担。
如果你是AI应用开发者，哪怕不使用这个项目，也值得学习它的自检链路设计；如果你是普通用户，强烈建议谨慎对待「破甲」类能力，不要为了流畅度牺牲人机确认这道安全防线。
系列预告：本系列持续跟踪GitHub本周最热开源项目，同步输出Valhalla L3静态审计报告，下一期继续解读同系列开源硬件、云原生、AI工具类项目。
