用途:这是一套面向部署到 Cloudflare Pages/Workers 的 Nuxt 4 应用的 SEO 优化准则,共 11 条规则、4 个类别,按影响优先级排列,用于指导自动化重构与代码生成。资料提到 Nuxt 4.5 的 head 管理改用 unhead v3,useHead 类型更严格(升级后的类型错误通常是收紧所致),且不再支持 promise 输入;示例均使用普通同步值以兼容 v3。
主要能力按优先级分四类: 1)OG 图片生成(CRITICAL,前缀 og-):在 Cloudflare Workers 上用 @cf-wasm/og 生成动态 OG 图;Satori 元素用普通 JS 对象、绝不用 React;为 CDN 设置 immutable 缓存头;OG 图须用 CORP 跨域,否则社交卡片会静默失效。 2)页面 SEO 与 Meta(HIGH,前缀 meta-):可复用的页面级 SEO composable;正确的 Open Graph 与 Twitter Card 标签;每页的 canonical URL 与 og:url。 3)结构化数据(MEDIUM,前缀 schema-):在 app.vue 中使用 JSON-LD,用于 Google Rich Results。 4)Cloudflare 与 Nitro 配置(HIGH,前缀 cf-):固定 compatibilityDate,绝不用 latest;CF Pages 的 Nitro 配置(nodeCompat、process.stdout、WASM);仅客户端库的 SSR external 配置;Cloudflare Workers 的 WASM 模块配置。
使用方式:在生成 CF Workers 动态 OG 图、设置页面级 SEO meta 与 composable、添加 JSON-LD、为 CF Pages 配置 Nitro、处理不兼容 SSR 的仅客户端库、设置社交分享 meta、使用 Satori 时参考。规则文件位于 rules/og-cf-workers.md、rules/meta-use-page-seo.md、rules/_sections.md 等,完整编译文档见 AGENTS.md;每条规则含原因说明、错误示例、正确示例及 Nuxt/Cloudflare 专有说明。
限制:资料未提供安装命令、依赖版本、价格及具体代码示例细节。