文字 PII 偵測與遮蔽

影像遮蔽模組會在螢幕截圖中模糊 PII,但從 UI、OCR、剪貼簿、LLM 提示/回應或日誌行擷取的 *文字*卻沒有字串層級的對應 —— 因此 PII 可能洩漏進動作紀錄、稽核日誌或一次模型呼叫。 detect_pii / redact_pii_text 可在純文字上找出並遮蔽電子郵件、電話號碼、SSN、信 用卡號、IPv4 位址與 IBAN。

樣式刻意保持簡單(無巢狀量詞 → 無災難性回溯)。純標準函式庫(re + hashlib);不匯 入 PySide6。

無頭 API

from je_auto_control import detect_pii, redact_pii_text

detect_pii("mail a@b.com, ip 10.0.0.1")
# -> [PIIFinding(kind='email', value='a@b.com', start=5, end=12), ...]

redact_pii_text("contact a@b.com")                    # -> "contact [email]"
redact_pii_text("a@b.com", mode="mask")               # -> "*******"
redact_pii_text("4111111111111111", mode="partial")   # -> "************1111"
redact_pii_text("a@b.com", mode="hash")               # -> "[email:fb98d44a]"

detect_pii(text, kinds=["email", "phone"])            # 限定偵測器

detect_pii 回傳依位置排序、互不重疊的結果(較前、再較長的匹配勝出 —— 因此信用卡號不 會同時被標記為電話)。redact_pii_text 模式:label``(``[email])、mask (****)、partial``(保留末 4 碼)、``hash``(``[email:<digest>])。

執行器指令

指令	效果
AC_detect_pii	{findings} —— 文字中的 PII 區段。
AC_redact_pii	{text} —— 已遮蔽 PII 的文字。

kinds 接受清單或 JSON 字串清單。相同操作亦提供為 MCP 工具(ac_detect_pii / ac_redact_pii),以及 Script Builder 中 Data 分類下的指令。