cc-safety-net

cc-safety-net 概覽

這是什麼

CC Safety Net（Coding CLI Safety Net）是一個針對 AI 編碼代理的執行前防護工具。它會在工具呼叫執行前，阻擋破壞性的 Git 與檔案系統指令，以及常見的敏感檔案存取嘗試。它會解析指令的實際行為，因此包裝指令或重新排列旗標無法隱藏其意圖。設定檔損壞時不會阻擋任何操作。它不是沙箱：不會限制程序、設定檔案系統權限，或監控網路對外連線。

主要功能

• 阻擋破壞性指令，例如 git reset --hard、git push --force，以及針對危險目標的 rm -rf，即使包在 bash -c 或 python -c 內也一樣。
• 阻擋對 SSH 金鑰、.env 檔案、~/.aws 與編碼 CLI 憑證的存取，涵蓋 shell 與代理的檔案工具。
• 透過 GUI 調整政策：執行 npx cc-safety-net gui 可選擇 Standard、Strict 或 Paranoid 預設，並開關規則。
• 透過規則書新增阻擋：官方提供 Terraform、AWS、gcloud 與 Azure 套件，或使用自訂 JSON。
• 透過 git 分享政策：提交 .cc-safety-net/，讓複製的專案與雲端工作階段套用相同規則。
• 可嵌入自有工具：直接從 Node.js 呼叫 checkCommand，不需安裝掛鉤。

使用情境

• 保護本機開發環境，避免 AI 編碼代理意外執行破壞性操作。
• 防止代理驅動的工作階段中洩漏機密（SSH 金鑰、.env 檔案、雲端憑證）。
• 透過 git 分享的規則書，在團隊複製與雲端工作階段中強制一致的安全政策。
• 將安全檢查整合到自訂的 Node.js 工具中，用於呼叫指令。

快速開始

需要 Node.js 18 或更高版本。安裝到本機的編碼 CLI，然後檢查防護是否正常運作： bash npx -y cc-safety-net@latest install npx -y cc-safety-net@latest doctor 使用 npx -y cc-safety-net@latest update 更新，使用 npx -y cc-safety-net uninstall 解除安裝。請保留 @latest 限定詞：單獨的 cc-safety-net 規格可能執行 npx 快取中的舊版本。

授權與價格

授權：MIT。價格：開源（未提供價格資訊）。

內容整理自該專案公開的 README 與儲存庫資訊。