⚡

NuxtSEO完整指南 nuxt-seo

这是一个全面的Nuxt SEO技能指南，用于优化Nuxt.js应用的搜索引擎优化。它涵盖了所有8个核心SEO模块和3个Pro模块的安装、配置、集成和最佳实践，帮助开发者实现robots.txt、sitemap.xml、Open Graph图像、Schema.org结构化数据等功能。关键词：Nuxt SEO, SEO优化, 前端开发, Vue.js, 搜索引擎优化, robots.txt, sitemap.xml, Open Graph, Schema.org。

前端开发 3 次安装 11 次浏览 更新于 3/7/2026

name: nuxt-seo description: | 综合指南，涵盖所有8个Nuxt SEO模块加上Pro模块：@nuxtjs/seo, nuxt-robots, nuxt-sitemap, nuxt-og-image, nuxt-schema-org, nuxt-link-checker, nuxt-seo-utils, nuxt-site-config, 和Pro模块（AI Ready, Skew Protection, SEO Pro MCP）。用于构建SEO优化的Nuxt应用，实现robots.txt和sitemaps，生成Open Graph图像，添加Schema.org结构化数据，管理元标签，检查链接，配置站点范围的SEO设置，或实现高级SEO功能，如渲染模式、规范URL、Twitter Cards和IndexNow。

关键词：nuxt-seo, nuxt, seo, nuxt 3, nuxt 4, nuxt seo, vue, vue 3, 搜索引擎优化, @nuxtjs/seo, nuxt-robots, nuxt-sitemap, nuxt-og-image, nuxt-schema-org, nuxt-link-checker, nuxt-seo-utils, nuxt-site-config, robots.txt, sitemap, sitemap.xml, og image, open graph, 社交分享, meta tags, schema.org, 结构化数据, json-ld, 规范urls, breadcrumbs, bot detection, crawling, indexing, noindex, nofollow, xml sitemap, multiple sitemaps, sitemap index, dynamic sitemap, og image generation, satori, chromium rendering, vue templates, seo setup, seo configuration, meta management, social media preview, search optimization, link checking, broken links, site config, multi-language seo, i18n seo, sitemap not generated, robots.txt missing, og image not rendering, schema validation errors, duplicate meta tags, canonical url issues, sitemap index errors, twitter cards, indexnow, ssr, ssg, isr, rendering modes, rich results, useSeoMeta, useSchemaOrg, defineOgImage, url structure, meta robots, ai ready, llms.txt, skew protection, i18n multilanguage, hreflang, _i18nTransform, _sitemap, route rules, routeRules, enhanced titles, title template, fallback title, link checker rules, prerendering spa, hydration mismatch, crawler protection, getBotDetection, useBotDetection, 404 page, seo-friendly 404, inspection rules, absolute-site-urls, link-text, missing-hash, no-error-response, defineSitemapEventHandler, nitro hooks, sitemap:input, sitemap:resolved, nuxt-og-image:context, asSeoCollection, asSitemapCollection, asSchemaOrgCollection, nuxt content v3, content collections, nuxt ai ready, mcp server, content signals, og image templates, multi-sitemaps, chunked sitemap, image sitemap, video sitemap, zero runtime license: MIT metadata: version: 2.2.0 last_updated: 2025-12-28 module_versions: nuxtjs_seo: 3.3.0 nuxt_robots: 5.6.7 nuxt_sitemap: 7.5.0 nuxt_og_image: 5.1.13 nuxt_schema_org: 5.0.10 nuxt_link_checker: 4.3.9 nuxt_seo_utils: 7.0.19 nuxt_site_config: 3.2.14 nuxt_compatibility: “>=3.0.0” auto_trigger_scenarios: - 设置Nuxt项目中的SEO - 配置robots.txt或sitemap - 生成Open Graph图像 - 添加Schema.org结构化数据 - 管理元标签和社交分享 - 检查和修复损坏链接 - 实现站点范围SEO配置 - 实现Twitter Cards或Open Graph - 设置规范URL - 配置渲染模式（SSR/SSG/ISR） - 使用IndexNow进行即时索引 - 使用JSON-LD实现丰富结果 - 设置多语言/i18n SEO - 配置SEO路由规则 - 调试水合不匹配 - 创建SEO友好的404页面 - 防止恶意爬虫

