agentic-os-org/anolisa/pii-checker

PII Checker

复用已安装的 agent-sec-cli scan-pii 检测个人信息和凭证。 V2 需要预先运行的 Rust daemon 和 AGENT_SEC_DAEMON_SOCKET；不自动启动或回退到 Python。 支持邮箱、中国手机号、身份证号、银行卡号、API Key、Bearer Token、JWT、 私钥及自定义规则。仅检查用户指定的内容，不主动扩大到整个目录或历史会话。

调用

已知文件路径时直接扫描文件，无需先将原文读取到对话中：

agent-sec-cli scan-pii --input /absolute/path/to/input.txt --source manual --format json

用户要求脱敏时追加 --redact-output：

agent-sec-cli scan-pii --input /absolute/path/to/input.txt --source manual --format json --redact-output

内容来自文本或上游工具时，通过工具的标准输入接口或已有数据流传给下面的命令； 不要启动无人提供输入的交互式读取：

agent-sec-cli scan-pii --stdin --source manual --format json

• --input 只接受单个 UTF-8 文本文件，不解析目录、PDF、图片或压缩包。
• --input、--stdin、--text 三者必须且只能选一个。敏感正文优先走文件或

stdin，避免放入命令参数；不要将待扫描文本拼接为 shell 代码。

• 替换路径时优先使用参数数组；必须经 shell 时，对整个路径使用可靠的 shell

quoting（例如 shlex.quote），不能只在任意路径两侧加单引号。

• 普通主动检查使用 --source manual。此标签用于审计，不会更改输入或 Hook 策略。
• --include-low-confidence 可用于用户要求的更广泛复核，包含默认被过滤的低置信度

命中；这些分值是启发式评分，不是经过校准的概率。

• 默认扫描完整输入。只有明确限定范围时才设置正整数 --max-bytes，并报告截断。
• CLI 不可用、不支持 scan-pii、输入不可读或命令失败时，报告未完成检查；

不以模型自行猜测代替扫描结果，不安装软件或更改安全配置来绕过失败。

解释结果

解析 JSON 的 ok、verdict、summary、findings；不能只看退出码。 warn 和 deny 也可能返回退出码 0，表示扫描完成。

未配置自定义规则（status=absent）是正常状态，不算扫描失败。 JSON 缺失、解析失败、关键字段缺失或出现未知 verdict 时，报告无法取得有效判定。 pass 只表示未检出，不能承诺不存在敏感信息或内容可以安全外发。

报告实际扫描范围、判定、summary.total / summary.by_type 的命中统计， 必要时列出 finding 的 type、severity、span 和 evidence_redacted。 不要使用 --raw-evidence，也不要从原文或对话历史补回已脱敏的值。

脱敏与审计

只在用户要求脱敏时返回 redacted_text，并先检查 summary.redacted_text_omitted。 该标记为 true 时，即使扫描成功且覆盖完整，也没有可交付的完整脱敏正文； 应说明输出大小限制，并报告扫描判定与统计。不得把 [REDACTED: output size limit] 占位符作为完整脱敏文本交付、保存或覆盖原文件，也不要用省略后的 findings 重建全文。 该标记为 false 或不存在时，redacted_text 在实际扫描范围内替换检出的内容。 如果扫描或自定义规则不完整，要说明脱敏结果也不完整，不能把截断的片段当作全文。 --redact-output 不修改原文件；仅在用户要求保存或替换文件时执行对应写入。

扫描会记录经过脱敏的 pii_scan 安全事件。此 Skill 不调整 Hook 开关、阻断策略 或自定义规则配置；历史安全事件的查询与复盘由 security-observability 处理。