dsh-plugin-recycle-bin

DSH 安全删除守卫：在 Windows 上强制所有删除走回收站，禁用 del/rm/Remove-Item 等磁盘删除命令，禁止自动清空回收站；回收站或硬盘已满时停止删除、提醒用户并等待指令。

功能特性

• 🗑️ 删除一律进回收站：经 file_trash 工具，用 Microsoft.VisualBasic SendToRecycleBin 移入系统回收站，可恢复、绝不永久擦除。
• 🚫 禁用磁盘删除：拦截 del、rm、Remove-Item、erase、rd、rmdir、deltree、find -delete、unlink。
• 🛡️ 禁止安全擦除：拦截 sdelete、shred、srm、cipher /w、wipe。
• 🚯 禁止清空回收站：拦截 Clear-RecycleBin 及针对 C:\$Recycle.Bin / Recycler 的删除。
• ⛔ 满则停手：删除前检查剩余空间，不足时不删，用 ctx.userQuestions 停顿询问用户（放空间后重试 / 坚持回收 / 取消）。
• 💡 低误判：只在命令位置匹配删除 token，$rm、form 等不会误判。
• 🔍 容量查看：trash_status 工具报告回收站支持情况、剩余/总空间与安全阈值。
• 🧠 模型教育：向系统提示注入 safety:recycle-bin 区段，引导模型只用 file_trash、不空回收站、满时询问。

实现方式

分三层：

1. Shell 接缝拦截：包装 ctx.shell.run / start，因此覆盖 PowerShell 与 bash 工具的前台/后台命令。guardCommand() 以「命令位置」正则匹配破坏性命令，命中即返回阻断结果（[exit code: 2]），命令不会 spawn。
2. 回收站删除：file_trash 将目标交给 lib/recycle.js，经 pwsh 调用 PowerShell 以 SendToRecycleBin 移入回收站。经本插件删除，永久擦除在机制上不可行。
3. 容量判定：fs.statfsSync（失败回退 Get-PSDrive）测剩余空间，classifyCapacity() 给出 ok | low | full；非 ok 时经 ctx.userQuestions 停顿等待用户（该服务缺失则安全失败、停止删除）。

依赖策略：不声明任何 peerDependencies / dependencies，运行时所需 @deepseek-ai/* 由 DSH 宿主解析提供。

安装

用 DSH 插件管理器导入发布包，并确保组合存在该插件：

# cordis.patch.yml
- insert:
    - id: recycle-bin
      name: 'dsh-plugin-recycle-bin'
      config:
        enabled: true
        blockDestructiveCommands: true
        forbidEmptyRecycleBin: true
        forbidWipe: true
        minFreeBytes: 104857600
        reserveBytes: 52428800
        pwshPath: ''

需要 ctx.shell 执行器、tools、systemPrompt。ctx.userQuestions 可选，缺失时「已满」会安全失败。

配置

字段	类型	默认	含义
enabled	boolean	true	总开关。
blockDestructiveCommands	boolean	true	阻断硬盘删除命令。
forbidEmptyRecycleBin	boolean	true	禁止清空回收站。
forbidWipe	boolean	true	禁止安全擦除器。
minFreeBytes	number	104857600	剩余空间低于此值停止删除。
reserveBytes	number	52428800	回收后保留的剩余空间。
pwshPath	string	""	可选：显式 pwsh 路径。

使用

file_trash(paths: ["C:\\Project\\draft.md", "C:\\Project\\old-temp"])
trash_status(path: "C:\\Project")    # path 可选

• file_trash 返回 deleted / skipped / blockedFull / message；满则暂停询问。
• trash_status 返回回收站支持情况、剩余/总空间与安全阈值。

安全边界

强约束（正常模型工具路径内，无法绕过）：标准 pwsh/bash 工具的删除与擦除命令在执行前被拦截；后台删除、子代理同样覆盖；经 file_trash 必进回收站，满则停手。

已知边界（可绕过/覆盖不到）：

• 持久 shell（dsh-tool-*-persistent）会话内命令不经过 ctx.shell 包装。
• PTC / run_code 模型代码里直接调宿主 child_process.exec("del …") 不走 shell 接缝。
• 第三方 / MCP / 自注册工具若直接用 Node fs 删除，本插件管不到。
• enabled: false 或 blockDestructiveCommands: false 可关闭（策略，非不可逆）。
• 人类 / 外部程序手动删除不受此约束。

如需更强保证，建议叠加：工具注册表层拦截、Windows ACL 受限令牌沙箱 + ConstrainedLanguage、PowerShell 全局别名把 Remove-Item/del/rm 映射到回收站、或在文件系统层禁止 DELETE 权限。

开发与测试

纯 JS、无构建。语法检查：node --check lib/index.js lib/guard.js lib/recycle.js。守卫匹配器（lib/guard.js，无外部依赖）可独立验证覆盖清单与误判场景（$rm、form）。

结构

lib/
├─ index.js    # 插件入口：shell 守卫、file_trash/trash_status、提示区段
├─ guard.js    # 破坏性命令匹配器 + 被阻断结果构造
├─ recycle.js  # Windows 回收站删除、空间测量、容量判定
└─ index.d.ts  # 类型声明
cordis.patch.yml / cordis.example.yml   # 组合接线

许可

MIT