| name | document-privacy-audit |
| description | 针对指定 PDF 或 Office 文档（.pdf/.docx/.xlsx/.pptx）进行全文解析、检索与深度理解，识别并汇总隐私/敏感信息（PII、金融、健康、账号凭据等），输出审计报告与风险提示。用于合规审查、数据脱敏准备、外发前检查或隐私扫描。 |
Document Privacy Audit
概览
执行全文抽取与结构化检索，结合规则与语义判断定位隐私信息，输出带定位与风险等级的汇总报告。
工作流程
- 明确范围与交付
- 确认文件路径与格式、语言、是否包含扫描页。
- 明确隐私范围（仅 PII，还是包含财务/健康/凭据）。
- 约定输出格式（Markdown 报告 + JSON 明细，或仅报告）。
- 抽取全文并保留定位
- 优先使用
scripts/extract_text.py 输出 JSONL，保留页码/段落/单元格定位。
- PDF 如无文本层，提示使用 OCR（
ocrmypdf 或 tesseract）后再抽取。
示例：
python scripts/extract_text.py --input /path/to/file.pdf --output /path/to/extracted.jsonl
python scripts/extract_text.py --input /path/to/file.docx --output /path/to/extracted.jsonl
- 全文检索与结构化理解
- 对抽取结果做关键词检索（
rg 或自定义脚本），保留命中位置。
- 归纳文档结构与主题，为隐私判断提供上下文（例如表格是名单/账单/病历）。
- 识别隐私信息
- 使用
scripts/pii_scan.py 做规则扫描，生成候选清单。
- 结合上下文进行语义复核，剔除明显误报并补充漏报。
- 分类与分级请参考
references/pii_catalog.md。
示例：
python scripts/pii_scan.py --input /path/to/extracted.jsonl --output /path/to/pii_report.json
- 汇总输出
- 输出审计摘要、发现明细、风险等级与建议。
- 所有示例必须脱敏展示，保留定位信息以便复核。
输出模板
# 隐私审计报告
- 文件: <path>
- 扫描范围: <PII/财务/健康/凭据>
- 扫描时间: <YYYY-MM-DD>
- 结论: <低/中/高风险 + 1-2 句说明>
## 发现摘要
| 类别 | 数量 | 示例(脱敏) | 位置 |
| --- | --- | --- | --- |
| 邮箱 | 3 | a***@example.com | page:2, page:5 |
| 手机 | 2 | 13******45 | page:3 |
## 高风险项
- <类别 + 脱敏示例 + 位置 + 风险原因>
## 细项清单
- <类别> | <脱敏示例> | <位置> | <上下文简述>
## 建议
- <脱敏/删除/分级访问/加密存储等>
资源
scripts/
extract_text.py: 统一抽取 PDF/Office 文本并保留定位。pii_scan.py: 规则扫描隐私信息并生成 JSON 报告。
references/
pii_catalog.md: 隐私类别、风险等级与脱敏示例。
