用途：在修改 Nuxt 代码前，按当前任务查阅匹配的主题参考，避免依据过时的 API、默认值或生态模式做改动。部分默认值会随兼容模式、构建器、部署预设或包主版本而异，需先确认边界再动代码。
参考索引（按任务选读）：升级与迁移读 upgrading.md；数据获取与状态读 data-fetching-and-state.md；路由与导航读 routing-and-navigation.md；渲染与组件读 rendering-and-components.md；模块与图层读 modules-and-layers.md；构建与类型读 build-and-types.md；Nitro 与部署读 nitro-and-deployment.md；生态模块读 ecosystem-modules.md。
兼容边界：先检查 package.json、锁文件、nuxt.config 与生成的类型配置，分别识别 Nuxt 主版本、兼容版本、构建器、Nitro 主版本及相关模块主版本。Nuxt 3 应用升级时保持在其发布通道；Nuxt 5 兼容视为实验预览而非有界迁移目标；Nitro 3 视为显式固定的预发布版本，不要从 Nuxt 主版本推断 Nitro 主版本。改动源码布局、兼容默认值、模块或构建器后需重新运行类型检查。
快速参考：新 Nuxt 4 项目应用代码位于 app/，server/、shared/、content/、public/ 与配置留在项目根；除非任务明确要求迁移，否则保留检测到的 Nuxt 3 布局。Nuxt 4 默认下组件名带路径前缀。mergeModels 不再自动导入需显式导入；错误码优先用 status 与 statusText；head 组合式函数从 Nuxt 自动导入或 #app/composables/head 导入。Nitro 预发布迁移中生产依赖默认打包，移除 nodeModulesDirs、nitro/deps/*、自定义 moduleSideEffects 与临时 TypeScript-paths 选项，从 nitro 根包导入配置、运行时与 HTTP 工具，ServerRequest 从 nitro/types 导入。
数据获取：同一 key 的调用方共享 ref、刷新、缓存与进行中请求；handler 需无副作用；缺失数据按 undefined 而非 null 处理；接受中止信号并传给下游请求；无兼容行为时消费者卸载后缓存会被清除。callOnce 回调失败可重试；clearNuxtState 恢复初始化值；useCookie({ refresh: true }) 使同值赋值续期。
路由与渲染：无路径路由组用括号目录，中间件读 route.meta.groups；布局对象写在页面元数据中以获得类型检查；每个文件只调用一次 definePageMeta；自定义 app.vue 需包含 <NuxtRouteAnnouncer>。惰性水合可按可见性、空闲、交互、媒体查询或延迟选择。服务端岛 props 视为 URL 数据，需非机密、可序列化且体积小。
模块与图层：本地 layers/ 与 modules/ 目录自动注册；用 getLayerDirectories 解析图层路径，#layers/<name> 别名导入；优先级为项目文件覆盖图层、本地图层反字母序、更早的 extends 覆盖更晚的。
限制：资料未提供具体安装命令、版本号、收费信息或效果数据；以上为查阅式知识补丁，不替代对项目实际版本与锁文件的检查。