Skip to content

删除护栏 ​

agent 删光用户目录、删空整块盘,这样的事故已经有人贴出来过不止一次。打开删除护栏后,agent 执行 rm -rf build、rmdir、git clean -fdx、Remove-Item -Recurse 这类删除命令时,讣告会拦下这一次执行,并告诉 agent 一条等价命令,比如 obit rm -rf build。agent 改用它之后,东西进墓地而不是消失,obit resurrect <id> 一条命令放回原处。

powershell
obit init -g --guard-rm                 # Claude Code;Codex 加 --agent codex。默认不开

一次真实的输出 ​

删除护栏打开时,hook 收到 Claude Code 的一次 Bash 调用 rm -rf build,回复如下,rm 没有执行:

json
{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"Obituary's delete guard is on: `'C:/work/obit.exe' rm -rf build` provides restorable deletion; `obit resurrect` restores graveyard entries."}}

之后 agent 改用讣告,东西进墓地,再一条命令放回:

console
$ obit rm -rf build
$ obit graveyard --here
ID  BURIED            PURGE  SIZE  PATH
#2  2026-11-11 00:36  in 7d  23 B  C:\work\build
$ obit resurrect --last
#2 resurrected  C:\work\build

原则 ​

  • 只拦不改。 讣告不改写 agent 的命令:Claude Code 会按改写后的命令检查权限,改写会让你设的 deny 规则失效。拦下再让 agent 自己发出等价命令,你的所有权限规则照常生效。
  • 出现字面的删除就拦。 命令里任何一个命令位置上出现 rm、rmdir、git clean、Remove-Item(含 del、rd、ri 这些别名),不论在 &&、||、;、管道、$(…)、子 shell、条件还是循环里,都拦下这一次执行,例如 rm -rf build && npm run build、rm -rf build 2>/dev/null、git clean -fdx && npm ci。拦下本身什么都不执行,所以多拦不会删错东西。字符串、注释、echo 的参数里的 rm 不算;rm --help、git clean -n、Remove-Item -WhatIf 只是预览,也不算;sudo rm、xargs rm、find -delete 里的删除是别的程序在做,照常放行(设了 OBIT_HOOK_AUDIT=1 会记进审计日志)。
  • 不会退回成真删。 obit rm / obit remove-item / obit git-clean 的每个路径都走下葬;被拒绝(盘符根、系统目录、用户目录本身等)时照 rm 的格式报错、返回非零。
  • 怕命令在路上变了样。 agent 想的命令和真正执行的命令之间,隔着 shell 的引号和转义,还可能隔着一层改写命令的代理。一个符号被吃掉,rm -rf "$OUT"/ 就成了 rm -rf /。所以 obit rm 动手前按磁盘上的真实路径再核对一遍。
  • 被 Git 跟踪的文件也照样下葬,这样未提交的修改也找得回来(这是 agent 主动删除,和「自动登记绝不碰被跟踪文件」不冲突)。
  • obit rm -rf 一个含 .git 的目录会把整个仓库下葬:真正的 rm -rf 会把它永久删掉,下葬至少还能复活。系统目录、用户文件夹这些不能强制的保护照样生效。
  • 等价命令刻意收窄:等价命令绝不能比原命令选中更多东西,所以讣告不做跨 shell 的翻译,只在下表的写法里给。给不出时照样拦下,理由里写明为什么给不出,并说明 obit bury <路径>(字面路径)和 obit git-clean 可以做到可复活的删除,agent 据此改写命令。

各场景下拦下和放行的写法 ​

场景拦下并给等价命令拦下,附原因和通用说明放行
Claude Code(Bash 工具)rm、rmdir、git clean,前面只能有字面的 cd x(用 &&、; 或换行连接);rm -f *.log(当前目录里没有以 - 开头的文件时)、rm -rf ../dist、rm -- "$target"(变量在 -- 之后)其他字面删除:前后还有别的语句(npm …、trap、hash 等)、-- 之前的变量、以 / 开头的 POSIX 绝对路径、重定向、||、管道、$(…)、交互式、带路径的 /usr/bin/rm不是删除的命令
Codex,WSL 的 /mnt/<盘> 下单独一条 rm / rmdir,参数都是不含 ..、~、通配、引号的相对路径其他字面删除,含 git clean 和指向 WSL 自己文件系统的路径工作目录在 WSL 自己的文件系统里
Codex,明确是 Windows PowerShell单独一条 Remove-Item 或别名,只带一个字面路径(可加 -Recurse、-Force)其他字面删除:多条语句、管道、-ErrorAction 等其他参数、provider 路径、~、通配、反引号弯引号字符串里的文字
Codex 在 Windows 上但看不出是哪种 shell、Linux 上的 pwsh、git rm——全部放行

给等价命令时,删除命令必须是整条命令的最后一段,前面只能用 &&、; 或换行连接;文件名以点或空格结尾的不给(Windows 会把它们归一化成另一个名字)。这些情况下命令里的字面删除照样拦下。

你自己也可以用 ​

obit rm、obit rmdir、obit git-clean 接受 rm、rmdir、git clean 常用的非交互参数(-i、rmdir -p 这类不支持的参数会报错,不会悄悄忽略);obit remove-item 只接受一个字面路径,不是完整的 Remove-Item 替代。要用通配,在 bash 里用 obit rm *.log。

临时关掉:OBIT_GUARD_RM=0。obit stats 会显示拦下了多少次删除、埋了多少东西。

以 MIT 许可证开源。