Blur

核心功能：支持高斯、盒状、运动三种模糊类型，可模糊整图、指定区域，能检测并模糊人脸，支持批量处理；可记录元数据，支持撤销、导出处理记录。典型场景：保护人脸隐私、遮挡敏感信息、批量处理图片隐私内容。输入通过环境变量指定参数，命令行执行；输出为处理后的图片及JSON格式状态，元数据存于本地。

bytesagain

热度 22.41

最近更新 2026-03-19 00:31:49

分类：创作依赖：代码执行 / 读写文件应用场景：图像生成 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add blur

Metadata

name: blur
version: 1.0.0
description: Apply image blur effects and privacy masks using Python PIL processing. Use when you need to blur, redact faces, or mask sensitive regions in images.
author: BytesAgain
homepage: https://bytesagain.com
source: https://github.com/bytesagain/ai-skills
tags: ["blur","image","privacy","mask","redact","face-detection"]

Blur — Image Blur & Privacy Mask Tool

A comprehensive image processing skill for applying blur effects, face detection with automatic masking, region-based redaction, and batch processing. All processing metadata is tracked in JSONL format.

Prerequisites

bash (v4+)
python3 (v3.6+)
Pillow (PIL) — Python image library (install via pip3 install Pillow)
Optional: face detection libraries for the face command

Environment Variables

Variable	Required	Description
`BLUR_INPUT`	Yes*	Input image path
`BLUR_OUTPUT`	No	Output image path (default: auto-generated)
`BLUR_RADIUS`	No	Blur radius/strength (default: 10)
`BLUR_TYPE`	No	Blur type: gaussian, box, motion (default: gaussian)
`BLUR_REGION`	No	Region to blur: x,y,width,height
`BLUR_DIR`	No	Directory for batch processing
`BLUR_ID`	No	Processing record ID for undo/lookup
`BLUR_FORMAT`	No	Export format: json, csv (default: json)

Data Storage

Metadata: ~/.blur/data.jsonl
Config: ~/.blur/config.json
Output directory: ~/.blur/output/

Commands

`apply`

Apply blur effect to an entire image.

BLUR_INPUT="/path/to/image.jpg" BLUR_RADIUS="15" BLUR_TYPE="gaussian" scripts/script.sh apply

`face`

Detect and blur faces in an image for privacy.

BLUR_INPUT="/path/to/photo.jpg" BLUR_RADIUS="20" scripts/script.sh face

`region`

Blur a specific rectangular region in an image.

BLUR_INPUT="/path/to/image.jpg" BLUR_REGION="100,50,200,150" scripts/script.sh region

`batch`

Process multiple images in a directory.

BLUR_DIR="/path/to/images/" BLUR_RADIUS="10" scripts/script.sh batch

`preview`

Generate a low-resolution preview of the blur effect.

BLUR_INPUT="/path/to/image.jpg" BLUR_RADIUS="10" scripts/script.sh preview

`undo`

Revert a blur operation using the original backup.

BLUR_ID="blur_abc123" scripts/script.sh undo

`config`

View or update blur configuration.

BLUR_KEY="default_radius" BLUR_VALUE="15" scripts/script.sh config

`export`

Export processing history.

BLUR_FORMAT="json" scripts/script.sh export

`list`

List all processed images.

scripts/script.sh list

`status`

Show processing statistics.

scripts/script.sh status

`help`

Display usage information.

scripts/script.sh help

`version`

Display current version.

scripts/script.sh version

Output Format

{
  "status": "success",
  "command": "apply",
  "data": {
    "id": "blur_20240101_abc123",
    "input": "/path/to/image.jpg",
    "output": "/path/to/image_blurred.jpg",
    "blur_type": "gaussian",
    "radius": 10
  }
}

Error Handling

Exit Code	Meaning
0	Success
1	General error
2	Missing required parameter
3	Image not found
4	PIL/Pillow not installed