beijingwahw/dsh-nuke-plugin

Plugin插件 Native原生 ⭐ 2 MIT Approval & Security审批与安全

DeepSeek Harness 工业级 Nuke 环境清理引擎 — 事务回滚 · 崩溃自恢复 · 审计链 · 硬链接去重 · 趋势预测

Project Overview项目介绍

dsh-nuke-plugin is a native DeepSeek Harness plugin that provides secure, transactional cleanup of residual files left behind after plugin uninstallation. It transforms the risky process of deleting plugins and cleaning up leftovers into a verifiable, revocable, and auditable transaction system that eliminates common pain points like accidental deletion, irreversible changes, and lack of traceability after errors. To install the plugin, run the command dsh plugin add beijingwahw/dsh-nuke-plugin --profile web from your terminal, and you can start using it immediately after installation completes.

First-time users are recommended to follow a structured workflow: scan for residuals first, run a risk forecast with the nuke_oracle tool, check the blast radius of potential changes, do a dry run to confirm the plan, then execute the formal cleanup. If a crash occurs mid-cleanup, you can use the built-in recovery tools to roll back all changes to the pre-cleanup state. For regular maintenance, you can run one-click health checks, forecast disk fill time, and conduct regular chaos drills to verify your recovery pathway works as expected. This plugin is ideal for developers who manage long-lived DSH environments with multiple plugins and require high standards for data security and operational traceability.

The plugin is written in TypeScript and requires Node.js version 24.11 or higher to run, with development support for hot module replacement that lets you update code without restarting DSH. All operation logs, backups, audit data, and historical records are stored in the .nuke directory under your DSH root folder. It is released under the permissive MIT open source license, so you can use it, modify it, and redistribute it freely per the license terms. Its core innovation is a self-learning Bayesian prediction engine that uses historical operational data to forecast the probability of success and potential risks of any cleanup operation before you execute it.

这是一款专为DeepSeek Harness开发的原生插件,用于对DSH环境中插件卸载后的残留文件进行安全事务化清理。它将原本风险较高的删除清理操作改造为一套可验证、可撤销、可审计的事务系统,解决了手工清理易误删、脚本清理不可逆、出错后无法追溯的痛点。插件共提供25个专用工具,覆盖感知扫描、风险评估、事务执行、恢复审计和日常运维全流程。

推荐首次用户按照扫描残留、先知推演风险、爆炸半径预演、干跑验证、正式执行的流程操作,清理中途崩溃后可通过工具快速恢复到清理前状态。日常运维可使用一键巡检和磁盘空间预测功能,还能定期进行混沌演习验证崩溃恢复通路的有效性。它适合长期管理多插件DSH环境、对数据安全和操作可追溯性有较高要求的开发者。

本插件基于TypeScript开发,依赖Node.js 24.11及以上版本,开发环境支持热更新,所有操作日志和备份数据都存储在DSH根目录下的.nuke文件夹中。它采用MIT开源许可证免费使用,核心创新是加入基于历史数据贝叶斯自学习的先知推演功能,可概率化预测清理操作的潜在后果。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin add beijingwahw/dsh-nuke-plugin --profile web

把 beijingwahw/dsh-nuke-plugin 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-nuke-plugin

DeepSeek Harness 的工业级 Nuke 环境清理引擎 — 事务回滚 · 崩溃自恢复 · 审计链 · 先知推演 · 混沌演习 · 贝叶斯自学习 · 预测存证问责 · 自我校准 · Thompson 探索

Release Tests TypeScript License: MIT

把"删除插件并清理残留"这件危险的事,做成一套可验证、可撤销、可审计的事务系统。

为什么需要它

dsh 的一切皆插件 —— 但插件的装卸会在 .dsh/、Nuke 目录、系统 TEMP 等处留下残留。手工清理容易误删,脚本清理不可逆,出了事无从追溯。本插件用数据库级的纪律来做这件事:

