• ## 功能

1. 批量转换：将 image/catalog/ 等目录下的 JPG、JPEG、PNG、GIF、BMP 图片批量转换为 WebP 格式
2. 自动缩略图替换：通过 service.image.resize 钩子，在前端请求缩略图时自动生成对应尺寸的 WebP 缩略图（如 1-500x500.webp），每个尺寸独立缓存
3. 质量调节：支持 1-100 压缩质量设置，Imagick 和 GD 双引擎均生效
4. 目录选择：自动扫描全站可转换图片目录，支持下拉选择或手动输入自定义路径
5. 转换统计：显示图片总数、已转换数、待转换数、原图总大小
6. 转换结果详情：列出每个文件的成功 / 已存在 / 失败状态，成功文件显示原大小→WebP 大小及节省比例
7. 损坏文件自动修复：已存在的损坏 WebP 文件会被自动删除并重新转换
8. 一键清除：可批量删除指定目录下所有生成的 WebP 文件

使用方法

第一步：安装插件

第二步：转换图片

1. 后台侧栏进入「WebP 图片转换」
2. 选择目标目录（默认 image/catalog）
3. 设置压缩质量（推荐 75-85）
4. 勾选需要转换的格式（JPG/PNG/GIF/BMP）
5. 点击「开始转换」
6. 查看转换结果列表，确认失败文件

第三步：启用前端替换

• 勾选「启用 WebP 输出」并保存设置
• 前端页面会自动使用 WebP 格式缩略图

重新转换

• 勾选「覆盖已有 WebP」可强制重新转换已有文件
• 修改质量参数后需勾选此项才生效

注意事项

1. 原图永不删除：插件始终保留原图。ImageService 的缩略图管线依赖原图存在，删除原图会导致所有图片回退为占位图。已移除 "保留原图" 开关，避免误操作。
2. 转换失败自动回退：单张图片转换失败时，自动清理残留 WebP 文件，原图不受影响。前端钩子生成 WebP 缩略图失败时，自动回退到原始 JPG 缩略图，图片正常展示。
3. PHP 扩展要求：需要安装 Imagick 或 GD 扩展（至少一个）。Imagick 优先使用，质量参数通过 webp:quality 选项设置确保生效。
4. 缓存目录会增长：每个尺寸的 WebP 缩略图会缓存在 public/cache/ 下。如需清理，可在后台点击「清除 WebP」按钮删除生成的 WebP 文件。
5. .webp 和 .gif 不参与转换：BeikeShop 的 image_resize() 函数对 .gif 和 .webp 后缀直接返回原图，不走缩略图管线，因此 GIF 动图不受影响。
6. 修改质量后需重新转换：已转换的 WebP 文件会被跳过。修改质量参数后，需勾选「覆盖已有 WebP」再重新转换。
7. 浏览器兼容性：WebP 格式被所有现代浏览器支持（Chrome、Edge、Firefox、Safari 14+）。不支持 WebP 的旧浏览器将正常加载原始 JPG/PNG 图片。