媒体库优化插件

媒体库的两大难题，一次解决

WordPress 自带的媒体库只有"日期"这一个维度，图片一多就变成无限滚动的杂物堆；JPG / PNG 体积大，直接拖慢整站加载速度。

XT 媒体库优化插件把这两件事放进了同一个插件：

• 整理媒体：创建层级文件分类，上传时自动归类，媒体库内随时筛选、批量分配；
• 优化图片：JPG / JPEG / PNG 一键转换为 WebP 或 AVIF，支持上传自动转换、手动单张转换和后台批量转换任务。

转换由服务器本地的 GD 或 Imagick 完成——不上传到第三方，不消耗外部 API 额度，图片不出你的服务器。

它同时是一个轻量级插件：少量脚本和样式只在后台按需加载，前台页面不注入任何代码，后台也只在打开相关页面时才载入相关资源——装上它，你的网站前台和后台速度都不会因此变慢。

像整理文章一样整理图片

插件为媒体库引入了文件分类体系，支持创建多级层级分类——比如"产品图片"下面再分"主图"和"详情图"，一张图片还可以同时归入多个分类。

• 上传时选分类：上传图片时即可在下拉框中勾选分类，一步到位；
• 默认图片分类：设置默认分类后，没手动指定的上传图片自动归入；
• 批量归类：媒体库网格模式批量选中附件，勾选分类一键"应用"；
• 分类筛选：媒体库和选择媒体弹窗都支持按分类筛选，还能筛选"未分类"，杂图无处藏身。

小提示：分类只负责整理附件，不会搬移图片文件，放心使用。

WebP / AVIF 转换，规则你来定

进入转换设置，几项规则一目了然：是否在上传时自动转换、输出 WebP 还是 AVIF、质量值多少、原文件怎么处理。改完保存，之后的上传和手动转换都按这套规则执行。

• WebP 默认质量 80，AVIF 默认质量 60，均可在 1–100 之间调整；
• 同画质下 WebP 通常比 JPG 小 25%–35%，AVIF 压缩率更高——图片轻了，页面加载直接提速；
• 实际转换时先尝试 WordPress 图片编辑器，失败时自动尝试备用处理库，兼容性更稳；
• 插件不会虚报，日志会如实记录每张图的体积增减。

原文件的三种归宿：保留、替换、备份

转换后原来的 JPG / PNG 怎么办？插件提供三种策略，按需选择：

• 保留原文件：原图留在原位，转换文件另行生成，随时可对比、可回退，最稳妥；
• 替换原文件：转换成功后清理原图，附件直接使用新格式，沿用原附件 ID，链接不变；
• 备份原文件：原图移入专门的上传备份目录（wp-content/uploads/xt-media-optimizer-backup/），附件用新格式，原图也留着。

附件详情中会显示转换结果——格式、时间、体积变化一目了然；备份模式下还能直接点链接查看备份的原图。

选择"替换"前请务必备份媒体文件；想先观察效果，就从"保留"模式开始。

几百张图？交给后台批量任务

存量媒体库的转换不该靠人守着页面点。打开"批量转换"页面一键启动，插件自动扫描媒体库中尚未转换的 JPG / PNG，分批处理、逐张更新引用。

• 关掉页面也没关系：任务保存在服务器端，由 WP-Cron 接续执行，回来接着看进度；
• 随时暂停 / 继续 / 取消：任务节奏完全可控，取消也会优雅收尾，不留下半截数据；
• 设置快照机制：任务启动时锁定当时的规则，中途改设置不影响正在跑的任务；
• 已转换的自动跳过：不会对同一批图片反复重压缩。

优化了多少，数据说话

转换日志页面顶部直接给出三组核心统计：已优化图片数、累计体积减少量、整体缩小比例，涵盖上传、手动、批量三种来源，按附件去重，不做重复计算。

• 逐图日志（最近 300 条）：文件名、结果、来源、目标格式、体积变化、时间，一条不落；
• 任务日志（最近 100 条）：每个批量任务的总数、成功、失败与体积变化，最多保留 20 条错误提示方便排查；
• 如实呈现：个别图片转换后变大也会如实显示"增加"，绝不美化数据。

换图不断链，兼容性先替你把好关

页面图片引用更新：转换成功后，插件会分批更新数据库中可识别的文章内容与页面构建器数据里的图片链接，前台直接用上新格式，不用逐篇改文章。

环境检测：插件自带环境检测页，WordPress 版本、PHP 版本、GD / Imagick 扩展、WebP / AVIF 输出能力逐项列明，缺什么一目了然，不用瞎猜"为什么转不了"。

• WordPress 6.0+ / PHP 7.4+；
• 不依赖特定主题，任何主题都能用；
• 上传目录可读写、WP-Cron 正常运行即可工作。

给客户建站？界面可以"隐身"

如果是给客户交付的站点，插件的高级显示选项很实用：

• 可隐藏左侧"媒体库设置"菜单入口；
• 可让插件在"已安装插件"列表中隐身，功能照常运行；
• 可隐藏页头品牌 Logo 和右上角的文档按钮；
• 所有隐藏都是显示层面的设置，随时可通过访问高级选项页面地址恢复。

交付干净的后台界面，同时保留完整的媒体优化能力。