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 與儲存庫資訊。