Redact

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	PDF	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

csv

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
• --info structured 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:

json

{
  "type": "pptx",
  "pages": [
    {
      "page_index": 1,
      "content": [
        { "type": "text", "text": "..." },
        { "type": "image", "text": "ocr text..." }
      ]
    }
  ]
}

Image files output:

json

{
  "type": "image",
  "content": "..."
}

Features

Feature	Image	PDF	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 安装依赖：

bash

# 进入 skill 目录
cd skills/redact

# 同步依赖（自动创建虚拟环境并安装）
uv sync

Dependencies

• Python 3.10+
• PaddleOCR / PPStructureV3
• python-docx, python-pptx, PyMuPDF, Pillow