前言¶
智能体越来越多地自主运行 Shell 命令。当命令是 rm -rf 时，一个错误的变量或误判的上下文切换就足以丢失仓库——或者更糟。agent-guard 通过隔离、审计和人工升级，使破坏性操作默认可逆，并在受支持的变异前记录持久意图。
这是什么¶
agent-guard 是一个 DeepSeek Harness 插件，用于在 AI 智能体执行操作时提供可靠性保障。它不负责安全沙箱，而是防御操作失误。
核心价值：将破坏性操作默认变为可逆操作。
维护者：mokuyoaxis
许可证：MIT
核心功能¶
该插件包含以下能力：
- 隔离删除：将删除操作重定向到
.agent-trash/目录，并附带清单文件。 - Git 快照：在 Git 覆盖操作前自动创建快照。
- 人工升级：对于智能体无法安全自动处理的复合形状操作，触发人工确认（ASK）。
- 审计日志：使用追加式 JSONL 日志记录决策和结果。
- 跨 Harness 运行：可在任何能运行 Python 的 Harness 上运行。
安装与启用¶
安装前请确保环境满足依赖要求：Python 3.9+、POSIX shell、git。
使用官方安装命令添加插件：
dsh plugin --profile <p> add github:mokuyoaxis/agent-guard
安装完成后，插件会接管智能体的相关操作。
典型用法¶
插件提供了脚本用于处理删除、恢复和检查操作。以下是一些典型命令：
- 安全删除：对目录执行删除，实际操作是隔离到回收站。
python3 skills/delete-guard/scripts/safe_delete.py build/ --reason "stale"
- 查看状态：查看当前的隔离状态。
python3 skills/delete-guard/scripts/status.py
- 恢复文件：列出可恢复的 ID 并进行恢复。
python3 skills/delete-guard/scripts/restore.py list
python3 skills/delete-guard/scripts/restore.py <txid>
- 垃圾回收：清理
.agent-trash/中的文件。
python3 skills/delete-guard/scripts/gc.py
- 命令拦截：在执行命令前进行检查。
python3 skills/delete-guard/scripts/check.py --enforce -- "$COMMAND"
适用场景与注意¶
- 适用场景：需要智能体清理构建产物、工作区清理等场景，特别是对误删风险较高的操作。
- 注意：
- 这是一个可靠性基础设施，不是安全沙箱。它防御的是失误，而不是恶意智能体。
- 零第三方依赖。
- 基于会话的能力，仅限人工恢复。
结语¶
agent-guard 提供了一套机制，让智能体在执行破坏性操作时，将不可逆的破坏转变为可逆的隔离。对于需要智能体自主处理文件系统的场景，这是一个实用的保障层。
目录页：https://www.skillhub.cn/plugins/mokuyoaxis/agent-guard
GitHub 仓库：https://github.com/mokuyoaxis/agent-guard
