For AI agents: a documentation index is available at /llms.txt. Markdown versions of these pages are available by appending `.md` to the URL or by sending `Accept: text/markdown`.
博客
OGKit 团队撰写的 Open Graph 与社交预览工程笔记。
社交爬虫 User-Agent 真相表：按 UA 分叉内容的代价
facebookexternalhit、LinkedInBot、Twitterbot 等几乎都不执行 JS。这里给出可引用的 UA 表（来源与核实日期），以及何时该（不该）为机器人单独返回 HTML。
动态 OG 图：Next / Satori 与体积坑
每篇博客、每个文档页都要不同分享图时，怎么在代码路径（Next opengraph-image / Satori）和模板 SaaS 之间选型，以及字体、中文 subset、emoji 与字节预算的实战坑。
改了 Open Graph 为什么还是旧图
og:image 已换、页面浏览器里看着对，Facebook / LinkedIn / IM 却仍是上周活动图。各平台独立缓存、TTL 与官方 rescrape 路径——没有「一键清全世界」的魔法按钮。
2026 Open Graph 优化清单：发版前后与季度工程 + OGKit 用法
可打印的 OG 清单：发布前 15 分钟、发版后 rescrape、季度 CI/图预算/平台基线——标签、图片、平台、SPA、私有环境全覆盖，并对照 OGKit 各端该用哪一层。
把 OG 装进 CI：防回归门禁
视觉 QA 抓不到「改版把 og:image 弄丢了两周」这类事故。用稳定规则 id、退出码和 baseline，把 Open Graph 检查做成和 ESLint 一样的 PR 门禁。
OG 图片工程：尺寸、体积、格式、重定向
1200×630 只是入门。分享卡片更常死在字节预算、Content-Type 不一致、重定向链和鉴权图床——IM 客户端尤其如此。
Open Graph 工具怎么选：官方 debugger / 预览站 / 生成器
官方 debugger 清缓存不可替代；聚合预览适合日常 QA；生成器适合静态落地页。按任务选工具，别被「OG checker」广告轰炸带偏。
为什么 opengraph.xyz 预览不了你的 localhost（以及正确做法）
在线 OG 工具永远够不到 localhost、VPN 后的 staging 和登录墙页面。公网扫描器必须拒绝私有网段以防 SSRF；私有预览应落在权限最小化的浏览器扩展里——而不是临时打洞或把 cookie 贴给第三方。
你必须写对的 OG / Twitter meta 标签
可复制的最小集：og:title、og:type、og:url、og:image，以及 description、site_name 与 twitter:card——外加每周仍在上线的典型翻车方式。
同一份 OG 标签，八种卡片：Facebook、LinkedIn、X 等平台的预览差异与截断规则
为什么设计稿里的分享卡片一到 Facebook、LinkedIn、X、WhatsApp 就变形？逐平台拆解字段采信、标题截断、图片裁切与官方调试入口，每个数字都标来源。
SPA 爬虫抓不到 Open Graph：SSR 与预渲染
DevTools 里明明有 og:title，Slack 却只有裸链接。社交爬虫大多不跑 JS——如何复现、框架能做什么、扫描报告该怎么诚实表述。
Open Graph 到底在解决什么
OG 不是「再写一遍 title」。它决定链接在 Slack、LinkedIn、X、Discord、WhatsApp 里展开时的卡片长什么样——而且上线之后的维护才刚开始。
为什么你的 Open Graph 卡片一片空白
分享卡片空白，几乎从来不只是缺少 og:image 标签。这里列出最常见的五种原因，以及如何在一分钟内分辨它们。