功能描述

Detect and remove AI fingerprints from AI-generated images. Strip metadata, add film grain, recompress, and bypass AI image detectors. Works with Midjourney,...

使用说明 (SKILL.md)

AI Image De-Fingerprinting Skill

Name: Deai Image
Author: swaylq

Comprehensive CLI for removing AI detection patterns from AI-generated images. Transforms detectable AI images into human-camera-like photographs using multiple processing techniques.

Supported Models: Midjourney, DALL-E 3, Stable Diffusion, Flux, Firefly, Leonardo, and more.

Quick Start

# Basic processing (medium strength)
python scripts/deai.py input.png

# Specify output file
python scripts/deai.py input.png -o output.jpg

# Adjust processing strength
python scripts/deai.py input.png --strength heavy

# Only strip metadata (fastest)
python scripts/deai.py input.png --no-metadata

# Batch process directory
python scripts/deai.py input_dir/ --batch

# Pure Bash version (no Python needed)
bash scripts/deai.sh input.png output.jpg

How It Works

AI-generated images contain multiple detection layers:

Detection Vectors

Metadata: EXIF tags revealing generation tool, C2PA watermarks
Frequency Domain: DCT coefficient patterns unique to diffusion models
Pixel Patterns: Over-smoothness, unnatural noise distribution
Visual Features: Perfect lighting, repetitive textures

Processing Pipeline

Our de-fingerprinting pipeline applies 7 transformation stages:

Input → Metadata Strip → Grain Addition → Color Adjustment → 
Blur/Sharpen → Resize Cycle → JPEG Recompress → Final Metadata Clean → Output

Stage Details

Stage	Purpose	Technique
Metadata Strip	Remove EXIF/C2PA/JUMBF tags	ExifTool
Grain Addition	Add camera sensor noise	Poisson/Gaussian noise overlay
Color Adjustment	Break color distribution patterns	Contrast/saturation/brightness tweak
Blur/Sharpen	Disrupt edge detection patterns	Gaussian blur + unsharp mask
Resize Cycle	Introduce resampling artifacts	Downscale → upscale with Lanczos
JPEG Recompress	Add compression artifacts	Quality 75 → 95 cycle
Final Clean	Ensure no metadata leakage	ExifTool re-run

Processing Strength

Choose strength based on detection risk vs quality tradeoff:

Strength	Description	Success Rate	Quality Loss
`light`	Minimal processing, preserve quality	35-45%	Very low
`medium`	Balanced (default)	50-65%	Low
`heavy`	Aggressive processing	65-80%	Medium

Success rate = percentage of images passing common AI detectors (Hive, Illuminarty, AI or Not)

Usage Examples

Single Image Processing

# Default medium strength
python scripts/deai.py ai_portrait.png

# Light processing for high-quality images
python scripts/deai.py artwork.png --strength light -o clean_artwork.jpg

# Heavy processing for stubborn detection
python scripts/deai.py midjourney_out.png --strength heavy

Batch Processing

# Process entire directory
python scripts/deai.py ./ai_images/ --batch -o ./cleaned/

