thumbnail-generator 是一个 Python 缩略图生成工具，主要用于把原始图片批量或单张转换为适配网页、社交媒体、应用图标等用途的缩略图，并提供裁剪、尺寸、格式与质量控制。
主要能力：支持智能裁剪（居中、边缘检测、人脸感知等描述性选项）与多种裁剪位置；可一次生成多个尺寸；内置网页、社交媒体、应用图标、favicon 等预设；支持处理整个文件夹的批量操作；可控制质量与输出 JPEG、PNG、WebP 格式；提供 Python 类 API 与命令行两种调用方式。
使用方式：可通过 ThumbnailGenerator 类加载图片后调用 resize、crop_smart、generate_sizes、process_folder、apply_preset、save 等方法；命令行示例包括 python thumbnail_gen.py --input photo.jpg --size 200x200 --output thumb.jpg，以及 python thumbnail_gen.py --input ./photos/ --size 200x200 --output ./thumbs/ 等。依赖为 pillow>=10.0.0 与 numpy>=1.24.0。
限制：资料未提供安装方式、授权、收费、性能基准、人脸检测依赖细节与实际效果说明，相关事实暂未提供。