工作区回收站（Workspace Trash）

切勿永久删除工作区文件。始终使用回收站功能，而非直接调用 rm。

依赖项

• Node.js（node）—— 用于清单（JSON）文件管理
• POSIX 工具集 —— mv、cp、rm、find、awk、date、basename、dirname

配置

这些变量为标准的 OpenClaw 环境变量，通常已预先设置。若未设置，脚本将采用安全的默认值。

斜杠命令（Slash Commands）

• /trash — 显示回收站菜单（含查看、清空、还原等选项）
• /trash:view — 列出回收站中所有项目
• /trash:empty — 永久删除回收站内全部内容（执行前需用户确认！）
• /trash:restore — 列出项目并询问用户需还原哪一个

脚本调用方式

bash skills/workspace-trash/scripts/trash.sh  [args...]

支持的操作（Actions）：move、list、restore 、empty、size

安全性

• 作用域锁定（Scope lock）：仅允许将 $OPENCLAW_HOME（默认为 ~/.openclaw/）路径下的文件移入回收站；超出此范围的路径将被拒绝。
• 符号链接解析（Symlink resolution）：所有路径在作用域检查前均被解析为其真实物理路径，从而防止符号链接遍历攻击（symlink traversal attacks）。
• 不进行 Shell 层面的用户数据插值（No shell interpolation of user data）：所有用户提供的路径与文件名均通过环境变量（process.env）传入 Node.js，绝不会以字符串插值形式拼接到 node -e 命令中，以此防范由恶意构造的文件名引发的代码注入风险。
• -- 分隔符：所有对 mv、cp 和 rm 的调用均使用 -- 参数分隔符，防止以短横线（-）开头的文件名被误解析为命令行选项。

破坏性操作

• empty 操作：使用 rm -rf 永久删除回收站中全部内容。该操作不可逆。执行前代理（agent）必须始终向用户确认，并明确展示即将删除的具体内容。
• 跨文件系统回退机制（Cross-filesystem fallback）：当 mv 因跨越文件系统边界而失败时，脚本将自动回退至 cp -a + rm -rf 组合方案；仅当复制成功后，才会删除源文件。

使用规则

1. 严禁对 OpenClaw 文件直接使用 rm 或 rm -rf。应始终改用回收站脚本的 move 操作。
2. 当被要求删除、移除或清理文件时，应使用 trash.sh move ，而非 rm。
3. 清空回收站前，必须先向用户确认，并清晰展示将被删除的内容。
4. 回收站位于主工作区根目录下的 .trash/ 子目录中；一个名为 .manifest.json 的文件用于记录原始路径，以便后续还原。
5. 作用域限定：仅限 ~/.openclaw/ 下的任意文件——包括主工作区、代理工作区（workspace-*）及其他 OpenClaw 目录。脚本将拒绝处理任何位于 ~/.openclaw/ 外部的路径。
6. 跨文件系统支持：代理工作区可能挂载于不同文件系统。当 mv 因跨文件系统失败时，脚本将自动回退至 cp -a + rm；还原操作同样支持跨文件系统的移动。
7. 还原操作可通过列表中的索引编号（index number）或回收站内文件名进行；来自代理工作区的条目在列表视图中会标注 [agent] 标签。
8. 一次需删除多个文件时，请将它们全部作为参数一次性传入：例如 trash.sh move file1 file2 dir1。