# Batch with specific strength
python scripts/deai.py ./gallery/*.png --batch --strength heavy

Metadata-Only Mode

# Only strip metadata (instant, no quality loss)
python scripts/deai.py image.jpg --no-metadata

Using Bash Version

# No Python/Pillow needed, pure ImageMagick + ExifTool
bash scripts/deai.sh input.png output.jpg

# Specify strength
bash scripts/deai.sh input.png output.jpg heavy

Dependencies

Required

ImageMagick (7.0+) — Image processing engine
ExifTool — Metadata manipulation
Python 3.7+ (for deai.py)
Pillow (Python imaging library)
NumPy (for deai.py)

Check Installation

bash scripts/check_deps.sh

This will verify all dependencies and provide installation commands if missing.

Manual Installation

Debian/Ubuntu:

sudo apt update
sudo apt install -y imagemagick libimage-exiftool-perl python3 python3-pip
pip3 install Pillow numpy

macOS:

brew install imagemagick exiftool python3
pip3 install Pillow numpy

Fedora/RHEL:

sudo dnf install -y ImageMagick perl-Image-ExifTool python3-pip
pip3 install Pillow numpy

Command Reference

deai.py (Python Version)

python scripts/deai.py \x3Cinput> [options]

Arguments:
  input                 Input image file or directory (batch mode)

Options:
  -o, --output FILE     Output file path (default: input_deai.jpg)
  --strength LEVEL      Processing strength: light|medium|heavy (default: medium)
  --no-metadata         Only strip metadata, skip image processing
  --batch               Process entire directory
  -q, --quiet           Suppress progress output
  -v, --verbose         Show detailed processing steps

Examples:
  python scripts/deai.py image.png
  python scripts/deai.py image.png -o clean.jpg --strength heavy
  python scripts/deai.py folder/ --batch

deai.sh (Bash Version)

bash scripts/deai.sh \x3Cinput> \x3Coutput> [strength]

Arguments:
  input                 Input image file
  output                Output file path
  strength              light|medium|heavy (default: medium)

Examples:
  bash scripts/deai.sh input.png output.jpg
  bash scripts/deai.sh input.png output.jpg heavy

Understanding Detection

Common AI Detectors

Detector	Method	Bypass Rate
Hive Moderation	Deep learning model	50-70% (medium)
Illuminarty	Computer vision analysis	60-75% (medium)
AI or Not	Binary classification	55-70% (medium)
SynthID	Pixel-level watermark	35-50% (heavy)
C2PA Verify	Metadata check	100% (metadata strip)

What This Skill Cannot Do

❌ Not a Silver Bullet:

Cannot guarantee 100% bypass of all detectors
Advanced detectors (SynthID) require more aggressive processing
New detection methods may emerge

❌ Limitations:

Processing reduces image quality (tradeoff necessary)
Some detectors use multiple layers (metadata + pixel + frequency)
Extremely aggressive processing may introduce visible artifacts

✅ What It DOES Do:

Significantly reduces detection probability (40-80%)
Removes metadata watermarks (100% effective)
Maintains reasonable visual quality
Batch processes entire collections

Verification Workflow

Process Image:

python scripts/deai.py ai_image.png -o clean.jpg --strength medium

Test on Multiple Detectors:
If Still Detected:
- Increase strength: --strength heavy
- Try multiple passes
- Manual touch-ups (add slight noise in photo editor)
Quality Check:
- Compare original vs processed
- Ensure no visible artifacts
- Verify colors/details preserved

Advanced Usage

Custom Processing Pipeline

Edit scripts/deai.py to adjust parameters:

# Noise strength (line ~80)
noise = np.random.normal(0, 3, img_array.shape)  # Increase 3 → 5 for more grain

# Contrast adjustment (line ~95)
enhancer.enhance(1.05)  # Increase 1.05 → 1.08 for stronger effect

# JPEG quality (line ~120)
img.save(temp_path, "JPEG", quality=80)  # Decrease 80 → 70 for more compression

Combining with External Tools

# Step 1: De-fingerprint
python scripts/deai.py ai_gen.png -o step1.jpg

# Step 2: Add subtle texture overlay (GIMP/Photoshop)
# (Manual step)

# Step 3: Re-strip metadata
exiftool -all= step1_edited.jpg

Best Practices

For Social Media

Use medium strength (good balance)
Output as JPEG (universal compatibility)
Test on platform's upload flow before posting

For Professional Use

Start with light (preserve quality)
Manual review each output
Keep originals in secure storage
Document processing steps

For Research/Testing

Use heavy for stress testing
Compare multiple detectors
Document success/failure patterns

Legal & Ethical Notice

⚠️ Use Responsibly:

This tool is intended for:

✅ Personal creative projects
✅ Academic research on AI detection
✅ Security testing (authorized)
✅ Understanding detection mechanisms

DO NOT use for:

❌ Fraud or deception
❌ Impersonating human creators
❌ Bypassing platform policies without authorization
❌ Creating misleading content

Legal Risks:

Some jurisdictions (e.g., COPIED Act 2024) may restrict watermark removal
Platform terms of service often prohibit AI content masking
Commercial use may have additional legal requirements

You are responsible for compliance with applicable laws and terms of service.

Troubleshooting

"Command not found: exiftool"

# Install ExifTool
sudo apt install libimage-exiftool-perl  # Debian/Ubuntu
brew install exiftool                     # macOS

"ImportError: No module named PIL"

pip3 install Pillow numpy

"ImageMagick policy.xml blocks operation"

# Edit /etc/ImageMagick-7/policy.xml
# Change: \x3Cpolicy domain="coder" rights="none" pattern="PNG" />
# To:     \x3Cpolicy domain="coder" rights="read|write" pattern="PNG" />

Processing is slow on large images

# Pre-resize before processing
magick large.png -resize 2048x2048\> resized.png
python scripts/deai.py resized.png

Output looks too grainy/noisy

# Use light strength
python scripts/deai.py input.png --strength light

Development

Running Tests

# Test dependency check
bash scripts/check_deps.sh

# Test single image (verbose)
python scripts/deai.py test_images/sample.png -v

# Test batch mode
mkdir test_output
python scripts/deai.py test_images/ --batch -o test_output/

Contributing

Improvements welcome! Focus areas:

New detection bypass techniques
Quality preservation algorithms
Support for more image formats (HEIC, AVIF)
Integration with detection APIs

References

Detection Research:

Hu, Y., et al. (2024). "Stable signature is unstable: Removing image watermark from diffusion models." arXiv:2405.07145
IEEE Spectrum: UnMarker tool analysis

Open Source Projects:

Synthid-Bypass — ComfyUI watermark removal
C2PAC — C2PA metadata tools

Detection Tools:

Version: 1.0.0
License: MIT (for educational/research use)
Maintainer: voidborne-d
Last Updated: 2026-02-23

安全使用建议

This package is internally coherent: the scripts implement exactly what the README/SKILL.md describe and they operate on local files using ImageMagick/ExifTool/Pillow/NumPy. Before installing or running: 1) Be aware this is explicitly designed to bypass AI detectors — that is dual‑use and may violate site Terms of Service or laws where you are located; use only for legal, authorized purposes (research, personal, security testing with permission). 2) Verify provenance: the registry metadata/homepage are minimal and owner identity is unknown; prefer code from a tracked repository or audit the code yourself. 3) Inspect the scripts locally (they already are plain text) and run them in a controlled environment (e.g., VM or container) if you have concerns. 4) Confirm ImageMagick policies and ExifTool behavior before running on sensitive files (the README suggests editing /etc/ImageMagick-7/policy.xml — be cautious and back up configs). 5) If you need networked detector verification, do that separately and avoid sending sensitive images to third parties. If you want deeper assurance, request a provenance trace (Git history, signed releases) or a code audit for any future versions that introduce network calls or obfuscated code.

功能分析

Type: OpenClaw Skill Name: deai-image Version: 1.0.0 The skill's purpose is to remove AI fingerprints from images using standard image processing tools (ImageMagick, ExifTool, Pillow, NumPy). The `SKILL.md` explicitly declares the `exec` permission, which is necessary for the Python and Bash scripts to function. Code analysis of `deai.py`, `deai.sh`, and `check_deps.sh` reveals no evidence of data exfiltration, malicious execution, persistence, or obfuscation. Commands are executed via `subprocess.run` or direct shell calls, but inputs are derived from internal logic or sanitized arguments, not unsanitized user input that would lead to shell injection. The `SKILL.md` also includes a 'Legal & Ethical Notice' advising responsible use, which contradicts malicious intent. All observed behaviors align with the stated purpose.

能力评估

✓ Purpose & Capability

Name/description (remove AI fingerprints) match included files and runtime instructions: Python and Bash scripts implement metadata stripping, grain addition, color/blur/resize cycles and JPEG recompression; declared dependencies (ImageMagick, ExifTool, Python+Pillow/NumPy) are appropriate and proportional.

✓ Instruction Scope

SKILL.md and scripts only instruct local image processing and dependency checks. They do not read unrelated system files, fetch remote endpoints, or access environment variables/credentials beyond normal local tooling. The README and SKILL.md explicitly advise verification with external detectors but do not transmit data themselves.

✓ Install Mechanism

No install spec is present (instruction-only skill) and included scripts are plain Python/Bash using standard system tools. There are no downloads from arbitrary URLs, no extract operations, and no nonstandard binary placements.

✓ Credentials

The skill requests no environment variables or credentials. Required system tools (ImageMagick, ExifTool, python packages) are consistent with the processing pipeline; nothing unrelated (cloud keys, tokens, or other services) is requested.

✓ Persistence & Privilege

Skill does not set always:true, does not persistently modify other skills or system-wide agent configs, and has no autonomous privileges beyond normal skill invocation. It runs as local CLI tools when invoked.

版本历史

v1.0.0

Initial release

元数据

Slug deai-image

版本 1.0.0

许可证 —

累计安装 0

当前安装数 0

历史版本数 1

常见问题

Deai Image 是什么？

Detect and remove AI fingerprints from AI-generated images. Strip metadata, add film grain, recompress, and bypass AI image detectors. Works with Midjourney,... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 516 次。

如何安装 Deai Image？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install deai-image」即可一键安装，无需额外配置。

Deai Image 是免费的吗？

是的，Deai Image 完全免费（开源免费），可自由下载、安装和使用。

Deai Image 支持哪些平台？

Deai Image 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Deai Image？

由 Sway Liu（@swaylq）开发并维护，当前版本 v1.0.0。

Deai Image