Nuxt SEO - 所有 8 个 SEO 模块 + Pro 功能的完整指南

状态：生产就绪 最后更新：2025-12-28 依赖项：Nuxt >=3.0.0 最新版本：见下方模块版本表

在构建SEO优化的Nuxt应用时，使用此技能，结合任何官方Nuxt SEO模块和高级Pro模块。此技能涵盖了由Harlan Wilton维护的完整Nuxt SEO生态系统，包括渲染模式、JSON-LD、Twitter Cards、IndexNow等的全面指南。

Nuxt SEO 生态系统概述

Nuxt SEO 包括 8 个核心模块 加 3 个 Pro 模块，它们无缝协作：

核心模块

模块 版本 用途
@nuxtjs/seo v3.3.0 主要SEO模块（作为捆绑包安装所有8个模块）
nuxt-robots v5.6.7 管理robots.txt和机器人检测
nuxt-sitemap v7.5.0 生成具有高级功能的XML站点地图
nuxt-og-image v5.1.13 通过Vue模板创建Open Graph图像
nuxt-schema-org v5.0.10 构建Schema.org结构化数据图
nuxt-link-checker v4.3.9 查找和修复损坏链接
nuxt-seo-utils v7.0.19 SEO实用程序，用于可发现性和可分享性
nuxt-site-config v3.2.14 集中站点配置管理

Pro 模块

模块 用途
nuxt-ai-ready 为AI爬虫和LLM优化生成llms.txt
nuxt-skew-protection 防止部署期间的版本不匹配
Nuxt SEO Pro MCP 通过模型上下文协议的AI驱动SEO工具

要求：Nuxt v3 或 v4

快速开始（5 分钟）

1. 安装完整SEO捆绑包

一次性安装所有8个模块：

# 使用Bun（主要）
bunx nuxi module add @nuxtjs/seo

# 使用npm（备份）
npx nuxi module add @nuxtjs/seo

# 使用pnpm（备份）
pnpm dlx nuxi module add @nuxtjs/seo

为什么这很重要：

  • 用一个命令安装所有8个模块
  • 确保模块之间的兼容版本
  • 自动提供最佳实践默认值

2. 配置站点设置

添加到 nuxt.config.ts：

export default defineNuxtConfig({
  modules: ['@nuxtjs/seo'],

  site: {
    url: 'https://example.com',
    name: '我的超棒站点',
    description: '构建惊人的Web体验',
    defaultLocale: 'en'
  }
})

关键：

  • 将 site.url 设置为生产URL（站点地图和规范URL必需）
  • 对于多环境设置，使用环境变量
  • 如果使用i18n，设置 defaultLocale

3. 重启并验证

bun run dev
# 或
npm run dev

访问这些URL以验证：

  • http://localhost:3000/robots.txt - Robots文件
  • http://localhost:3000/sitemap.xml - 站点地图

安装选项

选项 1：完整捆绑包（推荐）

bunx nuxi module add @nuxtjs/seo
# 或: npx nuxi module add @nuxtjs/seo

配置：

export default defineNuxtConfig({
  modules: ['@nuxtjs/seo']
})

选项 2：单个模块

仅安装所需内容：

# Bun
bunx nuxi module add nuxt-robots
bunx nuxi module add nuxt-sitemap
bunx nuxi module add nuxt-og-image

# npm
npx nuxi module add nuxt-robots
npx nuxi module add nuxt-sitemap
npx nuxi module add nuxt-og-image

# pnpm（备份）
pnpm dlx nuxi module add nuxt-robots
pnpm dlx nuxi module add nuxt-sitemap
pnpm dlx nuxi module add nuxt-og-image

配置：

export default defineNuxtConfig({
  modules: [
    'nuxt-robots',
    'nuxt-sitemap',
    'nuxt-og-image'
  ]
})

模块概述（简要）

Nuxt SEO 生态系统包括 8 个专业模块，它们无缝协作。每个模块服务于特定目的，可以单独安装或作为完整捆绑包安装。

