dsh-delete-guard

DSH PLUGIN安全与权限

仓库 deepestevan/dsh-delete-guard

安全与权限 L5 · 运行验证通过 安全审查:低风险 可信度:银 可安装插件
安装这个插件

dsh-delete-guard 是 deepestevan 维护的 安全与权限 类 DSH 可安装插件, 仓库为 deepestevan/dsh-delete-guard,许可证 MIT。 下面按「装什么、怎么装、验没验过、跑起来要注意什么」逐项列出。

一句话选型结论

按资料字段整理

dsh-delete-guard 是安全与权限类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类安全与权限 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-10-23 创建于 2026-10-23
README 6.7 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:deepestevan/dsh-delete-guard
  1. 1
    确认版本与运行环境

    仓库没有标注兼容版本与 Node.js 要求,先确认你的 DSH 版本能装,再继续。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

安全与权限
字段来自项目仓库与公开索引,中文说明由本站标注

适用场景

文件读写存储

上游标签

ai-safetydeepseek-harnessdshdsh-bundledsh-pluginguardrailshooksrecycle-binsafe-deletetrashundeletewindows

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度银综合仓库活跃度与验证结果

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在安全与权限场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-delete-guard当前 L5 · 运行验证通过 低风险 0 未标注 有
dsh-infinite-gen-4 未做沙盒验证 未标注 1,611 未标注 无
cc-safety-net 未做沙盒验证 未标注 1,591 未标注 无
dsh-wallpaper-engine L5 · 运行验证通过 低风险 1,018 0.2.0-rc.2 等 10 个 有
api-relay-audit L5 · 运行验证通过 低风险 875 0.2.0-rc.2 等 10 个 有
hol-guard L4 · 沙盒安装通过 不在扫描口径 828 未标注 有

仓库档案

安全与权限
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方deepestevan仓库 dsh-delete-guard · 默认分支 main
分类安全与权限security
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言未标注仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-10-23 · 2026-10-23最后推送 2026-10-23
本站收录2026-10-30首次进入本站目录的时间

README 全文

6.7 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-delete-guard

English | 简体中文 | 日本語

让 agent 删不掉「恢复不了」的东西。

删除只有两条路:进 Windows 回收站(资源管理器里能还原),或者被拦下来换成一次
file_trash 调用。没有第三条。

agent:  Remove-Item -Recurse -Force .\src
被拒:    The delete guard blocked this delete. Re-run this as: file_trash with paths = ["…\src"]
随后:    file_trash → 移入回收站,「还原」可用

解决什么问题

DSH 里模型执行 pwsh 的删除命令,文件是被直接抹掉的:ctx.fs 没有 delete,
ctx.shell 只有 execute(),没有任何中间层。一句 Remove-Item -Recurse -Force
就能带走一整个目录,没有回收站,没有撤销。

本插件挂在 tools/pre-execute(宿主真正路由每个工具调用的接缝),把这些调用拒绝,
并告诉模型改用 file_trash;后者用 SHFileOperationW(FOF_ALLOWUNDO) 移动文件——和资源
管理器删文件是同一套 Win32 API,所以 $Recycle.Bin 的 $I/$R 元数据正确,「还原」可用。

挡住的不只是 Remove-Item:管道、xargs、变量拼接的目标、写在 if { } 里的删除、内联
-Command / -EncodedCommand、持久终端里敲的命令、Git Bash 的 /c/... 路径、以及清空
回收站的各种写法,各有对应规则。

安装

# 从 npm 安装
dsh plugin --profile web add dsh-delete-guard
# 或直接从仓库安装(npm 不可用时)
dsh plugin --profile web add github:deepestevan/dsh-delete-guard
# 或者从本地 tarball(改过源码时用这条)
pnpm pack --pack-destination ./temp/pack     # 先升 package.json 的 version
dsh plugin --profile web add file:./temp/pack/dsh-delete-guard-2.2.2.tgz
# 重启 dsh web:lib/*.js 只在进程启动时加载

file: 必须指向 tarball,不能指向源码目录——目录形式 pnpm 会硬链接,源码一挪插件就悬空。

