WordPress 媒体文件本地诊断
减小媒体文件，同时保留读者需要的细节
Devenia Speed Optimization 帮您找出大型图片和视频，查看它们的使用位置，并将选定文件替换为更小的版本。插件全部功能免费，在您自己的 WordPress 安装中运行。
最小的预览图，不能决定原文件的尺寸
同一张商品照片可能既用于小卡片，也用于放大的细节视图。如果只按卡片大小缩小原图，放大后的画面就可能模糊。
请检查重要用途中的最大显示尺寸、浏览器实际下载的文件，以及屏幕的像素密度。对于宽 600 像素的显示区域，2 倍像素密度可能需要宽 1200 像素的图片，前提是原图有足够细节。
插图展示了同一张照片的两种显示大小。缩小图片尺寸和文件体积时，仍需让大图中的花纹保持清晰。
一个来源，两种用途：替换之后，小预览图和放大的细节视图都必须正常显示。
结合实际页面来判断文件
扫描会找出待检查的文件。请根据这些信息决定哪些值得处理，以及替换文件必须保留什么。
文件体积与图片尺寸
对比字节数、像素尺寸和已生成的图片规格。原图很大，并不意味着每位访客都会下载它；WordPress 可以提供更小的响应式图片。
附件在哪里使用
查看内容、区块和特色图片中的已发现引用。请亲自检查重要页面，包括放大视图。数据库中有引用，不等于文件实际可见或已加载。
测得的显示尺寸
页面测量由操作人员或集成提供；插件不会运行浏览器。请记录电脑和手机上的相关尺寸及像素密度，再逐一核对建议尺寸能否满足所有重要用途。
兼容的替换文件
提供体积更小、MIME 类型和扩展名相同的文件。替换图片不能增加像素尺寸，宽高比相对原图的偏差不能超过百分之一。将 JPEG 改为 WebP 需要采用其他媒体处理流程。
扫描、准备、替换，每次处理一个文件
扫描不会压缩媒体文件。请单独制作并检查较小的文件。管理页面提供扫描、设置、报告和恢复；登记及应用替换文件需调用 WordPress Abilities API。
1. 运行本地扫描
打开工具 → Speed Optimization，检查设置并选择 Run local scan。也可以运行
wp devenia-speed-optimization scan 执行相同扫描。2. 核对页面上的实际用途
先选一个重要页面，检查下载的图片、显示尺寸和放大视图。集成可以读取
speed-optimization/list-render-candidates，并通过 speed-optimization/record-render-measurements 保存测量结果。3. 制作较小的文件
用图片或视频工具单独制作替换文件。检查清晰度、比例，以及需要保留的透明效果或动画，然后将已检查的文件作为新附件上传到媒体库。
4. 登记并确认替换
先调用
speed-optimization/create-repair-job，再用原文件和替换文件的附件 ID 调用 speed-optimization/register-replacement。通过 speed-optimization/apply-replacement 并提供 confirm: APPLY_REPLACEMENT 执行替换。插件会再次检查文件，并在替换前创建本地备份。5. 检查结果
清理网站使用的缓存，在电脑和手机上打开受影响的页面。检查响应式图片和放大视图。如需恢复，可使用管理页面的备份操作，或调用
speed-optimization/restore-original 并提供 confirm: RESTORE_ORIGINAL。开始前，先了解适用范围
需要 WordPress 6.9 或更高版本，以及 PHP 7.4 或更高版本。扫描和所有 API 功能都要求网站管理权限。替换或恢复文件还需要上传文件和编辑该附件的权限。
文件必须在 WordPress 本地上传目录中可用，备份也会占用磁盘空间。卸载前请先恢复需要的文件：删除插件会清除设置和备份索引。
检查默认设置
新安装默认启用每日扫描，并在结果变化时发送邮件到 WordPress 管理员地址。让插件持续运行前，请检查这些选项。
默认扫描最新的 250 个附件，数量可调整为 25 至 5000。每份报告最多保留 100 个按优先级排列的候选文件。节省量和延迟数据只是估算，不是实测提速结果。
面向开发者与集成
插件在 speed-optimization/ 下提供 15 项功能，用于设置、扫描、报告、测量、修复任务、替换和备份。可用 speed-optimization/get-settings 读取当前配置。
附件和元数据由 WordPress 管理。同格式替换会保留目标附件及其文件 URL。缓存处理和视觉检查仍需按网站的正常工作流程完成。