ClawHub

Picture

v1.0.0

提供图片加载、保存、尺寸调整、裁剪、格式转换，智能增强，滤镜应用，拼接，背景移除和文字添加的全能图片处理工具。

⭐ 0· 110·0 current·0 all-time
bybittao@hgta23

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for hgta23/picture.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "Picture" (hgta23/picture) from ClawHub.
Skill page: https://clawhub.ai/hgta23/picture
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install picture

ClawHub CLI

Package manager switcher

npx clawhub@latest install picture
Security Scan
VirusTotalVirusTotal
Pending
View report →
OpenClawOpenClaw
Benign
high confidence
✓
Purpose & Capability
The skill name/description (image loading, resizing, filters, background removal, text) matches the included Python modules. Required files and APIs (Pillow functions, file I/O for images and fonts) are exactly what an image-processing library needs.
✓
Instruction Scope
SKILL.md instructions and example.py show only local image operations (open, transform, save). There are no instructions to read unrelated system files, environment secrets, or to send data to external endpoints.
✓
Install Mechanism
No install spec is provided (instruction-only), and requirements.txt only lists pillow>=10.0.0 — a standard dependency for image processing. Nothing is downloaded from arbitrary URLs or installed from untrusted sources.
✓
Credentials
The skill requests no environment variables, credentials, or config paths. It does read system font files if present (expected for text rendering) but that is proportional to the stated functionality.
✓
Persistence & Privilege
The skill does not request always:true, does not modify other skills, and contains no code to persist or elevate privileges beyond reading/writing image files provided by the user.
Assessment
This package is coherent and appears safe for image processing. Before installing, note: it requires Pillow and will read/write files you pass to it (so avoid processing untrusted images if you are concerned about malformed file attacks). The text module will attempt to load system font files (normal behavior). Verify you run it in an environment with sufficient memory for large images and review any files you supply as inputs/outputs. If you need networked or remote-storage integration, this skill does not include that and would need explicit, separate code.

Like a lobster shell, security has layers — review code before you run it.

latestvk970m19179tmytdpq8rcyfndg984dway
110downloads
0stars
1versions
Updated 3w ago
v1.0.0
MIT-0
bittao@hgta23
latest
Download

name: picture version: 1.0.0 description: 创意图片处理技能包，以"P一下图片"为核心理念，提供图片基础操作、增强、滤镜、拼接、背景移除、文字添加等强大功能

picture 创意图片处理技能包 🎨

强大的图片处理工具包，让你轻松 "P一下图片"！p 字母代表 Power（强力）、Productivity（生产力）、Precision（精准）、Playful（有趣）。

功能特性

核心基础操作

  • 图片加载与保存：支持 JPEG、PNG、WebP 等常见格式
  • 尺寸调整：按比例缩放或指定尺寸，保持图片质量
  • 图片裁剪：精确裁剪指定区域
  • 格式转换：多种图片格式互转

智能图片增强

  • 亮度调整：自由调节图片明暗
  • 对比度调整：增强画面层次感
  • 清晰度增强：让图片更锐利
  • 智能增强：一键优化，自动调整各项参数

创意滤镜特效

  • 黑白滤镜：经典黑白效果
  • 复古滤镜：怀旧 sepia 色调
  • 模糊滤镜：柔化画面，支持自定义模糊半径
  • 轮廓滤镜：提取边缘，艺术效果
  • 反色滤镜：颜色反转
  • 像素化滤镜：马赛克效果，支持自定义像素大小

图片拼接合成

  • 水平拼接：多张图片横向无缝拼接
  • 垂直拼接：多张图片纵向无缝拼接
  • 网格拼接：指定行列数，智能排列
  • 智能对齐：支持多种对齐方式（居中、左/右、上/下）

背景移除功能

  • 简单背景移除：自动检测白色/浅色背景并移除
  • 指定颜色移除：自定义背景颜色，支持容差调节
  • 边缘平滑：高斯模糊柔化边缘，更自然

文字添加功能

  • 多种位置预设：9种预设位置（左上、上中、右上、左中、居中、右中、左下、下中、右下）
  • 自定义坐标：精确 x,y 定位
  • 字体样式：支持自定义字体、字号、颜色
  • 旋转效果：任意角度旋转文字
  • 中文字体：自动检测并使用系统中文字体

快速开始

安装

pip install -r requirements.txt

基础使用示例

from p_skill import (
    load_image, save_image,
    resize_image, crop_image,
    smart_enhance,
    grayscale, sepia,
    stitch_horizontal,
    remove_background_simple,
    add_text
)

# 加载图片
image = load_image("input.jpg")

# 调整尺寸
resized = resize_image(image, scale=0.5)

# 智能增强
enhanced = smart_enhance(resized)

# 添加复古滤镜
filtered = sepia(enhanced)

# 添加文字
with_text = add_text(filtered, "Hello p-skill!", position="bottom-center")

# 保存结果
save_image(with_text, "output.jpg")

API 文档

核心模块 (core)

load_image(file_path: str) -> Image.Image

加载图片文件。

参数:

  • file_path: 图片文件路径

返回: PIL Image 对象

save_image(image: Image.Image, output_path: str, quality: int = 95) -> None

