这段时间 AI Agent 在本地跑起来越来越顺但每次看到 Agent 在终端里执行rm -rf都让人心里一紧。尤其是在 Mac 上rm删文件是直接清理不会进废纸篓一旦删错数据基本就回不来了。今天这个思路非常直接把 Mac 上的rm重映射成mv到废纸篓让删除变成“移动”给手滑和 LLM 误操作留一条退路。这不是一个复杂的框架也不是带 WebUI 的图形工具而是一个非常实用的 shell 层安全策略。它不需要额外装后端服务不需要 GPU也没有显存、API 端口这类概念适合所有用 Mac 做开发、跑脚本、调 LLM Agent 的同学。本文会用可落地的 shell 函数演示如何实现并重点说明它对 LLM Agent 场景的保护逻辑、测试方法和踩坑点。1. 核心能力速览能力项说明项目类型命令行安全工具 / Shell 重映射方案适用系统macOSzsh / bash 环境替换对象系统rm命令替换行为将删除目标mv到~/.Trash废纸篓核心价值防止手动误删和 LLM Agent 调用rm -rf时造成不可恢复的数据丢失依赖系统自带mv无第三方依赖接口 API无 HTTP API纯命令行批量任务单次可处理多个文件 / 多个路径后台服务无不常驻内存安全边界不能替代备份对系统关键目录需额外保护扩展性可以继续封装为独立脚本或加入日志上面这张表把关键信息先给出来。下面从为什么需要它、怎么实现、怎么验证、怎么排查这几个角度展开。2. 适用场景与使用边界2.1 它适合谁这个方案最适合下面三类人群经常在终端里手动执行删除命令偶尔会因为写错路径或通配符误删的工作者。本地跑 LLM Agent、Claude Code 这类会主动调用 shell 工具的工具链用户这些 Agent 在规划任务时有可能会把“清理临时文件”理解成rm -rf。团队内部希望统一 shell 环境降低新手误操作风险的技术负责人。2.2 能解决什么问题它解决的核心问题是把“删除”这个不可逆动作变成“移动到废纸篓”这个可撤销动作。举个例子你让一个本地 Agent 清理~/temp目录它如果执行了/bin/rm -rf ~/temp那么在 Mac 上这个目录会直接消失。但如果你在 shell 里把rm重定向为mv那么同样的命令执行后~/temp会被挪到~/.Trash里你还能从废纸篓中找回来。2.3 不适合什么场景它不适合需要真正快速清理大文件的场景因为移动文件到废纸篓后废纸篓里仍然占用磁盘空间。如果磁盘已满直接把大文件移动到废纸篓可能仍然失败甚至因为废纸篓占用更多空间导致系统异常。另外这个方案不应对sudo rm的场景生效。sudo会调用系统原生命令绕过 shell 里的 alias 和 function。也就是说如果你或 Agent 使用sudo rm仍然会直接删除。2.4 使用边界与合规提醒使用这个工具时要明确几条边界它只是把删除变慢不是把数据变没。真正重要数据仍然必须走版本控制、网盘同步或 Time Machine。对于 LLM Agent 场景不能因为有了safe_rm就放松对 Agent 权限的限制。更稳妥的方式是让 Agent 在容器、沙箱或独立用户目录中运行即使误删也不影响宿主系统。不要试图把/、/System、/Library这些目录也“移动”到废纸篓。移动系统目录可能直接导致系统无法启动需要额外加保护逻辑。3. 环境准备与前置条件在实现 Safe-rm 之前先确认你的 Mac 环境是否满足条件。3.1 操作系统本文假设你使用的是 macOS且终端默认 shell 为 zshmacOS 10.15 之后默认就是 zsh。如果你还在用 bash操作步骤基本一致只需把配置文件换成~/.bashrc或~/.bash_profile。查看当前 shellecho $SHELL输出一般是/bin/zsh。查看 zsh 版本zsh --version3.2 关键目录macOS 上每个用户的废纸篓目录是~/.TrashFinder 中的“废纸篓”就是映射到这个目录。我们需要确认这个目录存在并且可写ls -ld ~/.Trash正常会输出类似drwx------ 2 username staff 64 Jan 1 12:00 /Users/username/.Trash如果该目录不存在可以手动创建mkdir -p ~/.Trash3.3 备份 shell 配置修改 shell 配置前建议先备份cp ~/.zshrc ~/.zshrc.backup-$(date %s)这样万一配置写错可以随时还原。3.4 确认不冲突检查当前环境是否已经对rm做了 aliaswhich rm alias rm 2/dev/null如果which rm输出是/bin/rm说明当前没有拦截。如果已经有 alias可以先把原来的配置注释掉再参考本文的方案统一管理。4. 安装部署与启动方式这个项目不需要下载安装包也不需要启动服务。实现方式就是把一段 shell 函数写入你的 shell 配置文件让新的rm行为在每次打开终端时自动生效。4.1 方案一临时重定向仅当前终端如果你想先快速验证效果可以直接在终端里执行下面这段函数safe_rm() { local trash_dir$HOME/.Trash mkdir -p $trash_dir for target in $; do case $target in -*) continue ;; esac if [ -e $target ] || [ -L $target ]; then local base base$(basename $target) local dest_path if [ -d $target ]; then dest_path$trash_dir/${base}-$(date %Y%m%d%H%M%S) else dest_path$trash_dir/$base fi mv $target $dest_path fi done } alias rmsafe_rm粘贴到终端后执行echo test /tmp/safe_rm_test.txt rm /tmp/safe_rm_test.txt然后打开访达进入废纸篓你会看到safe_rm_test.txt出现在里面。这个验证方式只对当前终端窗口生效新开终端后rm恢复原状。4.2 方案二写入 ~/.zshrc推荐长期生效如果你确认这个行为符合预期可以将函数写入~/.zshrc# Safe-rm: remap rm to mv to Trash safe_rm() { # 保护系统关键路径 local protected_paths(/ /System /Library $HOME/Library $HOME/Applications /Applications /private/var /private/etc /usr /bin /sbin) local target for target in $; do # 跳过选项参数 case $target in -*) continue ;; esac # 处理通配符已经展开为多个参数的情况 if [ ! -e $target ] [ ! -L $target ]; then continue fi # 规范化绝对路径 local abs_target case $target in /*) abs_target$target ;; *) abs_target$PWD/$target ;; esac # 检查保护路径 local protect protect0 local p for p in ${protected_paths[]}; do if [ $abs_target $p ]; || [[ $abs_target $p/* ]]; then echo safe_rm: 拒绝移动受保护路径 $target 2 protect1 break fi done if [ $protect 1 ]; then continue fi local trash_dir$HOME/.Trash mkdir -p $trash_dir local base base$(basename $target) local dest_path if [ -d $target ] [ ! -L $target ]; then # 目录加时间戳避免重名 dest_path$trash_dir/${base}-$(date %Y%m%d%H%M%S) else dest_path$trash_dir/$base # 同名处理加时间戳 if [ -e $dest_path ]; then dest_path$trash_dir/${base}-$(date %Y%m%d%H%M%S) fi fi echo safe_rm: $target - $dest_path mv $target $dest_path done } alias rmsafe_rm写入后让配置生效source ~/.zshrc或者新开一个终端窗口。4.3 方案三独立脚本 自定义 PATH如果你希望不依赖用户个人 shell 配置并且团队内统一使用可以写成一个独立脚本放到/usr/local/bin/safe-rm#!/bin/bash # safe-rm: 将删除操作重定向到废纸篓 # 用法safe-rm path1 [path2 ...] SAFE_RM_TRASH${HOME}/.Trash SAFE_RM_PROTECTED(/ /System /Library $HOME/Library) mkdir -p $SAFE_RM_TRASH for arg in $; do case $arg in -*) continue ;; esac filename$(basename $arg) dest$SAFE_RM_TRASH/$filename if [ -e $dest ]; then dest$SAFE_RM_TRASH/${filename}-$(date %s) fi mv $arg $dest done给脚本加上执行权限chmod x /usr/local/bin/safe-rm然后在~/.zshrc中添加 aliasalias rm/usr/local/bin/safe-rm这种方式的好处是脚本可以单独维护也可以被其他脚本直接调用。4.4 保留真正的 rm无论采用哪种方案建议保留一种绕过方式在确需要真正删除时使用。在 zsh 中使用反斜杠绕过 alias\rm -rf /tmp/test或者直接调用系统二进制/bin/rm -rf /tmp/test这样做的好处是当你明确要清空废纸篓或释放空间时仍然有路可走同时普通命令中的误操作仍然被保护。5. 功能测试与效果验证部署完成后不能只看函数有没有生效要系统地验证行为是否符合预期。下面给出一组测试用例建议按顺序执行。5.1 验证普通文件删除测试目的确认rm已经成为安全删除而不是直接删除。先创建测试文件mkdir -p /tmp/safe_rm_demo cd /tmp/safe_rm_demo echo hello test1.txt执行rm test1.txt预期结果终端输出safe_rm: /tmp/safe_rm_demo/test1.txt - /Users/xxx/.Trash/test1.txt当前目录下没有test1.txtFinder 废纸篓中出现test1.txt判断标准废纸篓中能找到文件说明重定向成功。5.2 验证多个文件同时删除测试目的确认函数能处理多个参数。cd /tmp/safe_rm_demo echo a a.txt echo b b.txt echo c c.txt rm a.txt b.txt c.txt预期结果三个文件都能在废纸篓中找到。如果出现同名文件后面的文件会带时间戳后缀。5.3 验证目录删除测试目的确认rm -rf dir不会直接把目录删除而是把目录移动到废纸篓。cd /tmp/safe_rm_demo mkdir -p project_dir/source echo config project_dir/source/config.txt rm -rf project_dir预期结果当前目录下project_dir消失。废纸篓中出现带时间戳的project_dir-20250101120000目录目录。打开后目录内结构完整config.txt依然存在。判断标准目录整体被移动到废纸篓而不是删除内部文件后丢弃目录。5.4 验证通配符展开测试目的确认配合 shell 通配符时仍然安全。cd /tmp/safe_rm_demo echo 1 data1.log echo 2 data2.log rm *.log预期结果data1.log和data2.log都被移到废纸篓且终端会输出两条转移日志。5.5 验证不存在的路径测试目的确认函数不会因为文件不存在而报错。rm definitely_not_exists.txt预期结果不报错不输出也不会影响后续参数处理。5.6 验证受保护路径测试目的确认系统关键路径不会被移动。rm / rm /Library预期结果终端输出“拒绝移动受保护路径”且对应路径仍然存在。5.7 验证同名文件冲突测试目的确认废纸篓中已有同名文件时不会互相覆盖。echo first /tmp/safe_rm_demo/tmp_test.txt rm /tmp/safe_rm_demo/tmp_test.txt echo second /tmp/safe_rm_demo/tmp_test.txt rm /tmp/safe_rm_demo/tmp_test.txt预期结果废纸篓中出现tmp_test.txt和tmp_test.txt-20250101120000两个文件且内容分别对应第一次和第二次创建的内容。5.8 验证绕过方式测试目的确认在需要真正删除时依然有能力绕过 alias。mkdir -p /tmp/safe_rm_demo/real_delete echo do not recover /tmp/safe_rm_demo/real_delete/target.txt \rm -rf /tmp/safe_rm_demo/real_delete预期结果目录被直接删除废纸篓中没有出现real_delete。5.9 判断成功的标准汇总测试项成功标准文件删除废纸篓中出现目标文件目录递归删除整个目录出现在废纸篓内部文件完整多文件删除多个文件都出现在废纸篓通配符展开所有展开结果都被处理不存在路径无报错受保护路径拒绝执行并输出提示同名冲突文件名不互相覆盖绕过方式直接删除生效6. 接口 API 与批量任务6.1 无 HTTP 接口Safe-rm 不是一个服务程序不监听端口也没有 API 接口。它的运行方式是命令调用所以不存在curl http://127.0.0.1:xxxx这类交互。如果你需要把“安全删除”暴露成 HTTP 服务给 LLM Agent 或其他应用调用可以考虑自己封装一层轻量 HTTP 服务底层调用safe_rm。比如用 Python 写一个 Flask 接口from flask import Flask, request, jsonify import subprocess app Flask(__name__) app.route(/delete, methods[POST]) def delete(): paths request.json.get(paths, []) result subprocess.run( [/usr/local/bin/safe-rm] paths, capture_outputTrue, textTrue, ) return jsonify({ returncode: result.returncode, stdout: result.stdout, stderr: result.stderr, }) if __name__ __main__: app.run(host127.0.0.1, port8765)这只是示例需要根据你的实际服务框架调整。6.2 批量任务支持safe-rm 天然支持多个参数因此批量清理临时文件非常方便。比如定期清理某个临时目录下的所有.log文件safe-rm /tmp/project-*.log /tmp/cache-*.tmp配合 cron 时可以写成脚本#!/bin/bash # /usr/local/bin/cleanup_temp.sh /usr/local/bin/safe-rm /tmp/app-*.log然后在 crontab 中加入0 * * * * /usr/local/bin/cleanup_temp.sh但要注意如果批量任务中包含了合法数据仍然会被移动到废纸篓。批量任务最适合的是明确不需要的临时文件。6.3 批量任务失败重试建议由于 safe-rm 的核心操作是mv它最常见的失败原因是废纸篓所在磁盘空间不足。目标路径跨文件系统移动耗时较长。目标路径不存在。没有权限访问。建议在批量脚本中对返回码做检查for target in /tmp/app-*.log; do if /usr/local/bin/safe-rm $target; then echo deleted $target else echo failed $target /tmp/delete_errors.log fi done这样即使失败也不会中断整个批量任务。7. 资源占用与性能观察7.1 进程与内存占用safe-rm 是命令行函数或独立脚本没有常驻后台进程。执行结束后不会驻留内存因此不存在长期资源占用问题。每次调用时只会短暂启动一个 shell 进程和若干mv进程复杂度可以忽略不计。7.2 磁盘性能影响从删除变成移动本质上是在同一文件系统内移动文件。macOS 上同一分区内mv通常只是修改目录项不需要复制文件内容因此速度非常快。但如果目标路径位于其他卷比如使用外置硬盘而废纸篓在系统盘那么mv就会变成真正的跨卷复制。这会导致两个问题大文件移动很慢。复制完成后原文件被删除。所以建议废纸篓目录保持与常规工作目录在同一分区。系统默认的~/.Trash在系统盘上如果你的数据经常在外部卷建议在外部卷也保留一个独立回收目录或者调整 safe_rm 的目标目录。7.3 大文件与大批量操作如果一次性删除大量小文件执行mv的次数较多理论上会比原生rm稍慢但仍在可接受范围。如果一次性删除一个超大目录mv目录的速度主要取决于目录项数量。可以使用time命令观察time rm -rf /tmp/large_dir对比普通rmtime \rm -rf /tmp/large_dir分别记录时间。通常 safe-rm 会比直接删除多花费几十到几百毫秒但这个开销换来了误删恢复能力是值得的。7.4 如何降低资源影响不要在删除超大目录时频繁执行避免废纸篓短时间内不断膨胀。定期检查~/.Trash大小手动清理不需要的旧文件。如果磁盘紧张优先用/bin/rm清理明确的临时文件而不是把所有删除都塞进废纸篓。可以在 safe_rm 中增加一个判断当目标路径体积超过阈值时提示确认后再执行。8. 常见问题与排查方法问题现象可能原因排查方式解决方案执行rm后文件直接被删除没有加载 shell 函数或当前 shell 是 bash但配置写到了 zshrc终端执行which rm如果输出为/bin/rm说明 alias 未生效执行source ~/.zshrc或确保 bash 用户写入.bashrc然后新开终端safe_rm: command not found使用了独立脚本方案但脚本不在 PATH 中ls -l /usr/local/bin/safe-rm检查文件是否存在或把脚本所在目录加入 PATHrm是 shell 内置命令alias 不生效zsh 中没有内置 rm但某些 shell 可能内置了同名命令在 zsh 中执行which rm确认是否指向函数如果指向内置命令改用function rm覆盖或者移除内置命令定义mv: /Users/xxx/.Trash/xxx.db: No such file or directory~/.Trash目录被锁或不存在ls -ld ~/.Trash手动mkdir -p ~/.Trash并确认用户有写权限删除受保护路径时报错函数中保护逻辑误判打印abs_target检查路径是否符合预期调整保护路径列表rm -rf参数没有被正确过滤出现mv: illegal option当前函数实现未处理选项参数或用户在较老 macOS 上执行在函数中加入case跳过-*使用本文提供的完整函数版本同名文件被覆盖函数未处理同名冲突打开废纸篓检查是否有同名文件添加时间戳后缀逻辑sudo rm仍然直接删除sudo 调用外部命令不被 shell alias 拦截执行sudo rm测试不要依赖 safe_rm 保护 sudo如需保护使用专门的safe_rm二进制包装器废纸篓里看不到移动的文件移动到了其他目录而不是~/.Trash在终端执行ls -la ~/.Trash查看调整函数中的trash_dir变量跨卷移动时报cross-device link错误目标路径和废纸篓不在同一文件系统查看mount输出将废纸篓目录改到目标路径所在卷或自定义临时回收目录终端启动时报语法错误zsh 变量定义或case写法不兼容检查报错行号使用本文完整函数避免手写时遗漏;;批量任务中途失败某个文件不存在或没有权限查看脚本输出的错误信息在脚本中捕获返回码并记录日志9. 最佳实践与使用建议9.1 区分“安全删除”和“真正删除”建议在团队或个人的终端中加入两个命令rm安全删除移动到废纸篓。trash之外的grm或del真正删除直接调用系统/bin/rm。例如alias del\rm这样日常操作默认走安全通道需要真删时用del避免绕路。9.2 目录重载时避免误操作在safe_rm函数中建议保留输出日志。日志里应记录时间、原路径、目标路径。这样如果后续出现问题可以快速追踪。可以加一行echo $(date %Y-%m-%d_%H:%M:%S) $target - $dest_path $HOME/.safe_rm.log这行代码适用于任何实现版本修改后重新加载 shell 即可生效。9.3 给 LLM Agent 额外加一层保护对于 LLM Agent只有 safe_rm 还不够。建议同时做以下事情不要给 Agent 使用sudo权限。在独立用户目录或容器中运行 Agent这样即使 Agent 执行了删除也只影响隔离环境。在设计 Agent 工具时将rm替换成safe_rm并让 Agent 返回执行日志。在 prompt 中明确禁止 Agent 使用rm -rf清理整个用户目录而是要求先列出待清理文件。定期对重要目录做快照或备份。9.4 不要依赖 safe_rm 做终极保障safe_rm 的本质是把误删概率降低但它不是备份系统。你应该用 Git 管理代码。用 iCloud Drive、Dropbox 或 NAS 同步重要文件。用 Time Machine 做整机时间点备份。在客户端开发时将产物目录放到回收目录可追踪的位置。9.5 第一次使用先小范围验证不要刚配置完 safe_rm 就立刻对大量生产数据执行删除。先用临时目录测试几十个文件确认函数行为符合预期后再逐步应用到日常目录。9.6 在团队中推广时要注意跨 shellmacOS 上不同团队成员的 shell 可能不同常见的有 zsh、bash、fish。建议提供一个统一的脚本为 zsh 用户提供~/.zshrc配置。为 bash 用户提供~/.bashrc配置。为 fish 用户提供~/.config/fish/conf.d/safe_rm.fish配置。这样保证每位成员的rm行为一致。10. 总结与下一步Safe-rm 的核心思路可以浓缩成一句话把rm的语义从“删除”改成“移动到废纸篓”。尤其是当你开始让 LLM Agent 在本地终端里执行命令时这个改造能避免大量不可恢复的数据丢失。它不需要安装额外的运行时不需要 GPU也不影响现有脚本的运行方式改造成本很低。最先应该验证的功能是普通文件删除。创建一个测试文件执行rm然后去废纸篓确认文件是否还在。只要这一步能跑通你就能放心把这条策略应用到日常命令行工作中。最容易踩的坑是 alias 没有生效。很多人写完配置后没有source ~/.zshrc或者直接在 bash 里测试但配置写在了 zshrc 里。记住一个判断方法在终端执行which rm如果输出是/bin/rm说明安全删除还没接管如果输出是函数名或脚本路径说明已经生效。后续可以扩展的方向很多把这个函数改写成独立二进制、通过 MCP 暴露给 LLM Agent 安全工具、在团队中统一部署、加入全局删除审计日志甚至做成一个系统级系统托盘常驻工具。这个方案的价值不在技术上有多新而在于它能在日常工作中实实在在减少一次“手滑”带来的代价。建议直接收藏在 Mac 上配置好之后后面跑任何本地 Agent 或批量脚本都会安心很多。