用途:作为项目中图像处理的总协调入口,负责在向页面添加图片时统筹格式优化、响应式标记与校验,具体模式交由子技能处理。
主要能力:写入 JPEG 或 PNG 时,PostToolUse 钩子自动用 Sharp 生成 .webp 与 .avif 变体,并报告结果;写入 HTML 时钩子检查图片是否缺少 loading、decoding、alt、width/height 属性。跳过已是 srcset 变体(匹配 -\d+)、已有 .webp 与 .avif 同源文件及非源格式的文件。
使用方式:将源图放入目录后由钩子生成现代格式,再用 <picture> 写 HTML。手动命令示例:node scripts/quality/optimize-images.js src/images;加 --sizes 生成 400w、800w、1200w 变体;--dry-run 预览;node scripts/quality/image-check.js src/images 校验尺寸;node scripts/quality/image-html-check.js src/**/*.html 校验标记。命名规范:源 name.jpg/png,格式变体 name.webp/avif,尺寸变体 name-{width}.{format}。
格式建议:AVIF 质量 65、WebP 82、JPEG/PNG 85,回退顺序 AVIF > WebP > JPEG/PNG。srcset 宽度按场景选择(Hero 800/1200/1920,内容 400/800/1200 等)。
限制:依赖 Sharp;不处理已为 WebP/AVIF/GIF/SVG 的文件;具体 srcset/sizes 模式、占位图生成与 LCP 优化需参考相关子技能。缺失信息暂未提供。