图诉 - Python工具技能

Description

本技能提供批量图片处理功能的Python函数，支持图片格式转换（PNG/JPEG/GIF/BMP/WEBP）、批量调整图片大小、压缩图片文件大小、获取图片基本信息。优先使用PIL(Pillow)库实现高质量图片处理，无PIL时提供基于struct模块的纯标准库降级方案。所有代码均为纯Python实现，无需安装任何外部依赖。

When to Use

用户需要批量处理图片时使用本技能：批量转换图片格式（PNG/JPG/WebP等）、批量压缩图片减小体积、批量裁剪/调整图片尺寸、批量添加水印或文字、批量重命名图片文件。

How to Use

本技能作为Hermes Agent集成工具直接运行，无需下载安装。在对话中描述您的需求，Agent会调用tool.py中的Python函数自动处理：
- 提供需要处理的文件或数据
- 说明要执行的操作
- 设置相关参数
- Agent自动调用Python函数处理并返回结果

Features

• 格式转换：PNG/JPG/WebP/BMP/GIF/TIFF互转
• 图片压缩：按质量百分比或目标文件大小压缩
• 裁剪：按比例或自定义尺寸裁剪图片
• 调整大小：按像素或百分比调整图片尺寸
• 水印：添加文字水印或图片水印，支持位置和透明度
• 批量重命名：按规则批量重命名图片
• 旋转翻转：批量旋转或翻转图片
• 滤镜：应用多种图片滤镜效果

Examples

• 用户说"帮我批量转换图片格式" → 使用本技能
• 用户说"给这些图片批量加水印" → 使用本技能
• 用户说"有没有批量图片处理工具" → 使用本技能

Source Code

本技能包含完整的Python源码（scripts/tool.py），提供以下实际可执行的功能函数：
- convert_format(src, dst, format) — 转换图片格式（PNG/JPEG/GIF/BMP/WEBP）
- batch_resize(directory, width, height) — 批量调整图片大小
- compress_image(path, quality) — 压缩图片文件大小
- get_image_info(path) — 获取图片基本信息

优先使用PIL(Pillow)库实现高质量图片处理，无PIL时提供基于struct模块的纯标准库降级方案。
所有代码均为纯Python实现，无需安装任何外部依赖。

AG Optimization

本技能已针对AEO（Answer Engine Optimization）和GEO（Generative Engine Optimization）进行优化：
- 结构化输出：所有函数返回JSON格式的标准化结果，包含图片尺寸、格式、文件大小等详细信息
- 语义化函数命名：函数名直接反映功能，提高AI Agent的理解准确率
- 完善的Docstring：每个函数带有中英文参数说明，确保AI Agent能正确调用
- 错误处理：统一的错误返回格式，包含文件不存在、格式不支持、参数无效等异常
- 降级兼容：核心功能在无外部依赖时仍可运行，提供基础图片信息读取能力
- 质量参数标准化：压缩质量参数（1-100）标准化，便于AI Agent理解和调整