用途：当链接在社交与聊天平台出现无预览、图片破损、尺寸裁切或内容陈旧时使用；也用于审查 Web 应用中的 Open Graph、Twitter/X card、图片 URL、alt 文本与 metadataBase 覆盖率；适合上线前确保每个公开页面都能在各平台呈现可预期的富预览。
主要能力：说明预览失效的常见根因（缺少 og:title/og:description/og:image、图片为相对 URL、尺寸非 1200×630、Twitter card 类型缺失或误用 summary、平台缓存旧元数据、标签由客户端 JS 注入而爬虫不执行 JS）。提供 Next.js App Router 的 buildSocialMetadata 辅助函数，根据标题、描述、路径、图片、alt 与宽高生成包含 canonical、openGraph（含 secureUrl、width、height、alt、type）与 twitter（card 为 summary_large_image）的元数据；并给出静态页面、动态页面与根布局（设置 metadataBase）的用法。附 OG 图片检查清单（1200×630、Facebook 上限 8MB、HTTPS、文件名不含空格、JPEG/PNG、GET 无需鉴权）及平台差异说明（Facebook 与 LinkedIn 缓存激进，LinkedIn 忽略 twitter: 标签，Twitter 需绝对图片 URL，WhatsApp/Telegram 首次分享读 OG 且缓存数小时，Slack/Discord 均用 OG 且缓存）。
使用方式：部署后可用 curl 抓取原始 HTML 检查 og:/twitter: 标签是否可见；用平台调试工具验证（Facebook Sharing Debugger、LinkedIn Post Inspector、Twitter/X Card Validator、metatags.io）；再在调试器中点击重新抓取以刷新缓存。核对清单包括 metadataBase、统一辅助函数、绝对图片 URL、secureUrl 等于 url、图片规格、twitter:card 为 summary_large_image、alt 文本、标签存在于原始 HTML、各平台预览正确、缓存已刷新。
限制：无法强制所有社交平台立即刷新缓存，修复正确后个别预览可能仍陈旧；平台调试器验证需可公网访问的已部署 URL；不替代对图片文字、alt 文本与预览文案的品牌、无障碍或法律审查。环境变量与域名需按实际替换，具体安装命令资料未提供。