用途:在通过 OpenRouter 调用上游大模型时,防止提示词不当泄露 PII,并满足 GDPR/CCPA 等合规要求。OpenRouter 本身不用 API 数据训练,但各上游提供商有各自的数据保留与训练政策,需分别核查。
主要能力:一是 PII 检测与脱敏,内置邮箱、电话、SSN、信用卡、sk-or-v1- API 密钥、IP 的正则规则,scan_and_redact() 返回 clean_text、findings 与 has_pii。二是占位符替换,PrivacyProxy.anonymize() 在调用前把 PII 换成唯一占位符,deanonymize() 在模型回复后还原原值。三是按隐私选择提供商,privacy_aware_completion() 按 public/standard/sensitive 敏感级别映射模型与 provider 块,standard/sensitive 使用 order: ["Anthropic"] 与 allow_fallbacks: False。四是隐私中间件,PrivacyMiddleware 可在每次调用前扫描,选择 block_on_pii=True 抛错或 auto_redact=True 自动脱敏。
使用方式:需 OpenRouter API 密钥(sk-or-v1-...)并导出为 OPENROUTER_API_KEY,Python 3.8+ 与 OpenAI SDK(pip install openai)。先按自身数据调整 PII_RULES 并检查误报,再按需选用脱敏或占位符模式,最后把中间件接入所有调用路径。
适用场景:处理 PII、合规审计、敏感数据提示词保护。限制:正则可能误报,需调优或改用 NLP 检测;模型可能原样返回占位符,需 deanonymize() 还原;提供商数据政策需自行核查;企业场景建议对日志提示做 SHA-256 哈希、对最敏感负载使用 BYOK。