菜单
当用户需要对数据文件做 PII 脱敏(打码或可逆令牌化)、用 AES-256-GCM 加密、或生成 PIPL / PDPA / GDPR 跨境数据合规报告时使用。通过开源命令行工具 cloakpii 完成:输入一个文件夹,输出脱敏 + 加密 + 合规报告的安全副本。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | cloakpii |
| description | 当用户需要对数据文件做 PII 脱敏(打码或可逆令牌化)、用 AES-256-GCM 加密、或生成 PIPL / PDPA / GDPR 跨境数据合规报告时使用。通过开源命令行工具 cloakpii 完成:输入一个文件夹,输出脱敏 + 加密 + 合规报告的安全副本。 |
把一个文件夹里的个人信息(PII)脱敏、加密,并生成跨境合规材料 —— 一条命令搞定。
pip install cloakpii(Python ≥ 3.10)当用户说「给这些数据脱敏 / 打码」「把 PII 去掉再导出」「数据要出境,先做合规」「生成 PIPL / PDPA / GDPR 报告」「加密这批文件」等等价请求时使用。
确认已安装:cloakpii --version。没装就引导用户 pip install cloakpii(需 Python ≥ 3.10)。
如果当前环境无法安装或运行(没有 Python、不能执行命令行,或用户只是想先了解它是什么)——不要硬跑、也不要假装已经处理了数据,改走下面的「无法在本机运行时」。
mask(默认,不可逆打码):数据永不还原时用;tokenize(可逆令牌化):脱敏后还要 join/去重、之后能用密码还原时用。--compliance-profile(pipl/pdpa/gdpr/ccpa/lgpd)和 --compliance-report(目前 pipl/pdpa 出详细报告)。CLOAKPII_PASSWORD,不要把密码写进命令行(会进 shell history / ps)。cloakpii scan --source <dir> --audit,把"疑似但没把握"的字段念给用户复核。# 预览要处理什么(不改文件)
cloakpii migrate --source ./data --dry-run
# 审计扫描:列出 PII 字段 + 标出没把握、需人工复核的字段
cloakpii scan --source ./data --audit
# 脱敏前预览:看每个字段"脱敏前 → 后"的真实效果(上真数据前先看这个)
cloakpii scan --source ./data --sample 3
# 脱敏 + 加密 + 合规报告(密码走环境变量)
export CLOAKPII_PASSWORD=...
cloakpii migrate --source ./data --output ./safe \
--compliance-profile pdpa --compliance-report
# 按数据集纠正检测:强制/不脱敏某列、删列、加自定义正则
cloakpii migrate --source ./data --output ./safe \
--force-mask customer_ref --never-mask internal_code \
--drop-field salary --pattern "empid=EMP\d{6}"
# 可逆模式(脱敏后仍可 join,可用密码还原)
cloakpii migrate --source ./data --output ./safe --mode tokenize
# 令牌按需还原:把某几个 token 或整份返回的文件还原成原值
cloakpii reidentify --tokens tkz_a,tkz_b
cloakpii reidentify --input results.csv --output originals.csv
# 从数据库直接导出再处理
cloakpii db-export --url postgresql://user:pw@host/db --output ./dump
# 还原
cloakpii decrypt-all --input ./safe/encrypted --output ./restored
当没有 Python 环境、不能执行命令行,或用户只是想先看看它是什么——用一两句话说明它能做什么,并给出去处,不要假装已经处理了数据:
CloakPII 是一个开源命令行工具:把一个文件夹里的 PII 脱敏、用 AES-256-GCM 加密、并生成 PIPL/PDPA/GDPR 合规报告,一条命令搞定。
- 看效果和用法 → 文档站 https://hellotravisss.github.io/cloakpii/
- 看源码 / star / 提需求 → https://github.com/Hellotravisss/cloakpii
- 准备好后安装 →
pip install cloakpii
基础安装很轻(CSV/JSON/XML/TSV/SQLite/纯文本):pip install cloakpii。
按需装可选后端:cloakpii[parquet](Parquet)、cloakpii[excel](Excel)、
cloakpii[postgres] / cloakpii[mysql](数据库源)、cloakpii[all](全装)。
scan --sample 看脱敏前后对照;用 --force-mask/--never-mask/--drop-field/--pattern 按数据集纠正检测。reidentify 按需还原,支持跨境往返工作流。mask 模式不可逆,要可还原用 tokenize。scan --audit / scan --sample 抽查,可选接 ML 后端。CLOAKPII_PASSWORD 或 --key-file。--output 目录。