[{"data":1,"prerenderedAt":1146},["ShallowReactive",2],{"docs-navigation-zh-CN":3,"mdc--tctnej-key":338,"docs--docs-components-commit-changelog":351,"surround--docs-components-commit-changelog":952,"component-meta-CommitChangelog":955,"-docs-components-commit-changelog-description":1049,"-docs-components-commit-changelog-prop-commitPath-description":1066,"-docs-components-commit-changelog-prop-prefix-description":1074,"-docs-components-commit-changelog-prop-suffix-description":1082,"-docs-components-commit-changelog-prop-name-description":1090,"-docs-components-commit-changelog-prop-author-description":1098,"-docs-components-commit-changelog-prop-casing-description":1106,"-docs-components-commit-changelog-prop-files-description":1138},[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":228,"body":353,"category":16,"description":231,"difficulty":16,"extension":940,"index":113,"keywords":16,"links":941,"meta":946,"navigation":947,"path":229,"requires":16,"seo":948,"sitemap":950,"stem":230,"__hash__":951},"docs\u002Fdocs\u002F5.components\u002F6.commit-changelog.md",{"type":354,"value":355,"toc":925},"minimark",[356,371,378,382,423,452,457,469,472,476,492,499,580,615,618,661,667,738,741,758,835,838,844,866,879,883,893,897,901,904,907,914,918,921],[345,357,358,361,362,365,366,370],{},[359,360,228],"code",{}," 根据文件路径请求 GitHub 提交记录，并按发布版本分组：已发布的提交归入对应版本，尚未发布的归入 ",[359,363,364],{},"Soon","。站点有 ",[367,368,369],"a",{"href":91},"版本发布页"," 时，版本标签链接到站内页面，否则跳转到 GitHub Release。",[345,372,373,374,377],{},"该组件不依赖 ",[359,375,376],{},"componentDocs"," 开关，开启 GitHub 集成即可使用。",[379,380,381],"h2",{"id":381},"前置条件",[383,384,385,414],"ul",{},[386,387,388,392,393,396,397,396,400,403,404,407,408,411,412],"li",{},[389,390,391],"strong",{},"仓库信息","：",[359,394,395],{},"github.owner","、",[359,398,399],{},"github.name",[359,401,402],{},"github.url"," 与 ",[359,405,406],{},"github.branch"," 默认从本地 git remote 推断，推断失败时在 ",[359,409,410],{},"app\u002Fapp.config.ts"," 中手动填写，见 ",[367,413,246],{"href":247},[386,415,416,419,420],{},[389,417,418],{},"访问令牌","：在环境变量中配置 ",[359,421,422],{},"NUXT_GITHUB_TOKEN",[424,425,431],"pre",{"className":426,"code":427,"filename":428,"language":429,"meta":430,"style":430},"language-bash shiki shiki-themes github-light github-light github-dark","NUXT_GITHUB_TOKEN=\u003Cyour-github-token>\n",".env","bash","",[359,432,433],{"__ignoreMap":430},[434,435,438,441,445,449],"span",{"class":436,"line":437},"line",1,[434,439,422],{"class":440},"sxrX7",[434,442,444],{"class":443},"s8jYJ","=\u003C",[434,446,448],{"class":447},"sIIMD","your-github-token",[434,450,451],{"class":443},">\n",[453,454,456],"warning",{"to":455},"https:\u002F\u002Fgithub.com\u002Fsettings\u002Ftokens","令牌需要读取仓库提交记录的权限：公开仓库可使用只读的 fine-grained token，私有仓库需要授予 Contents 读取权限。",[458,459,460,461,464,465,468],"tip",{},"未配置令牌或设置了 ",[359,462,463],{},"github: false"," 时，组件显示 ",[359,466,467],{},"No recent changes","，不会导致构建失败。",[379,470,471],{"id":471},"用法",[473,474,475],"h3",{"id":475},"推导文件路径",[424,477,481],{"className":478,"code":479,"language":480,"meta":430,"style":430},"language-mdc shiki shiki-themes github-light github-light github-dark",":commit-changelog\n","mdc",[359,482,483],{"__ignoreMap":430},[434,484,485,488],{"class":436,"line":437},[434,486,487],{"class":440},":",[434,489,491],{"class":490},"sovSZ","commit-changelog\n",[345,493,494,495,498],{},"文件路径按 ",[359,496,497],{},"{commitPath}\u002F{prefix}\u002F{name}.{suffix}"," 拼接：",[500,501,502,515],"table",{},[503,504,505],"thead",{},[506,507,508,512],"tr",{},[509,510,511],"th",{},"片段",[509,513,514],{},"来源",[516,517,518,539,551,563],"tbody",{},[506,519,520,526],{},[521,522,523],"td",{},[359,524,525],{},"commitPath",[521,527,528,529,531,532,535,536],{},"组件的 ",[359,530,525],{},"，其次 ",[359,533,534],{},"github.commitPath","，默认 ",[359,537,538],{},"src",[506,540,541,546],{},[521,542,543],{},[359,544,545],{},"prefix",[521,547,528,548,550],{},[359,549,545],{},"，默认为空",[506,552,553,558],{},[521,554,555],{},[359,556,557],{},"name",[521,559,528,560,562],{},[359,561,557],{},"，默认取当前路由最后一段",[506,564,565,570],{},[521,566,567],{},[359,568,569],{},"suffix",[521,571,528,572,531,574,535,577],{},[359,573,569],{},[359,575,576],{},"github.suffix",[359,578,579],{},"vue",[345,581,582,584,585,588,589,592,593,596,597,396,600,396,603,606,607,610,611,614],{},[359,583,557],{}," 按 ",[359,586,587],{},"casing"," 转换：默认的 ",[359,590,591],{},"auto"," 对 ",[359,594,595],{},".vue"," 文件使用 PascalCase，其他文件使用 camelCase；",[359,598,599],{},"kebab",[359,601,602],{},"camel",[359,604,605],{},"pascal"," 强制使用对应格式。例如在 ",[359,608,609],{},"\u002Fdocs\u002Fcomponents\u002Faccordion"," 页面中，上面的写法对应 ",[359,612,613],{},"src\u002FAccordion.vue","。",[473,616,617],{"id":617},"指定文件",[424,619,621],{"className":478,"code":620,"language":480,"meta":430,"style":430},":commit-changelog{name=\"useUser\" suffix=\"ts\" commitPath=\"src\u002Fcomposables\"}\n",[359,622,623],{"__ignoreMap":430},[434,624,625,627,630,633,636,639,642,645,647,650,653,655,658],{"class":436,"line":437},[434,626,487],{"class":440},[434,628,629],{"class":490},"commit-changelog",[434,631,632],{"class":440},"{",[434,634,557],{"class":635},"snPdu",[434,637,638],{"class":440},"=",[434,640,641],{"class":447},"\"useUser\"",[434,643,644],{"class":635}," suffix",[434,646,638],{"class":440},[434,648,649],{"class":447},"\"ts\"",[434,651,652],{"class":635}," commitPath",[434,654,638],{"class":440},[434,656,657],{"class":447},"\"src\u002Fcomposables\"",[434,659,660],{"class":440},"}\n",[345,662,663,664,666],{},"文件统一使用 kebab-case 命名时，在 ",[359,665,410],{}," 中全局设置，省去每处单独指定：",[424,668,672],{"className":669,"code":670,"filename":410,"language":671,"meta":430,"style":430},"language-ts shiki shiki-themes github-light github-light github-dark","export default defineAppConfig({\n  github: {\n    commitPath: 'src\u002Fcomposables',\n    suffix: 'ts',\n    casing: 'kebab'\n  }\n})\n","ts",[359,673,674,688,694,706,717,726,732],{"__ignoreMap":430},[434,675,676,679,682,685],{"class":436,"line":437},[434,677,678],{"class":443},"export",[434,680,681],{"class":443}," default",[434,683,684],{"class":635}," defineAppConfig",[434,686,687],{"class":440},"({\n",[434,689,691],{"class":436,"line":690},2,[434,692,693],{"class":440},"  github: {\n",[434,695,697,700,703],{"class":436,"line":696},3,[434,698,699],{"class":440},"    commitPath: ",[434,701,702],{"class":447},"'src\u002Fcomposables'",[434,704,705],{"class":440},",\n",[434,707,709,712,715],{"class":436,"line":708},4,[434,710,711],{"class":440},"    suffix: ",[434,713,714],{"class":447},"'ts'",[434,716,705],{"class":440},[434,718,720,723],{"class":436,"line":719},5,[434,721,722],{"class":440},"    casing: ",[434,724,725],{"class":447},"'kebab'\n",[434,727,729],{"class":436,"line":728},6,[434,730,731],{"class":440},"  }\n",[434,733,735],{"class":436,"line":734},7,[434,736,737],{"class":440},"})\n",[473,739,740],{"id":740},"关联多个文件",[345,742,743,746,747,396,749,396,751,396,753,396,755,757],{},[359,744,745],{},"files"," 中的每一项是对顶层字段（",[359,748,525],{},[359,750,545],{},[359,752,569],{},[359,754,557],{},[359,756,587],{},"）的局部覆盖，未写的字段沿用顶层值。各文件的提交合并去重后按时间倒序展示：",[424,759,761],{"className":478,"code":760,"language":480,"meta":430,"style":430},"::commit-changelog\n---\ncommitPath: layer\u002Fapp\u002Fcomposables\nsuffix: ts\nfiles:\n  - name: useHeader\n  - name: useNavigation\n---\n::\n",[359,762,763,770,775,785,794,801,813,824,829],{"__ignoreMap":430},[434,764,765,768],{"class":436,"line":437},[434,766,767],{"class":440},"::",[434,769,491],{"class":490},[434,771,772],{"class":436,"line":690},[434,773,774],{"class":440},"---\n",[434,776,777,779,782],{"class":436,"line":696},[434,778,525],{"class":490},[434,780,781],{"class":440},": ",[434,783,784],{"class":447},"layer\u002Fapp\u002Fcomposables\n",[434,786,787,789,791],{"class":436,"line":708},[434,788,569],{"class":490},[434,790,781],{"class":440},[434,792,793],{"class":447},"ts\n",[434,795,796,798],{"class":436,"line":719},[434,797,745],{"class":490},[434,799,800],{"class":440},":\n",[434,802,803,806,808,810],{"class":436,"line":728},[434,804,805],{"class":440},"  - ",[434,807,557],{"class":490},[434,809,781],{"class":440},[434,811,812],{"class":447},"useHeader\n",[434,814,815,817,819,821],{"class":436,"line":734},[434,816,805],{"class":440},[434,818,557],{"class":490},[434,820,781],{"class":440},[434,822,823],{"class":447},"useNavigation\n",[434,825,827],{"class":436,"line":826},8,[434,828,774],{"class":440},[434,830,832],{"class":436,"line":831},9,[434,833,834],{"class":440},"::\n",[473,836,837],{"id":837},"按作者过滤",[345,839,840,843],{},[359,841,842],{},"author"," 传入 GitHub 用户名或提交邮箱：",[424,845,847],{"className":478,"code":846,"language":480,"meta":430,"style":430},":commit-changelog{author=\"octocat\"}\n",[359,848,849],{"__ignoreMap":430},[434,850,851,853,855,857,859,861,864],{"class":436,"line":437},[434,852,487],{"class":440},[434,854,629],{"class":490},[434,856,632],{"class":440},[434,858,842],{"class":635},[434,860,638],{"class":440},[434,862,863],{"class":447},"\"octocat\"",[434,865,660],{"class":440},[458,867,868,869,396,872,403,875,878],{},"获取范围受 ",[359,870,871],{},"github.since",[359,873,874],{},"github.until",[359,876,877],{},"github.perPage"," 控制，默认不限制日期，每个文件最多获取 100 条。",[379,880,882],{"id":881},"ai-与-raw-markdown","AI 与 raw markdown",[345,884,885,886,889,890,892],{},"在 ",[359,887,888],{},"\u002Fraw\u002F**.md"," 与 MCP 返回的 Markdown 中，组件被替换为指向 GitHub 提交历史的链接，路径推导规则相同；此时未指定 ",[359,891,557],{}," 会使用页面标题。",[379,894,896],{"id":895},"api","API",[473,898,900],{"id":899},"props","Props",[902,903],"component-props",{},[379,905,906],{"id":906},"相关",[383,908,909],{},[386,910,911,913],{},[367,912,234],{"href":235},"：在页头显示当前页面的最后一次提交",[379,915,917],{"id":916},"changelog","Changelog",[629,919],{"commit-path":920},"layer\u002Fapp\u002Fcomponents\u002Fcontent",[922,923,924],"style",{},"html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}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 .sovSZ, html code.shiki .sovSZ{--shiki-light:#22863A;--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}",{"title":430,"searchDepth":690,"depth":690,"links":926},[927,928,934,935,938,939],{"id":381,"depth":690,"text":381},{"id":471,"depth":690,"text":471,"children":929},[930,931,932,933],{"id":475,"depth":696,"text":475},{"id":617,"depth":696,"text":617},{"id":740,"depth":696,"text":740},{"id":837,"depth":696,"text":837},{"id":881,"depth":690,"text":882},{"id":895,"depth":690,"text":896,"children":936},[937],{"id":899,"depth":696,"text":900},{"id":906,"depth":690,"text":906},{"id":916,"depth":690,"text":917},"md",[942],{"label":943,"icon":944,"to":945},"GitHub","i-simple-icons-github","https:\u002F\u002Fgithub.com\u002Fmhaibaraai\u002Fmovk-nuxt-docs\u002Fblob\u002Fmain\u002Flayer\u002Fapp\u002Fcomponents\u002Fcontent\u002FCommitChangelog.vue",{},{"icon":232},{"title":228,"description":949},"Show the GitHub commit history of a component or source file as a timeline grouped by release, with path inference, author filter and multiple files.",{"loc":229},"8S_DuBZ-geEKql9J4ptOvErHfvd5KHRLYIWzpWmTagU",[953,954],{"title":222,"path":223,"stem":224,"description":225,"icon":226,"children":-1},{"title":234,"path":235,"stem":236,"description":237,"icon":238,"children":-1},{"mode":956,"prefetch":113,"preload":113,"filePath":957,"declarationPath":958,"pascalName":228,"kebabName":629,"chunkName":959,"priority":437,"_scanned":960,"meta":961},"all","..\u002Flayer\u002Fapp\u002Fcomponents\u002Fcontent\u002FCommitChangelog.vue","\u002Fopt\u002Fbuildhome\u002Frepo\u002Flayer\u002Fapp\u002Fcomponents\u002Fcontent\u002FCommitChangelog.vue","components\u002Fcommit-changelog",true,{"type":437,"props":962,"slots":1045,"events":1046,"exposed":1047,"hash":1048},[963,976,981,988,993,998,1011],{"name":525,"global":113,"description":964,"tags":965,"required":113,"type":969,"schema":970,"default":968},"仓库中的文件路径",[966],{"name":967,"text":968},"defaultValue","'src'","undefined | string",{"kind":971,"type":972,"schema":973},"enum","string | undefined",{"0":974,"1":975},"undefined","string",{"name":545,"global":113,"description":977,"tags":978,"required":113,"type":969,"schema":979},"文件路径的前缀",[],{"kind":971,"type":972,"schema":980},{"0":974,"1":975},{"name":569,"global":113,"description":982,"tags":983,"required":113,"type":969,"schema":986,"default":985},"文件扩展名",[984],{"name":967,"text":985},"'vue'",{"kind":971,"type":972,"schema":987},{"0":974,"1":975},{"name":557,"global":113,"description":989,"tags":990,"required":113,"type":969,"schema":991},"要获取更新日志的组件或文件名",[],{"kind":971,"type":972,"schema":992},{"0":974,"1":975},{"name":842,"global":113,"description":994,"tags":995,"required":113,"type":969,"schema":996},"按作者筛选提交",[],{"kind":971,"type":972,"schema":997},{"0":974,"1":975},{"name":587,"global":113,"description":999,"tags":1000,"required":113,"type":1003,"schema":1004,"default":1002},"文件名的命名格式\n- 'auto': Vue 文件使用 PascalCase，其他使用 camelCase（默认）\n- 'kebab': 保持 kebab-case（如 use-user.ts）\n- 'camel': 转换为 camelCase（如 useUser.ts）\n- 'pascal': 转换为 PascalCase（如 UseUser.ts）",[1001],{"name":967,"text":1002},"'auto'","undefined | \"auto\" | \"kebab\" | \"camel\" | \"pascal\"",{"kind":971,"type":1005,"schema":1006},"CommitCasing | undefined",{"0":974,"1":1007,"2":1008,"3":1009,"4":1010},"\"auto\"","\"kebab\"","\"camel\"","\"pascal\"",{"name":745,"global":113,"description":1012,"tags":1013,"required":113,"type":1014,"schema":1015},"关联多个文件：每一项与顶层 props 合并后各自解析出一个文件路径，\n对应的提交记录会合并去重并按时间倒序展示",[],"undefined | CommitChangelogFile[]",{"kind":971,"type":1016,"schema":1017},"CommitChangelogFile[] | undefined",{"0":974,"1":1018},{"kind":1019,"type":1020,"schema":1021},"array","CommitChangelogFile[]",[1022],{"kind":1023,"type":1024,"schema":1025},"object","CommitChangelogFile",{"commitPath":1026,"prefix":1031,"suffix":1034,"name":1037,"casing":1040},{"name":525,"global":113,"description":1027,"tags":1028,"required":113,"type":972,"schema":1029},"覆盖顶层 commitPath",[],{"kind":971,"type":972,"schema":1030},{"0":974,"1":975},{"name":545,"global":113,"description":1032,"tags":1033,"required":113,"type":972,"schema":972},"覆盖顶层 prefix",[],{"name":569,"global":113,"description":1035,"tags":1036,"required":113,"type":972,"schema":972},"覆盖顶层 suffix",[],{"name":557,"global":113,"description":1038,"tags":1039,"required":113,"type":972,"schema":972},"覆盖顶层 name",[],{"name":587,"global":113,"description":1041,"tags":1042,"required":113,"type":1005,"schema":1043},"覆盖顶层 casing",[],{"kind":971,"type":1005,"schema":1044},{"0":974,"1":1007,"2":1008,"3":1009,"4":1010},[],[],[],"nsLsqPBwWP0ZW77_TOFZLWdXj_eVL6_GDgz1nNuAbqg",{"data":1050,"body":1051},{},{"type":341,"children":1052},[1053],{"type":344,"tag":345,"props":1054,"children":1055},{},[1056,1058,1064],{"type":349,"value":1057},"用 ",{"type":344,"tag":359,"props":1059,"children":1061},{"className":1060},[],[1062],{"type":349,"value":1063},":commit-changelog",{"type":349,"value":1065}," 从 GitHub 拉取组件或源文件的提交记录，按版本分组展示为时间线；文件路径由组件名推导，可按目录、扩展名、命名格式与作者调整，一篇文档也可关联多个文件。",{"data":1067,"body":1068},{},{"type":341,"children":1069},[1070],{"type":344,"tag":345,"props":1071,"children":1072},{},[1073],{"type":349,"value":964},{"data":1075,"body":1076},{},{"type":341,"children":1077},[1078],{"type":344,"tag":345,"props":1079,"children":1080},{},[1081],{"type":349,"value":977},{"data":1083,"body":1084},{},{"type":341,"children":1085},[1086],{"type":344,"tag":345,"props":1087,"children":1088},{},[1089],{"type":349,"value":982},{"data":1091,"body":1092},{},{"type":341,"children":1093},[1094],{"type":344,"tag":345,"props":1095,"children":1096},{},[1097],{"type":349,"value":989},{"data":1099,"body":1100},{},{"type":341,"children":1101},[1102],{"type":344,"tag":345,"props":1103,"children":1104},{},[1105],{"type":349,"value":994},{"data":1107,"body":1108},{},{"type":341,"children":1109},[1110,1115],{"type":344,"tag":345,"props":1111,"children":1112},{},[1113],{"type":349,"value":1114},"文件名的命名格式",{"type":344,"tag":383,"props":1116,"children":1117},{},[1118,1123,1128,1133],{"type":344,"tag":386,"props":1119,"children":1120},{},[1121],{"type":349,"value":1122},"'auto': Vue 文件使用 PascalCase，其他使用 camelCase（默认）",{"type":344,"tag":386,"props":1124,"children":1125},{},[1126],{"type":349,"value":1127},"'kebab': 保持 kebab-case（如 use-user.ts）",{"type":344,"tag":386,"props":1129,"children":1130},{},[1131],{"type":349,"value":1132},"'camel': 转换为 camelCase（如 useUser.ts）",{"type":344,"tag":386,"props":1134,"children":1135},{},[1136],{"type":349,"value":1137},"'pascal': 转换为 PascalCase（如 UseUser.ts）",{"data":1139,"body":1140},{},{"type":341,"children":1141},[1142],{"type":344,"tag":345,"props":1143,"children":1144},{},[1145],{"type":349,"value":1012},1794996153247]