关于 wordpress-ai-image-optimizer
wordpress-ai-image-optimizer 是用于审计和优化 WordPress 图片及其内容引用的技能。它在本地处理图片并保留原件,发布更改前需要审核。
主要功能
- 01审计图片用途、大小、格式和元数据
- 02压缩、转换格式、缩放并重命名图片
- 03生成替代文本和响应式图片尺寸
- 04在内容副本中更新图片引用
- 05创建快照并生成运行报告
适用场景
- 01审计 WordPress 媒体库并查找优化项
- 02缩小图片并转换为 WebP 或 AVIF
- 03改善文件名、替代文本和响应式图片支持
MCP 相关
通过 Respira MCP 工具审计 WordPress 图片、管理媒体与内容、创建快照、恢复更改并生成报告。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ respira-press/ agent-skills-wordpress --skill wordpress-ai-image-optimizer安装后在 Claude Code 中输入/wordpress-ai-image-optimizer确认已加载。
详细介绍
WordPress AI 图像优化器
版本: 1.2.1
更新日期: 2026-06-30
最新更新: v1.2.0 将逐张调用 respira_update_media 的循环替换为单次 respira_update_media_batch 批量处理(每次最多约 50 项),在批量处理前通过 respira_get_snapshot 为媒体库创建快照,确保整个运行过程可一步撤销;通过 respira_analyze_images 执行审计;通过 respira_search_stock_images + respira_sideload_image 提供可选的图库图片替换方案;最后通过 respira_generate_activity_report 生成摘要(例如“优化了 47 张图片,节省 1.2GB”)。
为 WordPress 网站提供 AI 驱动的图像优化。自动压缩图像、转换格式、重命名文件并更新所有引用。在 AI 代码编辑器中本地处理图像,生成优化版本,并保留原始文件以确保安全。
此技能的功能
扫描:
- 媒体库中的所有图像
- 文章和页面内容中的图像
- 特色图像
- 页面构建器元素中的图像(Elementor、Divi、Bricks 等)
- WooCommerce 产品图像
- 自定义文章类型中的图像
检测:
- 文件大小(磁盘上实际占用的 KB/MB)
- 图像尺寸(宽 x 高,单位为像素)
- 格式(JPG、PNG、GIF、WebP、AVIF、SVG)
- HTML 中是否设置了 width/height 属性
- 是否存在替代文本(以及质量)
- 图像是否正在使用(是否为孤立媒体)
- 是否存在响应式图像尺寸(WordPress srcset)
- 压缩质量(根据文件大小估算)
- 延迟加载的实现方式
- 不利于 SEO 的文件名(IMG_1234.jpg、screenshot.png 等)
- 原始图像过大(上传了 5000px,但最大只需要 2000px)
- 内容图像缺少 srcset
- 绕过 WordPress 响应式系统的页面构建器图像
通过 AI 代码编辑器进行优化:
- 从 WordPress 下载图像
- 使用最佳质量设置压缩(JPG 为 80-85%,PNG 无损)
- 转换为现代格式(优先使用 WebP,适当时使用 AVIF)
- 将过大的原始图像调整为最佳尺寸
- 使用利于 SEO 的描述性文件名重命名
- 使用 AI 生成缺失的替代文本
- 重新生成 WordPress 响应式图像尺寸
- 将优化后的版本上传回 WordPress
- 创建新的媒体条目(保留旧文件以确保安全)
- 更新重复内容中的所有引用
提供:
- 全面的图像健康评分(0-100)
- 按影响优先级排列的优化机会
- 优化前后的文件大小对比
- 预计的页面速度提升
- 插件/CDN 检测与建议
要求
- 已安装并连接 Respira for WordPress 插件
- MCP 连接处于活动状态(桌面端或 WebMCP)
- 配备图像处理工具的 AI 代码编辑器(Claude Code、Cursor 等)
- WooCommerce 扩展(可选——用于优化产品图像)
- 读取权限(用于扫描图像),写入权限(用于上传优化后的版本)
使用方法
触发语句
“用 AI 优化我的 WordPress 图像”
其他触发语句
- “运行 AI 图像优化”
- “压缩并优化所有图像”
- “审计我的媒体库”
- “提升图像性能”
执行流程
阶段 1:全面审查图片
- 扫描网站中的所有图片:
- 媒体库(所有已上传的文件)
- 内容图片(文章、页面、自定义文章类型)
- 特色图片
- 页面构建器图片(Elementor、Divi、Bricks 等)
- WooCommerce 商品图片(如果已启用 WooCommerce)
- 分析每张图片(使用
respira_analyze_images执行审查;它会在一次调用中返回每张图片的审查结果):- 文件大小和格式
- 实际尺寸与显示尺寸
- 替代文本是否存在及其质量
- 文件名是否适合 SEO
- 使用情况(哪些页面/文章使用了这张图片)
- 响应式图片尺寸(srcset)
- 懒加载实现情况
- 检测优化插件/CDN:
- Smush、ShortPixel、EWWW、Imagify、Optimole
- Cloudflare、BunnyCDN、其他 CDN
- 按影响程度为优化机会评分:
- 文件大小 × 页面流量 = 优化优先级
- 区分快速见效的优化和收益较大的优化
- 生成全面的报告
阶段 2:征求用户批准
展示报告并询问要执行哪些优化:
- 压缩过大的图片
- 将 JPG/PNG 转换为 WebP
- 调整不必要地过大的原始图片尺寸
- 重命名不利于 SEO 的文件
- 添加缺失的替代文本
- 重新生成响应式图片尺寸
用户可以选择:
- “优化所有内容”(所有优化)
- “仅压缩”(不更改格式)
- “前 10 张图片”(优先处理影响最大的图片)
- “仅首页图片”(优先处理关键页面)
阶段 3:AI 处理
- 进行任何写入操作前,使用
respira_get_snapshot创建媒体库快照,以便通过一次操作(respira_restore_snapshot)还原整个批次。只需在批次开始前创建一次,无需为每张图片分别创建。 - 将图片从 WordPress 下载到本地工作区。
- 在本地处理图片:
- 压缩
- 格式转换
- 调整尺寸
- 重命名为适合 SEO 的文件名
- 使用 AI 生成替代文本
- 可选:如果图片质量较低,或与页面内容不符,可使用
respira_search_stock_images查找替代图片,再通过respira_sideload_image将其导入,而不是重新优化原图
- 将优化后的版本上传回 WordPress:
- 创建新的媒体条目(原始文件保持不变)
- 使用
respira_update_media_batch一次性应用元数据,而不是每张图片都单独调用一次respira_update_media。批量操作最多可接受约 50 个项目,因此通常一次调用即可更新整个媒体库(替代文本、标题、说明文字、描述)。只有在进行单项修正时,才改用单独的respira_update_media。 - 将旧文件标记为“已弃用,由 [new-filename] 替代”
- 更新重复内容中的引用:
- 创建受影响文章/页面的副本
- 将旧图片 URL 替换为新的优化后图片 URL
- 更新页面构建器和 WooCommerce 的图片引用
- 重新生成响应式图片尺寸和 srcset 支持
阶段 4:审核并发布
- 提供优化前后的对比:
- 文件大小节省量
- 格式变化
- 尺寸变化
- 文件名改进情况
- 受影响的页面
- 用户在 WordPress 管理后台审核副本
- 用户批准发布
- 保留旧文件,以便安全回滚
- 使用
respira_generate_activity_report生成本次运行摘要,让整个工作可通过一行记录进行审计(例如“已优化 47 张图片,节省 1.2GB,为 31 张图片添加了替代文本”)。该工具会读取 Respira 已记录的本批次变更日志。
诚实声明
此技能会下载图片,使用 AI 进行处理,并上传优化后的版本。发布前,您可以审核所有更改。
此技能无法:
- 保证质量完美(压缩会造成有损失)
- 修复已损坏或破损的图片文件
- 优化 CSS 背景图片
- 处理托管在 WordPress 上传目录之外的外部图片
- 改善构图或艺术指导(仅进行技术优化)
此技能可以:
- 压缩图片,且不会造成明显的质量损失
- 转换为 WebP,大幅减小文件体积
- 将尺寸过大的原图调整为实用尺寸
- 使用适合 SEO 的名称重命名文件
- 生成描述性替代文本
- 自动更新重复内容中的引用
- 保留原图,以便安全回滚
安全模型
- 非破坏性:创建新的优化图片并保留旧文件
- 优先处理副本:在副本中更新内容,绝不修改线上页面
- 需要用户批准:发布前先审核
- 可随时回滚:保留旧文件,支持还原
- 未经明确批准,不会影响线上网站
技术详情
使用以下 Respira MCP 工具:
审计:
respira_analyze_images(通过一次调用驱动第 1 阶段审计,并提供每张图片的分析结果)
媒体操作:
respira_list_mediarespira_get_mediarespira_upload_mediarespira_update_media_batch(主要元数据写入工具——每次调用最多处理约 50 项)respira_update_media(单项备用方案/一次性更正)respira_delete_media(可选清理)
图库替换(可选):
respira_search_stock_imagesrespira_sideload_image
快照与回滚:
respira_get_snapshot(批量操作前创建快照)respira_restore_snapshot(一步还原)
报告:
respira_generate_activity_report(运行摘要:已优化的图片数量、节省的空间、添加的替代文本;9.0 及更高版本的插件会将其列为工具;旧版插件请调用respira_invoke_ability,并在args下传入相同参数,同时设置ability: "respira/generate-activity-report")
内容扫描:
respira_list_pagesrespira_list_postsrespira_read_pagerespira_read_postrespira_get_builder_info
内容更新:
respira_create_page_duplicaterespira_create_post_duplicaterespira_update_pagerespira_update_post
WooCommerce(可选):
woocommerce_list_productswoocommerce_get_productwoocommerce_update_product
插件检测:
respira_list_plugins
相关技能
- SEO 与 AEO 增效器
- WordPress 网站 DNA
- 移动体验报告
由 Respira Team 构建 https://respira.press/skills/wordpress-ai-image-optimizer