偵測器資料庫File blast radius

File blast radius

一個小任務,三十個檔案異動。

掌握代理任務影響的檔案範圍是否超出預期。

看見問題,理解發現。

英語旁白附字幕。

為何容易被忽略

你請求一個小修正,代理卻開始觸及整個專案的檔案。大範圍重構可能是正確的,但它需要比單行修改更高程度的關注。

當檔案操作逐一出現時,風險很容易被忽略。每次編輯單獨看起來都很小,但合在一起,可能影響遠超原始任務範圍的專案部分。

ClawMetry 偵測的內容

ClawMetry 檢查捕獲的工具參數中的檔案變更範圍與破壞性命令模式。大範圍編輯可能觸發檔案影響範圍警告;針對根目錄的遞迴刪除可能觸發嚴重發現。

改變發現結果的關鍵差異

觸發範例

30 個不同檔案寫入

警告發現

靜默對比

4 個不同檔案寫入

此偵測器無發現。

在受檢比較中,寫入三十個不同檔案會觸發警告,寫入四個檔案則保持靜默。大範圍編輯的閾值可能因執行環境與基準而異。發現結果提供計數與有限證據,協助你聚焦審查。

檢查偵測器結果
{
  "kind": "file_blast_radius",
  "severity": "warning",
  "evidence": {
    "distinct_files": 30,
    "write_calls": 30,
    "threshold": 25,
    "threshold_source": "static",
    "baseline": null,
    "outside_workspace": 0,
    "destructive": [],
    "samples": [
      "example/f0.py",
      "example/f1.py",
      "example/f2.py"
    ],
    "observed": "tool_arguments"
  }
}
下載輸入及完整結果 (JSON)
範例的檢查方式

這些範例使用已撰寫的事件資料或一次性設定檔來評估已發布的偵測器。影片說明這些行為,並非即時代理或產品介面的錄製內容。範例中沒有任何指令被實際執行。

結果確立了這些輸入的行為,並不確立執行時期擷取、預防或實際入侵。 檢查已固定的原始碼合約.

接下來要檢查什麼

比對受影響範圍與請求內容。仔細檢查實際差異,特別是自動產生的變更與刪除。在接受結果前,確認測試涵蓋了相關檔案。重點是在你仍有上下文時,及早發現意外的大範圍變更。

  1. 比對範圍與任務
  2. 審查實際差異
  3. 檢查測試與刪除

此訊號確立的範圍

此偵測器讀取工具參數,而非檔案系統系統呼叫。它在動作後回報,無法證明每個命名的變更都已成功執行。

讓重要時刻保持可見。

追蹤代理活動、檢查發現結果,決定哪些需要您的關注。