Skill: hgta23/p (version 1.0.0)

name: p-skill version: 1.0.0 description: 创意图片处理技能包，以"P一下图片"为核心理念，提供图片基础操作、增强、滤镜、拼接、背景移除、文字添加等强大功能 --------------------------------------------------------------------------------- # p-skill 创意图片处理技能包 🎨 强大的图片处理工具包，让你轻松 "P一下图片"！p 字母代表 Power（强力）、Productivity（生产力）、Precision（精准）、Playful（有趣）。 ## 功能特性 ### 核心基础操作 - **图片加载与保存**：支持 JPEG、PNG、WebP 等常见格式 - **尺寸调整**：按比例缩放或指定尺寸，保持图片质量 - **图片裁剪**：精确裁剪指定区域 - **格式转换**：多种图片格式互转 ### 智能图片增强 - **亮度调整**：自由调节图片明暗 - **对比度调整**：增强画面层次感 - **清晰度增强**：让图片更锐利 - **智能增强**：一键优化，自动调整各项参数 ### 创意滤镜特效 - **黑白滤镜**：经典黑白效果 - **复古滤镜**：怀旧 sepia 色调 - **模糊滤镜**：柔化画面，支持自定义模糊半径 - **轮廓滤镜**：提取边缘，艺术效果 - **反色滤镜**：颜色反转 - **像素化滤镜**：马赛克效果，支持自定义像素大小 ### 图片拼接合成 - **水平拼接**：多张图片横向无缝拼接 - **垂直拼接**：多张图片纵向无缝拼接 - **网格拼接**：指定行列数，智能排列 - **智能对齐**：支持多种对齐方式（居中、左/右、上/下） ### 背景移除功能 - **简单背景移除**：自动检测白色/浅色背景并移除 - **指定颜色移除**：自定义背景颜色，支持容差调节 - **边缘平滑**：高斯模糊柔化边缘，更自然 ### 文字添加功能 - **多种位置预设**：9种预设位置（左上、上中、右上、左中、居中、右中、左下、下中、右下） - **自定义坐标**：精确 x,y 定位 - **字体样式**：支持自定义字体、字号、颜色 - **旋转效果**：任意角度旋转文字 - **中文字体**：自动检测并使用系统中文字体 ## 快速开始 ### 安装 ```bash pip install -r requirements.txt ``` ### 基础使用示例 ```python 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


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)