模块 1：@nuxtjs/seo

主要SEO模块，作为捆绑包安装所有8个模块。通过 site 对象提供统一配置，并与Nuxt Content集成以实现自动SEO。

模块 2：nuxt-robots

管理robots.txt和机器人检测。控制搜索引擎可以爬取哪些页面，具有站点范围和页面级规则。包括服务器端和客户端机器人检测。

模块 3：nuxt-sitemap

从路由自动生成XML站点地图，支持动态URL、多个站点地图、媒体和高级优化。适合拥有数千页面的大型站点。

模块 4：nuxt-og-image

使用Vue模板动态创建Open Graph图像。零运行时开销，使用Satori渲染器或具有完整CSS支持的Chromium渲染器。

模块 5：nuxt-schema-org

为增强搜索结果构建Schema.org结构化数据，具有丰富摘要、知识面板和更好的SEO。

模块 6：nuxt-link-checker

查找和修复可能负面影响SEO的链接。在开发和构建期间检测损坏链接、重定向和问题。

模块 7：nuxt-seo-utils

SEO实用程序，用于可发现性和可分享性，包括规范URL、面包屑、应用图标和Open Graph自动化。

模块 8：nuxt-site-config

所有SEO模块的集中站点配置管理。站点范围设置（如URL、名称和区域设置）的单一真相源。

完整模块文档，包括配置、API和示例：
当需要时加载 references/module-details.md：

  • 特定模块的详细配置选项
  • 完整API文档
  • 代码示例和使用模式
  • 模块特定故障排除

集成模式

基本示例

// nuxt.config.ts - 完整SEO设置
export default defineNuxtConfig({
  modules: ['@nuxtjs/seo'],

  site: {
    url: 'https://example.com',
    name: '我的超棒站点',
    defaultLocale: 'en'
  },

  robots: {
    disallow: ['/admin']
  },

  sitemap: {
    sitemaps: {
      blog: { sources: ['/api/__sitemap__/blog'] }
    }
  }
})

完整集成示例：
当需要时加载 references/common-patterns.md：

  • 博客页面SEO实现
  • 电子商务产品页面示例
  • 多语言SEO模式
  • 与Nuxt Content集成

关键规则

始终做

✅ 在nuxt.config.ts中设置 site.url（站点地图和规范URL必需） ✅ 对于多环境设置，使用环境变量 ✅ 配置robots.txt以阻止管理员/私有页面 ✅ 向所有重要页面添加Schema.org结构化数据 ✅ 为社交分享生成OG图像 ✅ 部署到生产前测试所有SEO功能 ✅ 部署后向Google搜索控制台提交站点地图 ✅ 在开发期间启用链接检查器

绝不做

❌ 忘记设置 site.url（破坏站点地图和规范URL） ❌ 允许爬取暂存环境 ❌ 跳过关键页面的Schema.org（产品、文章、事件） ❌ 在没有测试OG图像的情况下部署 ❌ 使用过时模块版本 ❌ 忽略链接检查器发现的损坏链接 ❌ 忘记从站点地图中排除管理员/私有路由 ❌ 对OG图像使用错误的渲染引擎（Chromium vs Satori）

已知问题预防

此技能预防 10 个记录的常见SEO错误：

问题 #1：站点地图未生成

错误：/sitemap.xml 返回 404 原因：缺少 site.url 配置 预防：始终在nuxt.config.ts中设置 site.url

问题 #2：robots.txt 缺失

错误：/robots.txt 无法访问 原因：模块未安装或配置错误 预防：安装 nuxt-robots 并设置 site.url

问题 #3：OG 图像未渲染

错误：/__og-image__/og.png 返回错误 原因：与Satori渲染器不兼容的CSS 预防：使用Satori兼容的CSS或切换到Chromium渲染器

问题 #4：Schema 验证错误

错误：页面源中的无效JSON-LD 原因：不正确的Schema.org结构 预防：遵循官方Schema.org类型并使用Google丰富结果测试验证

问题 #5：损坏内部链接

