SurrogateShield

一個以隱私為優先的護欄,適用於LLM和RAG管道。SurrogateShield即時偵測、編輯和重建敏感的PII資料,同時防禦

SurrogateShield 是什麼?

一個以隱私為優先的護欄,適用於LLM和RAG管道。SurrogateShield即時偵測、編輯和重建敏感的PII資料,同時防禦對抗性攻擊。

SurrogateShield 概覽

這是什麼

SurrogateShield 是一個隱私優先的防護層,專為大型語言模型(LLM)與檢索增強生成(RAG)管線設計。它能夠即時偵測、遮罩並還原敏感的個人識別資訊(PII),同時抵禦對抗性攻擊。所有加密操作都在本地執行。在密封的 test-3 基準測試中,SurrogateShield 僅讓 3,677 個個人值中的 0.8% 通過,而 GLiNER-PII 為 9.1%,Microsoft Presidio 為 31.6%。

主要功能

  • 分層 PII 偵測:正則表達式、DeBERTa-v3-small PII 標記器、spaCy 與可選的 distilbert-NER,提供 balanced、strict、fast 與 classic 四種預設。
  • 逼真的替代值生成:偽造姓名、社會安全碼、比特幣地址等,均能通過格式檢查。
  • AES-256-GCM 加密的 ShadowMap:替代值與原始值的對應關係絕不以明文儲存。
  • 多供應商支援:Claude、Gemini、ChatGPT,或透過 Ollama 完全離線使用。
  • 服務查詢智慧:位置查詢僅對地址進行最小模糊化處理,而非完全取代。
  • 準識別符風險偵測:當 ZIP+出生日期+性別等組合可能導致重新識別時發出警告(Sweeney k-匿名性)。
  • 隱私感知 RAG:文件在索引前即被匿名化;所有向量儲存操作均使用替代值。

使用情境

  • 在 LLM 互動中保護 PII,在敏感資料送達 LLM 供應商前將其遮罩,並在回覆中還原。
  • 為 RAG 管線匿名化資料,防止索引與檢索過程中 PII 外洩。
  • 透過批次評估、各實體類型指標與消融研究來評估 PII 偵測管線。

快速開始

從儲存庫根目錄安裝獨立 Python 函式庫:pip install ./python-library完整的設定說明(包括設定檔與執行儀表板)請參閱儲存庫的 README。

授權與價格

授權:Apache-2.0。價格:開源(免費)。

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

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/sherwinvisheshsurrogateshield.svg)](https://yunodb.com/tools/sherwinvisheshsurrogateshield?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/sherwinvisheshsurrogateshield?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/sherwinvisheshsurrogateshield.svg" alt="Featured on YunoDB" height="20"></a>