@movk/nuxt-docs 1.16.2 → 1.17.0

package/README.md

@@ -1,4 +1,4 @@
-[![Movk Nuxt Docs OG](https://docs.mhaibaraai.cn/_og/s/c_Docs,title_~546w5Luj5YyWIE51eHQg5paH5qGj5Li76aKY,description_~5Z-65LqOIE51eHQgNCDnmoTnjrDku6PmlofmoaPkuLvpopjvvIzpm4bmiJDnu4Tku7boh6rliqjljJbmlofmoaPjgIFBSSDogYrlpKnliqnmiYvjgIFNQ1AgU2VydmVyIOWSjOWujOaVtOeahOW8gOWPkeiAheS9k-mqjOS8mOWMluOAgg.png)](https://docs.mhaibaraai.cn/)
+[![Movk Nuxt Docs OG](https://docs.mhaibaraai.cn/_og/s/o_njw78u.png)](https://docs.mhaibaraai.cn/)
 [![Movk Nuxt Docs](https://docs.mhaibaraai.cn/og-image.png)](https://docs.mhaibaraai.cn/)
 
 > 基于 Nuxt 4 的现代文档主题，集成组件自动化文档、AI 聊天助手、MCP Server 和完整的开发者体验优化
@@ -30,6 +30,23 @@
 - **LLM 优化** - 通过 `nuxt-llms` 模块自动生成 `llms.txt` 和 `llms-full.txt`，为 AI 工具提供优化的文档索引
 - **流式响应** - 支持 AI 响应流式输出和代码高亮，配合 `shiki-stream` 实现实时语法高亮渲染
 
+### AI 助手 Skill
+
+Agent Skills 是一种开放格式，允许 AI 代理（Claude Code、Cursor、Windsurf 等）自动发现并加载文档站的专属工作流。Movk Nuxt Docs 将 `skills/` 目录下的所有技能自动发布到 `/.well-known/skills/` 端点。
+
+**内置技能：**
+
+- `create-docs` - 为任意项目生成基于 Movk Nuxt Docs 的完整文档网站
+- `review-docs` - 审查文档质量，检查清晰度、SEO 和技术正确性
+
+**一键安装到 AI 工具：**
+
+```bash
+npx skills add https://docs.mhaibaraai.cn
+```
+
+详见 [Agent Skills 文档](https://docs.mhaibaraai.cn/docs/getting-started/skills)。
+
 ### 🧩 自动化文档生成
 
 - **组件元数据自动提取** - 基于 `nuxt-component-meta` 自动提取 Vue 组件的 Props、Slots、Emits 定义
@@ -79,21 +96,6 @@ pnpm dev
 
 访问 `http://localhost:3000` 查看你的文档网站。
 
-### AI 助手 Skill
-
-为你的 AI 助手（Cursor、Claude Code 等）添加 Movk Nuxt Docs 专业知识，加速文档编写：
-
-```bash
-npx skills add mhaibaraai/movk-nuxt-docs
-```
-
-此 Skill 为 AI 助手提供 Movk Nuxt Docs 专业知识，帮助你更高效地编写文档：
-
-- 📝 MDC 组件用法和现成模板
-- 🎨 中文文档写作规范和内容结构模式
-- 🔧 nuxt.config.ts 和 app.config.ts 配置参考
-- 📚 入门页、功能介绍页等常用页面模板
-
 ### 作为 Layer 使用
 
 在现有 Nuxt 项目中使用 Movk Nuxt Docs 作为 layer：

package/app/app.config.ts

@@ -11,7 +11,7 @@ export default defineAppConfig({
     radius: 0.25,
     blackAsPrimary: false,
     icons: 'lucide',
-    font: 'Public Sans'
+    font: 'Alibaba PuHuiTi'
   },
   ui: {
     colors: {

package/app/assets/css/main.css

@@ -4,7 +4,7 @@
 @theme static {
   --container-8xl: 90rem;
 
-  --font-sans: 'Public Sans', sans-serif;
+  --font-sans: 'Alibaba PuHuiTi', sans-serif;
 
   --color-green-50: #EFFDF5;
   --color-green-100: #D9FBE8;

package/app/components/DocsAsideRightBottom.vue

@@ -13,9 +13,9 @@ const showExplainWithAi = computed(() => {
 <template>
   <UButton
     v-if="showExplainWithAi"
-    :icon="aiChat.icons.explain"
+    :icon="aiChat.icons?.explain ?? ''"
     target="_blank"
-    :label="aiChat.texts.explainWithAi"
+    :label="aiChat.texts?.explainWithAi ?? ''"
     size="sm"
     variant="ghost"
     color="neutral"

package/app/components/OgImage/OgImageDocs.takumi.vue

@@ -1,17 +1,13 @@
 <script setup lang="ts">
-withDefaults(defineProps<{
+defineProps<{
   title?: string
   description?: string
   siteName?: string
-}>(), {
-  title: '文档',
-  description: '使用 Nuxt Content 构建的文档站点',
-  siteName: 'Movk Nuxt Docs'
-})
+}>()
 </script>
 
 <template>
-  <div style="font-family: 'Noto Sans SC', sans-serif;" class="w-full h-full flex flex-col justify-center items-center relative p-10 lg:p-15 bg-white text-neutral-900 dark:bg-neutral-900 dark:text-neutral-50">
+  <div style="font-family: 'Alibaba PuHuiTi', sans-serif;" class="w-full h-full flex flex-col justify-center items-center relative p-10 lg:p-15 bg-white text-neutral-900 dark:bg-neutral-900 dark:text-neutral-50">
     <div
       class="absolute top-0 left-0 right-0 bottom-0"
       :style="{
@@ -65,14 +61,14 @@ withDefaults(defineProps<{
             fill="url(#nsLine1)"
           />
         </svg>
-        <span class="text-[32px] font-medium lg:text-[42px] text-green-500">
+        <span class="text-[32px] font-bold lg:text-[42px] text-green-500">
           {{ siteName }}
         </span>
       </div>
 
       <div class="items-center justify-center w-full">
         <h1
-          class="text-[48px] lg:text-[72px] leading-tight text-pretty font-normal text-slate-900 max-w-175 lg:max-w-250"
+          class="text-[48px] lg:text-[72px] leading-tight text-pretty font-medium text-slate-800 max-w-175 lg:max-w-250"
           style="display: block; line-clamp: 3; text-overflow: ellipsis; text-wrap: balance;"
         >
           {{ title }}
@@ -81,7 +77,7 @@ withDefaults(defineProps<{
 
       <p
         v-if="description"
-        class="text-slate-500 text-[24px] lg:text-[32px] opacity-70 max-w-162.5 lg:max-w-225 leading-normal"
+        class="text-slate-700 text-[24px] lg:text-[32px] font-normal opacity-70 max-w-162.5 lg:max-w-225 leading-normal"
       >
         {{ description }}
       </p>

package/app/components/header/Header.vue

@@ -4,7 +4,7 @@ import type { ButtonProps } from '@nuxt/ui'
 const route = useRoute()
 const { header, github } = useAppConfig()
 
-const links = computed<ButtonProps[]>(() => github && github.url
+const links = computed<ButtonProps[]>(() => (github && github.url
   ? [
       {
         'icon': 'i-simple-icons-github',
@@ -12,13 +12,13 @@ const links = computed<ButtonProps[]>(() => github && github.url
         'target': '_blank',
         'aria-label': 'GitHub'
       },
-      ...header?.links || []
+      ...(header?.links || [])
     ]
-  : header.links)
+  : header?.links || []) as ButtonProps[])
 </script>
 
 <template>
-  <UHeader :ui="{ left: 'min-w-0' }" class="flex flex-col" aria-label="Site Header">
+  <UHeader :ui="{ left: 'min-w-0', right: 'gap-0.5' }" class="flex flex-col" aria-label="Site Header">
     <template #left>
       <HeaderLogo />
     </template>

package/app/components/theme-picker/ThemePicker.vue

@@ -49,7 +49,7 @@ const {
           Primary
 
           <UButton
-            to="/docs/getting-started/theme/css-variables#colors"
+            to="https://ui.nuxt.com/docs/getting-started/theme/css-variables#colors"
             size="xs"
             color="neutral"
             variant="link"
@@ -86,7 +86,7 @@ const {
           Neutral
 
           <UButton
-            to="/docs/getting-started/theme/css-variables#text"
+            to="https://ui.nuxt.com/docs/getting-started/theme/css-variables#text"
             size="xs"
             color="neutral"
             variant="link"
@@ -113,7 +113,7 @@ const {
           Radius
 
           <UButton
-            to="/docs/getting-started/theme/css-variables#radius"
+            to="https://ui.nuxt.com/docs/getting-started/theme/css-variables#radius"
             size="xs"
             color="neutral"
             variant="link"
@@ -140,7 +140,7 @@ const {
           Font
 
           <UButton
-            to="/docs/getting-started/integrations/fonts"
+            to="https://ui.nuxt.com/docs/getting-started/integrations/fonts"
             size="xs"
             color="neutral"
             variant="link"
@@ -168,7 +168,7 @@ const {
           Icons
 
           <UButton
-            to="/docs/getting-started/integrations/icons"
+            to="https://ui.nuxt.com/docs/getting-started/integrations/icons"
             size="xs"
             color="neutral"
             variant="link"
@@ -196,7 +196,7 @@ const {
           Color Mode
 
           <UButton
-            to="/docs/getting-started/integrations/color-mode"
+            to="https://ui.nuxt.com/docs/getting-started/integrations/color-mode"
             size="xs"
             color="neutral"
             variant="link"

package/app/composables/useTheme.ts

@@ -9,7 +9,7 @@ export function useTheme() {
   const site = useSiteConfig()
 
   const radius = useLocalStorage(`${site.name}-ui-radius`, 0.25)
-  const font = useLocalStorage(`${site.name}-ui-font`, 'Public Sans')
+  const font = useLocalStorage(`${site.name}-ui-font`, 'Alibaba PuHuiTi')
   const _iconSet = useLocalStorage(`${site.name}-ui-icons`, 'lucide')
   const blackAsPrimary = useLocalStorage(`${site.name}-ui-black-as-primary`, false)
 
@@ -38,7 +38,7 @@ export function useTheme() {
   })
 
   const radiuses = [0, 0.125, 0.25, 0.375, 0.5]
-  const fonts = ['Public Sans', 'DM Sans', 'Geist', 'Inter', 'Poppins', 'Outfit', 'Raleway']
+  const fonts = ['Alibaba PuHuiTi', 'Public Sans', 'DM Sans', 'Geist', 'Inter', 'Poppins', 'Outfit', 'Raleway']
 
   const icons = [{
     label: 'Lucide',
@@ -83,7 +83,7 @@ export function useTheme() {
 
   const link = computed(() => {
     const name = font.value
-    if (name === 'Public Sans') return []
+    if (name === 'Alibaba PuHuiTi' || !fonts.includes(name)) return []
     return [{
       rel: 'stylesheet' as const,
       href: `https://fonts.googleapis.com/css2?family=${encodeURIComponent(name)}:wght@400;500;600;700&display=swap`,
@@ -100,7 +100,7 @@ export function useTheme() {
   const hasCSSChanges = computed(() => {
     return radius.value !== 0.25
       || blackAsPrimary.value
-      || font.value !== 'Public Sans'
+      || font.value !== 'Alibaba PuHuiTi'
   })
 
   const hasAppConfigChanges = computed(() => {
@@ -115,7 +115,7 @@ export function useTheme() {
       '@import "@nuxt/ui";'
     ]
 
-    if (font.value !== 'Public Sans') {
+    if (font.value !== 'Alibaba PuHuiTi') {
       lines.push('', '@theme {', `  --font-sans: '${font.value}', sans-serif;`, '}')
     }
 
@@ -172,7 +172,7 @@ export function useTheme() {
     window.localStorage.removeItem(`${site.name}-ui-neutral`)
 
     radius.value = 0.25
-    font.value = 'Public Sans'
+    font.value = 'Alibaba PuHuiTi'
     _iconSet.value = 'lucide'
     appConfig.ui.icons = themeIcons.lucide as any
     blackAsPrimary.value = false

package/app/pages/docs/[...slug].vue

@@ -8,6 +8,7 @@ definePageMeta({
   heroBackground: 'opacity-30'
 })
 
+const { isOpen } = useAIChat()
 const route = useRoute()
 const appConfig = useAppConfig()
 const { toc, github } = appConfig
@@ -110,7 +111,13 @@ defineOgImage('Docs', {
 </script>
 
 <template>
-  <UPage v-if="page">
+  <UPage
+    v-if="page"
+    :ui="isOpen ? {
+      center: 'lg:col-span-10',
+      right: 'lg:col-span-0 hidden'
+    } : undefined"
+  >
     <UPageHeader :title="title">
       <template #headline>
         <UBreadcrumb :items="breadcrumb" />

package/app/plugins/theme.ts

@@ -67,7 +67,7 @@ export default defineNuxtPlugin({
             `if (localStorage.getItem('${site.name}-ui-font')) {`,
             `var font = localStorage.getItem('${site.name}-ui-font');`,
             `document.getElementById('${site.name}-ui-font').innerHTML = ':root { --font-sans: \\'' + font + '\\', sans-serif; }';`,
-            `if (font !== 'Public Sans') {`,
+            `if (font !== 'Alibaba PuHuiTi' && ['Alibaba PuHuiTi', 'Public Sans', 'DM Sans', 'Geist', 'Inter', 'Poppins', 'Outfit', 'Raleway'].includes(font)) {`,
             `var lnk = document.createElement('link');`,
             `lnk.rel = 'stylesheet';`,
             `lnk.href = 'https://fonts.googleapis.com/css2?family=' + encodeURIComponent(font) + ':wght@400;500;600;700&display=swap';`,

package/modules/ai-chat/index.ts

@@ -31,7 +31,7 @@ export interface AiChatModuleOptions {
   models?: string[]
 }
 
-const log = logger.withTag('movk-nuxt-docs')
+const log = logger.withTag('@movk/nuxt-docs')
 
 export default defineNuxtModule<AiChatModuleOptions>({
   meta: {

package/modules/ai-chat/runtime/components/AiChat.vue

@@ -4,12 +4,12 @@ const { toggleChat } = useAIChat()
 </script>
 
 <template>
-  <UTooltip :text="aiChat.texts.trigger">
+  <UTooltip :text="aiChat.texts?.trigger ?? ''">
     <UButton
-      :icon="aiChat.icons.trigger"
+      :icon="aiChat.icons?.trigger ?? ''"
       variant="ghost"
       class="rounded-full"
-      :aria-label="aiChat.texts.trigger"
+      :aria-label="aiChat.texts?.trigger ?? ''"
       @click="toggleChat"
     />
   </UTooltip>

package/modules/ai-chat/runtime/components/AiChatFloatingInput.vue

@@ -12,7 +12,7 @@ const inputRef = ref<{ inputRef: HTMLInputElement } | null>(null)
 
 const isDocsRoute = computed(() => route.meta.layout === 'docs')
 const isFloatingInputEnabled = computed(() => aiChat.floatingInput !== false)
-const focusInputShortcut = computed(() => aiChat.shortcuts.focusInput)
+const focusInputShortcut = computed(() => aiChat.shortcuts?.focusInput ?? 'meta_i')
 
 const shortcutDisplayKeys = computed(() => {
   const shortcut = focusInputShortcut.value
@@ -72,7 +72,7 @@ defineShortcuts(shortcuts)
           <UInput
             ref="inputRef"
             v-model="input"
-            :placeholder="aiChat.texts.placeholder"
+            :placeholder="aiChat.texts?.placeholder ?? ''"
             size="lg"
             maxlength="1000"
             :ui="{

package/modules/ai-chat/runtime/components/AiChatPanel.vue

@@ -4,7 +4,7 @@ import type { FaqCategory, FaqQuestions, ToolPart, ToolState } from '../types'
 import { Chat } from '@ai-sdk/vue'
 import { DefaultChatTransport, getToolName, isReasoningUIPart, isTextUIPart, isToolUIPart } from 'ai'
 import { computed } from 'vue'
-import { isReasoningStreaming, isToolStreaming } from '@nuxt/ui/utils/ai'
+import { isPartStreaming, isToolStreaming } from '@nuxt/ui/utils/ai'
 import { useModels } from '../composables/useModels'
 import { splitByCase, upperFirst } from 'scule'
 import AiChatPreStream from './AiChatPreStream.vue'
@@ -28,7 +28,7 @@ let _skipSync = false
 const chat = new Chat({
   messages: messages.value,
   transport: new DefaultChatTransport({
-    api: config.public.aiChat.apiPath,
+    api: (config.app?.baseURL.replace(/\/$/, '') || '') + config.public.aiChat.apiPath,
     body: () => ({ model: model.value })
   }),
   onError: (error: Error) => {
@@ -159,30 +159,30 @@ const faqQuestions = computed<FaqCategory[]>(() => {
   <USidebar
     v-model:open="isOpen"
     side="right"
-    :title="aiChat.texts.title"
+    :title="aiChat.texts?.title ?? ''"
     rail
     :style="{ '--sidebar-width': '24rem' }"
     :ui="{ footer: 'p-0', actions: 'gap-0.5' }"
   >
     <template #actions>
-      <UTooltip v-if="canClear" :text="aiChat.texts.clearChat">
+      <UTooltip v-if="canClear" :text="aiChat.texts?.clearChat ?? ''">
         <UButton
-          :icon="aiChat.icons.clearChat"
+          :icon="aiChat.icons?.clearChat ?? ''"
           color="neutral"
           variant="ghost"
-          :aria-label="aiChat.texts.clearChat"
+          :aria-label="aiChat.texts?.clearChat ?? ''"
           @click="clearMessages"
         />
       </UTooltip>
     </template>
 
     <template #close>
-      <UTooltip :text="aiChat.texts.close">
+      <UTooltip :text="aiChat.texts?.close ?? ''">
         <UButton
-          :icon="aiChat.icons.close"
+          :icon="aiChat.icons?.close ?? ''"
           color="neutral"
           variant="ghost"
-          :aria-label="aiChat.texts.close"
+          :aria-label="aiChat.texts?.close ?? ''"
           @click="isOpen = false"
         />
       </UTooltip>
@@ -215,13 +215,17 @@ const faqQuestions = computed<FaqCategory[]>(() => {
         class="px-0 gap-2"
         :user="{ ui: { container: 'max-w-full' } }"
       >
+        <template #indicator>
+          <UChatTool icon="i-lucide-brain" text="Thinking..." streaming />
+        </template>
+
         <template #content="{ message }">
           <template v-for="(part, index) in message.parts" :key="`${message.id}-${part.type}-${index}`">
             <UChatReasoning
               v-if="isReasoningUIPart(part)"
               :text="part.text"
-              :streaming="isReasoningStreaming(message, index, chat)"
-              :icon="aiChat.icons.reasoning"
+              :streaming="isPartStreaming(part)"
+              :icon="aiChat.icons?.reasoning ?? ''"
             >
               <MDCCached
                 :value="part.text"
@@ -230,14 +234,21 @@ const faqQuestions = computed<FaqCategory[]>(() => {
                 class="*:first:mt-0 *:last:mb-0"
               />
             </UChatReasoning>
-            <MDCCached
-              v-else-if="isTextUIPart(part) && part.text.length > 0"
-              :value="part.text"
-              :cache-key="`${message.id}-${index}`"
-              :components="components"
-              :parser-options="{ highlight: false }"
-              class="*:first:mt-0 *:last:mb-0"
-            />
+
+            <template v-else-if="isTextUIPart(part) && part.text.length > 0">
+              <MDCCached
+                v-if="message.role === 'assistant'"
+                :value="part.text"
+                :cache-key="`${message.id}-${index}`"
+                :components="components"
+                :parser-options="{ highlight: false }"
+                class="*:first:mt-0 *:last:mb-0"
+              />
+              <p v-else-if="message.role === 'user'" class="whitespace-pre-wrap text-sm/6">
+                {{ part.text }}
+              </p>
+            </template>
+
             <UChatTool
               v-else-if="isToolUIPart(part)"
               :text="getToolText(part)"
@@ -262,7 +273,7 @@ const faqQuestions = computed<FaqCategory[]>(() => {
       <UChatPrompt
         v-model="input"
         :error="chat.error"
-        :placeholder="aiChat.texts.placeholder"
+        :placeholder="aiChat.texts?.placeholder ?? ''"
         variant="naked"
         size="sm"
         autofocus
@@ -275,7 +286,7 @@ const faqQuestions = computed<FaqCategory[]>(() => {
             <AiChatModelSelect v-model="model" />
 
             <div class="flex gap-1 justify-between items-center px-1 text-xs text-muted">
-              <span>{{ aiChat.texts.lineBreak }}</span>
+              <span>{{ aiChat.texts?.lineBreak ?? '' }}</span>
               <UKbd value="shift" />
               <UKbd value="enter" />
             </div>

package/modules/ai-chat/runtime/composables/useModels.ts

@@ -3,7 +3,7 @@ export function useModels() {
   const model = useCookie<string>('model', { default: () => config.public.aiChat.model })
 
   const { aiChat } = useAppConfig()
-  const providerIcons = computed(() => aiChat.icons.providers || {})
+  const providerIcons = computed(() => (aiChat.icons?.providers ?? {}) as Record<string, string>)
 
   function getModelIcon(modelId: string): string {
     const provider = modelId.split('/')[0] || ''

package/modules/ai-chat/runtime/server/api/ai-chat.ts

@@ -23,7 +23,7 @@ function getMainAgentSystemPrompt(siteName: string) {
 - 在适用时引用具体的组件名称、props 或 API。
 - 如果问题不明确，请要求澄清而不是猜测。
 - 当发现多个相关项目时，使用要点清楚地列出它们。
-- 要策略性地使用工具：先广泛搜索，然后根据需要获取具体信息。
+- 您最多需要 5 次工具调用才能找到答案，因此要有策略：从广泛开始，然后在需要时具体化。
 - 以对话方式格式化回复，而不是文档章节形式`
 }
 
@@ -42,6 +42,7 @@ export default defineEventHandler(async (event) => {
   const siteConfig = getSiteConfig(event)
   const siteName = siteConfig.name || 'Documentation'
 
+  const baseURL = config.app?.baseURL?.replace(/\/$/, '') || ''
   const mcpPath = config.aiChat.mcpPath
   const isExternalUrl = mcpPath.startsWith('http://') || mcpPath.startsWith('https://')
 
@@ -50,7 +51,7 @@ export default defineEventHandler(async (event) => {
   try {
     const mcpUrl = isExternalUrl
       ? mcpPath
-      : `${getRequestURL(event).origin}${mcpPath}`
+      : `${getRequestURL(event).origin}${baseURL}${mcpPath}`
 
     httpClient = await createMCPClient({
       transport: { type: 'http', url: mcpUrl }

package/modules/module.ts

@@ -22,7 +22,7 @@ export interface ModuleOptions {
   mermaid?: boolean
 }
 
-const log = logger.withTag('movk-nuxt-docs')
+const log = logger.withTag('@movk/nuxt-docs')
 
 export default defineNuxtModule<ModuleOptions>({
   meta: {
@@ -63,7 +63,7 @@ export default defineNuxtModule<ModuleOptions>({
 
       if (mermaidAvailable) {
         addComponentsDir({
-          path: resolve('./runtime/components/prose'),
+          path: resolve('./components/prose'),
           pathPrefix: false,
           prefix: 'Prose',
           global: true
@@ -153,7 +153,6 @@ export default defineNuxtModule<ModuleOptions>({
     })
 
     const layerPath = resolve('..')
-
     // @ts-ignore - component-meta is not typed
     nuxt.hook('component-meta:extend', (options: any) => {
       const userInclude = (nuxt.options.componentMeta && typeof nuxt.options.componentMeta === 'object')
@@ -165,14 +164,6 @@ export default defineNuxtModule<ModuleOptions>({
         ...createComponentMetaExcludeFilters(resolve, dir, layerPath, userInclude)
       ]
     })
-
-    nuxt.hook('nitro:config', (nitroConfig) => {
-      nitroConfig.publicAssets ||= []
-      nitroConfig.publicAssets.push({
-        dir: resolve('./runtime/public'),
-        maxAge: 60 * 60 * 24 * 30
-      })
-    })
   }
 })
 

package/modules/skills/index.ts

@@ -0,0 +1,144 @@
+import { addServerHandler, createResolver, defineNuxtModule, logger } from '@nuxt/kit'
+import { existsSync } from 'node:fs'
+import { readdir, readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+import { parse as parseYaml } from 'yaml'
+
+interface SkillEntry {
+  name: string
+  description: string
+  files: string[]
+}
+
+const SKILL_NAME_REGEX = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/
+const MAX_NAME_LENGTH = 64
+
+const log = logger.withTag('@movk/nuxt-docs')
+
+export default defineNuxtModule({
+  meta: {
+    name: 'skills'
+  },
+  async setup(_options, nuxt) {
+    const skillsDir = join(nuxt.options.rootDir, 'skills')
+    if (!existsSync(skillsDir)) return
+
+    const catalog = await scanSkills(skillsDir)
+    if (!catalog.length) return
+
+    log.info(`Found ${catalog.length} agent skill${catalog.length > 1 ? 's' : ''}: ${catalog.map(s => s.name).join(', ')}`)
+
+    nuxt.options.runtimeConfig.skills = { catalog }
+
+    const { resolve } = createResolver(import.meta.url)
+
+    nuxt.hook('nitro:config', (nitroConfig) => {
+      nitroConfig.serverAssets ||= []
+      nitroConfig.serverAssets.push({ baseName: 'skills', dir: skillsDir })
+
+      nitroConfig.prerender ||= {}
+      nitroConfig.prerender.routes ||= []
+      nitroConfig.prerender.routes.push('/.well-known/skills/index.json')
+      for (const skill of catalog) {
+        for (const file of skill.files) {
+          nitroConfig.prerender.routes.push(`/.well-known/skills/${skill.name}/${file}`)
+        }
+      }
+    })
+
+    addServerHandler({
+      route: '/.well-known/skills/index.json',
+      handler: resolve('./runtime/server/routes/skills-index')
+    })
+
+    addServerHandler({
+      route: '/.well-known/skills/**',
+      handler: resolve('./runtime/server/routes/skills-files')
+    })
+  }
+})
+
+function parseFrontmatter(content: string): { name?: string, description?: string } | null {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/)
+  if (!match?.[1]) return null
+  try {
+    return parseYaml(match[1])
+  } catch {
+    return null
+  }
+}
+
+function validateSkillName(name: string, dirName: string): boolean {
+  if (name.length > MAX_NAME_LENGTH) {
+    log.warn(`Skill "${name}" exceeds ${MAX_NAME_LENGTH} character limit`)
+    return false
+  }
+  if (!SKILL_NAME_REGEX.test(name) || name.includes('--')) {
+    log.warn(`Skill name "${name}" does not match the Agent Skills naming spec`)
+    return false
+  }
+  if (name !== dirName) {
+    log.warn(`Skill name "${name}" does not match directory name "${dirName}"`)
+    return false
+  }
+  return true
+}
+
+async function listFilesRecursively(dir: string, base: string = ''): Promise<string[]> {
+  const files: string[] = []
+  const entries = await readdir(dir, { withFileTypes: true })
+  for (const entry of entries) {
+    const relPath = base ? `${base}/${entry.name}` : entry.name
+    if (entry.isDirectory()) {
+      files.push(...await listFilesRecursively(join(dir, entry.name), relPath))
+    } else {
+      files.push(relPath)
+    }
+  }
+  return files
+}
+
+async function scanSkills(skillsDir: string): Promise<SkillEntry[]> {
+  const catalog: SkillEntry[] = []
+  const entries = await readdir(skillsDir, { withFileTypes: true })
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue
+
+    const skillDir = join(skillsDir, entry.name)
+    const skillMdPath = join(skillDir, 'SKILL.md')
+
+    if (!existsSync(skillMdPath)) continue
+
+    const content = await readFile(skillMdPath, 'utf-8')
+    const frontmatter = parseFrontmatter(content)
+
+    if (!frontmatter?.description) {
+      log.warn(`Skipping skill "${entry.name}": missing description in SKILL.md frontmatter`)
+      continue
+    }
+
+    const name = frontmatter.name || entry.name
+    if (!validateSkillName(name, entry.name)) continue
+
+    const allFiles = await listFilesRecursively(skillDir)
+    const files = allFiles.filter(f => !f.split('/').some(s => s.startsWith('.')))
+    const sortedFiles = ['SKILL.md', ...files.filter(f => f !== 'SKILL.md')]
+
+    catalog.push({
+      name,
+      description: frontmatter.description,
+      files: sortedFiles
+    })
+  }
+
+  return catalog
+}
+
+declare module 'nuxt/schema' {
+  interface RuntimeConfig {
+    skills: {
+      catalog: SkillEntry[]
+    }
+  }
+}

package/modules/skills/runtime/server/routes/skills-files.ts

@@ -0,0 +1,49 @@
+const CONTENT_TYPES: Record<string, string> = {
+  '.md': 'text/markdown; charset=utf-8',
+  '.json': 'application/json; charset=utf-8',
+  '.yaml': 'text/yaml; charset=utf-8',
+  '.yml': 'text/yaml; charset=utf-8',
+  '.txt': 'text/plain; charset=utf-8',
+  '.py': 'text/plain; charset=utf-8',
+  '.sh': 'text/plain; charset=utf-8',
+  '.js': 'text/javascript; charset=utf-8',
+  '.ts': 'text/plain; charset=utf-8'
+}
+
+function getContentType(path: string): string {
+  const ext = path.slice(path.lastIndexOf('.'))
+  return CONTENT_TYPES[ext] || 'application/octet-stream'
+}
+
+export default defineEventHandler(async (event) => {
+  const url = getRequestURL(event)
+  const prefix = '/.well-known/skills/'
+  const idx = url.pathname.indexOf(prefix)
+  if (idx === -1) {
+    throw createError({ statusCode: 404, statusMessage: 'Not Found' })
+  }
+
+  const filePath = decodeURIComponent(url.pathname.slice(idx + prefix.length))
+
+  if (!filePath || filePath.includes('..')) {
+    throw createError({ statusCode: 400, statusMessage: 'Bad Request' })
+  }
+
+  const { skills } = useRuntimeConfig(event)
+  const skillName = filePath.split('/')[0]
+  if (!skills.catalog.some((s: { name: string }) => s.name === skillName)) {
+    throw createError({ statusCode: 404, statusMessage: 'Not Found' })
+  }
+
+  const storage = useStorage('assets:skills')
+  const content = await storage.getItemRaw<string>(filePath)
+
+  if (!content) {
+    throw createError({ statusCode: 404, statusMessage: 'Not Found' })
+  }
+
+  setResponseHeader(event, 'content-type', getContentType(filePath))
+  setResponseHeader(event, 'cache-control', 'public, max-age=3600')
+
+  return content
+})

package/modules/skills/runtime/server/routes/skills-index.ts

@@ -0,0 +1,8 @@
+export default defineEventHandler((event) => {
+  const { skills } = useRuntimeConfig(event)
+
+  setResponseHeader(event, 'content-type', 'application/json')
+  setResponseHeader(event, 'cache-control', 'public, max-age=3600')
+
+  return { skills: skills.catalog }
+})

package/nuxt.config.ts

@@ -2,6 +2,7 @@ import { defineNuxtConfig } from 'nuxt/config'
 import pkg from './package.json'
 import { createResolver, useNuxt } from '@nuxt/kit'
 import { join } from 'pathe'
+import { createAlibabaPuHuiTiProvider } from './providers/alibaba-puhuiti'
 
 const { resolve } = createResolver(import.meta.url)
 
@@ -95,6 +96,7 @@ export default defineNuxtConfig({
 
   nitro: {
     prerender: {
+      routes: ['/', '/sitemap.xml'],
       crawlLinks: true,
       failOnError: false,
       autoSubfolderIndex: false
@@ -119,8 +121,7 @@ export default defineNuxtConfig({
       cfg.optimizeDeps.include.push(
         'tailwindcss/colors',
         '@movk/nuxt-docs > @movk/core',
-        '@movk/nuxt-docs > prettier',
-        '@movk/nuxt-docs > reka-ui'
+        '@movk/nuxt-docs > prettier'
       )
 
       // AI Chat static deps — only pre-bundle when the feature is actually enabled.
@@ -167,9 +168,11 @@ export default defineNuxtConfig({
   },
 
   fonts: {
+    providers: {
+      'alibaba-puhuiti': createAlibabaPuHuiTiProvider('https://cdn.mhaibaraai.cn/fonts')
+    },
     families: [
-      { name: 'Public Sans', global: true },
-      { name: 'Noto Sans SC', global: true, provider: 'local' }
+      { name: 'Alibaba PuHuiTi', provider: 'alibaba-puhuiti', global: true }
     ]
   },
 
@@ -183,7 +186,8 @@ export default defineNuxtConfig({
     clientBundle: {
       scan: true,
       includeCustomCollections: true
-    }
+    },
+    provider: 'iconify'
   },
 
   llms: {

package/nuxt.schema.ts

@@ -33,7 +33,7 @@ export default defineNuxtSchema({
           title: '字体',
           description: '全局字体名称',
           icon: 'i-lucide-type',
-          default: 'Public Sans'
+          default: 'Alibaba PuHuiTi'
         })
       }
     }),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@movk/nuxt-docs",
   "type": "module",
-  "version": "1.16.2",
+  "version": "1.17.0",
   "private": false,
   "description": "Modern Nuxt 4 documentation theme with auto-generated component docs, AI chat assistant, MCP server, and complete developer experience optimization.",
   "author": "YiXuan <mhaibaraai@gmail.com>",
@@ -39,20 +39,20 @@
     "README.md"
   ],
   "dependencies": {
-    "@ai-sdk/gateway": "^3.0.83",
-    "@ai-sdk/mcp": "^1.0.30",
-    "@ai-sdk/vue": "^3.0.141",
-    "@iconify-json/lucide": "^1.2.100",
-    "@iconify-json/simple-icons": "^1.2.75",
+    "@ai-sdk/gateway": "^3.0.88",
+    "@ai-sdk/mcp": "^1.0.32",
+    "@ai-sdk/vue": "^3.0.146",
+    "@iconify-json/lucide": "^1.2.101",
+    "@iconify-json/simple-icons": "^1.2.76",
     "@iconify-json/vscode-icons": "^1.2.45",
     "@movk/core": "^1.2.2",
     "@nuxt/a11y": "^1.0.0-alpha.1",
     "@nuxt/content": "^3.12.0",
     "@nuxt/image": "^2.0.0",
     "@nuxt/kit": "^4.4.2",
-    "@nuxt/ui": "^4.6.0",
-    "@nuxtjs/mcp-toolkit": "^0.12.0",
-    "@nuxtjs/mdc": "^0.21.0",
+    "@nuxt/ui": "^4.6.1",
+    "@nuxtjs/mcp-toolkit": "^0.13.3",
+    "@nuxtjs/mdc": "^0.21.1",
     "@nuxtjs/robots": "^6.0.6",
     "@octokit/rest": "^22.0.1",
     "@shikijs/core": "^4.0.2",
@@ -63,26 +63,27 @@
     "@takumi-rs/wasm": "^0.73.1",
     "@vueuse/core": "^14.2.1",
     "@vueuse/nuxt": "^14.2.1",
-    "ai": "^6.0.141",
-    "defu": "^6.1.4",
+    "ai": "^6.0.146",
+    "defu": "^6.1.6",
     "exsolve": "^1.0.8",
     "git-url-parse": "^16.1.0",
     "motion-v": "^2.2.0",
     "nuxt-component-meta": "^0.17.2",
     "nuxt-llms": "^0.2.0",
-    "nuxt-og-image": "^6.3.0",
+    "nuxt-og-image": "^6.3.2",
     "nuxt-site-config": "^4.0.7",
     "ohash": "^2.0.11",
     "pathe": "^2.0.3",
     "pkg-types": "^2.3.0",
     "prettier": "^3.8.1",
-    "reka-ui": "^2.9.2",
     "scule": "^1.3.0",
     "shiki-stream": "^0.1.4",
     "shiki-transformer-color-highlight": "^1.1.0",
     "tailwindcss": "^4.2.2",
     "ufo": "^1.6.3",
+    "unifont": "^0.7.4",
     "vue-component-meta": "^3.2.6",
+    "yaml": "^2.8.3",
     "zod": "^4.3.6"
   }
 }

package/server/api/github/commits.json.get.ts

@@ -32,9 +32,9 @@ export default defineCachedEventHandler(async (event) => {
   const allCommits = await Promise.all(
     paths.map(path =>
       octokit.rest.repos.listCommits({
-        sha: github.branch,
-        owner: github.owner,
-        repo: github.name,
+        sha: github.branch!,
+        owner: github.owner!,
+        repo: github.name!,
         path,
         since: github.since,
         per_page: github.per_page || 100,

package/server/api/github/last-commit.json.get.ts

@@ -29,9 +29,9 @@ export default defineCachedEventHandler(async (event) => {
 
   try {
     const commits = await octokit.rest.repos.listCommits({
-      sha: github.branch,
-      owner: github.owner,
-      repo: github.name,
+      sha: github.branch!,
+      owner: github.owner!,
+      repo: github.name!,
       path,
       per_page: 1
     }).then(res => res.data).catch(() => [])
@@ -58,8 +58,8 @@ export default defineCachedEventHandler(async (event) => {
         const prMatch = commit.commit.message.match(/#(\d+)/)
         if (prMatch?.[1]) {
           const prData = await octokit.rest.pulls.get({
-            owner: github.owner,
-            repo: github.name,
+            owner: github.owner!,
+            repo: github.name!,
             pull_number: Number.parseInt(prMatch[1])
           }).then(res => res.data).catch(() => null)
 

package/server/api/github/releases.json.get.ts

@@ -17,8 +17,8 @@ export default defineCachedEventHandler(async () => {
   const octokit = new Octokit({ auth: process.env.NUXT_GITHUB_TOKEN })
 
   const releases = await octokit.rest.repos.listReleases({
-    owner: github.owner,
-    repo: github.name
+    owner: github.owner!,
+    repo: github.name!
   }).then(res => res.data).catch(() => [])
 
   return releases