错误：内部链接上的404错误 原因：路由更改后链接未更新 预防：在开发期间启用 nuxt-link-checker

问题 #6：重复元标签

错误：多个具有相同属性的元标签 原因：冲突的手动元标签和模块自动化 预防：让模块自动处理元标签

问题 #7：规范 URL 问题

错误：元标签中的错误规范URL 原因：不正确的 site.url 或缺少尾随斜杠配置 预防：正确配置 site.url 和 trailingSlash

问题 #8：站点地图索引错误

错误：站点地图索引XML格式错误 原因：单个站点地图中URL过多 预防：使用 chunksSize 选项分割大型站点地图

问题 #9：爬取暂存环境

错误：Google索引了暂存站点 原因：没有robots.txt阻止 预防：配置robots以阻止暂存：disallow: process.env.NUXT_PUBLIC_ENV === 'staging' ? ['/'] : []

问题 #10：缺少社交分享图像

错误：在社交媒体上分享时没有预览图像 原因：OG图像未定义或无法访问 预防：在所有重要页面上使用 defineOgImage()

配置示例

基本生产配置

export default defineNuxtConfig({
  modules: ['@nuxtjs/seo'],

  site: {
    url: process.env.NUXT_PUBLIC_SITE_URL,
    name: '我的站点',
    defaultLocale: 'en'
  },

  robots: {
    disallow: process.env.NUXT_PUBLIC_ENV === 'staging' ? ['/'] : []
  },

  sitemap: {
    sitemaps: {
      blog: { sources: ['/api/__sitemap__/blog'] }
    }
  }
})

完整配置示例：
当需要时加载 references/advanced-configuration.md：

  • 生产就绪的多环境设置
  • 开发和暂存配置
  • 高级站点地图模式
  • 动态路由规则
  • 多语言配置

使用捆绑资源

脚本 (scripts/)

init-nuxt-seo.sh - 新项目的快速设置脚本

./scripts/init-nuxt-seo.sh

自动：

  • 安装 @nuxtjs/seo 模块
  • 创建基本 nuxt.config.ts 配置
  • 设置示例OG图像组件
  • 创建站点地图API端点示例

参考 (references/)

何时加载参考

根据用户的具体需求加载适当的参考文件：

加载 references/seo-guides.md 当：

  • 用户询问渲染模式（SSR, SSG, ISR, Hybrid）
  • 需要JSON-LD结构化数据实现
  • 设置规范URL
  • 实现Twitter Cards或Open Graph
  • 配置元机器人标签
  • 使用IndexNow进行即时索引
  • URL结构最佳实践
  • 调试SEO问题
  • 丰富结果实现

加载 references/pro-modules.md 当：

  • 用户询问AI优化（llms.txt）
  • 需要部署版本倾斜保护
  • 设置MCP工具用于AI辅助SEO
  • 高级Pro模块功能

加载 references/advanced-seo-guides.md 当：

  • 用户询问I18n/多语言SEO
  • 需要hreflang或区域特定站点地图
  • 配置SEO路由规则（routeRules）
  • 增强标题配置（模板、回退）
  • 深入nuxt-seo-utils功能
  • 链接检查器检查规则
  • 为SEO预渲染Vue SPA
  • 水合不匹配调试
  • 防止恶意爬虫/机器人
  • 创建SEO友好的404页面

加载 references/modules-overview.md 当：

  • 用户询问“有哪些可用模块？”或“我应该使用哪个模块？”
  • 需要模块能力和用例概述
  • 比较模块以选择正确的一个
  • 理解模块如何协作

加载 references/installation-guide.md 当：

  • 用户首次设置Nuxt SEO
  • 包管理器特定问题（Bun vs npm vs pnpm）
  • 安装故障排除或依赖冲突
  • 需要逐步安装说明

加载 references/api-reference.md 当：

  • 用户询问特定可组合API（例如，“如何使用useSchemaOrg？”）
  • 需要完整参数列表或返回类型
  • 故障排除API方法签名
  • 查找特定配置选项

加载 references/common-patterns.md 当：

  • 用户想要现实世界实现示例
  • 需要博客、电子商务或多语言SEO模式
  • 与Nuxt Content或其他模块集成
  • 生产就绪配置示例