更新走 remove + add 两步:单跑 add 可能返回 Already up to date 而什么都没换,而 lib/*.js 只有进程重启才会重新加载。

挡住什么

会进回收站(被重定向)

Remove-Item C:\tmp\a.txt        del / erase / rd / rmdir / rm / unlink
Remove-Item -Recurse -Force C:\tmp\dir
if (Test-Path $p) { Remove-Item $p -Force }
terminal_send: "Remove-Item C:\tmp\a.txt"

直接拒绝

类别 例子
目标不可枚举(没法证明搬对东西) Remove-Item $(…)、… \| Remove-Item、xargs rm、Remove-Item @targets、-Recurse C:\tmp\*
危险路径 C:\、\、C:\Windows、Program Files、..\..\、Git Bash 的 ~ / /tmp
无删除动词的擦除 [System.IO.File]::Delete(…)、Invoke-Expression "…"、cmd /c del、robocopy /MIR、find -delete
永久擦除工具 shred、sdelete、srm、cipher /w、format X:(只按程序位置判定)
清空回收站 Clear-RecycleBin(含 &、子壳、-EncodedCommand 形态)、SHEmptyRecycleBin、对回收站条目驱动 shell 动词、直接删 $Recycle.Bin 内容
没有回收站的位置 UNC 共享、exFAT/FAT32 卷(在那里"回收"等于永久擦除)
脚本内删除 内联 shell / Python / Node 体里的删除动词与擦除调用;把含删除的文本写进 .ps1/.sh/.py

放行:只读命令、只提到删除词的操作(Select-String -Pattern "Remove-Item"、
Get-Content shred.exe)、以及从回收站还原文件。

两个工具

工具 作用
file_trash { paths, reason? } 唯一允许的删除方式。移入回收站,逐条报告成功与失败,绝不降级成永久删除
trash_status { drive? } 报告该卷回收站的项目数与占用,用于确认删除确实落进了回收站

配置

在 profile 的 cordis.patch.yml 里覆盖(config 是整块替换,要保留的键必须重述):

键 默认 含义
enabled true 总开关
blockDestructiveCommands true 拦截 shell 删除并重定向到 file_trash
forbidEmptyRecycleBin true 禁止清空或改动回收站
forbidWipe true 禁止 shred / sdelete / srm / cipher /w / format
blockScriptDeletes true 禁止脚本文件与内联字符串里的删除

恢复已删的文件

恢复不是插件的功能,也不需要——回收站是操作系统的。脚本里这样还原(与界面语言无关):

  1. 读 X:\$Recycle.Bin\\$I* 记录:偏移 24 是原路径字符数,偏移 28 起是 UTF-16LE 原路径;
  2. 按原路径匹配到目标条目,取配对的 $R 文件;
  3. Move-Item 搬回原位。

$R/$I 的文件名是随机的($R3LCXYR.txt),原文件名不在文件名里,只能靠解析 $I
反查;动词还原后可能残留孤儿 $I 记录,跳过 payload 缺失的即可。资源管理器里右键
「还原」与之一致,只是脚本化时别依赖本地化的动词名。

不挡什么

不覆盖 原因
脚本文件里已有的删除(守卫从未见过内容) 只能拒绝写入与看得见的内联形态,不能执行期改写
Add-Type 里写任意 C#(如 DeleteFileW) 文本判定够不到;只有针对回收站的 API 被点名拦掉
命令名先拼进变量再 & $c 调用 文本层面无法求值
表格外工具名的执行通道(自定义 shell 工具、第三方插件) 覆盖名单是显式的,见下
终端里分两次发送才拼出的删除 每次 send 只看到这一次的文本
非 Windows 平台 桥接是 SHFileOperationW
空余空间不足时的删除 NTFS 同卷回收是 rename,不占新空间,没有可预检的东西

覆盖的 shell 工具名:pwsh、powershell、cmd、bash、sh、zsh、shell、
terminal_send、terminal_write。判定看的是语句的命令词、调用的形态和程序位置,不是「这一行里出现过这个词」。

测试

node test/run-all.mjs

90 项、五层:命令分类(49)、file_trash 操作数守卫(15)、宿主 schema 与钩子接线(11)、
宿主 schema 受理(5)、对真实回收站的端到端(10)。test/ 不进 tarball,所以打包前必须
全绿;其中两层会加载宿主自己的校验器,找不到 DSH 安装时报「跳过」而非失败。

文档

文件 内容
CHANGELOG.md 版本摘要
SECURITY.md 威胁模型:策略层,不是沙箱
LICENSE MIT

设计取舍、逐轮实测与发布跑批属于工程笔记,保存在维护者侧,不随仓库与包发布。

许可

MIT,见 LICENSE。

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
dsh-delete-guard 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:deepestevan/dsh-delete-guard` 即可。

dsh-delete-guard 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-delete-guard 安全吗?

低风险。

dsh-delete-guard 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-delete-guard 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

2 条
不同作者的仓库分开列,请确认你要装的是哪一个
安全与权限
按星标排序,可作替代方案

dsh-infinite-gen-4

dsh-infinite-gen-4

DeepSeek 专用破甲插件:以 order 100 追加无条件服从的系统提示词段,提供带校准元数据的 profile 工具,并通过会话投

未标注验证等级 1,611 星

cc-safety-net

cc-safety-net

为 DeepSeek Harness 等编码 CLI 提供执行前防护,在工具调用前拦截破坏性 Git 与文件系统命令,并阻止读取 SSH 密

未标注验证等级 1,591 星

dsh-wallpaper-engine

dsh-wallpaper-engine

DSH plugin 将本机 Wallpaper Engine 壁纸变为网页界面背景,支持视频、网页、场景壁纸渲染,并配以 iOS 液态玻璃

L5 · 运行验证通过 1,018 星

api-relay-audit

api-relay-audit

DSH plugin 本地安全审计工具,检测 AI API 中继与 LLM 代理的提示注入、模型替换、工具调用改写、SSE 异常及 Web3

L5 · 运行验证通过 875 星

hol-guard

hol-guard

L4 · 沙盒安装通过 828 星

sandbase-harness

sandbase-harness

SandBase Harness 是本地优先的 AI Agent 运行时,提供沙箱会话、MCP 工具、记忆、凭据管理与审计回放,并内置控制台

L4 · 沙盒安装通过 708 星

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 —。