前言¶
智能體越來越多地自主運行 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