加载 references/module-details.md 当：

  • 用户询问特定模块配置
  • 需要其中一个8个模块的详细文档
  • 故障排除模块特定问题

加载 references/best-practices.md 当：

  • 设置生产SEO配置
  • 需要SEO优化指南
  • 遵循Nuxt SEO最佳实践

加载 references/troubleshooting.md 当：

  • 用户经历特定错误
  • 站点地图、robots.txt或OG图像问题
  • 构建问题或模块冲突

加载 references/advanced-configuration.md 当：

  • 需要生产就绪配置
  • 多环境设置（开发/暂存/生产）
  • 高级功能（多个站点地图、自定义OG模板）

加载 references/og-image-guide.md 当：

  • 用户询问OG图像生成、Satori vs Chromium
  • 需要自定义OG图像模板或Vue组件
  • 配置字体、表情符号或OG图像缓存
  • 故障排除OG图像渲染问题
  • 实现自定义道具或动态OG图像

加载 references/nuxt-content-integration.md 当：

  • 用户使用 @nuxt/content 与SEO模块
  • 需要 asSeoCollection, asSitemapCollection, asSchemaOrgCollection 模式
  • Content v2 vs v3 集成差异
  • 与内容的模块加载顺序问题
  • 从内容前置元数据自动SEO

加载 references/sitemap-advanced.md 当：

  • 用户需要来自API/数据库的动态站点地图URL
  • 实现分块多站点地图
  • 图像或视频站点地图
  • 使用 _i18nTransform 的 I18n 站点地图
  • 性能优化（缓存、零运行时）
  • defineSitemapEventHandler 模式

加载 references/nitro-api-reference.md 当：

  • 用户需要服务器端SEO钩子
  • 实现 sitemap:input, sitemap:resolved, sitemap:output 钩子
  • OG图像钩子 (nuxt-og-image:context, nuxt-og-image:satori:vnodes)
  • Robots 可组合 (getSiteRobotConfig, getPathRobotConfig)
  • 用于SEO的Nitro插件集成

加载 references/ai-seo-tools.md 当：

  • 用户询问 llms.txt 或 AI 可发现性
  • 实现 Nuxt AI Ready 模块
  • 用于AI驱动SEO的MCP服务器
  • AI爬虫的内容信号
  • LLM优化技术

可用参考：

  • references/seo-guides.md - 综合SEO实现指南（渲染、JSON-LD、规范URL、IndexNow、Twitter Cards、Open Graph、元机器人、URL结构）
  • references/pro-modules.md - Pro模块（AI Ready、Skew Protection、SEO Pro MCP）
  • references/advanced-seo-guides.md - 高级SEO主题（I18n多语言、路由规则、增强标题、链接检查器规则、SPA预渲染、水合、爬虫保护、404页面）
  • references/og-image-guide.md - OG图像生成指南（Satori/Chromium、字体、表情符号、缓存、自定义模板）
  • references/nuxt-content-integration.md - Nuxt Content v2/v3 集成（asSeoCollection、模块顺序、自动SEO）
  • references/sitemap-advanced.md - 高级站点地图模式（动态URL、多站点地图、分块、i18n、性能）
  • references/nitro-api-reference.md - 服务器端SEO钩子和可组合（Nitro插件、站点地图钩子、机器人可组合）
  • references/ai-seo-tools.md - AI SEO工具（llms.txt、Nuxt AI Ready、MCP、内容信号）
  • references/modules-overview.md - 所有8个核心模块的详细概述
  • references/installation-guide.md - 逐步安装模式
  • references/api-reference.md - 所有可组合的完整API文档
  • references/common-patterns.md - 现实世界使用模式和示例
  • references/module-details.md - 详细模块配置
  • references/best-practices.md - 生产SEO最佳实践
  • references/troubleshooting.md - 错误解决指南
  • references/advanced-configuration.md - 高级配置模式

资产 (assets/)

  • assets/package-versions.json - 当前模块版本用于验证

代理 (agents/)

复杂SEO任务的自主代理：

