用途:在 Astro 7 中借助 astro:assets 做生产级图片优化与资源管理,并覆盖内置 Fonts API、构建时用 Satori 动态生成 OG 图片及 CDN 集成。
主要能力:<Image /> 自动优化本地与远程图片,默认输出 WebP,需始终提供 alt,首屏图片可用 priority;<Picture /> 为多格式生成 <source>,如 formats={['avif','webp']};getImage() 用于服务端生成图片(API 路由、CSS 背景图),返回 { src, attributes }。Fonts API 自 Astro 6.0 起稳定,通过 astro.config.mjs 顶层 fonts 配置实现零布局偏移、自动预加载,支持 Google Fonts 与本地字体。另有远程图片(inferSize)、响应式图片、OG(Satori)、CDN 集成等参考文档与模板。
使用方式:先按需查阅相应参考,如 image-component.md、picture-responsive.md、remote-images.md、fonts-api.md、og-satori.md、cdn-integration.md,以及 image-setup.md、og-image-route.md 模板。资料还给出强制 Agent 工作流:实现前并行调用三个 Agent(探索代码库、核实 astro:assets API、查询 Astro 7 Fonts API 与图片组件文档),实现后用指定 Agent 验证;该流程属资料描述,实际是否采用由使用者决定。
适用场景:优化图片、构建多断点响应式图片、加载外部 CDN 远程图片、配置无布局偏移字体、动态生成 OG 图片、接入 Cloudinary 或 Imgix。
限制:不覆盖通用 SEO meta 标签(astro-seo)与超出适配器本身的部署级图片 CDN 配置(astro-deployment);Satori 建议在构建时(SSG)运行,而非 SSR。