删除守卫 deepestevan/dsh-delete-guard

$shell = New-Object -ComObject Shell.Application
$bin = $shell.Namespace(10) # 10 = Recycle Bin
$bin.Items() | Where-Object { $_.Name -eq 'a.txt' } | ForEach-Object {
$bin.GetDetailsOf($_, 1) # 原路径，仅用于确认
$_.InvokeVerb('ESTORE') # 还原
}

或者直接打开回收站，右键「还原」。file_trash 从不永久删除，所以只要没清空回收站，文件就还在。

已知限制

- 只覆盖 Windows 回收站。Linux 上 file_trash 会明确报错，不会退化成 rm。
- 只拦已知形态。混淆写法（& $cmd、动态拼出的程序名）拦不住——这是启发式规则，不是沙箱。
- format 按程序位置判定，不解析参数：format.com 一律拒绝，Format-Volume 放行。
- terminal_send 只做文本匹配，不跟踪终端状态；命令在终端里被改写后可能漏判。
- file_trash 依赖 SHFileOperationW，单次调用有路径长度上限；超长路径会逐条报错，不会静默丢弃。

开发

pnpm install
pnpm build # tsc → lib/
pnpm test # vitest
pnpm lint # eslint

规则集中在 src/guard/rules/，每条规则一个文件，导出 match(command) → verdict。新增规则时同步在 test/guard/ 下补用例。

许可

MIT
1. 读 X:\$Recycle.Bin\<SID>\$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。