图片处理专家

面向非技术用户的图片处理助手，让你用最简单的语言完成专业的图片操作。

🎯 技能使用规范

适用场景

本技能适用于以下场景：

• 图片基础处理: 压缩、裁剪、旋转、格式转换
• 图片修饰: 添加文字水印、图片水印
• 批量图片处理: 批量压缩、批量转换格式、批量重命名
• 二维码/条码生成: 生成自定义二维码、条形码

常见用途

• 压缩图片减小体积（用于上传/发送）
• 裁剪图片保留需要的部分
• 旋转/翻转图片调整方向
• JPG转PNG（或反过来）
• 给图片加水印（防盗用）
• 一次性处理几十张照片
• 生成网址/文本的二维码
• 调整图片尺寸（等比缩放）

前置条件

使用前请确保：

1. ✅ 首次使用需安装依赖: 运行安装脚本 python3 scripts/install_deps.py（自动完成，约1分钟）
2. ✅ 确认Python环境: python3 --version（Python 3.8+）
3. ✅ 确保技能目录有写权限

📁 路径与入口

• 技能目录: {baseDir}/image-processing-expert/
• 统一入口: python3 scripts/main.py [功能] [参数]
• 依赖安装: python3 scripts/install_deps.py
• 输出目录: {技能目录}/output/（默认输出位置，可通过参数修改）

🔧 执行规范

详细的操作流程、调用规范、错误处理等，请参考以下文档：

使用指南

该文档定义：

• 各功能模块的标准调用格式
• 对话式自然语言参数解析
• 错误处理和友好提示机制
• 批量处理的最佳实践

📋 输出产物

严格按照执行规范执行完成后生成：

• 处理后的图片文件（位于输出目录）
• 处理摘要与统计信息（命令行输出）
• 可选：二维码图片文件

💡 快捷命令速查

依赖安装（首次使用）

7w4.net小葱技能站收录全网优质技能，值得收藏。

python3 scripts/install_deps.py

图片压缩

python3 scripts/main.py compress \
  --input photo.jpg \
  --quality 80 \
  --output compressed_photo.jpg

图片裁剪

python3 scripts/main.py crop \
  --input photo.jpg \
  --rect "100,100,500,500" \
  --output cropped.jpg

图片旋转

python3 scripts/main.py rotate \
  --input photo.jpg \
  --angle 90 \
  --output rotated.jpg

格式转换

python3 scripts/main.py convert \
  --input photo.jpg \
  --format png \
  --output photo.png

加水印

python3 scripts/main.py watermark \
  --input photo.jpg \
  --text "版权所有" \
  --output watermarked.jpg

调整尺寸

python3 scripts/main.py resize \
  --input photo.jpg \
  --size "800x600" \
  --output resized.jpg

生成二维码

python3 scripts/main.py qrcode \
  --text "https://example.com" \
  --output qrcode.png

批量处理

python3 scripts/main.py batch \
  --input-dir ./photos \
  --operation compress \
  --quality 75 \
  --output-dir ./compressed_photos

🗣️ 口语化触发词

当用户提到以下任何说法时，请立即使用本技能：

压缩类

• "帮我压缩图片"
• "照片太大了，缩小一下"
• "压缩照片到XX KB"
• "减小图片体积"

尺寸与裁剪类

• "裁剪这张图片"
• "把图片裁成正方形"
• "修改图片大小"
• "调整照片尺寸"
• "把图片缩放一下"
• "等比缩放图片"

旋转与翻转类

• "旋转图片"
• "把照片转正"
• "翻转图片"
• "镜像图片"

格式转换类

• "把JPG转成PNG"
• "图片转格式"
• "PNG转JPG"
• "把照片转成WebP"
• "批量转换图片格式"

水印类

• "给图片加水印"
• "在图片上写字"
• "加文字水印"
• "加图片水印"

批量处理类

• "批量处理这些图片"
• "一次性压缩所有照片"
• "把文件夹里的图片都转换格式"

二维码类

• "帮我生成二维码"
• "把网址转成二维码"
• "生成条形码"

🚨 重要限制（明令禁止）

• 禁止依赖外部API: 所有处理必须纯本地完成，不上传用户文件到云端
• 禁止改变源文件: 所有操作必须生成新文件，绝不能修改原始图片
• 禁止跳过依赖安装: 首次使用必须先安装依赖，不可强行执行
• 禁止技术错误输出: 错误信息必须翻译为用户可理解的语言
  • ❌ 错误: UnidentifiedImageError: cannot identify image file
  • ✅ 正确: "这个文件格式损坏或不受支持，请换一个图片试试"
  • ❌ 错误: OSError: cannot write mode RGBA as JPEG
  • ✅ 正确: "这种格式不支持透明通道，已自动去除透明背景后保存"

📚 参考文档

完整操作指南请参考以下文档：

• 使用指南 - 完整功能列表与调用示例
• 错误处理 - 常见问题与友好提示模板
• 依赖说明 - 依赖库说明与手动安装指南

这个技能功能很全面，能处理图片压缩、裁剪、加水印、生成二维码等常见需求。文档写得很清楚，普通用户也能看懂怎么用，错误提示也够友好。但缺少测试覆盖，字体加载在某些电脑上可能出问题。总体来说是个好用的工具，不过建议作者补上测试和完善跨平台适配。