痛点 解法
删错无法挽回 每个动作自带 validate / preview / execute / undo,目录删除 = 原子改名进回收区
清理途中崩溃 WAL 预写日志 + 备份区,nuke_recover 重放并反向补偿;nuke_drill 随时实战验证这条退路
出事无从追责 hash chain 审计日志,任何篡改可被 nuke_verify 检出
并发清理打架 跨进程读写锁(O_EXCL + bootToken 归属核验 + guard 目录互斥)
不知道能删多少 五因子评分 + 趋势回归 + 磁盘写满预测,先预演后执行
不知道"删了会怎样" nuke_oracle 先知推演:基于历史执行数据预测事务成功率、期望回收、最脆弱步骤

安装

dsh plugin add beijingwahw/dsh-nuke-plugin --profile web

安装后直接对话即可,例如:

帮我扫描一下 web profile 的插件残留,先预演不要真删

安全纪律(设计原则)

  1. fail-closed — 校验器/健康检查自身失败时同样拒绝操作,绝不"查不到就放行"
  2. 路径 Containment — 所有路径操作限制在授权目录内;txId 白名单 [A-Za-z0-9_-]{1,64} 防穿越注入
  3. TOCTOU 复验 — 分析与执行是两个时刻,执行前重验指纹(size + SHA-256 + mtime)
  4. 诚实记账 — bytesSaved 只计真正释放的空间(nlink>1 的硬链接替换不虚增)
  5. 保护名单 + 限额 + 黑窗 — 作为引擎 pre-hook veto,超限即拒绝(纵深防御,不依赖单层检查)
  6. 回收区代替物理删除 — commit 后才允许 purge;restore 失败或存在孤儿产物时绝不 purge

工具速查(25 个)

所有工具注册为 dsh Agent 工具,安装后直接让 Agent 调用即可。

感知 — 先看清现状

工具 说明
nuke_list 列出 profile 下已安装的第三方插件
nuke_scan 残留扫描(配置引用/目录/TEMP),五因子评分 + 可回收空间统计;省略插件名进入全局模式
nuke_deps 依赖关系检测:谁引用了目标插件(删除前必查)
nuke_orphans 全局孤儿扫描:node_modules 未声明包 / 无主附件 / TEMP 过期条目
nuke_health 健康检查:config/dependency/runtime/residue 四组,critical 失败自动阻断清理

决策 — 评估风险与收益

工具 说明
nuke_blastradius 爆炸半径沙盘推演(what-if,零副作用):删除会损坏谁、可级联谁、风险几级
nuke_strategies 查看三级策略(safe / balanced / aggressive)的动作集
nuke_policy 查看守卫配置:保护名单 / 批量上限 / 回收上限 / 磁盘下限 / 时间黑窗
nuke_trend 历史趋势:字节/天变化率、30 天外推、3σ̂ 异常检测(失控写盘早期信号)
nuke_forecast 磁盘写满预测:趋势 × 实时余量 → 倒计时与分级建议
nuke_oracle 先知推演:概率化后果预测——事务成功率、期望回收(校准分布修正)、最脆弱步骤、爆炸半径、磁盘倒计时延长、预计耗时(p50 与悲观 p90)、下行风险 CVaR₁₀、Thompson 探索口径与信息价值排序(建议先执行哪步以最快积累证据);基于历史执行数据贝叶斯自学习 + 从战绩自我校准,零副作用不拿锁
nuke_failures 失败档案:每类动作的历史失败模式诊断(EBUSY 锁定/超时/权限/校验拒绝…)、瞬态份额与处方;⚡瞬态引擎自动重试、🔒永久需人工介入
nuke_scorecard 先知战绩对账单:执行前已存证进 hash chain 的预测(成功率/耗时)vs 实际结局——Brier 技能分(对照无技能基线)、逐步命中明细、耗时偏差分布、重试疗效学习值、系统性偏差诊断与自我校准位移;回答"先知的数字到底可不可信、偏在哪、纠了没有"

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-injection-guard 下一个 Next dsh-safemode-profile →