mcpField
W
wordpress-ai-image-optimizer

wordpress-ai-image-optimizer

github.com/respira-press开发4987 次安装1 周前更新
代码仓库

关于 wordpress-ai-image-optimizer

wordpress-ai-image-optimizer 是用于审计和优化 WordPress 图片及其内容引用的技能。它在本地处理图片并保留原件,发布更改前需要审核。

主要功能

  1. 01审计图片用途、大小、格式和元数据
  2. 02压缩、转换格式、缩放并重命名图片
  3. 03生成替代文本和响应式图片尺寸
  4. 04在内容副本中更新图片引用
  5. 05创建快照并生成运行报告

适用场景

  1. 01审计 WordPress 媒体库并查找优化项
  2. 02缩小图片并转换为 WebP 或 AVIF
  3. 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:全面审查图片

  1. 扫描网站中的所有图片:
    • 媒体库(所有已上传的文件)
    • 内容图片(文章、页面、自定义文章类型)
    • 特色图片
    • 页面构建器图片(Elementor、Divi、Bricks 等)
    • WooCommerce 商品图片(如果已启用 WooCommerce)
  2. 分析每张图片(使用 respira_analyze_images 执行审查;它会在一次调用中返回每张图片的审查结果):
    • 文件大小和格式
    • 实际尺寸与显示尺寸
    • 替代文本是否存在及其质量
    • 文件名是否适合 SEO
    • 使用情况(哪些页面/文章使用了这张图片)
    • 响应式图片尺寸(srcset)
    • 懒加载实现情况
  3. 检测优化插件/CDN:
    • Smush、ShortPixel、EWWW、Imagify、Optimole
    • Cloudflare、BunnyCDN、其他 CDN
  4. 按影响程度为优化机会评分:
    • 文件大小 × 页面流量 = 优化优先级
    • 区分快速见效的优化和收益较大的优化
  5. 生成全面的报告

阶段 2:征求用户批准

展示报告并询问要执行哪些优化:

  • 压缩过大的图片
  • 将 JPG/PNG 转换为 WebP
  • 调整不必要地过大的原始图片尺寸
  • 重命名不利于 SEO 的文件
  • 添加缺失的替代文本
  • 重新生成响应式图片尺寸

用户可以选择:

  • “优化所有内容”(所有优化)
  • “仅压缩”(不更改格式)
  • “前 10 张图片”(优先处理影响最大的图片)
  • “仅首页图片”(优先处理关键页面)

阶段 3:AI 处理

  1. 进行任何写入操作前,使用 respira_get_snapshot 创建媒体库快照,以便通过一次操作(respira_restore_snapshot)还原整个批次。只需在批次开始前创建一次,无需为每张图片分别创建。
  2. 将图片从 WordPress 下载到本地工作区。
  3. 在本地处理图片:
    • 压缩
    • 格式转换
    • 调整尺寸
    • 重命名为适合 SEO 的文件名
    • 使用 AI 生成替代文本
    • 可选:如果图片质量较低,或与页面内容不符,可使用 respira_search_stock_images 查找替代图片,再通过 respira_sideload_image 将其导入,而不是重新优化原图
  4. 将优化后的版本上传回 WordPress:
    • 创建新的媒体条目(原始文件保持不变)
    • 使用 respira_update_media_batch 一次性应用元数据,而不是每张图片都单独调用一次 respira_update_media。批量操作最多可接受约 50 个项目,因此通常一次调用即可更新整个媒体库(替代文本、标题、说明文字、描述)。只有在进行单项修正时,才改用单独的 respira_update_media。
    • 将旧文件标记为“已弃用,由 [new-filename] 替代”
  5. 更新重复内容中的引用:
  • 创建受影响文章/页面的副本
  • 将旧图片 URL 替换为新的优化后图片 URL
  • 更新页面构建器和 WooCommerce 的图片引用
  1. 重新生成响应式图片尺寸和 srcset 支持

阶段 4:审核并发布

  1. 提供优化前后的对比:
  • 文件大小节省量
  • 格式变化
  • 尺寸变化
  • 文件名改进情况
  • 受影响的页面
  1. 用户在 WordPress 管理后台审核副本
  2. 用户批准发布
  3. 保留旧文件,以便安全回滚
  4. 使用 respira_generate_activity_report 生成本次运行摘要,让整个工作可通过一行记录进行审计(例如“已优化 47 张图片,节省 1.2GB,为 31 张图片添加了替代文本”)。该工具会读取 Respira 已记录的本批次变更日志。

诚实声明

此技能会下载图片,使用 AI 进行处理,并上传优化后的版本。发布前,您可以审核所有更改。

此技能无法:

  • 保证质量完美(压缩会造成有损失)
  • 修复已损坏或破损的图片文件
  • 优化 CSS 背景图片
  • 处理托管在 WordPress 上传目录之外的外部图片
  • 改善构图或艺术指导(仅进行技术优化)

此技能可以:

  • 压缩图片,且不会造成明显的质量损失
  • 转换为 WebP,大幅减小文件体积
  • 将尺寸过大的原图调整为实用尺寸
  • 使用适合 SEO 的名称重命名文件
  • 生成描述性替代文本
  • 自动更新重复内容中的引用
  • 保留原图,以便安全回滚

安全模型

  • 非破坏性:创建新的优化图片并保留旧文件
  • 优先处理副本:在副本中更新内容,绝不修改线上页面
  • 需要用户批准:发布前先审核
  • 可随时回滚:保留旧文件,支持还原
  • 未经明确批准,不会影响线上网站

技术详情

使用以下 Respira MCP 工具:

审计:

  • respira_analyze_images(通过一次调用驱动第 1 阶段审计,并提供每张图片的分析结果)

媒体操作:

  • respira_list_media
  • respira_get_media
  • respira_upload_media
  • respira_update_media_batch(主要元数据写入工具——每次调用最多处理约 50 项)
  • respira_update_media(单项备用方案/一次性更正)
  • respira_delete_media(可选清理)

图库替换(可选):

  • respira_search_stock_images
  • respira_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_pages
  • respira_list_posts
  • respira_read_page
  • respira_read_post
  • respira_get_builder_info

内容更新:

  • respira_create_page_duplicate
  • respira_create_post_duplicate
  • respira_update_page
  • respira_update_post

WooCommerce(可选):

  • woocommerce_list_products
  • woocommerce_get_product
  • woocommerce_update_product

插件检测:

  • respira_list_plugins

相关技能

  • SEO 与 AEO 增效器
  • WordPress 网站 DNA
  • 移动体验报告

由 Respira Team 构建 https://respira.press/skills/wordpress-ai-image-optimizer

评论

支持 Markdown