[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M73030M2K64BJ1TPEW5JBHW7":3,"skill-same:01M73030M2K64BJ1TPEW5JBHW7":48},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":47},"01M73030M2K64BJ1TPEW5JBHW7","nuxt4-patterns",null,"Nuxt 4 应用模式，涵盖水合安全、性能优化、路由规则、懒加载，以及使用 useFetch 和 useAsyncData 进行 SSR 安全的数据获取。","SriramGandhiS\u002FSkills","SriramGandhiS","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F211849986?v=4","01M72WQCW12BYX71C6WN584TTA","Sriram S","01M72WQCWTJ2RD0ET1X31AF1RC",1,"MIT","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fskills\u002Feverything-claude-code\u002Fdocs\u002Fzh-CN\u002Fskills\u002Fnuxt4-patterns\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: nuxt4-patterns\ndescription: Nuxt 4 应用模式，涵盖水合安全、性能优化、路由规则、懒加载，以及使用 useFetch 和 useAsyncData 进行 SSR 安全的数据获取。\norigin: ECC\n---\n\n# Nuxt 4 模式\n\n在构建或调试具有 SSR、混合渲染、路由规则或页面级数据获取的 Nuxt 4 应用时使用。\n\n## 何时激活\n\n* 服务器 HTML 与客户端状态之间的水合不匹配\n* 路由级别的渲染决策，例如预渲染、SWR、ISR 或仅客户端部分\n* 围绕懒加载、延迟水合或有效负载大小的性能工作\n* 使用 `useFetch`、`useAsyncData` 或 `$fetch` 进行页面或组件数据获取\n* 与路由参数、中间件或 SSR\u002F客户端差异相关的 Nuxt 路由问题\n\n## 水合安全性\n\n* 保持首次渲染是确定性的。不要将 `Date.now()`、`Math.random()`、仅限浏览器的 API 或存储读取直接放入 SSR 渲染的模板状态中。\n* 当服务器无法生成相同标记时，将仅限浏览器的逻辑移到 `onMounted()`、`import.meta.client`、`ClientOnly` 或 `.client.vue` 组件后面。\n* 使用 Nuxt 的 `useRoute()` 组合式函数，而不是来自 `vue-router` 的那个。\n* 不要使用 `route.fullPath` 来驱动 SSR 渲染的标记。URL 片段是仅客户端的，这可能导致水合不匹配。\n* 将 `ssr: false` 视为真正仅限浏览器区域的逃生舱口，而不是解决不匹配的默认修复方法。\n\n## 数据获取\n\n* 在页面和组件中，优先使用 `await useFetch()` 进行 SSR 安全的 API 读取。它将服务器获取的数据转发到 Nuxt 有效负载中，并避免在水合时进行第二次获取。\n* 当数据获取器不是简单的 `$fetch()` 调用，或者需要自定义键，或者正在组合多个异步源时，使用 `useAsyncData()`。\n* 为 `useAsyncData()` 提供一个稳定的键以重用缓存并实现可预测的刷新行为。\n* 保持 `useAsyncData()` 处理程序无副作用。它们可能在 SSR 和水合期间运行。\n* 将 `$fetch()` 用于用户触发的写入或仅客户端操作，而不是应该从 SSR 水合而来的顶级页面数据。\n* 对于不应阻塞导航的非关键数据，使用 `lazy: true`、`useLazyFetch()` 或 `useLazyAsyncData()`。在 UI 中处理 `status === 'pending'`。\n* 仅对 SEO 或首次绘制不需要的数据使用 `server: false`。\n* 使用 `pick` 修剪有效负载大小，并在不需要深层响应性时优先使用较浅的有效负载。\n\n```ts\nconst route = useRoute()\n\nconst { data: article, status, error, refresh } = await useAsyncData(\n  () => `article:${route.params.slug}`,\n  () => $fetch(`\u002Fapi\u002Farticles\u002F${route.params.slug}`),\n)\n\nconst { data: comments } = await useFetch(`\u002Fapi\u002Farticles\u002F${route.params.slug}\u002Fcomments`, {\n  lazy: true,\n  server: false,\n})\n```\n\n## 路由规则\n\n在 `nuxt.config.ts` 中优先使用 `routeRules` 来定义渲染和缓存策略：\n\n```ts\nexport default defineNuxtConfig({\n  routeRules: {\n    '\u002F': { prerender: true },\n    '\u002Fproducts\u002F**': { swr: 3600 },\n    '\u002Fblog\u002F**': { isr: true },\n    '\u002Fadmin\u002F**': { ssr: false },\n    '\u002Fapi\u002F**': { cache: { maxAge: 60 * 60 } },\n  },\n})\n```\n\n* `prerender`：在构建时生成静态 HTML\n* `swr`：提供缓存内容并在后台重新验证\n* `isr`：在支持的平台上进行增量静态再生\n* `ssr: false`：客户端渲染的路由\n* `cache` 或 `redirect`：Nitro 级别的响应行为\n\n按路由组选择路由规则，而非全局设置。营销页面、产品目录、仪表板和 API 通常需要不同的策略。\n\n## 懒加载与性能\n\n* Nuxt 已经按路由进行代码分割。在微优化组件分割之前，保持路由边界的意义。\n* 使用 `Lazy` 前缀来动态导入非关键组件。\n* 使用 `v-if` 有条件地渲染懒加载组件，以便在 UI 实际需要时才加载该代码块。\n* 对首屏下方或非关键的交互式 UI 使用延迟水合。\n\n```vue\n\u003Ctemplate>\n  \u003CLazyRecommendations v-if=\"showRecommendations\" \u002F>\n  \u003CLazyProductGallery hydrate-on-visible \u002F>\n\u003C\u002Ftemplate>\n```\n\n* 对于自定义策略，使用 `defineLazyHydrationComponent()` 配合可见性或空闲策略。\n* Nuxt 延迟水合适用于单文件组件。向延迟水合的组件传递新 props 将立即触发水合。\n* 在内部导航中使用 `NuxtLink`，以便 Nuxt 可以预取路由组件和生成的有效负载。\n\n## 检查清单\n\n* 首次 SSR 渲染和水合后的客户端渲染产生相同的标记\n* 页面数据使用 `useFetch` 或 `useAsyncData`，而非顶层的 `$fetch`\n* 非关键数据是懒加载的，并具有明确的加载 UI\n* 路由规则符合页面的 SEO 和新鲜度要求\n* 重量级交互式组件是懒加载或延迟水合的\n","# Nuxt 4 模式\n\n在构建或调试具有 SSR、混合渲染、路由规则或页面级数据获取的 Nuxt 4 应用时使用。\n\n## 何时激活\n\n* 服务器 HTML 与客户端状态之间的水合不匹配\n* 路由级别的渲染决策，例如预渲染、SWR、ISR 或仅客户端部分\n* 围绕懒加载、延迟水合或有效负载大小的性能工作\n* 使用 `useFetch`、`useAsyncData` 或 `$fetch` 进行页面或组件数据获取\n* 与路由参数、中间件或 SSR\u002F客户端差异相关的 Nuxt 路由问题\n\n## 水合安全性\n\n* 保持首次渲染是确定性的。不要将 `Date.now()`、`Math.random()`、仅限浏览器的 API 或存储读取直接放入 SSR 渲染的模板状态中。\n* 当服务器无法生成相同标记时，将仅限浏览器的逻辑移到 `onMounted()`、`import.meta.client`、`ClientOnly` 或 `.client.vue` 组件后面。\n* 使用 Nuxt 的 `useRoute()` 组合式函数，而不是来自 `vue-router` 的那个。\n* 不要使用 `route.fullPath` 来驱动 SSR 渲染的标记。URL 片段是仅客户端的，这可能导致水合不匹配。\n* 将 `ssr: false` 视为真正仅限浏览器区域的逃生舱口，而不是解决不匹配的默认修复方法。\n\n## 数据获取\n\n* 在页面和组件中，优先使用 `await useFetch()` 进行 SSR 安全的 API 读取。它将服务器获取的数据转发到 Nuxt 有效负载中，并避免在水合时进行第二次获取。\n* 当数据获取器不是简单的 `$fetch()` 调用，或者需要自定义键，或者正在组合多个异步源时，使用 `useAsyncData()`。\n* 为 `useAsyncData()` 提供一个稳定的键以重用缓存并实现可预测的刷新行为。\n* 保持 `useAsyncData()` 处理程序无副作用。它们可能在 SSR 和水合期间运行。\n* 将 `$fetch()` 用于用户触发的写入或仅客户端操作，而不是应该从 SSR 水合而来的顶级页面数据。\n* 对于不应阻塞导航的非关键数据，使用 `lazy: true`、`useLazyFetch()` 或 `useLazyAsyncData()`。在 UI 中处理 `status === 'pending'`。\n* 仅对 SEO 或首次绘制不需要的数据使用 `server: false`。\n* 使用 `pick` 修剪有效负载大小，并在不需要深层响应性时优先使用较浅的有效负载。\n\n```ts\nconst route = useRoute()\n\nconst { data: article, status, error, refresh } = await useAsyncData(\n  () => `article:${route.params.slug}`,\n  () => $fetch(`\u002Fapi\u002Farticles\u002F${route.params.slug}`),\n)\n\nconst { data: comments } = await useFetch(`\u002Fapi\u002Farticles\u002F${route.params.slug}\u002Fcomments`, {\n  lazy: true,\n  server: false,\n})\n```\n\n## 路由规则\n\n在 `nuxt.config.ts` 中优先使用 `routeRules` 来定义渲染和缓存策略：\n\n```ts\nexport default defineNuxtConfig({\n  routeRules: {\n    '\u002F': { prerender: true },\n    '\u002Fproducts\u002F**': { swr: 3600 },\n    '\u002Fblog\u002F**': { isr: true },\n    '\u002Fadmin\u002F**': { ssr: false },\n    '\u002Fapi\u002F**': { cache: { maxAge: 60 * 60 } },\n  },\n})\n```\n\n* `prerender`：在构建时生成静态 HTML\n* `swr`：提供缓存内容并在后台重新验证\n* `isr`：在支持的平台上进行增量静态再生\n* `ssr: false`：客户端渲染的路由\n* `cache` 或 `redirect`：Nitro 级别的响应行为\n\n按路由组选择路由规则，而非全局设置。营销页面、产品目录、仪表板和 API 通常需要不同的策略。\n\n## 懒加载与性能\n\n* Nuxt 已经按路由进行代码分割。在微优化组件分割之前，保持路由边界的意义。\n* 使用 `Lazy` 前缀来动态导入非关键组件。\n* 使用 `v-if` 有条件地渲染懒加载组件，以便在 UI 实际需要时才加载该代码块。\n* 对首屏下方或非关键的交互式 UI 使用延迟水合。\n\n```vue\n\u003Ctemplate>\n  \u003CLazyRecommendations v-if=\"showRecommendations\" \u002F>\n  \u003CLazyProductGallery hydrate-on-visible \u002F>\n\u003C\u002Ftemplate>\n```\n\n* 对于自定义策略，使用 `defineLazyHydrationComponent()` 配合可见性或空闲策略。\n* Nuxt 延迟水合适用于单文件组件。向延迟水合的组件传递新 props 将立即触发水合。\n* 在内部导航中使用 `NuxtLink`，以便 Nuxt 可以预取路由组件和生成的有效负载。\n\n## 检查清单\n\n* 首次 SSR 渲染和水合后的客户端渲染产生相同的标记\n* 页面数据使用 `useFetch` 或 `useAsyncData`，而非顶层的 `$fetch`\n* 非关键数据是懒加载的，并具有明确的加载 UI\n* 路由规则符合页面的 SEO 和新鲜度要求\n* 重量级交互式组件是懒加载或延迟水合的\n",{"name":5,"origin":24,"description":7},"ECC","master","d6ca01da0f24a3b0e26e4a8b7b66cbd25d429f5d","skills\u002Feverything-claude-code\u002Fdocs\u002Fzh-CN\u002Fskills\u002Fnuxt4-patterns",0,"https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills","https:\u002F\u002Fgithub.com\u002FSriramGandhiS","https:\u002F\u002Fsriram.website\u002F","Curious guy who keeps tinkering until something works","2026-05-20 16:21:34",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add SriramGandhiS\u002FSkills --skill nuxt4-patterns",{"tool":40,"command":41},"bunx","bunx skills add SriramGandhiS\u002FSkills --skill nuxt4-patterns",{"tool":43,"command":44},"pnpm","pnpm dlx skills add SriramGandhiS\u002FSkills --skill nuxt4-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fskills\u002Feverything-claude-code\u002Fdocs\u002Fzh-CN\u002Fskills\u002Fnuxt4-patterns\u002FSKILL.md",true,[],[49,56,61,67,74,81],{"skillNo":50,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":19},"01M732609EPJWV13PVTX3GT4TM","webgpu-threejs-tsl","Comprehensive guide for developing WebGPU-enabled Three.js applications using TSL (Three.js Shading Language). Covers WebGPU renderer setup, TSL syntax and node materials, compute shaders, post-processing effects, and WGSL integration. Use this skill when working with Three.js WebGPU, TSL shaders, node materials, or GPU compute in Three.js.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fwebgpu-threejs-tsl\u002Fskills\u002Fwebgpu-threejs-tsl\u002FSKILL.md",[],[],{"skillNo":57,"name":51,"nameZh":6,"description":52,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M7325XM47AGWB6K6C4VXKE6B","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fwebgpu-threejs-tsl\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7325WP6DES69JKC840VMFEP","verification-loop","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fverification-loop\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7325TFQF1DZTQ6J3WGQQ1VR","tdd-workflow","Use this skill when writing new features, fixing bugs, or refactoring code. Enforces test-driven development with 80%+ coverage including unit, integration, and E2E tests.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Ftdd-workflow\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7325RGV9AY9PK92D2V8KKPW","strategic-compact","Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fstrategic-compact\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7325MZC28SE86E7NMCNEFS4","security-review","Use this skill when adding authentication, handling user input, working with secrets, creating API endpoints, or implementing payment\u002Fsensitive features. Provides comprehensive security checklist and patterns.","https:\u002F\u002Fgithub.com\u002FSriramGandhiS\u002FSkills\u002Fblob\u002Fmaster\u002Fweb-assets\u002Fdocs\u002Fzh-TW\u002Fskills\u002Fsecurity-review\u002FSKILL.md",[],[]]