代理 用途
seo-auditor.md Nuxt项目的综合SEO审计
schema-generator.md 生成Schema.org结构化数据
og-image-generator.md 创建自定义OG图像Vue模板
link-checker.md 分析内部/外部链接
sitemap-builder.md 设计最佳站点地图策略

命令 (commands/)

快速SEO任务的斜杠命令：

命令 用途
/seo-audit 运行综合SEO审计
/seo-setup 快速Nuxt SEO项目设置
/og-preview 预览OG图像生成
/check-links 运行链接检查器分析
/validate-sitemap 验证站点地图配置
/check-schema 验证Schema.org实现

钩子 (hooks/)

自动运行的SEO验证钩子：

钩子 事件 用途
SEO 配置验证器 PreToolUse 验证文件编辑中的SEO配置
写后检查器 PostToolUse 文件写入后检查SEO配置
完成验证器 Stop 任务完成前确保SEO验证
项目检测器 SessionStart 会话开始时检测Nuxt SEO模块

最佳实践

前 3 个关键实践

1. 始终设置站点配置

site: {
  url: process.env.NUXT_PUBLIC_SITE_URL,
  name: '您的站点名称'
}

2. 阻止搜索引擎爬取暂存环境

robots: {
  disallow: process.env.NUXT_PUBLIC_ENV === 'staging' ? ['/'] : []
}

3. 向所有页面添加 Schema.org 每个页面应有适当的结构化数据（Organization, BlogPosting, Product等）。

完整最佳实践指南：
当需要时加载 references/best-practices.md：

  • 所有8个SEO最佳实践
  • 环境变量配置
  • 动态站点地图生成
  • OG图像优化
  • 多语言SEO设置

故障排除

前 3 个常见问题

1. 站点地图未生成

  • 确保 nuxt-sitemap 已安装
  • 在配置中设置 site.url
  • 重启开发服务器并访问 /sitemap.xml

2. OG 图像未渲染

  • 检查 nuxt-og-image 是否安装
  • 验证字体是否可访问
  • 对于复杂布局，切换到Chromium渲染器

3. 构建错误

  • 更新所有模块到最新版本
  • 清除 .nuxt 和 node_modules/.cache
  • 重新安装：rm -rf node_modules && bun install

完整故障排除指南：
当需要时加载 references/troubleshooting.md：

  • 所有5个常见问题的详细解决方案
  • 高级调试技术
  • 模块特定错误解决
  • 构建和部署问题

包版本（验证于 2025-12-28）

{
  "dependencies": {
    "@nuxtjs/seo": "^3.3.0",
    "nuxt-robots": "^5.6.7",
    "nuxt-sitemap": "^7.5.0",
    "nuxt-og-image": "^5.1.13",
    "nuxt-schema-org": "^5.0.10",
    "nuxt-link-checker": "^4.3.9",
    "nuxt-seo-utils": "^7.0.19",
    "nuxt-site-config": "^3.2.14"
  }
}

完整设置清单

使用此清单验证设置：

  • [ ] 安装了 @nuxtjs/seo 或单个模块
  • [ ] 在 nuxt.config.ts 中设置了 site.url
  • [ ] 配置了 site.name 和 site.description
  • [ ] 如果使用 i18n，设置了 defaultLocale
  • [ ] 配置了 robots.txt 以阻止管理员/私有页面
  • [ ] 配置了暂存环境以阻止所有爬取
  • [ ] 为内容创建了动态站点地图端点
  • [ ] 向重要页面添加了 OG 图像
  • [ ] 向关键页面添加了 Schema.org 结构化数据
  • [ ] 在开发中启用了链接检查器
  • [ ] 测试了 /robots.txt 端点
  • [ ] 测试了 /sitemap.xml 端点
  • [ ] 验证了 OG 图像正确渲染
  • [ ] 向 Google 搜索控制台提交了站点地图
  • [ ] 生产构建成功，无错误

官方文档

生产就绪：所有模式基于 https://nuxtseo.com/llms.txt 的官方文档 | 最后验证：2025-12-28

版本历史

