技能介绍

解决什么

处理图片素材时，常见的麻烦是尺寸不统一、格式混杂、压缩策略各不一致。手工写脚本逐个处理不仅耗时，也难把缩放、加水印、格式转换、压缩等步骤稳定串联。这个技能将常见图片操作封装为 Python 函数，借助 ImageMagick 完成本地转换，并通过 TinyPNG API 进行压缩，让批量处理可以脚本化、可复现。

如何工作

核心代码位于 scripts/image_server.py，既可作为 Python 模块导入，也可命令行调用。依赖 ImageMagick；压缩依赖 TinyPNG，通过 TINIFY_KEY 或 TINIFY_CONFIG_PATH 配置（前者优先级更高）；水印中文字体通过 FONT_PATH 指定。

关键能力：

get_images_from_dir(dir) 列出目录内图片，便于批量遍历。
get_image_information(path) 返回宽高、格式、大小。
resize_image(path, width) 按宽度缩放，高度等比计算。
format_convert(path, format) 转换格式。
compress(path) 调用 TinyPNG 压缩。
concatenate_images(inputs, direction, bg_color, spacing) 横/纵拼接，可设背景与间距。
add_watermark(path, text, pos_x, pos_y, color, fontsize) 添加文字水印。
generate_gif(inputs, frame_delay) 由序列生成动图。
generate_pdf(inputs) 合并为 PDF。

所有函数返回处理后文件路径，可作为后续输入链式调用。常见工作流：先 resize_image 到目标宽度，再 add_watermark 得到分享图；用 get_images_from_dir 列出后逐个 format_convert 再 compress；统一宽度后 generate_pdf 生成演示文档；或按目录顺序 generate_gif 出图。

边界与注意

add_watermark 的 pos_x、pos_y 为相对值（0.0–1.0），不是绝对像素。
水印中文需设置 FONT_PATH 指向中文字体，否则可能缺字。
compress 需配置 TINIFY_KEY（推荐）或 TINIFY_CONFIG_PATH，否则无法调用 API。
generate_gif、generate_pdf 可接收目录或文件列表；concatenate_images 传入目录时按文件名排序，命名直接影响顺序。
resize_image 只需提供宽度，高度自动等比，适合保留比例的场景。