privacy-mask

Category: Data & AI | Uploader: fullstackcrew-alpha | Downloads: 0 | Version: v1.0（Latest）

Mask sensitive information (phone numbers, emails, IDs, API keys, crypto wallets, etc.) in screenshots before analysis. Use when receiving screenshots that may contain private data, or when the user mentions privacy/masking/脱敏/打码.

Changelog: Source: GitHub https://github.com/fullstackcrew-alpha/privacy-mask

Directory Structure

Current level: Root

📁 .claude/
- 📁 hooks/
  - 📄 mask-images.sh 3.5 KB
- 📄 settings.json 327 B
📁 .claude-plugin/
- 📄 plugin.json 335 B
📁 .github/
- 📁 workflows/
  - 📄 ci.yml 894 B
  - 📄 publish.yml 626 B
📁 examples/
- 📄 architecture.svg 27.7 KB
- 📄 demo.gif 80.7 KB
- 📄 demo_before_after_form.png 10.1 KB
- 📄 demo_card_before.png 265.0 KB
- 📄 demo_card_masked.png 199.9 KB
- 📄 demo_chat_before.png 12.4 KB
- 📄 demo_chat_masked.png 8.8 KB
- 📄 demo_form_before.png 13.2 KB
- 📄 demo_terminal_before.png 17.1 KB
- 📄 demo_terminal_masked.png 9.7 KB
📁 hooks/
- 📄 hooks.json 132 B
📁 mask_engine/
- 📁 data/
  - 📄 config.json 9.4 KB
  - 📄 hook.sh 2.9 KB
- 📁 ocr/
  - 📄 __init__.py 2.7 KB
  - 📄 _types.py 1.8 KB
  - 📄 merge.py 1.1 KB
  - 📄 rapidocr_engine.py 1.7 KB
  - 📄 tesseract.py 1.4 KB
- 📄 __init__.py 444 B
- 📄 bbox.py 1.2 KB
- 📄 cli.py 9.4 KB
- 📄 config.py 2.5 KB
- 📄 detector.py 8.4 KB
- 📄 fonts.py 975 B
- 📄 masker.py 1.2 KB
- 📄 ocr.py 5.8 KB
- 📄 pipeline.py 3.5 KB
📁 scripts/
- 📄 benchmark.py 10.7 KB
- 📄 generate_test_images.py 13.8 KB
- 📄 mask-images.sh 2.9 KB
- 📄 mask_image.py 2.1 KB
- 📄 preview_detections.py 2.6 KB
📁 skills/
- 📁 privacy-mask/
  - 📄 SKILL.md 2.0 KB
📁 tests/
- 📄 __init__.py 0 B
- 📄 test_detector.py 52.2 KB
- 📄 test_masker.py 2.7 KB
- 📄 test_ocr.py 5.4 KB
- 📄 test_pipeline.py 3.1 KB
📄 .clawhubignore 167 B
📄 .gitignore 333 B
📄 CHANGELOG.md 1.6 KB
📄 CLAUDE.md 1.5 KB
📄 config.json 8.7 KB
📄 CONTRIBUTING.md 3.2 KB
📄 LICENSE 1.0 KB
📄 marketplace.json 329 B
📄 pyproject.toml 1.2 KB
📄 README.md 7.4 KB
📄 README.zh.md 7.2 KB
📄 requirements.txt 63 B
📄 setup.sh 1.3 KB
📄 SKILL.md 2.2 KB

SKILL.md

---
name: privacy-mask
description: Mask sensitive information (phone numbers, emails, IDs, API keys, crypto wallets, etc.) in screenshots before analysis. Use when receiving screenshots that may contain private data, or when the user mentions privacy/masking/脱敏/打码.
version: 0.1.0
license: MIT
compatibility: Requires tesseract OCR and Python 3.10+. All processing is local and offline.
metadata:
  author: wuhao
  openclaw:
    requires:
      bins:
        - tesseract
        - python3
    emoji: "\U0001F6E1"
    homepage: https://github.com/fullstackcrew-alpha/privacy-mask
---

# Privacy Mask

Detect and mask sensitive information in images locally before they leave your machine.

## When to use

- User sends a screenshot that may contain private data
- User mentions privacy, masking, 脱敏, or 打码
- You need to analyze an image but want to redact sensitive info first

## Quick start

```bash
pip install privacy-mask
privacy-mask install   # one-time: sets up global Claude Code hook
```

After install, all images are automatically masked before upload. No further action needed.

## Manual usage

Mask an image:
```bash
privacy-mask mask <image_path>
privacy-mask mask <image_path> --in-place
privacy-mask mask <image_path> --dry-run   # detect only
```

Output is JSON:
```json
{
  "status": "success",
  "detections": [{"label": "PHONE_CN", "text": "***", "bbox": [10, 20, 100, 30]}],
  "summary": "Masked 1 regions: 1 PHONE_CN"
}
```

## What it detects (47 rules)

- **IDs**: Chinese ID card, passport, HK/TW ID, US SSN, UK NINO, Canadian SIN, Indian Aadhaar/PAN, Korean RRN, Singapore NRIC, Malaysian IC
- **Phone**: Chinese mobile/landline, US phone, international (+prefix)
- **Financial**: Bank card, Amex, IBAN, SWIFT/BIC
- **Developer keys**: AWS, GitHub, Slack, Google, Stripe tokens, JWT, connection strings, API keys, SSH/PEM keys
- **Crypto**: Bitcoin, Ethereum wallet addresses
- **Other**: Email, birthday, IP/IPv6, MAC, UUID, license plate, MRZ, URL auth tokens

## Important

- All processing is **local and offline** — no data leaves the machine
- The hook intercepts images **before** upload to cloud API
- Configure rules in the bundled `config.json` or pass `--config` for custom rules

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

privacy-mask

Directory Structure

SKILL.md

Report

Notice