Privacy redaction toolkit for images, PDFs, Word documents, and PowerPoint presentations. Use when the user needs to redact, mask, or replace sensitive/private information in files. Triggers: Redacting or masking sensitive text in images, PDFs, documents, or presentations Replacing names, phone numbers, IDs, or other PII in files Processing privacy compliance for documents before sharing Anonymizing content in visual files Supported formats: png/jpg images, PDF, docx/doc, pptx/ppt
Redact Skill
Privacy redaction toolkit using PPStructureV3 OCR for text detection and replacement.
Scripts
| Script | Format | Command |
|---|---|---|
read.py | Images / PDF / Word / PowerPoint | read.py <input> [--info] [--mode json] |
redact-image.py | Images (png, jpg, etc.) | redact-image.py <input> <rules.csv> <output> |
redact-pdf.py | redact-pdf.py <input> <rules.csv> <output> | |
redact-document.py | Word (docx, doc) | redact-document.py <input> <rules.csv> <output> |
redact-presentation.py | PowerPoint (pptx, ppt) | redact-presentation.py <input> <rules.csv> <output> |
CSV Rules Format
target_text,replacement_text
张三,李四
手机号,
身份证号,
| Rule | Effect |
|---|---|
原文本,新文本 | Replace with new text |
原文本, | Empty = mask with █ (documents) or solid color block (images/PDF) |
Masking Behavior
| Format | Empty Replacement |
|---|---|
| Images, PDF | Solid color block overlay |
| Word, PowerPoint | █ characters (same length as target) |
Read Features
read.py supports:
- Reading text from images, PDF, Word, and PowerPoint files
- OCR for image files and embedded images
- Page-aware output for PDF / Word / PowerPoint
--infostructured output:<page index="..."><image format='markdown' type='ocr'>...</image>for OCR text extracted from images
JSON Output
Document-like files (pdf, docx, doc, pptx) output:
{
"type": "pptx",
"pages": [
{
"page_index": 1,
"content": [
{ "type": "text", "text": "..." },
{ "type": "image", "text": "ocr text..." }
]
}
]
}
Image files output:
{
"type": "image",
"content": "..."
}
Features
| Feature | Image | Document | Presentation | |
|---|---|---|---|---|
| Read text | ✅ | ✅ | ✅ | ✅ |
| JSON output | ✅ | ✅ | ✅ | ✅ |
| Text replacement | ✅ | ✅ | ✅ | ✅ |
| Solid color mask | ✅ | ✅ | - | - |
| █ character mask | - | - | ✅ | ✅ |
| OCR detection | ✅ | ✅ | ✅ (images) | ✅ (images) |
| Tables | - | ✅ | ✅ | ✅ |
| Headers/Footers | - | ✅ | ✅ | - |
| Embedded images | - | ✅ | ✅ | ✅ |
Environment Setup
使用 uv 安装依赖:
# 进入 skill 目录
cd skills/redact
# 同步依赖(自动创建虚拟环境并安装)
uv sync
Dependencies
- Python 3.10+
- PaddleOCR / PPStructureV3
- python-docx, python-pptx, PyMuPDF, Pillow
Related skills
- Downloads
- 874All time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v0.1.1
- License
- MIT-0