v2.2.0 (2025-12-28)

  • 完全扩展，全面覆盖 nuxtseo.com/llms.txt 的所有主题
  • 添加了 5 个新参考文件：
    • references/og-image-guide.md - 完整OG图像指南（Satori/Chromium、字体、表情符号、缓存）
    • references/nuxt-content-integration.md - Nuxt Content v2/v3 集成模式
    • references/sitemap-advanced.md - 高级站点地图模式（动态URL、多站点地图、分块）
    • references/nitro-api-reference.md - 服务器端SEO钩子和可组合
    • references/ai-seo-tools.md - Nuxt AI Ready、llms.txt、MCP服务器、内容信号
  • 添加了 3 个新代理：
    • agents/og-image-generator.md - 创建自定义OG图像Vue模板
    • agents/link-checker.md - 分析内部/外部链接
    • agents/sitemap-builder.md - 设计最佳站点地图策略
  • 添加了 4 个新命令：
    • /og-preview - 预览OG图像生成
    • /check-links - 运行链接检查器分析
    • /validate-sitemap - 验证站点地图配置
    • /check-schema - 验证Schema.org实现
  • 添加了 SEO 验证钩子：
    • PreToolUse 钩子用于 SEO 配置验证
    • PostToolUse 钩子用于写后检查
    • Stop 钩子用于完成验证
    • SessionStart 钩子用于项目检测
  • 增强了关键词，添加了 20+ 新术语以改进可发现性
  • 总计：16 个参考文件、5 个代理、6 个命令、4 个钩子

v2.1.0 (2025-12-28)

  • 添加了 references/advanced-seo-guides.md 与 9 个高级主题：
    • I18n 多语言 SEO（robots + 站点地图集成）
    • SEO 路由规则（routeRules 配置）
    • 增强标题（模板、回退）
    • Nuxt SEO Utils 深入探讨
    • Nuxt Link Checker 规则（14 个检查规则）
    • 为SEO预渲染Vue SPA
    • 水合不匹配（原因、修复、SEO影响）
    • 防止恶意爬虫
    • SEO友好 404 页面
  • 添加了 5 个新自动触发场景
  • 增强了关键词，添加了 25+ 新术语

v2.0.0 (2025-12-28)

  • 重大更新，包括综合SEO指南和Pro模块
  • 添加了 references/seo-guides.md - 完整SEO实现指南：
    • 渲染模式（SSR, SSG, ISR, Hybrid）
    • JSON-LD 结构化数据
    • 规范URL
    • IndexNow & 索引API
    • Twitter Cards
    • 社交分享 & Open Graph
    • 元机器人标签
    • URL 结构最佳实践
    • 丰富结果
    • 调试Vue SEO问题
  • 添加了 references/pro-modules.md - Pro模块文档：
    • Nuxt AI Ready（llms.txt 生成）
    • Nuxt Skew Protection（部署版本安全）
    • Nuxt SEO Pro MCP（AI驱动SEO工具）
  • 创建了 agents/seo-auditor.md - 自主SEO审计代理
  • 创建了 agents/schema-generator.md - Schema.org代码生成器
  • 创建了 commands/seo-audit.md - SEO审计斜杠命令
  • 创建了 commands/seo-setup.md - 快速SEO设置命令
  • 更新了所有包版本到最新（2025-12-28）
  • 增强了关键词以改进技能发现
  • 添加了 5 个新自动触发场景

v1.1.0 (2025-11-27)

  • 重构了 SKILL.md 从 1505 到 628 行（减少 58%）
  • 将模块详细信息提取到 references/module-details.md
  • 将最佳实践提取到 references/best-practices.md
  • 将故障排除提取到 references/troubleshooting.md
  • 将高级配置提取到 references/advanced-configuration.md
  • 添加了“何时加载参考”部分以进行渐进式披露
  • 为所有 8 个参考文件添加了目录
  • 所有内容保留，仅为最佳令牌效率重组
  • 根据技能审查流程完成了阶段 6-7、13-14

v1.0.0 (2025-11-10)

  • 初始版本
  • 所有 8 个 Nuxt SEO 模块的完整文档
  • 10 个记录的错误模式
  • 生产测试模式