在展示或记录 Agent 输出前脱敏凭据、PII 和内部信息

任何需要把 AI/Agent 响应展示给用户或写入日志、并防止意外泄露敏感信息的场景。

适用场景

解决思路

1. 在 agent 响应展示给用户或写入日志前，扫描输出中是否意外泄露敏感信息，并执行脱敏。
2. 凭据和密钥分类的敏感值统一替换为 `[REDACTED]`。
3. AWS Access Key：匹配 `AKIA[0-9A-Z]{16}`，替换为 `[REDACTED]`。
4. AWS Secret Key：匹配 access key 后 40 字符 base64 值，替换为 `[REDACTED]`。
5. OpenAI API Key：匹配 `sk-[a-zA-Z0-9]{48}`，替换为 `[REDACTED]`。
6. Anthropic Key：匹配 `sk-ant-[a-zA-Z0-9-]{80,}`，替换为 `[REDACTED]`。
7. GitHub Token：匹配 `ghp_[a-zA-Z0-9]{36}`，替换为 `[REDACTED]`。
8. Generic Passwords：匹配 `password\s*[:=]\s*['"][^'"]+['"]`，替换为 `[REDACTED]`。
9. Private Keys：匹配 `-----BEGIN.*PRIVATE KEY-----`，替换为 `[REDACTED]`。
10. JWT Tokens：匹配 `eyJ[a-zA-Z0-9_-]+\.eyJ[a-zA-Z0-9_-]+`，替换为 `[REDACTED]`。
11. Database URLs：匹配 `<db-scheme>://[^\s]+`，替换为 `[REDACTED]`；`<db-scheme>` 通常包括 `postgres`、`mysql`、`mongodb`。
12. Email addresses：隐藏 local part，如 `j***@example.com`。
13. Phone numbers：隐藏数字并保留最后 4 位，如 `+1 (***) ***-1234`。
14. SSN / National IDs：完全脱敏为 `[SSN REDACTED]`；匹配任何带连字符的 9 位模式。
15. Credit card numbers：脱敏为 `****-****-****-1234`，保留最后 4 位。
16. Private IP addresses：通常作为配置保留原样，如 `192.168.1.1`。
17. Public IP addresses：根据上下文评估，可能需要脱敏。
18. Full home directory paths：把 `/Users/john/` 替换为 `~/`。
19. Internal hostnames：替换为 `[internal-host]`。
20. Internal URLs/endpoints：把域名替换为 `[internal]`。
21. Stack traces with internal paths：简化为相对路径。
22. Docker/container IDs：截断为前 8 个字符。
23. 当 agent 输出代码片段时，检查硬编码连接字符串。
24. 当 agent 输出代码片段时，检查配置对象里的 API keys。
25. 当 agent 输出代码片段时，检查环境变量默认值里的 passwords。
26. 当 agent 输出代码片段时，检查源码中嵌入的 private keys。
27. 当 agent 输出代码片段时，检查带 token 的 webhook URLs。
28. Step 1 Scan：对输出文本运行所有检测模式。
29. Step 2 Classify：Critical（凭据、私钥、token）始终脱敏。
30. Step 2 Classify：High（PII、database URLs）除非明确调试，否则脱敏。
31. Step 2 Classify：Medium（内部路径、hostnames）泛化处理。
32. Step 2 Classify：Low（非敏感但内部）保留但标记。
33. Step 3 Redact：替换敏感值同时保留上下文。例如 `postgres://admin:s3cr3t_p4ss@db.internal:5432/prod` -> `postgres://[REDACTED]@[REDACTED]:5432/[REDACTED]`。
34. Step 3 Redact：例如 `/Users/john.smith/projects/secret-project/src/auth.ts:42` -> `~/projects/.../src/auth.ts:42`。
35. Step 4 Report：输出 `OUTPUT SANITIZATION REPORT`，包含 items scanned、redactions made。
36. Step 4 Report：逐项记录等级、检测类型、行号、操作，如 `[CRITICAL] API Key detected and redacted (line 15)`、`Type: OpenAI API Key`、`Action: Replaced with [REDACTED]`。
37. Step 4 Report：对 `[HIGH]` email 记录 `Type: PII - Email`、`Action: Masked local part`。
38. Step 4 Report：对 `[MEDIUM]` path 记录 `Type: Internal path`、`Action: Replaced with ~/`。
39. 始终宁可过度脱敏，误报好于泄露 secret。
40. 绝不记录或存储原始敏感值。
41. 脱敏后保持可读性，输出仍应能理解。
42. 如果整个响应都敏感（如 dump `.env`），用警告替换，而不是逐项脱敏。
43. 用户明确要求查看代码中的值（如 "show me my .env"）时，不要脱敏，但要警告用户。

适用边界 · 注意事项

• 当用户明确要求查看敏感值（如 "show me my .env"）时，不应直接脱敏，而应警告用户。
• 当整个响应本身都是敏感内容（如 dump `.env`）时，不应逐项脱敏后展示，应替换为警告。
• 私有 IP 地址通常作为配置保留原样，除非上下文要求，否则不属于需要脱敏的目标。