保存图片到文件。

参数:

  • image: PIL Image 对象
  • output_path: 输出文件路径
  • quality: 图片质量 (1-100)，默认 95

resize_image(image: Image.Image, size: tuple[int, int] = None, scale: float = None) -> Image.Image

调整图片尺寸。

参数:

  • image: PIL Image 对象
  • size: 目标尺寸 (width, height)
  • scale: 缩放比例

返回: 调整后的图片

crop_image(image: Image.Image, box: tuple[int, int, int, int]) -> Image.Image

裁剪图片。

参数:

  • image: PIL Image 对象
  • box: 裁剪区域 (left, upper, right, lower)

返回: 裁剪后的图片

convert_format(image: Image.Image, format: str) -> Image.Image

转换图片格式。

参数:

  • image: PIL Image 对象
  • format: 目标格式 ('JPEG', 'PNG', 'WEBP' 等)

返回: 格式转换后的图片

增强模块 (enhance)

adjust_brightness(image: Image.Image, factor: float) -> Image.Image

调整图片亮度。

参数:

  • image: PIL Image 对象
  • factor: 亮度因子 (1.0 为原图，<1.0 变暗，>1.0 变亮)

adjust_contrast(image: Image.Image, factor: float) -> Image.Image

调整图片对比度。

参数:

  • image: PIL Image 对象
  • factor: 对比度因子 (1.0 为原图)

adjust_sharpness(image: Image.Image, factor: float) -> Image.Image

调整图片清晰度。

参数:

  • image: PIL Image 对象
  • factor: 清晰度因子 (1.0 为原图，>1.0 更锐利)

smart_enhance(image: Image.Image, brightness_factor: float = 1.1, contrast_factor: float = 1.1, sharpness_factor: float = 1.2) -> Image.Image

智能增强，一键优化图片。

滤镜模块 (filters)

grayscale(image: Image.Image) -> Image.Image

黑白滤镜。

sepia(image: Image.Image) -> Image.Image

复古滤镜。

blur(image: Image.Image, radius: int = 2) -> Image.Image

模糊滤镜。

参数:

  • radius: 模糊半径，默认 2

contour(image: Image.Image) -> Image.Image

轮廓滤镜。

invert(image: Image.Image) -> Image.Image

反色滤镜。

pixelate(image: Image.Image, pixel_size: int = 10) -> Image.Image

像素化滤镜。

参数:

  • pixel_size: 像素块大小，默认 10

拼接模块 (composite)

stitch_horizontal(images: list[Image.Image], align: str = 'center') -> Image.Image

水平拼接多张图片。

参数:

  • images: 图片列表
  • align: 对齐方式 ('top', 'bottom', 'center')

stitch_vertical(images: list[Image.Image], align: str = 'center') -> Image.Image

垂直拼接多张图片。

参数:

  • images: 图片列表
  • align: 对齐方式 ('left', 'right', 'center')

stitch_grid(images: list[Image.Image], cols: int, rows: int = None, align: str = 'center') -> Image.Image

网格拼接多张图片。

参数:

  • images: 图片列表
  • cols: 列数
  • rows: 行数（可选，自动计算）
  • align: 对齐方式

背景移除模块 (background)

remove_background_simple(image: Image.Image, threshold: int = 240, smooth_radius: int = 2) -> Image.Image

简单背景移除（适用于白色/浅色背景）。

参数:

  • threshold: 颜色阈值 (0-255)，默认 240
  • smooth_radius: 边缘平滑半径，默认 2

返回: 透明背景的 RGBA 图片

remove_background_color(image: Image.Image, target_color: tuple[int, int, int], tolerance: int = 30, smooth_radius: int = 2) -> Image.Image

指定颜色背景移除。

参数:

  • target_color: 目标背景颜色 (R, G, B)
  • tolerance: 颜色容差，默认 30
  • smooth_radius: 边缘平滑半径，默认 2

返回: 透明背景的 RGBA 图片

文字添加模块 (text)

add_text(image: Image.Image, text: str, position: str | tuple[int, int] = 'center', font_size: int = 36, color: tuple[int, int, int] | tuple[int, int, int, int] = (0, 0, 0), font_path: str = None, rotation: float = 0, offset: tuple[int, int] = (0, 0)) -> Image.Image

向图片添加文字。

参数:

  • image: PIL Image 对象
  • text: 要添加的文字内容
  • position: 位置 ('top-left', 'top-center', 'top-right', 'center-left', 'center', 'center-right', 'bottom-left', 'bottom-center', 'bottom-right') 或 (x, y) 坐标
  • font_size: 字体大小，默认 36
  • color: 文字颜色 (R, G, B) 或 (R, G, B, A)
  • font_path: 字体文件路径（可选，使用系统默认）
  • rotation: 旋转角度，默认 0
  • offset: 相对于位置的偏移 (x, y)，默认 (0, 0)

返回: 添加文字后的图片

性能说明

  • 单张 1080p 图片处理时间通常 < 5 秒
  • 支持最大分辨率取决于系统内存
  • 推荐使用 PNG 格式保存需要透明背景的图片

依赖

  • Pillow >= 10.0.0

Comments

Loading comments...