[{"data":1,"prerenderedAt":2791},["ShallowReactive",2],{"docs-navigation-zh-CN":3,"mdc--tctnej-key":338,"docs--docs-getting-started-migration":351,"surround--docs-getting-started-migration":2780,"-docs-getting-started-migration-description":2783},[4],{"title":5,"path":6,"stem":7,"children":8,"page":113},"Docs","\u002Fdocs","docs",[9,38,114,150,191,239],{"title":10,"path":11,"stem":12,"children":13,"category":16,"description":16,"icon":37},"开始","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started\u002F1.index",[14,19,25,31],{"title":15,"path":11,"stem":12,"category":16,"description":17,"icon":18},"简介",null,"Movk Nuxt Docs 是一个可以直接 extends 的 Nuxt Layer，提供文档站所需的排版、导航、搜索、SEO 与 AI 能力。本页说明它适合什么项目、默认包含哪些功能、哪些功能按需开启。","i-lucide-book-open",{"title":20,"path":21,"stem":22,"category":16,"description":23,"icon":24},"安装","\u002Fdocs\u002Fgetting-started\u002Finstallation","docs\u002F1.getting-started\u002F2.installation","用官方模板从零创建文档站，或把 @movk\u002Fnuxt-docs 作为 Layer 接入现有 Nuxt 项目。本页列出 default、i18n、module 三套模板的区别、运行环境要求与必须安装的依赖。","i-lucide-download",{"title":26,"path":27,"stem":28,"category":16,"description":29,"icon":30},"项目结构","\u002Fdocs\u002Fgetting-started\u002Fproject-structure","docs\u002F1.getting-started\u002F3.project-structure","说明使用 Movk Nuxt Docs 的项目中各目录与文件的职责：内容放在哪里、路由如何生成、哪些文件会被自动识别为版本发布页与案例页，以及两份配置文件分别管什么。","i-lucide-folder-tree",{"title":32,"path":33,"stem":34,"category":16,"description":35,"icon":36},"从 v2 迁移","\u002Fdocs\u002Fgetting-started\u002Fmigration","docs\u002F1.getting-started\u002F4.migration","逐条列出从 @movk\u002Fnuxt-docs v2 升级到 v3 的破坏性变更，每项给出 v2 与 v3 写法对比。按顺序检查依赖与功能开关、内容目录、配置字段、视觉默认值和组件覆盖，即可完成升级。","i-lucide-arrow-right-left","i-lucide-square-play",{"title":39,"category":16,"description":16,"icon":40,"path":41,"stem":42,"children":43,"page":113},"指南","i-lucide-compass","\u002Fdocs\u002Fguide","docs\u002F2.guide",[44,51,58,64,70,76,82,89,95,101,107],{"title":45,"path":46,"stem":47,"category":48,"description":49,"icon":50},"配置总览","\u002Fdocs\u002Fguide\u002Fconfiguration","docs\u002F2.guide\u002F1.configuration","basics","Movk Nuxt Docs 的配置分为 nuxt.config.ts 与 app.config.ts 两处：前者在构建期决定启用哪些模块与功能，后者在运行时控制界面、文案与导航。本页说明两者的分工、生效时机，以及常见需求应该改哪一处。","i-lucide-settings",{"title":52,"path":53,"stem":54,"category":55,"description":56,"icon":57},"故障排查","\u002Fdocs\u002Fguide\u002Ftroubleshooting","docs\u002F2.guide\u002F10.troubleshooting","shipping","汇总可选依赖缺失、AI Chat 与 MCP 依赖关系、文档 404、多语言配置、pnpm 构建脚本审批与提交记录问题的解决办法。","i-lucide-life-buoy",{"title":59,"path":60,"stem":61,"category":55,"description":62,"icon":63},"常见问题","\u002Fdocs\u002Fguide\u002Ffaq","docs\u002F2.guide\u002F11.faq","关于 Movk Nuxt Docs 的常见疑问：与 Nuxt UI 文档模板的关系、包管理器与 Node.js 版本、单语言站点、关闭 GitHub 集成、接入其他 AI 厂商、升级与组件覆盖、静态部署的限制等，每条都链接到详细说明。","i-lucide-circle-help",{"title":65,"path":66,"stem":67,"category":48,"description":68,"icon":69},"主题与字体","\u002Fdocs\u002Fguide\u002Ftheme","docs\u002F2.guide\u002F2.theme","默认主题采用编辑风：暖灰纸面、朱红强调色、衬线标题与等宽元信息。本页说明默认配色与字体、如何通过 app.config 切换颜色与标题字体、引入中文衬线字体，以及访客主题面板与动效偏好的行为。","i-lucide-palette",{"title":71,"path":72,"stem":73,"category":48,"description":74,"icon":75},"导航与分类","\u002Fdocs\u002Fguide\u002Fnavigation","docs\u002F2.guide\u002F3.navigation","页头导航、移动端菜单与侧栏分组都在 app.config 中声明，文档目录结构则决定栏目条与侧栏的内容和顺序。本页说明各类导航的数据来源、多语言文案与链接前缀、侧栏分组规则，以及导航过滤与 ⌘K 搜索。","i-lucide-map",{"title":77,"path":78,"stem":79,"category":48,"description":80,"icon":81},"功能开关","\u002Fdocs\u002Fguide\u002Ffeatures","docs\u002F2.guide\u002F4.features","组件文档、Mermaid、AI Chat、无障碍检查等可选功能都由 nuxt.config 中的开关控制，默认关闭的功能不会打包任何相关依赖。本页列出每个开关的默认值、启用后需要安装的依赖，以及关闭时的降级行为。","i-lucide-toggle-right",{"title":83,"path":84,"stem":85,"category":86,"description":87,"icon":88},"自定义","\u002Fdocs\u002Fguide\u002Fcustomization","docs\u002F2.guide\u002F5.customization","customization","在项目组件目录中创建与内置组件同名的 Vue 文件，即可替换页头、侧栏、页脚等界面区域。本页列出 v3 承诺稳定的可覆盖组件、各自的挂载位置，并为每个组件给出最小覆盖示例。","i-lucide-paintbrush",{"title":90,"path":91,"stem":92,"category":86,"description":93,"icon":94},"页面与布局","\u002Fdocs\u002Fguide\u002Fpages","docs\u002F2.guide\u002F6.pages","除文档页外，Layer 会根据 content 目录中的文件自动生成首页、版本发布页与案例页，你也可以在 app\u002Fpages 中编写任意 Vue 页面。本页说明各内置路由的生成条件与内容格式、自定义页面的页头页脚开关，以及内置布局。","i-lucide-layout-panel-top",{"title":96,"path":97,"stem":98,"category":86,"description":99,"icon":100},"国际化","\u002Fdocs\u002Fguide\u002Fi18n","docs\u002F2.guide\u002F7.i18n","用 @nuxtjs\u002Fi18n 为文档站开启多语言：安装与配置、内容目录约定、按语言生成的内容集合、界面文案覆盖与 hreflang SEO。未配置时站点按单语言运行，也可只切换界面语言。","i-lucide-languages",{"title":102,"path":103,"stem":104,"category":86,"description":105,"icon":106},"OG 图片","\u002Fdocs\u002Fguide\u002Fog-image","docs\u002F2.guide\u002F8.og-image","每个文档页在构建时自动生成社交分享图片（OG 图片）。本页说明内置模板读取哪些字段、如何在自定义页面中生成、如何替换模板，以及关闭该功能后的行为。","i-lucide-image",{"title":108,"path":109,"stem":110,"category":55,"description":111,"icon":112},"部署","\u002Fdocs\u002Fguide\u002Fdeployment","docs\u002F2.guide\u002F9.deployment","把文档站部署到 Vercel、Netlify、Cloudflare 或任意 Node.js 服务器，也可以生成纯静态站点。本页列出构建命令、环境变量、各平台的注意事项，以及静态部署下不可用的功能。","i-lucide-rocket",false,{"title":115,"category":16,"description":16,"icon":116,"path":117,"stem":118,"children":119,"page":113},"AI","i-lucide-sparkles","\u002Fdocs\u002Fai","docs\u002F3.ai",[120,126,132,138,144],{"title":121,"path":122,"stem":123,"category":16,"description":124,"icon":125},"AI Chat","\u002Fdocs\u002Fai\u002Fai-chat","docs\u002F3.ai\u002F1.ai-chat","为文档站启用内置 AI 助手：说明启用条件与依赖安装、模型与端点路由的配置方式、如何接入其他厂商，以及组件与组合式函数的 API，帮助你在几分钟内让读者直接向文档提问。","i-lucide-bot",{"title":127,"path":128,"stem":129,"category":16,"description":130,"icon":131},"MCP Server","\u002Fdocs\u002Fai\u002Fmcp","docs\u002F3.ai\u002F2.mcp","每个文档站默认在 \u002Fmcp 提供 Model Context Protocol 服务。本页列出内置的工具、资源与提示词，说明如何在 Claude Code、Cursor、VS Code 等客户端接入，以及如何关闭、限制或扩展服务器。","i-lucide-plug",{"title":133,"path":134,"stem":135,"category":16,"description":136,"icon":137},"Agent Skills","\u002Fdocs\u002Fai\u002Fskills","docs\u002F3.ai\u002F3.skills","把项目根目录 skills\u002F 下的 Agent Skills 随文档站一起发布到 \u002F.well-known\u002Fskills\u002F，读者一条命令即可安装到 Claude Code、Cursor 等助手。本页说明目录结构、命名规则、发布方式与内置的两个 Skill。","i-lucide-wand-sparkles",{"title":139,"path":140,"stem":141,"category":16,"description":142,"icon":143},"llms.txt","\u002Fdocs\u002Fai\u002Fllms-txt","docs\u002F3.ai\u002F4.llms-txt","文档站自动生成 \u002Fllms.txt 与 \u002Fllms-full.txt，为大语言模型提供站点目录与全文。本页说明默认值从哪里来、如何配置标题与分组、它们与每页 Markdown 表示的关系，以及在 Cursor 等工具中的用法。","i-lucide-file-text",{"title":145,"path":146,"stem":147,"category":16,"description":148,"icon":149},"代理发现","\u002Fdocs\u002Fai\u002Fagent-discovery","docs\u002F3.ai\u002F5.agent-discovery","文档站默认为 AI 代理提供每页的 Markdown 表示、Markdown 站点地图与一组 \u002F.well-known 发现文档，代理无需解析 HTML 就能找到并读取内容。本页列出全部端点、内容协商规则与 layer 的补充实现。","i-lucide-radar",{"title":151,"category":16,"description":16,"icon":152,"path":153,"stem":154,"children":155,"page":113},"写作","i-lucide-square-pilcrow","\u002Fdocs\u002Fwriting","docs\u002F4.writing",[156,162,168,174,179,185],{"title":157,"path":158,"stem":159,"category":16,"description":160,"icon":161},"Markdown 语法","\u002Fdocs\u002Fwriting\u002Fmarkdown-syntax","docs\u002F4.writing\u002F1.markdown-syntax","文档页面使用标准 Markdown 编写：标题决定目录与锚点，配合强调、链接、列表、表格与引用组织内容。本页列出常用语法及其在 Movk Nuxt Docs 中的渲染效果。","i-lucide-heading",{"title":163,"path":164,"stem":165,"category":16,"description":166,"icon":167},"代码块","\u002Fdocs\u002Fwriting\u002Fcode-blocks","docs\u002F4.writing\u002F2.code-blocks","代码块默认使用 github-light \u002F github-dark 高亮，支持文件名、行高亮、复制按钮与颜色、图标预览；用 code-group、code-tree 等组件组织多文件与长代码示例。","i-lucide-square-code",{"title":169,"path":170,"stem":171,"category":16,"description":172,"icon":173},"MDC 组件","\u002Fdocs\u002Fwriting\u002Fmdc-components","docs\u002F4.writing\u002F3.mdc-components","在 Markdown 中用 MDC 语法嵌入 Nuxt UI 的 Prose 组件：提示块、徽标、卡片、折叠面板、选项卡、步骤、字段说明、图标与按键，无需编写 Vue 代码即可组织更有层次的文档内容。","i-lucide-puzzle",{"title":175,"path":176,"stem":177,"category":16,"description":178,"icon":106},"图片与视频","\u002Fdocs\u002Fwriting\u002Fmedia","docs\u002F4.writing\u002F4.media","用 Markdown 图片语法插入远程或本地图片，用 `u-color-mode-image` 为亮色与暗色模式分别提供截图，用 `:video` 嵌入视频；本页同时说明图片放置位置与替代文本的写法。",{"title":180,"path":181,"stem":182,"category":16,"description":183,"icon":184},"Mermaid 图表","\u002Fdocs\u002Fwriting\u002Fmermaid","docs\u002F4.writing\u002F5.mermaid","开启 `movkNuxtDocs.mermaid` 并安装 mermaid 与 dompurify 后，语言为 `mermaid` 的代码块渲染为流程图、时序图、类图等图表，随亮暗主题切换，进入视口时才加载，并提供复制与全屏查看。","i-lucide-workflow",{"title":186,"path":187,"stem":188,"category":16,"description":189,"icon":190},"内容组件","\u002Fdocs\u002Fwriting\u002Fcontent-components","docs\u002F4.writing\u002F6.content-components","layer 在 Nuxt UI Prose 组件之外提供的内容组件：为元素添加入场动画的 Motion、动态星空背景 StarsBg，以及编辑式落地页使用的 LandingCover、LandingSection 等组件，均可直接在 Markdown 中使用。","i-lucide-sparkle",{"title":192,"category":16,"description":16,"icon":193,"path":194,"stem":195,"children":196,"page":113},"组件","i-lucide-component","\u002Fdocs\u002Fcomponents","docs\u002F5.components",[197,203,209,215,221,227,233],{"title":198,"path":199,"stem":200,"category":16,"description":201,"icon":202},"ComponentProps","\u002Fdocs\u002Fcomponents\u002Fcomponent-props","docs\u002F5.components\u002F1.component-props","在 Markdown 中用一行 `:component-props` 生成 Vue 组件的 Props 表格，名称、默认值、类型与 JSDoc 说明均来自 nuxt-component-meta 提取的元数据，组件改动后文档自动同步。","i-lucide-list",{"title":204,"path":205,"stem":206,"category":16,"description":207,"icon":208},"ComponentSlots","\u002Fdocs\u002Fcomponents\u002Fcomponent-slots","docs\u002F5.components\u002F2.component-slots","用一行 `:component-slots` 列出 Vue 组件的全部插槽，插槽名、作用域参数类型与 JSDoc 说明来自 `defineSlots` 的类型定义，无需手写插槽文档。","i-lucide-layout-panel-left",{"title":210,"path":211,"stem":212,"category":16,"description":213,"icon":214},"ComponentEmits","\u002Fdocs\u002Fcomponents\u002Fcomponent-emits","docs\u002F5.components\u002F3.component-emits","用一行 `:component-emits` 列出 Vue 组件的全部事件，事件名、参数签名与 JSDoc 说明来自 `defineEmits` 的类型定义，与 Props、Slots 表格配套组成完整 API 文档。","i-lucide-radio-tower",{"title":216,"path":217,"stem":218,"category":16,"description":219,"icon":220},"ComponentExample","\u002Fdocs\u002Fcomponents\u002Fcomponent-example","docs\u002F5.components\u002F4.component-example","用 `:component-example` 把示例目录中的 Vue 文件渲染为实时预览，并在下方展示带高亮的源码；支持行高亮、折叠、可调参数与仅客户端渲染，适合展示组件在真实场景下的组合用法。","i-lucide-app-window",{"title":222,"path":223,"stem":224,"category":16,"description":225,"icon":226},"ComponentCode","\u002Fdocs\u002Fcomponents\u002Fcomponent-code","docs\u002F5.components\u002F5.component-code","用 `::component-code` 以属性矩阵驱动任意已注册的 Vue 组件实时渲染，读者在预览上方切换属性值，下方的 Vue 代码片段同步更新，可直接复制使用。","i-lucide-sliders-horizontal",{"title":228,"path":229,"stem":230,"category":16,"description":231,"icon":232},"CommitChangelog","\u002Fdocs\u002Fcomponents\u002Fcommit-changelog","docs\u002F5.components\u002F6.commit-changelog","用 `:commit-changelog` 从 GitHub 拉取组件或源文件的提交记录，按版本分组展示为时间线；文件路径由组件名推导，可按目录、扩展名、命名格式与作者调整，一篇文档也可关联多个文件。","i-lucide-git-commit-horizontal",{"title":234,"path":235,"stem":236,"category":16,"description":237,"icon":238},"PageLastCommit","\u002Fdocs\u002Fcomponents\u002Fpage-last-commit","docs\u002F5.components\u002F7.page-last-commit","文档页导语下方的元信息行会显示当前 Markdown 文件的最后一次提交，包括时间、作者与提交信息；本页说明它的启用条件、日期格式配置与 PR squash merge 的作者识别。","i-lucide-history",{"title":240,"category":16,"description":16,"icon":241,"path":242,"stem":243,"children":244,"page":113},"参考","i-lucide-book-marked","\u002Fdocs\u002Freference","docs\u002F6.reference",[245,251,257,332],{"title":246,"path":247,"stem":248,"category":16,"description":249,"icon":250},"app.config 参考","\u002Fdocs\u002Freference\u002Fapp-config","docs\u002F6.reference\u002F1.app-config","app.config.ts 全部配置项的字段、类型、默认值与说明，由 layer 的 nuxt.schema.ts 自动生成，与发布版本保持一致。需要了解某一项的用法时，从这里跳转到对应指南。","i-lucide-file-cog",{"title":252,"path":253,"stem":254,"category":16,"description":255,"icon":256},"nuxt.config 选项","\u002Fdocs\u002Freference\u002Fnuxt-config","docs\u002F6.reference\u002F2.nuxt-config","Layer 在构建期读取的全部 nuxt.config 选项与环境变量，包括功能开关、AI Chat、组件元数据、MCP、llms.txt、代理发现与站点信息。修改这些选项后需要重新构建或重启开发服务器。","i-lucide-settings-2",{"title":258,"category":16,"description":16,"icon":259,"path":260,"stem":261,"children":262,"page":113},"组合式函数","i-lucide-square-function","\u002Fdocs\u002Freference\u002Fcomposables","docs\u002F6.reference\u002F3.composables",[263,268,274,280,286,292,298,304,310,315,321,327],{"title":264,"path":265,"stem":266,"category":16,"description":267,"icon":100},"useMovkI18n","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-movk-i18n","docs\u002F6.reference\u002F3.composables\u002F1.use-movk-i18n","统一的多语言访问入口。无论是否启用 @nuxtjs\u002Fi18n，都能用同一套 API 读取当前语言、翻译文案、生成带语言前缀的链接，并拿到当前语言对应的内容集合名与文档根路径。",{"title":269,"path":270,"stem":271,"category":16,"description":272,"icon":273},"useLocaleSeo","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-locale-seo","docs\u002F6.reference\u002F3.composables\u002F10.use-locale-seo","为多语言站点注入 hreflang alternate 链接、x-default 与 og:locale，让搜索引擎正确识别各语言版本。layer 的 app.vue 已全局调用；只有在项目中重写 app.vue 时需要自行调用。","i-lucide-globe",{"title":275,"path":276,"stem":277,"category":16,"description":278,"icon":279},"useFetchComponentMeta","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-fetch-component-meta","docs\u002F6.reference\u002F3.composables\u002F11.use-fetch-component-meta","读取 nuxt-component-meta 生成的组件元数据，包括 Props、Slots、Events 的类型与说明。ComponentProps 等组件文档组件都基于它实现，需要自行渲染组件 API 表格时直接调用。仅在开启组件文档功能时可用。","i-lucide-braces",{"title":281,"path":282,"stem":283,"category":16,"description":284,"icon":285},"useFetchComponentExample","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-fetch-component-example","docs\u002F6.reference\u002F3.composables\u002F12.use-fetch-component-example","读取 components\u002Fcontent\u002Fexamples 下示例组件的源码、文件路径与组件名。ComponentExample 用它展示示例代码，需要在自定义组件中显示示例源码时直接调用。仅在开启组件文档功能时可用。","i-lucide-file-code",{"title":287,"path":288,"stem":289,"category":16,"description":290,"icon":291},"useDocsNavigation","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-navigation","docs\u002F6.reference\u002F3.composables\u002F2.use-docs-navigation","读取外壳预先加载好的文档导航树。页头栏目条、侧栏和文档页都从这里拿导航数据，自定义组件调用它即可复用同一份数据，不会再次查询内容集合。","i-lucide-list-tree",{"title":293,"path":294,"stem":295,"category":16,"description":296,"icon":297},"useNavigation","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-navigation","docs\u002F6.reference\u002F3.composables\u002F3.use-navigation","把文档导航树加工成侧栏需要的形态：取出顶层栏目、把当前栏目的页面按 docs.categories 分组，并为任意路径生成面包屑。自定义侧栏或目录组件时用它保持与默认实现一致的分组规则。","i-lucide-panel-left",{"title":299,"path":300,"stem":301,"category":16,"description":302,"icon":303},"useHeader","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-header","docs\u002F6.reference\u002F3.composables\u002F4.use-header","提供页头桌面端与移动端导航链接。推荐直接在 app.config 的 header.nav 与 header.mobileNav 中声明；需要按运行时状态动态生成链接时，再在项目中创建同名 composable 覆盖它。","i-lucide-panel-top",{"title":305,"path":306,"stem":307,"category":16,"description":308,"icon":309},"useCategory","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-category","docs\u002F6.reference\u002F3.composables\u002F5.use-category","提供侧栏分类定义，决定栏目内带 category 的页面如何分组、按什么顺序显示。推荐在 app.config 的 docs.categories 中声明；只有分类需要在运行时计算时，才在项目中创建同名 composable 覆盖。","i-lucide-folders",{"title":311,"path":312,"stem":313,"category":16,"description":314,"icon":69},"useTheme","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-theme","docs\u002F6.reference\u002F3.composables\u002F6.use-theme","主题面板背后的状态与操作：主色、中性色、圆角、图标集、黑色主色与颜色模式，访客的选择保存在 localStorage，并能导出为 app.config 或 CSS 片段。自定义主题面板或在页面中切换主题时使用。",{"title":316,"path":317,"stem":318,"category":16,"description":319,"icon":320},"useDocsRoute","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-route","docs\u002F6.reference\u002F3.composables\u002F7.use-docs-route","判断当前路由是否是文档子页面，兼容默认语言的 \u002Fdocs\u002F* 与其他语言的 \u002F{locale}\u002Fdocs\u002F*。自定义页头、页脚等全站组件需要只在文档页显示某些内容时使用。","i-lucide-route",{"title":322,"path":323,"stem":324,"category":16,"description":325,"icon":326},"useDocsFilterConfig","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-filter-config","docs\u002F6.reference\u002F3.composables\u002F8.use-docs-filter-config","侧栏导航过滤框的配置、显示条件与过滤函数，对应 app.config 的 aside.filter。自定义侧栏顶部或侧栏主体组件时，用这些函数保持与默认过滤行为一致。","i-lucide-list-filter",{"title":328,"path":329,"stem":330,"category":16,"description":331,"icon":220},"useDocsShell","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-shell","docs\u002F6.reference\u002F3.composables\u002F9.use-docs-shell","app.vue 与 error.vue 共用的站点外壳：按当前语言加载导航树与搜索索引，注入 html 语言、方向、字体与颗粒属性，并向组件树提供导航。只有在项目中完全重写 app.vue 或 error.vue 时才需要直接调用它。",{"title":333,"path":334,"stem":335,"category":16,"description":336,"icon":337},"A–Z 索引","\u002Fdocs\u002Freference\u002Fa-z","docs\u002F6.reference\u002F9.a-z","按英文标题首字母列出全部文档页面，记得功能名称却不确定它在哪个分区时，从这里直接跳转；中文页面同时显示英文标题以便按字母查找。","i-lucide-list-ordered",{"data":339,"body":340},{},{"type":341,"children":342},"root",[343],{"type":344,"tag":345,"props":346,"children":347},"element","p",{},[348],{"type":349,"value":350},"text","Copyright © 2024 - 2026",{"id":352,"title":32,"body":353,"category":16,"description":35,"difficulty":2771,"extension":424,"index":113,"keywords":16,"links":16,"meta":2772,"navigation":2773,"path":33,"requires":2774,"seo":2775,"sitemap":2778,"stem":34,"__hash__":2779},"docs\u002Fdocs\u002F1.getting-started\u002F4.migration.md",{"type":354,"value":355,"toc":2738},"minimark",[356,360,404,408,415,1458,1460,1465,1469,1482,1565,1569,1580,1646,1655,1659,1669,1686,1690,1693,1743,1746,1761,1826,1832,1835,1844,1882,1885,1906,1942,1945,1948,2023,2026,2041,2283,2288,2291,2294,2297,2314,2370,2372,2375,2411,2418,2480,2485,2488,2501,2574,2577,2580,2590,2593,2596,2611,2618,2627,2634,2643,2688,2698,2718,2734],[357,358,359],"h2",{"id":359},"升级步骤",[361,362,363,375,384,390,397],"ol",{},[364,365,366,367,371,372],"li",{},"将 ",[368,369,370],"code",{},"@movk\u002Fnuxt-docs"," 升级到 ",[368,373,374],{},"^3.0.0",[364,376,377,378,383],{},"按下文 ",[379,380,382],"a",{"href":381},"#%E4%BE%9D%E8%B5%96%E4%B8%8E%E5%8A%9F%E8%83%BD%E5%BC%80%E5%85%B3","依赖与功能开关"," 安装你用到的可选依赖",[364,385,386,387],{},"确认文档位于 ",[368,388,389],{},"content\u002Fdocs\u002F",[364,391,392,393,396],{},"检查 ",[368,394,395],{},"app.config.ts"," 与覆盖的组件",[364,398,399,400,403],{},"运行 ",[368,401,402],{},"nuxt build","。缺少依赖或配置冲突时构建会直接报错并说明原因",[357,405,407],{"id":406},"用-ai-迁移","用 AI 迁移",[345,409,410,411,414],{},"把下面的提示词交给 Claude Code、Cursor、Codex 等编码代理，它会按本页的变更清单检查并修改你的项目。代理也可以直接读取本页的 Markdown 版本：",[368,412,413],{},"https:\u002F\u002Fdocs.mhaibaraai.cn\u002Fraw\u002Fdocs\u002Fgetting-started\u002Fmigration.md","。",[416,417,419],"collapsible",{"name":418},"完整迁移提示词",[420,421,426],"pre",{"className":422,"code":423,"language":424,"meta":425,"style":425},"language-md shiki shiki-themes github-light github-light github-dark","你正在把**当前项目**（@movk\u002Fnuxt-docs 的使用方）升级到 **@movk\u002Fnuxt-docs 3.0**。\n\nv3 把默认关闭的功能改为 optional peer 依赖，固定了内容目录，重命名了部分配置字段，并以编辑式排版作为新的视觉默认值。大多数变更在构建期直接报错，少数（视觉默认值、组件覆盖）只会改变外观。\n\n你的任务：\n\n1. 只在**当前仓库**中查找受下列变更影响的代码、配置与内容。\n2. 按清单改为 v3 写法，不要为旧写法添加兼容层。\n3. 保持站点现有行为与外观；第 6 节的视觉默认值先询问我是否保留 v2 外观，再决定是否改回。\n4. 完成后运行项目的 `nuxt build`、类型检查与测试，修复由迁移引起的失败。\n5. 最后列出：修改的文件、新安装的依赖、需要我人工确认的项。\n\n## 不要改动\n\n- `extends: ['@movk\u002Fnuxt-docs']` 写法不变\n- 覆盖 `useHeader` \u002F `useCategory` 的旧写法仍然可用；只在我同意时才改为 `app.config` 的 `header.nav` \u002F `docs.categories`\n- MDC 语法、frontmatter 字段、文件名数字前缀不变\n- `AI_API_KEY`、`AI_BASE_URL`、`NUXT_GITHUB_TOKEN` 环境变量名不变\n\n## 前置\n\n先将 `@movk\u002Fnuxt-docs` 升级到 `^3.0.0`，用项目实际使用的包管理器：\n\n```bash\npnpm add @movk\u002Fnuxt-docs@^3.0.0\n```\n\n## 变更清单\n\n### 1. 可选功能的依赖\n\n以下功能的依赖不再随 Layer 安装。只为项目实际启用的功能安装：\n\n| 功能 | 启用条件 | 需安装 |\n|---|---|---|\n| 组件文档 | 页面中使用 `ComponentProps` \u002F `ComponentSlots` \u002F `ComponentEmits` \u002F `ComponentCode` \u002F `ComponentExample` | `nuxt-component-meta vue-component-meta prettier`，并设置 `movkNuxtDocs.componentDocs: true` |\n| AI Chat | 构建期存在 `AI_API_KEY` 或 `aiChat.enabled: true` | `ai @ai-sdk\u002Fopenai @ai-sdk\u002Fvue @comark\u002Fvue @shikijs\u002Fengine-javascript @shikijs\u002Flangs @shikijs\u002Fthemes` |\n| Mermaid | `movkNuxtDocs.mermaid` 开启 | `mermaid dompurify`（v2 缺依赖时静默跳过，v3 构建报错） |\n| 无障碍检查 | v2 默认开启，v3 默认关闭 | 需要时设置 `movkNuxtDocs.a11y: true` 并安装 `@nuxt\u002Fa11y` |\n| 国际化 | `modules` 中含 `@nuxtjs\u002Fi18n` | `@nuxtjs\u002Fi18n` |\n\n判断组件文档是否启用：在 `content\u002F` 与 `app\u002F` 中搜索上表的组件名。\n\n### 2. AI Chat 与 MCP\n\n启用 AI Chat 时不能设置 `movkNuxtDocs.mcp: false`，否则构建报错。如两者同时出现，删除 `mcp: false`。\n\n### 3. 内容目录\n\n文档必须位于 `content\u002Fdocs\u002F`，其他语言位于 `content\u002F{locale}\u002Fdocs\u002F`，路由前缀固定为 `\u002Fdocs`。如果文档直接放在 `content\u002F` 下（如 `content\u002F1.getting-started\u002F`），整体移入 `content\u002Fdocs\u002F`，并更新站内链接、`header.nav`、`docs.categories` 等处的路径。`content\u002Findex.md`、`content\u002Freleases.*`、`content\u002Ftemplates.*` 保持在 `content\u002F` 根目录。\n\n### 4. 配置字段\n\n- `app.config.ts` 中 `github.per_page` 重命名为 `github.perPage`\n- v2 默认只显示 `2025-01-31` 之后、构建时刻之前的提交，v3 不再过滤。原来依赖该行为时显式设置 `github.since` \u002F `github.until`\n\n### 5. 移除的作者私有默认值\n\nv3 不再携带以下默认值。如果站点依赖它们，在项目配置中显式设置：\n\n- `header.avatar`（v2 指向作者头像）\n- `github.dateFormat.options.timeZone: 'Asia\u002FShanghai'`\n- Alibaba PuHuiTi 字体 CDN：字体栈仍优先使用该字体，需要时通过 `app.head.link` 自行引入样式表\n\n### 6. 视觉默认值（先询问我）\n\n| 项 | v2 | v3 | 改回 v2 |\n|---|---|---|---|\n| 主色 \u002F 中性色 | `green` \u002F `slate` | `vermilion` \u002F `paper` | `app.config.ts` 设置 `ui.colors.primary: 'green'`、`ui.colors.neutral: 'slate'` |\n| 标题字体 | 无衬线 | 衬线（Fraunces） | `theme.font: 'sans'` |\n| 代码高亮 | Nuxt Content 默认 | `github-light` \u002F `github-dark` | `nuxt.config.ts` 设置 `content.build.markdown.highlight.theme` |\n\n项目已显式配置的颜色、字体、高亮主题保持不变。\n\n### 7. 组件覆盖\n\n在 `app\u002Fcomponents\u002F` 中查找与 Layer 同名的覆盖组件：\n\n- 可覆盖的组件、挂载位置与 props 以文档「自定义」页的覆盖契约表为准，未列出的（如 `ThemePickerButton`）属于内部实现，提示我需要人工确认\n- 页头、侧栏、目录、上下篇、页脚结构已重做；覆盖过这些组件或在 CSS 中依赖其 DOM 结构的，标记出来交给我确认\n- `PageHeaderLinks` 的挂载位置改到文档页导语下方的元信息行\n- Layer 覆盖了 Nuxt UI 的 `ProsePre`；项目自己的 `ProsePre` 覆盖仍然优先，无需改动\n\n### 8. 删除的 API\n\n- 删除 `HeroBackground` 组件的所有引用，以及 `definePageMeta({ heroBackground: ... })` 中的 `heroBackground`\n- 在项目中覆盖 `useToolCall` 时，`state` 参数类型由 `ToolState` 改为 `string`，并删除不再使用的 `ToolState` 导入\n\n## 验证\n\n1. 运行 `nuxt build`。出现「已启用的功能缺少依赖」时按提示安装；出现 `[request error]` 日志说明有死链，修正对应链接\n2. 运行项目的类型检查与测试\n3. 启动开发服务器，抽查首页、一篇文档页与使用组件文档的页面\n","md","",[368,427,428,450,457,463,468,474,479,495,504,513,529,538,543,550,555,567,601,609,631,636,642,647,664,669,675,689,695,700,706,711,717,722,728,733,739,745,789,811,829,846,867,872,890,895,901,906,923,928,934,939,1010,1015,1021,1026,1046,1068,1073,1079,1084,1090,1095,1106,1114,1128,1133,1139,1144,1150,1156,1198,1209,1235,1240,1246,1251,1257,1262,1274,1279,1293,1301,1312,1331,1336,1342,1347,1370,1407,1412,1418,1423,1442,1450],{"__ignoreMap":425},[429,430,433,437,441,444,447],"span",{"class":431,"line":432},"line",1,[429,434,436],{"class":435},"sxrX7","你正在把",[429,438,440],{"class":439},"sEO0R","**当前项目**",[429,442,443],{"class":435},"（@movk\u002Fnuxt-docs 的使用方）升级到 ",[429,445,446],{"class":439},"**@movk\u002Fnuxt-docs 3.0**",[429,448,449],{"class":435},"。\n",[429,451,453],{"class":431,"line":452},2,[429,454,456],{"emptyLinePlaceholder":455},true,"\n",[429,458,460],{"class":431,"line":459},3,[429,461,462],{"class":435},"v3 把默认关闭的功能改为 optional peer 依赖，固定了内容目录，重命名了部分配置字段，并以编辑式排版作为新的视觉默认值。大多数变更在构建期直接报错，少数（视觉默认值、组件覆盖）只会改变外观。\n",[429,464,466],{"class":431,"line":465},4,[429,467,456],{"emptyLinePlaceholder":455},[429,469,471],{"class":431,"line":470},5,[429,472,473],{"class":435},"你的任务：\n",[429,475,477],{"class":431,"line":476},6,[429,478,456],{"emptyLinePlaceholder":455},[429,480,482,486,489,492],{"class":431,"line":481},7,[429,483,485],{"class":484},"sP4rz","1.",[429,487,488],{"class":435}," 只在",[429,490,491],{"class":439},"**当前仓库**",[429,493,494],{"class":435},"中查找受下列变更影响的代码、配置与内容。\n",[429,496,498,501],{"class":431,"line":497},8,[429,499,500],{"class":484},"2.",[429,502,503],{"class":435}," 按清单改为 v3 写法，不要为旧写法添加兼容层。\n",[429,505,507,510],{"class":431,"line":506},9,[429,508,509],{"class":484},"3.",[429,511,512],{"class":435}," 保持站点现有行为与外观；第 6 节的视觉默认值先询问我是否保留 v2 外观，再决定是否改回。\n",[429,514,516,519,522,526],{"class":431,"line":515},10,[429,517,518],{"class":484},"4.",[429,520,521],{"class":435}," 完成后运行项目的 ",[429,523,525],{"class":524},"sBjJW","`nuxt build`",[429,527,528],{"class":435},"、类型检查与测试，修复由迁移引起的失败。\n",[429,530,532,535],{"class":431,"line":531},11,[429,533,534],{"class":484},"5.",[429,536,537],{"class":435}," 最后列出：修改的文件、新安装的依赖、需要我人工确认的项。\n",[429,539,541],{"class":431,"line":540},12,[429,542,456],{"emptyLinePlaceholder":455},[429,544,546],{"class":431,"line":545},13,[429,547,549],{"class":548},"syb_3","## 不要改动\n",[429,551,553],{"class":431,"line":552},14,[429,554,456],{"emptyLinePlaceholder":455},[429,556,558,561,564],{"class":431,"line":557},15,[429,559,560],{"class":484},"-",[429,562,563],{"class":524}," `extends: ['@movk\u002Fnuxt-docs']`",[429,565,566],{"class":435}," 写法不变\n",[429,568,570,572,575,578,581,584,587,590,593,596,598],{"class":431,"line":569},16,[429,571,560],{"class":484},[429,573,574],{"class":435}," 覆盖 ",[429,576,577],{"class":524},"`useHeader`",[429,579,580],{"class":435}," \u002F ",[429,582,583],{"class":524},"`useCategory`",[429,585,586],{"class":435}," 的旧写法仍然可用；只在我同意时才改为 ",[429,588,589],{"class":524},"`app.config`",[429,591,592],{"class":435}," 的 ",[429,594,595],{"class":524},"`header.nav`",[429,597,580],{"class":435},[429,599,600],{"class":524},"`docs.categories`\n",[429,602,604,606],{"class":431,"line":603},17,[429,605,560],{"class":484},[429,607,608],{"class":435}," MDC 语法、frontmatter 字段、文件名数字前缀不变\n",[429,610,612,614,617,620,623,625,628],{"class":431,"line":611},18,[429,613,560],{"class":484},[429,615,616],{"class":524}," `AI_API_KEY`",[429,618,619],{"class":435},"、",[429,621,622],{"class":524},"`AI_BASE_URL`",[429,624,619],{"class":435},[429,626,627],{"class":524},"`NUXT_GITHUB_TOKEN`",[429,629,630],{"class":435}," 环境变量名不变\n",[429,632,634],{"class":431,"line":633},19,[429,635,456],{"emptyLinePlaceholder":455},[429,637,639],{"class":431,"line":638},20,[429,640,641],{"class":548},"## 前置\n",[429,643,645],{"class":431,"line":644},21,[429,646,456],{"emptyLinePlaceholder":455},[429,648,650,653,656,658,661],{"class":431,"line":649},22,[429,651,652],{"class":435},"先将 ",[429,654,655],{"class":524},"`@movk\u002Fnuxt-docs`",[429,657,371],{"class":435},[429,659,660],{"class":524},"`^3.0.0`",[429,662,663],{"class":435},"，用项目实际使用的包管理器：\n",[429,665,667],{"class":431,"line":666},23,[429,668,456],{"emptyLinePlaceholder":455},[429,670,672],{"class":431,"line":671},24,[429,673,674],{"class":435},"```bash\n",[429,676,678,682,686],{"class":431,"line":677},25,[429,679,681],{"class":680},"snPdu","pnpm",[429,683,685],{"class":684},"sIIMD"," add",[429,687,688],{"class":684}," @movk\u002Fnuxt-docs@^3.0.0\n",[429,690,692],{"class":431,"line":691},26,[429,693,694],{"class":435},"```\n",[429,696,698],{"class":431,"line":697},27,[429,699,456],{"emptyLinePlaceholder":455},[429,701,703],{"class":431,"line":702},28,[429,704,705],{"class":548},"## 变更清单\n",[429,707,709],{"class":431,"line":708},29,[429,710,456],{"emptyLinePlaceholder":455},[429,712,714],{"class":431,"line":713},30,[429,715,716],{"class":548},"### 1. 可选功能的依赖\n",[429,718,720],{"class":431,"line":719},31,[429,721,456],{"emptyLinePlaceholder":455},[429,723,725],{"class":431,"line":724},32,[429,726,727],{"class":435},"以下功能的依赖不再随 Layer 安装。只为项目实际启用的功能安装：\n",[429,729,731],{"class":431,"line":730},33,[429,732,456],{"emptyLinePlaceholder":455},[429,734,736],{"class":431,"line":735},34,[429,737,738],{"class":435},"| 功能 | 启用条件 | 需安装 |\n",[429,740,742],{"class":431,"line":741},35,[429,743,744],{"class":435},"|---|---|---|\n",[429,746,748,751,754,756,759,761,764,766,769,771,774,777,780,783,786],{"class":431,"line":747},36,[429,749,750],{"class":435},"| 组件文档 | 页面中使用 ",[429,752,753],{"class":524},"`ComponentProps`",[429,755,580],{"class":435},[429,757,758],{"class":524},"`ComponentSlots`",[429,760,580],{"class":435},[429,762,763],{"class":524},"`ComponentEmits`",[429,765,580],{"class":435},[429,767,768],{"class":524},"`ComponentCode`",[429,770,580],{"class":435},[429,772,773],{"class":524},"`ComponentExample`",[429,775,776],{"class":435}," | ",[429,778,779],{"class":524},"`nuxt-component-meta vue-component-meta prettier`",[429,781,782],{"class":435},"，并设置 ",[429,784,785],{"class":524},"`movkNuxtDocs.componentDocs: true`",[429,787,788],{"class":435}," |\n",[429,790,792,795,798,801,804,806,809],{"class":431,"line":791},37,[429,793,794],{"class":435},"| AI Chat | 构建期存在 ",[429,796,797],{"class":524},"`AI_API_KEY`",[429,799,800],{"class":435}," 或 ",[429,802,803],{"class":524},"`aiChat.enabled: true`",[429,805,776],{"class":435},[429,807,808],{"class":524},"`ai @ai-sdk\u002Fopenai @ai-sdk\u002Fvue @comark\u002Fvue @shikijs\u002Fengine-javascript @shikijs\u002Flangs @shikijs\u002Fthemes`",[429,810,788],{"class":435},[429,812,814,817,820,823,826],{"class":431,"line":813},38,[429,815,816],{"class":435},"| Mermaid | ",[429,818,819],{"class":524},"`movkNuxtDocs.mermaid`",[429,821,822],{"class":435}," 开启 | ",[429,824,825],{"class":524},"`mermaid dompurify`",[429,827,828],{"class":435},"（v2 缺依赖时静默跳过，v3 构建报错） |\n",[429,830,832,835,838,841,844],{"class":431,"line":831},39,[429,833,834],{"class":435},"| 无障碍检查 | v2 默认开启，v3 默认关闭 | 需要时设置 ",[429,836,837],{"class":524},"`movkNuxtDocs.a11y: true`",[429,839,840],{"class":435}," 并安装 ",[429,842,843],{"class":524},"`@nuxt\u002Fa11y`",[429,845,788],{"class":435},[429,847,849,852,855,858,861,863,865],{"class":431,"line":848},40,[429,850,851],{"class":435},"| 国际化 | ",[429,853,854],{"class":524},"`modules`",[429,856,857],{"class":435}," 中含 ",[429,859,860],{"class":524},"`@nuxtjs\u002Fi18n`",[429,862,776],{"class":435},[429,864,860],{"class":524},[429,866,788],{"class":435},[429,868,870],{"class":431,"line":869},41,[429,871,456],{"emptyLinePlaceholder":455},[429,873,875,878,881,884,887],{"class":431,"line":874},42,[429,876,877],{"class":435},"判断组件文档是否启用：在 ",[429,879,880],{"class":524},"`content\u002F`",[429,882,883],{"class":435}," 与 ",[429,885,886],{"class":524},"`app\u002F`",[429,888,889],{"class":435}," 中搜索上表的组件名。\n",[429,891,893],{"class":431,"line":892},43,[429,894,456],{"emptyLinePlaceholder":455},[429,896,898],{"class":431,"line":897},44,[429,899,900],{"class":548},"### 2. AI Chat 与 MCP\n",[429,902,904],{"class":431,"line":903},45,[429,905,456],{"emptyLinePlaceholder":455},[429,907,909,912,915,918,921],{"class":431,"line":908},46,[429,910,911],{"class":435},"启用 AI Chat 时不能设置 ",[429,913,914],{"class":524},"`movkNuxtDocs.mcp: false`",[429,916,917],{"class":435},"，否则构建报错。如两者同时出现，删除 ",[429,919,920],{"class":524},"`mcp: false`",[429,922,449],{"class":435},[429,924,926],{"class":431,"line":925},47,[429,927,456],{"emptyLinePlaceholder":455},[429,929,931],{"class":431,"line":930},48,[429,932,933],{"class":548},"### 3. 内容目录\n",[429,935,937],{"class":431,"line":936},49,[429,938,456],{"emptyLinePlaceholder":455},[429,940,942,945,948,951,954,957,960,963,965,968,971,974,976,979,981,983,986,989,992,994,997,999,1002,1005,1007],{"class":431,"line":941},50,[429,943,944],{"class":435},"文档必须位于 ",[429,946,947],{"class":524},"`content\u002Fdocs\u002F`",[429,949,950],{"class":435},"，其他语言位于 ",[429,952,953],{"class":524},"`content\u002F{locale}\u002Fdocs\u002F`",[429,955,956],{"class":435},"，路由前缀固定为 ",[429,958,959],{"class":524},"`\u002Fdocs`",[429,961,962],{"class":435},"。如果文档直接放在 ",[429,964,880],{"class":524},[429,966,967],{"class":435}," 下（如 ",[429,969,970],{"class":524},"`content\u002F1.getting-started\u002F`",[429,972,973],{"class":435},"），整体移入 ",[429,975,947],{"class":524},[429,977,978],{"class":435},"，并更新站内链接、",[429,980,595],{"class":524},[429,982,619],{"class":435},[429,984,985],{"class":524},"`docs.categories`",[429,987,988],{"class":435}," 等处的路径。",[429,990,991],{"class":524},"`content\u002Findex.md`",[429,993,619],{"class":435},[429,995,996],{"class":524},"`content\u002Freleases.*`",[429,998,619],{"class":435},[429,1000,1001],{"class":524},"`content\u002Ftemplates.*`",[429,1003,1004],{"class":435}," 保持在 ",[429,1006,880],{"class":524},[429,1008,1009],{"class":435}," 根目录。\n",[429,1011,1013],{"class":431,"line":1012},51,[429,1014,456],{"emptyLinePlaceholder":455},[429,1016,1018],{"class":431,"line":1017},52,[429,1019,1020],{"class":548},"### 4. 配置字段\n",[429,1022,1024],{"class":431,"line":1023},53,[429,1025,456],{"emptyLinePlaceholder":455},[429,1027,1029,1031,1034,1037,1040,1043],{"class":431,"line":1028},54,[429,1030,560],{"class":484},[429,1032,1033],{"class":524}," `app.config.ts`",[429,1035,1036],{"class":435}," 中 ",[429,1038,1039],{"class":524},"`github.per_page`",[429,1041,1042],{"class":435}," 重命名为 ",[429,1044,1045],{"class":524},"`github.perPage`\n",[429,1047,1049,1051,1054,1057,1060,1063,1065],{"class":431,"line":1048},55,[429,1050,560],{"class":484},[429,1052,1053],{"class":435}," v2 默认只显示 ",[429,1055,1056],{"class":524},"`2025-01-31`",[429,1058,1059],{"class":435}," 之后、构建时刻之前的提交，v3 不再过滤。原来依赖该行为时显式设置 ",[429,1061,1062],{"class":524},"`github.since`",[429,1064,580],{"class":435},[429,1066,1067],{"class":524},"`github.until`\n",[429,1069,1071],{"class":431,"line":1070},56,[429,1072,456],{"emptyLinePlaceholder":455},[429,1074,1076],{"class":431,"line":1075},57,[429,1077,1078],{"class":548},"### 5. 移除的作者私有默认值\n",[429,1080,1082],{"class":431,"line":1081},58,[429,1083,456],{"emptyLinePlaceholder":455},[429,1085,1087],{"class":431,"line":1086},59,[429,1088,1089],{"class":435},"v3 不再携带以下默认值。如果站点依赖它们，在项目配置中显式设置：\n",[429,1091,1093],{"class":431,"line":1092},60,[429,1094,456],{"emptyLinePlaceholder":455},[429,1096,1098,1100,1103],{"class":431,"line":1097},61,[429,1099,560],{"class":484},[429,1101,1102],{"class":524}," `header.avatar`",[429,1104,1105],{"class":435},"（v2 指向作者头像）\n",[429,1107,1109,1111],{"class":431,"line":1108},62,[429,1110,560],{"class":484},[429,1112,1113],{"class":524}," `github.dateFormat.options.timeZone: 'Asia\u002FShanghai'`\n",[429,1115,1117,1119,1122,1125],{"class":431,"line":1116},63,[429,1118,560],{"class":484},[429,1120,1121],{"class":435}," Alibaba PuHuiTi 字体 CDN：字体栈仍优先使用该字体，需要时通过 ",[429,1123,1124],{"class":524},"`app.head.link`",[429,1126,1127],{"class":435}," 自行引入样式表\n",[429,1129,1131],{"class":431,"line":1130},64,[429,1132,456],{"emptyLinePlaceholder":455},[429,1134,1136],{"class":431,"line":1135},65,[429,1137,1138],{"class":548},"### 6. 视觉默认值（先询问我）\n",[429,1140,1142],{"class":431,"line":1141},66,[429,1143,456],{"emptyLinePlaceholder":455},[429,1145,1147],{"class":431,"line":1146},67,[429,1148,1149],{"class":435},"| 项 | v2 | v3 | 改回 v2 |\n",[429,1151,1153],{"class":431,"line":1152},68,[429,1154,1155],{"class":435},"|---|---|---|---|\n",[429,1157,1159,1162,1165,1167,1170,1172,1175,1177,1180,1182,1185,1188,1191,1193,1196],{"class":431,"line":1158},69,[429,1160,1161],{"class":435},"| 主色 \u002F 中性色 | ",[429,1163,1164],{"class":524},"`green`",[429,1166,580],{"class":435},[429,1168,1169],{"class":524},"`slate`",[429,1171,776],{"class":435},[429,1173,1174],{"class":524},"`vermilion`",[429,1176,580],{"class":435},[429,1178,1179],{"class":524},"`paper`",[429,1181,776],{"class":435},[429,1183,1184],{"class":524},"`app.config.ts`",[429,1186,1187],{"class":435}," 设置 ",[429,1189,1190],{"class":524},"`ui.colors.primary: 'green'`",[429,1192,619],{"class":435},[429,1194,1195],{"class":524},"`ui.colors.neutral: 'slate'`",[429,1197,788],{"class":435},[429,1199,1201,1204,1207],{"class":431,"line":1200},70,[429,1202,1203],{"class":435},"| 标题字体 | 无衬线 | 衬线（Fraunces） | ",[429,1205,1206],{"class":524},"`theme.font: 'sans'`",[429,1208,788],{"class":435},[429,1210,1212,1215,1218,1220,1223,1225,1228,1230,1233],{"class":431,"line":1211},71,[429,1213,1214],{"class":435},"| 代码高亮 | Nuxt Content 默认 | ",[429,1216,1217],{"class":524},"`github-light`",[429,1219,580],{"class":435},[429,1221,1222],{"class":524},"`github-dark`",[429,1224,776],{"class":435},[429,1226,1227],{"class":524},"`nuxt.config.ts`",[429,1229,1187],{"class":435},[429,1231,1232],{"class":524},"`content.build.markdown.highlight.theme`",[429,1234,788],{"class":435},[429,1236,1238],{"class":431,"line":1237},72,[429,1239,456],{"emptyLinePlaceholder":455},[429,1241,1243],{"class":431,"line":1242},73,[429,1244,1245],{"class":435},"项目已显式配置的颜色、字体、高亮主题保持不变。\n",[429,1247,1249],{"class":431,"line":1248},74,[429,1250,456],{"emptyLinePlaceholder":455},[429,1252,1254],{"class":431,"line":1253},75,[429,1255,1256],{"class":548},"### 7. 组件覆盖\n",[429,1258,1260],{"class":431,"line":1259},76,[429,1261,456],{"emptyLinePlaceholder":455},[429,1263,1265,1268,1271],{"class":431,"line":1264},77,[429,1266,1267],{"class":435},"在 ",[429,1269,1270],{"class":524},"`app\u002Fcomponents\u002F`",[429,1272,1273],{"class":435}," 中查找与 Layer 同名的覆盖组件：\n",[429,1275,1277],{"class":431,"line":1276},78,[429,1278,456],{"emptyLinePlaceholder":455},[429,1280,1282,1284,1287,1290],{"class":431,"line":1281},79,[429,1283,560],{"class":484},[429,1285,1286],{"class":435}," 可覆盖的组件、挂载位置与 props 以文档「自定义」页的覆盖契约表为准，未列出的（如 ",[429,1288,1289],{"class":524},"`ThemePickerButton`",[429,1291,1292],{"class":435},"）属于内部实现，提示我需要人工确认\n",[429,1294,1296,1298],{"class":431,"line":1295},80,[429,1297,560],{"class":484},[429,1299,1300],{"class":435}," 页头、侧栏、目录、上下篇、页脚结构已重做；覆盖过这些组件或在 CSS 中依赖其 DOM 结构的，标记出来交给我确认\n",[429,1302,1304,1306,1309],{"class":431,"line":1303},81,[429,1305,560],{"class":484},[429,1307,1308],{"class":524}," `PageHeaderLinks`",[429,1310,1311],{"class":435}," 的挂载位置改到文档页导语下方的元信息行\n",[429,1313,1315,1317,1320,1323,1326,1328],{"class":431,"line":1314},82,[429,1316,560],{"class":484},[429,1318,1319],{"class":435}," Layer 覆盖了 Nuxt UI 的 ",[429,1321,1322],{"class":524},"`ProsePre`",[429,1324,1325],{"class":435},"；项目自己的 ",[429,1327,1322],{"class":524},[429,1329,1330],{"class":435}," 覆盖仍然优先，无需改动\n",[429,1332,1334],{"class":431,"line":1333},83,[429,1335,456],{"emptyLinePlaceholder":455},[429,1337,1339],{"class":431,"line":1338},84,[429,1340,1341],{"class":548},"### 8. 删除的 API\n",[429,1343,1345],{"class":431,"line":1344},85,[429,1346,456],{"emptyLinePlaceholder":455},[429,1348,1350,1352,1355,1358,1361,1364,1367],{"class":431,"line":1349},86,[429,1351,560],{"class":484},[429,1353,1354],{"class":435}," 删除 ",[429,1356,1357],{"class":524},"`HeroBackground`",[429,1359,1360],{"class":435}," 组件的所有引用，以及 ",[429,1362,1363],{"class":524},"`definePageMeta({ heroBackground: ... })`",[429,1365,1366],{"class":435}," 中的 ",[429,1368,1369],{"class":524},"`heroBackground`\n",[429,1371,1373,1375,1378,1381,1384,1387,1390,1393,1396,1399,1402,1404],{"class":431,"line":1372},87,[429,1374,560],{"class":484},[429,1376,1377],{"class":435}," 在项目中覆盖 ",[429,1379,1380],{"class":524},"`useToolCall`",[429,1382,1383],{"class":435}," 时，",[429,1385,1386],{"class":524},"`state`",[429,1388,1389],{"class":435}," 参数类型由 ",[429,1391,1392],{"class":524},"`ToolState`",[429,1394,1395],{"class":435}," 改为 ",[429,1397,1398],{"class":524},"`string`",[429,1400,1401],{"class":435},"，并删除不再使用的 ",[429,1403,1392],{"class":524},[429,1405,1406],{"class":435}," 导入\n",[429,1408,1410],{"class":431,"line":1409},88,[429,1411,456],{"emptyLinePlaceholder":455},[429,1413,1415],{"class":431,"line":1414},89,[429,1416,1417],{"class":548},"## 验证\n",[429,1419,1421],{"class":431,"line":1420},90,[429,1422,456],{"emptyLinePlaceholder":455},[429,1424,1426,1428,1431,1433,1436,1439],{"class":431,"line":1425},91,[429,1427,485],{"class":484},[429,1429,1430],{"class":435}," 运行 ",[429,1432,525],{"class":524},[429,1434,1435],{"class":435},"。出现「已启用的功能缺少依赖」时按提示安装；出现 ",[429,1437,1438],{"class":524},"`[request error]`",[429,1440,1441],{"class":435}," 日志说明有死链，修正对应链接\n",[429,1443,1445,1447],{"class":431,"line":1444},92,[429,1446,500],{"class":484},[429,1448,1449],{"class":435}," 运行项目的类型检查与测试\n",[429,1451,1453,1455],{"class":431,"line":1452},93,[429,1454,509],{"class":484},[429,1456,1457],{"class":435}," 启动开发服务器，抽查首页、一篇文档页与使用组件文档的页面\n",[357,1459,382],{"id":382},[345,1461,1462,1463,414],{},"v3 把默认关闭的功能改为 optional peer 依赖，Layer 的直接依赖由 47 个降到 35 个。启用某项功能而未安装依赖时，构建期报错并给出安装命令。完整说明见 ",[379,1464,77],{"href":78},[1466,1467,1468],"h3",{"id":1468},"组件文档默认关闭",[345,1470,1471,619,1473,619,1475,619,1477,619,1479,1481],{},[368,1472,198],{},[368,1474,204],{},[368,1476,210],{},[368,1478,222],{},[368,1480,216],{}," 需要显式开启：",[1483,1484,1485,1542],"code-group",{},[420,1486,1491],{"className":1487,"code":1488,"filename":1489,"language":1490,"meta":425,"style":425},"language-ts shiki shiki-themes github-light github-light github-dark","export default defineNuxtConfig({\n  extends: ['@movk\u002Fnuxt-docs'],\n  movkNuxtDocs: {\n    componentDocs: true\n  }\n})\n","v3 nuxt.config.ts","ts",[368,1492,1493,1508,1519,1524,1532,1537],{"__ignoreMap":425},[429,1494,1495,1499,1502,1505],{"class":431,"line":432},[429,1496,1498],{"class":1497},"s8jYJ","export",[429,1500,1501],{"class":1497}," default",[429,1503,1504],{"class":680}," defineNuxtConfig",[429,1506,1507],{"class":435},"({\n",[429,1509,1510,1513,1516],{"class":431,"line":452},[429,1511,1512],{"class":435},"  extends: [",[429,1514,1515],{"class":684},"'@movk\u002Fnuxt-docs'",[429,1517,1518],{"class":435},"],\n",[429,1520,1521],{"class":431,"line":459},[429,1522,1523],{"class":435},"  movkNuxtDocs: {\n",[429,1525,1526,1529],{"class":431,"line":465},[429,1527,1528],{"class":435},"    componentDocs: ",[429,1530,1531],{"class":524},"true\n",[429,1533,1534],{"class":431,"line":470},[429,1535,1536],{"class":435},"  }\n",[429,1538,1539],{"class":431,"line":476},[429,1540,1541],{"class":435},"})\n",[420,1543,1548],{"className":1544,"code":1545,"filename":1546,"language":1547,"meta":425,"style":425},"language-bash shiki shiki-themes github-light github-light github-dark","pnpm add nuxt-component-meta vue-component-meta prettier\n","安装依赖","bash",[368,1549,1550],{"__ignoreMap":425},[429,1551,1552,1554,1556,1559,1562],{"class":431,"line":432},[429,1553,681],{"class":680},[429,1555,685],{"class":684},[429,1557,1558],{"class":684}," nuxt-component-meta",[429,1560,1561],{"class":684}," vue-component-meta",[429,1563,1564],{"class":684}," prettier\n",[1466,1566,1568],{"id":1567},"ai-chat无障碍检查与国际化需自行安装依赖","AI Chat、无障碍检查与国际化需自行安装依赖",[345,1570,1571,1572,1575,1576,1579],{},"AI Chat 的开启条件不变：构建期存在 ",[368,1573,1574],{},"AI_API_KEY"," 或设置 ",[368,1577,1578],{},"aiChat.enabled: true","。区别是依赖不再随 Layer 安装：",[420,1581,1583],{"className":1544,"code":1582,"language":1547,"meta":425,"style":425},"# AI Chat\npnpm add ai @ai-sdk\u002Fopenai @ai-sdk\u002Fvue @comark\u002Fvue @shikijs\u002Fengine-javascript @shikijs\u002Flangs @shikijs\u002Fthemes\n# movkNuxtDocs.a11y: true\npnpm add @nuxt\u002Fa11y\n# 在 modules 中启用 @nuxtjs\u002Fi18n\npnpm add @nuxtjs\u002Fi18n\n",[368,1584,1585,1591,1618,1623,1632,1637],{"__ignoreMap":425},[429,1586,1587],{"class":431,"line":432},[429,1588,1590],{"class":1589},"sCsY4","# AI Chat\n",[429,1592,1593,1595,1597,1600,1603,1606,1609,1612,1615],{"class":431,"line":452},[429,1594,681],{"class":680},[429,1596,685],{"class":684},[429,1598,1599],{"class":684}," ai",[429,1601,1602],{"class":684}," @ai-sdk\u002Fopenai",[429,1604,1605],{"class":684}," @ai-sdk\u002Fvue",[429,1607,1608],{"class":684}," @comark\u002Fvue",[429,1610,1611],{"class":684}," @shikijs\u002Fengine-javascript",[429,1613,1614],{"class":684}," @shikijs\u002Flangs",[429,1616,1617],{"class":684}," @shikijs\u002Fthemes\n",[429,1619,1620],{"class":431,"line":459},[429,1621,1622],{"class":1589},"# movkNuxtDocs.a11y: true\n",[429,1624,1625,1627,1629],{"class":431,"line":465},[429,1626,681],{"class":680},[429,1628,685],{"class":684},[429,1630,1631],{"class":684}," @nuxt\u002Fa11y\n",[429,1633,1634],{"class":431,"line":470},[429,1635,1636],{"class":1589},"# 在 modules 中启用 @nuxtjs\u002Fi18n\n",[429,1638,1639,1641,1643],{"class":431,"line":476},[429,1640,681],{"class":680},[429,1642,685],{"class":684},[429,1644,1645],{"class":684}," @nuxtjs\u002Fi18n\n",[345,1647,1648,1651,1652,414],{},[368,1649,1650],{},"@nuxt\u002Fa11y"," 在 v3 中默认关闭，需要设置 ",[368,1653,1654],{},"movkNuxtDocs.a11y: true",[1466,1656,1658],{"id":1657},"mermaid-缺少依赖时构建失败","Mermaid 缺少依赖时构建失败",[345,1660,1661,1662,580,1665,1668],{},"v2 中开启 Mermaid 但未安装 ",[368,1663,1664],{},"mermaid",[368,1666,1667],{},"dompurify"," 时会静默跳过，v3 改为构建报错：",[420,1670,1672],{"className":1544,"code":1671,"language":1547,"meta":425,"style":425},"pnpm add mermaid dompurify\n",[368,1673,1674],{"__ignoreMap":425},[429,1675,1676,1678,1680,1683],{"class":431,"line":432},[429,1677,681],{"class":680},[429,1679,685],{"class":684},[429,1681,1682],{"class":684}," mermaid",[429,1684,1685],{"class":684}," dompurify\n",[1466,1687,1689],{"id":1688},"启用-ai-chat-时不能关闭-mcp","启用 AI Chat 时不能关闭 MCP",[345,1691,1692],{},"AI Chat 通过 MCP Server 检索文档。同时设置以下两项会在构建期抛错：",[420,1694,1697],{"className":1487,"code":1695,"filename":1696,"language":1490,"meta":425,"style":425},"export default defineNuxtConfig({\n  aiChat: { enabled: true },\n  movkNuxtDocs: {\n    mcp: false \u002F\u002F 报错：aiChat 依赖 MCP Server\n  }\n})\n","nuxt.config.ts",[368,1698,1699,1709,1720,1724,1735,1739],{"__ignoreMap":425},[429,1700,1701,1703,1705,1707],{"class":431,"line":432},[429,1702,1498],{"class":1497},[429,1704,1501],{"class":1497},[429,1706,1504],{"class":680},[429,1708,1507],{"class":435},[429,1710,1711,1714,1717],{"class":431,"line":452},[429,1712,1713],{"class":435},"  aiChat: { enabled: ",[429,1715,1716],{"class":524},"true",[429,1718,1719],{"class":435}," },\n",[429,1721,1722],{"class":431,"line":459},[429,1723,1523],{"class":435},[429,1725,1726,1729,1732],{"class":431,"line":465},[429,1727,1728],{"class":435},"    mcp: ",[429,1730,1731],{"class":524},"false",[429,1733,1734],{"class":1589}," \u002F\u002F 报错：aiChat 依赖 MCP Server\n",[429,1736,1737],{"class":431,"line":470},[429,1738,1536],{"class":435},[429,1740,1741],{"class":431,"line":476},[429,1742,1541],{"class":435},[357,1744,1745],{"id":1745},"内容目录",[345,1747,1748,1749,1751,1752,956,1755,1757,1758,1760],{},"文档必须放在 ",[368,1750,389],{},"，其他语言放在 ",[368,1753,1754],{},"content\u002F{locale}\u002Fdocs\u002F",[368,1756,6],{},"。v2 在缺少 ",[368,1759,389],{}," 时会把文档挂到根路径，但该分支下文档页实际无法访问，v3 已移除。",[420,1762,1764],{"className":1544,"code":1763,"language":1547,"meta":425,"style":425},"# v2：直接放在 content\u002F 下\ncontent\u002F\n├── 1.getting-started\u002F\n└── 2.guide\u002F\n\n# v3：移入 content\u002Fdocs\u002F\ncontent\u002F\n└── docs\u002F\n    ├── 1.getting-started\u002F\n    └── 2.guide\u002F\n",[368,1765,1766,1771,1776,1784,1792,1796,1801,1805,1812,1819],{"__ignoreMap":425},[429,1767,1768],{"class":431,"line":432},[429,1769,1770],{"class":1589},"# v2：直接放在 content\u002F 下\n",[429,1772,1773],{"class":431,"line":452},[429,1774,1775],{"class":680},"content\u002F\n",[429,1777,1778,1781],{"class":431,"line":459},[429,1779,1780],{"class":680},"├──",[429,1782,1783],{"class":684}," 1.getting-started\u002F\n",[429,1785,1786,1789],{"class":431,"line":465},[429,1787,1788],{"class":680},"└──",[429,1790,1791],{"class":684}," 2.guide\u002F\n",[429,1793,1794],{"class":431,"line":470},[429,1795,456],{"emptyLinePlaceholder":455},[429,1797,1798],{"class":431,"line":476},[429,1799,1800],{"class":1589},"# v3：移入 content\u002Fdocs\u002F\n",[429,1802,1803],{"class":431,"line":481},[429,1804,1775],{"class":680},[429,1806,1807,1809],{"class":431,"line":497},[429,1808,1788],{"class":680},[429,1810,1811],{"class":684}," docs\u002F\n",[429,1813,1814,1817],{"class":431,"line":506},[429,1815,1816],{"class":680},"    ├──",[429,1818,1783],{"class":684},[429,1820,1821,1824],{"class":431,"line":515},[429,1822,1823],{"class":680},"    └──",[429,1825,1791],{"class":684},[345,1827,1828,1829,1831],{},"缺少 ",[368,1830,389],{}," 时，构建日志会输出警告。",[357,1833,1834],{"id":1834},"配置字段",[1466,1836,1838,1042,1841],{"id":1837},"githubper_page-重命名为-githubperpage",[368,1839,1840],{},"github.per_page",[368,1842,1843],{},"github.perPage",[420,1845,1850],{"className":1846,"code":1847,"filename":1848,"language":1849,"meta":425,"style":425},"language-diff shiki shiki-themes github-light github-light github-dark","export default defineAppConfig({\n  github: {\n-   per_page: 50\n+   perPage: 50\n  }\n})\n","app\u002Fapp.config.ts","diff",[368,1851,1852,1857,1862,1868,1874,1878],{"__ignoreMap":425},[429,1853,1854],{"class":431,"line":432},[429,1855,1856],{"class":435},"export default defineAppConfig({\n",[429,1858,1859],{"class":431,"line":452},[429,1860,1861],{"class":435},"  github: {\n",[429,1863,1864],{"class":431,"line":459},[429,1865,1867],{"class":1866},"s8CdH","-   per_page: 50\n",[429,1869,1870],{"class":431,"line":465},[429,1871,1873],{"class":1872},"sovSZ","+   perPage: 50\n",[429,1875,1876],{"class":431,"line":470},[429,1877,1536],{"class":435},[429,1879,1880],{"class":431,"line":476},[429,1881,1541],{"class":435},[1466,1883,1884],{"id":1884},"不再默认过滤提交日期",[345,1886,1887,1888,1891,1892,619,1895,1898,1899,580,1902,1905],{},"v2 默认 ",[368,1889,1890],{},"since"," 为 ",[368,1893,1894],{},"2025-01-31",[368,1896,1897],{},"until"," 为构建时刻，早于该日期与构建之后的提交都看不到。v3 的 ",[368,1900,1901],{},"github.since",[368,1903,1904],{},"github.until"," 默认留空，不做限制。需要限定范围时显式设置：",[420,1907,1909],{"className":1487,"code":1908,"filename":1848,"language":1490,"meta":425,"style":425},"export default defineAppConfig({\n  github: {\n    since: '2025-01-01T00:00:00Z'\n  }\n})\n",[368,1910,1911,1922,1926,1934,1938],{"__ignoreMap":425},[429,1912,1913,1915,1917,1920],{"class":431,"line":432},[429,1914,1498],{"class":1497},[429,1916,1501],{"class":1497},[429,1918,1919],{"class":680}," defineAppConfig",[429,1921,1507],{"class":435},[429,1923,1924],{"class":431,"line":452},[429,1925,1861],{"class":435},[429,1927,1928,1931],{"class":431,"line":459},[429,1929,1930],{"class":435},"    since: ",[429,1932,1933],{"class":684},"'2025-01-01T00:00:00Z'\n",[429,1935,1936],{"class":431,"line":465},[429,1937,1536],{"class":435},[429,1939,1940],{"class":431,"line":470},[429,1941,1541],{"class":435},[1466,1943,1944],{"id":1944},"移除作者私有的默认值",[345,1946,1947],{},"v3 发布包不再携带以下默认值，需要时在自己的配置中设置：",[1949,1950,1951,1967],"table",{},[1952,1953,1954],"thead",{},[1955,1956,1957,1961,1964],"tr",{},[1958,1959,1960],"th",{},"v2 默认",[1958,1962,1963],{},"v3 默认",[1958,1965,1966],{},"恢复方式",[1968,1969,1970,1989,2008],"tbody",{},[1955,1971,1972,1979,1984],{},[1973,1974,1975,1978],"td",{},[368,1976,1977],{},"header.avatar"," 指向作者头像",[1973,1980,1981],{},[368,1982,1983],{},"''",[1973,1985,1986,1987],{},"设置 ",[368,1988,1977],{},[1955,1990,1991,1996,1999],{},[1973,1992,1993],{},[368,1994,1995],{},"github.dateFormat.options.timeZone: 'Asia\u002FShanghai'",[1973,1997,1998],{},"不指定时区",[1973,2000,1267,2001,2004,2005],{},[368,2002,2003],{},"github.dateFormat.options"," 中设置 ",[368,2006,2007],{},"timeZone",[1955,2009,2010,2013,2016],{},[1973,2011,2012],{},"加载 Alibaba PuHuiTi 字体 CDN",[1973,2014,2015],{},"不加载",[1973,2017,2018,2019],{},"见下文 ",[379,2020,2022],{"href":2021},"#%E5%AD%97%E4%BD%93","字体",[357,2024,2025],{"id":2025},"页头导航与侧栏分类",[345,2027,2028,2029,2032,2033,580,2035,2037,2038,2040],{},"v2 通过在 ",[368,2030,2031],{},"app\u002Fcomposables\u002F"," 中覆盖 ",[368,2034,299],{},[368,2036,305],{}," 定义导航。v3 推荐在 ",[368,2039,395],{}," 中声明，文案可按语言区分，站内链接自动加语言前缀并计算激活状态。旧写法仍然可用。",[1483,2042,2043,2138],{},[420,2044,2047],{"className":1487,"code":2045,"filename":2046,"language":1490,"meta":425,"style":425},"export function useHeader() {\n  const desktopLinks = computed(() => [\n    { label: '文档', to: '\u002Fdocs\u002Fgetting-started', active: useRoute().path.startsWith('\u002Fdocs') }\n  ])\n  return { desktopLinks, mobileLinks: desktopLinks }\n}\n","v2 app\u002Fcomposables\u002FuseHeader.ts",[368,2048,2049,2062,2085,2120,2125,2133],{"__ignoreMap":425},[429,2050,2051,2053,2056,2059],{"class":431,"line":432},[429,2052,1498],{"class":1497},[429,2054,2055],{"class":1497}," function",[429,2057,2058],{"class":680}," useHeader",[429,2060,2061],{"class":435},"() {\n",[429,2063,2064,2067,2070,2073,2076,2079,2082],{"class":431,"line":452},[429,2065,2066],{"class":1497},"  const",[429,2068,2069],{"class":524}," desktopLinks",[429,2071,2072],{"class":1497}," =",[429,2074,2075],{"class":680}," computed",[429,2077,2078],{"class":435},"(() ",[429,2080,2081],{"class":1497},"=>",[429,2083,2084],{"class":435}," [\n",[429,2086,2087,2090,2093,2096,2099,2102,2105,2108,2111,2114,2117],{"class":431,"line":459},[429,2088,2089],{"class":435},"    { label: ",[429,2091,2092],{"class":684},"'文档'",[429,2094,2095],{"class":435},", to: ",[429,2097,2098],{"class":684},"'\u002Fdocs\u002Fgetting-started'",[429,2100,2101],{"class":435},", active: ",[429,2103,2104],{"class":680},"useRoute",[429,2106,2107],{"class":435},"().path.",[429,2109,2110],{"class":680},"startsWith",[429,2112,2113],{"class":435},"(",[429,2115,2116],{"class":684},"'\u002Fdocs'",[429,2118,2119],{"class":435},") }\n",[429,2121,2122],{"class":431,"line":465},[429,2123,2124],{"class":435},"  ])\n",[429,2126,2127,2130],{"class":431,"line":470},[429,2128,2129],{"class":1497},"  return",[429,2131,2132],{"class":435}," { desktopLinks, mobileLinks: desktopLinks }\n",[429,2134,2135],{"class":431,"line":476},[429,2136,2137],{"class":435},"}\n",[420,2139,2142],{"className":1487,"code":2140,"filename":2141,"language":1490,"meta":425,"style":425},"export default defineAppConfig({\n  header: {\n    nav: [\n      { label: { 'zh-CN': '文档', 'en': 'Docs' }, to: '\u002Fdocs\u002Fgetting-started', activeMatch: '\u002Fdocs' }\n    ]\n  },\n  docs: {\n    categories: {\n      guide: [\n        { id: 'basics', title: { 'zh-CN': '基础', 'en': 'Basics' }, icon: 'i-lucide-settings' }\n      ]\n    }\n  }\n})\n","v3 app\u002Fapp.config.ts",[368,2143,2144,2154,2159,2164,2201,2206,2211,2216,2221,2226,2265,2270,2275,2279],{"__ignoreMap":425},[429,2145,2146,2148,2150,2152],{"class":431,"line":432},[429,2147,1498],{"class":1497},[429,2149,1501],{"class":1497},[429,2151,1919],{"class":680},[429,2153,1507],{"class":435},[429,2155,2156],{"class":431,"line":452},[429,2157,2158],{"class":435},"  header: {\n",[429,2160,2161],{"class":431,"line":459},[429,2162,2163],{"class":435},"    nav: [\n",[429,2165,2166,2169,2172,2175,2177,2180,2183,2185,2188,2191,2193,2196,2198],{"class":431,"line":465},[429,2167,2168],{"class":435},"      { label: { ",[429,2170,2171],{"class":684},"'zh-CN'",[429,2173,2174],{"class":435},": ",[429,2176,2092],{"class":684},[429,2178,2179],{"class":435},", ",[429,2181,2182],{"class":684},"'en'",[429,2184,2174],{"class":435},[429,2186,2187],{"class":684},"'Docs'",[429,2189,2190],{"class":435}," }, to: ",[429,2192,2098],{"class":684},[429,2194,2195],{"class":435},", activeMatch: ",[429,2197,2116],{"class":684},[429,2199,2200],{"class":435}," }\n",[429,2202,2203],{"class":431,"line":470},[429,2204,2205],{"class":435},"    ]\n",[429,2207,2208],{"class":431,"line":476},[429,2209,2210],{"class":435},"  },\n",[429,2212,2213],{"class":431,"line":481},[429,2214,2215],{"class":435},"  docs: {\n",[429,2217,2218],{"class":431,"line":497},[429,2219,2220],{"class":435},"    categories: {\n",[429,2222,2223],{"class":431,"line":506},[429,2224,2225],{"class":435},"      guide: [\n",[429,2227,2228,2231,2234,2237,2239,2241,2244,2246,2248,2250,2253,2256,2263],{"class":431,"line":515},[429,2229,2230],{"class":435},"        { id: ",[429,2232,2233],{"class":684},"'basics'",[429,2235,2236],{"class":435},", title: { ",[429,2238,2171],{"class":684},[429,2240,2174],{"class":435},[429,2242,2243],{"class":684},"'基础'",[429,2245,2179],{"class":435},[429,2247,2182],{"class":684},[429,2249,2174],{"class":435},[429,2251,2252],{"class":684},"'Basics'",[429,2254,2255],{"class":435}," }, icon: ",[429,2257,2258,2262],{"class":684},[2259,2260],"i",{"class":2261},"shiki-icon-highlight sFRD0","'i-lucide-settings'",[429,2264,2200],{"class":435},[429,2266,2267],{"class":431,"line":531},[429,2268,2269],{"class":435},"      ]\n",[429,2271,2272],{"class":431,"line":540},[429,2273,2274],{"class":435},"    }\n",[429,2276,2277],{"class":431,"line":545},[429,2278,1536],{"class":435},[429,2280,2281],{"class":431,"line":552},[429,2282,1541],{"class":435},[345,2284,2285,2286,414],{},"字段说明见 ",[379,2287,71],{"href":72},[357,2289,2290],{"id":2290},"视觉默认值",[345,2292,2293],{},"v3 以编辑式排版作为默认外观。想保留 v2 的样子，可以逐项改回。",[1466,2295,2296],{"id":2296},"主色与中性色",[345,2298,2299,2300,1395,2303,2306,2307,1395,2310,2313],{},"默认主色由 ",[368,2301,2302],{},"green",[368,2304,2305],{},"vermilion","，中性色由 ",[368,2308,2309],{},"slate",[368,2311,2312],{},"paper","，背景不再是纯白：",[420,2315,2317],{"className":1487,"code":2316,"filename":1848,"language":1490,"meta":425,"style":425},"export default defineAppConfig({\n  ui: {\n    colors: {\n      primary: 'green',\n      neutral: 'slate'\n    }\n  }\n})\n",[368,2318,2319,2329,2334,2339,2350,2358,2362,2366],{"__ignoreMap":425},[429,2320,2321,2323,2325,2327],{"class":431,"line":432},[429,2322,1498],{"class":1497},[429,2324,1501],{"class":1497},[429,2326,1919],{"class":680},[429,2328,1507],{"class":435},[429,2330,2331],{"class":431,"line":452},[429,2332,2333],{"class":435},"  ui: {\n",[429,2335,2336],{"class":431,"line":459},[429,2337,2338],{"class":435},"    colors: {\n",[429,2340,2341,2344,2347],{"class":431,"line":465},[429,2342,2343],{"class":435},"      primary: ",[429,2345,2346],{"class":684},"'green'",[429,2348,2349],{"class":435},",\n",[429,2351,2352,2355],{"class":431,"line":470},[429,2353,2354],{"class":435},"      neutral: ",[429,2356,2357],{"class":684},"'slate'\n",[429,2359,2360],{"class":431,"line":476},[429,2361,2274],{"class":435},[429,2363,2364],{"class":431,"line":481},[429,2365,1536],{"class":435},[429,2367,2368],{"class":431,"line":497},[429,2369,1541],{"class":435},[1466,2371,2022],{"id":2022},[345,2373,2374],{},"Layer 默认加载 Inter、Fraunces 与 JetBrains Mono（仅拉丁字符），标题使用衬线体。改回全站无衬线：",[420,2376,2378],{"className":1487,"code":2377,"filename":1848,"language":1490,"meta":425,"style":425},"export default defineAppConfig({\n  theme: {\n    font: 'sans'\n  }\n})\n",[368,2379,2380,2390,2395,2403,2407],{"__ignoreMap":425},[429,2381,2382,2384,2386,2388],{"class":431,"line":432},[429,2383,1498],{"class":1497},[429,2385,1501],{"class":1497},[429,2387,1919],{"class":680},[429,2389,1507],{"class":435},[429,2391,2392],{"class":431,"line":452},[429,2393,2394],{"class":435},"  theme: {\n",[429,2396,2397,2400],{"class":431,"line":459},[429,2398,2399],{"class":435},"    font: ",[429,2401,2402],{"class":684},"'sans'\n",[429,2404,2405],{"class":431,"line":465},[429,2406,1536],{"class":435},[429,2408,2409],{"class":431,"line":470},[429,2410,1541],{"class":435},[345,2412,2413,2414,2417],{},"v2 自动加载的 Alibaba PuHuiTi 中文字体 CDN 已移除。字体栈仍会优先使用 ",[368,2415,2416],{},"Alibaba PuHuiTi","，自行引入样式表即可生效：",[420,2419,2421],{"className":1487,"code":2420,"filename":1696,"language":1490,"meta":425,"style":425},"export default defineNuxtConfig({\n  app: {\n    head: {\n      link: [\n        { rel: 'stylesheet', href: 'https:\u002F\u002Fyour-cdn.example.com\u002Ffonts\u002Falibaba-puhuiti.css' }\n      ]\n    }\n  }\n})\n",[368,2422,2423,2433,2438,2443,2448,2464,2468,2472,2476],{"__ignoreMap":425},[429,2424,2425,2427,2429,2431],{"class":431,"line":432},[429,2426,1498],{"class":1497},[429,2428,1501],{"class":1497},[429,2430,1504],{"class":680},[429,2432,1507],{"class":435},[429,2434,2435],{"class":431,"line":452},[429,2436,2437],{"class":435},"  app: {\n",[429,2439,2440],{"class":431,"line":459},[429,2441,2442],{"class":435},"    head: {\n",[429,2444,2445],{"class":431,"line":465},[429,2446,2447],{"class":435},"      link: [\n",[429,2449,2450,2453,2456,2459,2462],{"class":431,"line":470},[429,2451,2452],{"class":435},"        { rel: ",[429,2454,2455],{"class":684},"'stylesheet'",[429,2457,2458],{"class":435},", href: ",[429,2460,2461],{"class":684},"'https:\u002F\u002Fyour-cdn.example.com\u002Ffonts\u002Falibaba-puhuiti.css'",[429,2463,2200],{"class":435},[429,2465,2466],{"class":431,"line":476},[429,2467,2269],{"class":435},[429,2469,2470],{"class":431,"line":481},[429,2471,2274],{"class":435},[429,2473,2474],{"class":431,"line":497},[429,2475,1536],{"class":435},[429,2477,2478],{"class":431,"line":506},[429,2479,1541],{"class":435},[345,2481,2482,2483,414],{},"中文衬线标题的引入方法见 ",[379,2484,65],{"href":66},[1466,2486,2487],{"id":2487},"代码高亮主题",[345,2489,2490,2491,580,2494,2497,2498,2500],{},"代码块高亮由 Nuxt Content 默认主题改为 ",[368,2492,2493],{},"github-light",[368,2495,2496],{},"github-dark","。需要其他主题时在 ",[368,2499,1696],{}," 中覆盖：",[420,2502,2504],{"className":1487,"code":2503,"filename":1696,"language":1490,"meta":425,"style":425},"export default defineNuxtConfig({\n  content: {\n    build: {\n      markdown: {\n        highlight: {\n          theme: { default: 'material-theme-lighter', dark: 'material-theme-palenight' }\n        }\n      }\n    }\n  }\n})\n",[368,2505,2506,2516,2521,2526,2531,2536,2552,2557,2562,2566,2570],{"__ignoreMap":425},[429,2507,2508,2510,2512,2514],{"class":431,"line":432},[429,2509,1498],{"class":1497},[429,2511,1501],{"class":1497},[429,2513,1504],{"class":680},[429,2515,1507],{"class":435},[429,2517,2518],{"class":431,"line":452},[429,2519,2520],{"class":435},"  content: {\n",[429,2522,2523],{"class":431,"line":459},[429,2524,2525],{"class":435},"    build: {\n",[429,2527,2528],{"class":431,"line":465},[429,2529,2530],{"class":435},"      markdown: {\n",[429,2532,2533],{"class":431,"line":470},[429,2534,2535],{"class":435},"        highlight: {\n",[429,2537,2538,2541,2544,2547,2550],{"class":431,"line":476},[429,2539,2540],{"class":435},"          theme: { default: ",[429,2542,2543],{"class":684},"'material-theme-lighter'",[429,2545,2546],{"class":435},", dark: ",[429,2548,2549],{"class":684},"'material-theme-palenight'",[429,2551,2200],{"class":435},[429,2553,2554],{"class":431,"line":481},[429,2555,2556],{"class":435},"        }\n",[429,2558,2559],{"class":431,"line":497},[429,2560,2561],{"class":435},"      }\n",[429,2563,2564],{"class":431,"line":506},[429,2565,2274],{"class":435},[429,2567,2568],{"class":431,"line":515},[429,2569,1536],{"class":435},[429,2571,2572],{"class":431,"line":531},[429,2573,1541],{"class":435},[357,2575,2576],{"id":2576},"组件覆盖",[1466,2578,2579],{"id":2579},"以覆盖契约为准",[345,2581,2582,2583,2585,2586,2589],{},"v3 起，可覆盖的组件、挂载位置与 props 以 ",[379,2584,83],{"href":84}," 页的覆盖契约表为准，在 v3.x 内保持稳定。未列出的组件（如 ",[368,2587,2588],{},"ThemePickerButton","）属于内部实现，可能随版本调整。",[1466,2591,2592],{"id":2592},"页面结构重做",[345,2594,2595],{},"页头、侧栏、目录、上下篇与页脚的结构和样式均已重做。如果你覆盖过这些组件，或在 CSS 中依赖它们的 DOM 结构，需要对照新实现调整：",[2597,2598,2599,2602,2608],"ul",{},[364,2600,2601],{},"页头改为双行报头：字标、文字主导航与搜索框在上，编号栏目条在下",[364,2603,2604,2607],{},[368,2605,2606],{},"PageHeaderLinks"," 的挂载位置由页面标题右侧改为文档页导语下方的元信息行",[364,2609,2610],{},"侧栏当前项改为左侧朱红指示条",[1466,2612,2614,2615],{"id":2613},"layer-覆盖了-prosepre","Layer 覆盖了 ",[368,2616,2617],{},"ProsePre",[345,2619,2620,2621,2623,2624,2626],{},"Layer 覆盖了 Nuxt UI 的 ",[368,2622,2617],{},"，复制按钮会显示「复制 \u002F 已复制」文字。你在项目中自行覆盖 ",[368,2625,2617],{}," 时，以你的实现为准。",[1466,2628,2630,2631],{"id":2629},"移除-herobackground","移除 ",[368,2632,2633],{},"HeroBackground",[345,2635,2636,2638,2639,2642],{},[368,2637,2633],{}," 组件与页面 meta ",[368,2640,2641],{},"heroBackground"," 已删除，删除对它们的引用即可：",[420,2644,2647],{"className":1846,"code":2645,"filename":2646,"language":1849,"meta":425,"style":425},"\u003Cscript setup lang=\"ts\">\n- definePageMeta({ heroBackground: 'opacity-30' })\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n- \u003CHeroBackground \u002F>\n  \u003CContentRenderer :value=\"page\" \u002F>\n\u003C\u002Ftemplate>\n","app\u002Fpages\u002Findex.vue",[368,2648,2649,2654,2659,2664,2668,2673,2678,2683],{"__ignoreMap":425},[429,2650,2651],{"class":431,"line":432},[429,2652,2653],{"class":435},"\u003Cscript setup lang=\"ts\">\n",[429,2655,2656],{"class":431,"line":452},[429,2657,2658],{"class":1866},"- definePageMeta({ heroBackground: 'opacity-30' })\n",[429,2660,2661],{"class":431,"line":459},[429,2662,2663],{"class":435},"\u003C\u002Fscript>\n",[429,2665,2666],{"class":431,"line":465},[429,2667,456],{"emptyLinePlaceholder":455},[429,2669,2670],{"class":431,"line":470},[429,2671,2672],{"class":435},"\u003Ctemplate>\n",[429,2674,2675],{"class":431,"line":476},[429,2676,2677],{"class":1866},"- \u003CHeroBackground \u002F>\n",[429,2679,2680],{"class":431,"line":481},[429,2681,2682],{"class":435},"  \u003CContentRenderer :value=\"page\" \u002F>\n",[429,2684,2685],{"class":431,"line":497},[429,2686,2687],{"class":435},"\u003C\u002Ftemplate>\n",[1466,2689,2691,592,2694,2697],{"id":2690},"usetoolcall-的-state-类型放宽",[368,2692,2693],{},"useToolCall",[368,2695,2696],{},"state"," 类型放宽",[345,2699,2700,2701,1383,2703,2705,2706,2709,2710,2713,2714,2717],{},"在项目中覆盖 ",[368,2702,2693],{},[368,2704,2696],{}," 参数类型由 AI SDK 的 ",[368,2707,2708],{},"ToolState"," 放宽为 ",[368,2711,2712],{},"string","，避免核心代码依赖可选的 ",[368,2715,2716],{},"ai"," 包：",[420,2719,2722],{"className":1846,"code":2720,"filename":2721,"language":1849,"meta":425,"style":425},"-export function useToolCall(state: ToolState, toolName: string, input: Record\u003Cstring, string | undefined>) {\n+export function useToolCall(state: string, toolName: string, input: Record\u003Cstring, string | undefined>) {\n","app\u002Fcomposables\u002FuseToolCall.ts",[368,2723,2724,2729],{"__ignoreMap":425},[429,2725,2726],{"class":431,"line":432},[429,2727,2728],{"class":1866},"-export function useToolCall(state: ToolState, toolName: string, input: Record\u003Cstring, string | undefined>) {\n",[429,2730,2731],{"class":431,"line":452},[429,2732,2733],{"class":1872},"+export function useToolCall(state: string, toolName: string, input: Record\u003Cstring, string | undefined>) {\n",[2735,2736,2737],"style",{},"html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sEO0R, html code.shiki .sEO0R{--shiki-light:#24292E;--shiki-light-font-weight:bold;--shiki-default:#24292E;--shiki-default-font-weight:bold;--shiki-dark:#E1E4E8;--shiki-dark-font-weight:bold}html pre.shiki code .sP4rz, html code.shiki .sP4rz{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#FFAB70}html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .syb_3, html code.shiki .syb_3{--shiki-light:#005CC5;--shiki-light-font-weight:bold;--shiki-default:#005CC5;--shiki-default-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold}html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .s8CdH, html code.shiki .s8CdH{--shiki-light:#B31D28;--shiki-default:#B31D28;--shiki-dark:#FDAEB7}html pre.shiki code .sovSZ, html code.shiki .sovSZ{--shiki-light:#22863A;--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .sFRD0, html code.shiki .sFRD0{--shiki-icon-url:url(https:\u002F\u002Fapi.iconify.design\u002Flucide\u002Fsettings.svg?color=%23000)}",{"title":425,"searchDepth":452,"depth":452,"links":2739},[2740,2741,2742,2748,2749,2755,2756,2761],{"id":359,"depth":452,"text":359},{"id":406,"depth":452,"text":407},{"id":382,"depth":452,"text":382,"children":2743},[2744,2745,2746,2747],{"id":1468,"depth":459,"text":1468},{"id":1567,"depth":459,"text":1568},{"id":1657,"depth":459,"text":1658},{"id":1688,"depth":459,"text":1689},{"id":1745,"depth":452,"text":1745},{"id":1834,"depth":452,"text":1834,"children":2750},[2751,2753,2754],{"id":1837,"depth":459,"text":2752},"github.per_page 重命名为 github.perPage",{"id":1884,"depth":459,"text":1884},{"id":1944,"depth":459,"text":1944},{"id":2025,"depth":452,"text":2025},{"id":2290,"depth":452,"text":2290,"children":2757},[2758,2759,2760],{"id":2296,"depth":459,"text":2296},{"id":2022,"depth":459,"text":2022},{"id":2487,"depth":459,"text":2487},{"id":2576,"depth":452,"text":2576,"children":2762},[2763,2764,2765,2767,2769],{"id":2579,"depth":459,"text":2579},{"id":2592,"depth":459,"text":2592},{"id":2613,"depth":459,"text":2766},"Layer 覆盖了 ProsePre",{"id":2629,"depth":459,"text":2768},"移除 HeroBackground",{"id":2690,"depth":459,"text":2770},"useToolCall 的 state 类型放宽","intermediate",{},{"icon":36},"@movk\u002Fnuxt-docs 3.0",{"title":2776,"description":2777},"Migrating from v2","Upgrade @movk\u002Fnuxt-docs from v2 to v3 with a checklist of breaking changes covering feature flags, content paths, config fields, theme defaults and overrides.",{"loc":33},"Jfcz8K1DquDVb6F6qmpfE-Af_JINWesSjylX_P9VwWE",[2781,2782],{"title":26,"path":27,"stem":28,"description":29,"icon":30,"children":-1},{"title":45,"path":46,"stem":47,"description":49,"icon":50,"children":-1},{"data":2784,"body":2785},{},{"type":341,"children":2786},[2787],{"type":344,"tag":345,"props":2788,"children":2789},{},[2790],{"type":349,"value":35},1794996152633]