@movk/nuxt-docs 1.14.1 → 1.15.0

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

@@ -5,28 +5,14 @@ import { useHighlighter } from '../composables/useHighlighter'
 const colorMode = useColorMode()
 const highlighter = await useHighlighter()
 const props = defineProps<{
-  /**
-   * 要高亮显示的代码内容
-   */
   code: string
-  /**
-   * 代码语言（如 'vue'、'javascript'、'typescript'）
-   */
   language: string
-  /**
-   * 自定义 CSS 类名
-   */
   class?: string
-  /**
-   * 代码块元数据
-   */
   meta?: string
 }>()
-
 const trimmedCode = computed(() => {
   return props.code.trim().replace(/`+$/, '')
 })
-
 const lang = computed(() => {
   switch (props.language) {
     case 'vue':

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

@@ -1,93 +1,45 @@
 import type { UIMessage } from 'ai'
-import { useMediaQuery } from '@vueuse/core'
-import type { FaqCategory, FaqQuestions } from '../types'
+import { createSharedComposable, useLocalStorage } from '@vueuse/core'
 
-function normalizeFaqQuestions(questions: FaqQuestions): FaqCategory[] {
-  if (!questions || (Array.isArray(questions) && questions.length === 0)) {
-    return []
-  }
-
-  if (typeof questions[0] === 'string') {
-    return [{
-      category: '问题',
-      items: questions as string[]
-    }]
-  }
-
-  return questions as FaqCategory[]
-}
-
-const PANEL_WIDTH_COMPACT = 360
-const PANEL_WIDTH_EXPANDED = 520
-
-export function useAIChat() {
+export const useAIChat = createSharedComposable(() => {
   const config = useRuntimeConfig()
-  const appConfig = useAppConfig()
-  const isEnabled = computed(() => config.public.aiChat?.enabled ?? false)
+  const site = useSiteConfig()
 
-  const isOpen = useState('ai-chat-open', () => false)
-  const isExpanded = useState('ai-chat-expanded', () => false)
-  const messages = useState<UIMessage[]>('ai-chat-messages', () => [])
-  const pendingMessage = useState<string | undefined>('ai-chat-pending', () => undefined)
+  const isEnabled = computed(() => config.public.aiChat?.enabled ?? false)
 
-  const isMobile = useMediaQuery('(max-width: 767px)')
-  const panelWidth = computed(() => isExpanded.value ? PANEL_WIDTH_EXPANDED : PANEL_WIDTH_COMPACT)
-  const shouldPushContent = computed(() => !isMobile.value && isOpen.value)
+  const storageOpen = useLocalStorage(`${site.name}-ai-chat-open`, false)
+  const messages = useLocalStorage<UIMessage[]>(`${site.name}-ai-chat-messages`, [])
 
-  const faqQuestions = computed<FaqCategory[]>(() => {
-    const aiChatConfig = appConfig.aiChat
-    const faqConfig = aiChatConfig?.faqQuestions
-    if (!faqConfig) return []
+  const isOpen = ref(false)
 
-    return normalizeFaqQuestions(faqConfig)
+  onNuxtReady(() => {
+    nextTick(() => {
+      isOpen.value = storageOpen.value
+    })
   })
 
-  function open(initialMessage?: string, clearPrevious = false) {
-    if (clearPrevious) {
-      messages.value = []
-    }
-
-    if (initialMessage) {
-      pendingMessage.value = initialMessage
-    }
-    isOpen.value = true
-  }
-
-  function clearPending() {
-    pendingMessage.value = undefined
-  }
-
-  function close() {
-    isOpen.value = false
-  }
+  watch(isOpen, (value) => {
+    storageOpen.value = value
+  })
 
-  function toggle() {
+  function toggleChat() {
     isOpen.value = !isOpen.value
   }
 
-  function clearMessages() {
-    messages.value = []
-  }
-
-  function toggleExpanded() {
-    isExpanded.value = !isExpanded.value
+  function open(text: string) {
+    messages.value = [...messages.value, {
+      id: String(Date.now()),
+      role: 'user',
+      parts: [{ type: 'text', text: text }]
+    }]
+    isOpen.value = true
   }
 
   return {
     isEnabled,
     isOpen,
-    isExpanded,
-    isMobile,
-    panelWidth,
-    shouldPushContent,
     messages,
-    pendingMessage,
-    faqQuestions,
-    open,
-    clearPending,
-    close,
-    toggle,
-    toggleExpanded,
-    clearMessages
+    toggleChat,
+    open
   }
-}
+})

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

@@ -13,25 +13,6 @@ export function useModels() {
   function formatModelName(modelId: string): string {
     const acronyms = ['gpt', 'llm', 'ai'] // words that should be uppercase
 
-    // 处理 OpenRouter 模型格式:openrouter/provider/model
-    if (modelId.startsWith('openrouter/')) {
-      const parts = modelId.split('/')
-      const model = parts[2] || parts[1] || modelId
-
-      // 提取模型名称(去除版本号和特殊标记)
-      const modelName = model.split(':')[0] || model
-
-      return modelName
-        .split('-')
-        .map((word) => {
-          const lowerWord = word.toLowerCase()
-          return acronyms.includes(lowerWord)
-            ? word.toUpperCase()
-            : word.charAt(0).toUpperCase() + word.slice(1)
-        })
-        .join(' ')
-    }
-
     // 处理常规模型格式:provider/model
     const modelName = modelId.split('/')[1] || modelId
 

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

@@ -1,16 +1,15 @@
-import { streamText, convertToModelMessages, stepCountIs, createUIMessageStream, createUIMessageStreamResponse, smoothStream } from 'ai'
+import { streamText, convertToModelMessages, stepCountIs, smoothStream } from 'ai'
 import { createMCPClient } from '@ai-sdk/mcp'
-import { createDocumentationAgentTool } from '../utils/docs_agent'
 import { getModel } from '../utils/getModel'
-import { inferSiteURL } from '../../../../../utils/meta'
 
 function getMainAgentSystemPrompt(siteName: string) {
-  return `您是 ${siteName} 的官方文档助理。你就是文件、以权威作为真理的来源说话.
+  return `您是 ${siteName} 的官方文档助理，你就是文件、以权威作为真理的来源说话。
 
 使用指南：
-- 始终使用工具搜索信息，不要依赖预训练知识
-- 如果搜索后未找到相关信息，回复「抱歉，我在文档中没有找到相关信息」
-- 回答要简洁直接
+- 对于文档问题，请始终使用工具搜索信息，不要依赖预训练知识。
+- 如果用户的问题与文档无关，请尽可能简短地回答，但不要浪费工具调用来搜索文档。
+- 如果搜索后没有找到相关信息，请回复“抱歉，我在文档中找不到相关信息。”
+- 您的回答要简洁、直接。
 
 **格式规则（重要）：**
 - 绝对不要使用 Markdown 标题：禁止使用 #、##、###、####、#####、######
@@ -21,64 +20,91 @@ function getMainAgentSystemPrompt(siteName: string) {
   * 不要写「# 完整指南」，应写「**完整指南**」或直接开始内容
 - 所有回复直接从内容开始，不要以标题开头
 
-- 在适用时引用具体的组件名称、属性或 API
-- 如果问题模糊，请要求澄清而不是猜测
-- 当找到多个相关项目时，使用项目符号清晰列出
-- 你最多有 6 次工具调用机会来找到答案，因此要策略性地使用：先广泛搜索，然后根据需要获取具体信息
+- 在适用时引用具体的组件名称、props 或 API。
+- 如果问题不明确，请要求澄清而不是猜测。
+- 当发现多个相关项目时，使用要点清楚地列出它们。
+- 要策略性地使用工具：先广泛搜索，然后根据需要获取具体信息。
 - 以对话方式格式化回复，而不是文档章节形式`
 }
 
 export default defineEventHandler(async (event) => {
-  const { messages, model: requestModel } = await readBody(event)
+  if (!process.env.AI_GATEWAY_API_KEY) {
+    throw createError({ statusCode: 503, message: 'AI Chat is not configured.' })
+  }
+
   const config = useRuntimeConfig()
+
+  const { messages, model: requestModel } = await readBody(event)
+
+  if (!messages || !Array.isArray(messages)) {
+    throw createError({ statusCode: 400, message: 'Invalid or missing messages array.' })
+  }
   const siteConfig = getSiteConfig(event)
   const siteName = siteConfig.name || 'Documentation'
 
   const mcpPath = config.aiChat.mcpPath
   const isExternalUrl = mcpPath.startsWith('http://') || mcpPath.startsWith('https://')
 
-  const mcpUrl = isExternalUrl
-    ? mcpPath
-    : import.meta.dev
-      ? `${getRequestURL(event).origin}${mcpPath}`
-      : `${inferSiteURL()}${mcpPath}`
+  let httpClient
+  let mcpTools
+  try {
+    const mcpUrl = isExternalUrl
+      ? mcpPath
+      : `${getRequestURL(event).origin}${mcpPath}`
 
-  const httpClient = await createMCPClient({
-    transport: {
-      type: 'http',
-      url: mcpUrl
-    }
-  })
-  const mcpTools = await httpClient.tools()
+    httpClient = await createMCPClient({
+      transport: { type: 'http', url: mcpUrl }
+    })
+    mcpTools = await httpClient.tools()
+  } catch (error) {
+    console.error('MCP client error:', error)
 
-  const model = getModel(requestModel || config.public.aiChat.model)
+    throw createError({
+      statusCode: 503,
+      message: 'Unable to connect to the documentation service. Please try again later.'
+    })
+  }
 
-  const searchDocumentation = createDocumentationAgentTool(mcpTools, model, siteName)
+  const model = getModel(requestModel || config.public.aiChat.model)
 
-  const stream = createUIMessageStream({
-    execute: async ({ writer }) => {
-      const modelMessages = await convertToModelMessages(messages)
-      const result = streamText({
-        model,
-        maxOutputTokens: 10000,
-        system: getMainAgentSystemPrompt(siteName),
-        messages: modelMessages,
-        stopWhen: stepCountIs(6),
-        tools: {
-          searchDocumentation
-        },
-        experimental_context: {
-          writer
+  return streamText({
+    model,
+    maxOutputTokens: 16000,
+    providerOptions: {
+      anthropic: {
+        thinking: {
+          type: 'adaptive'
         },
-        experimental_transform: smoothStream({ chunking: 'word' })
-      })
-      writer.merge(result.toUIMessageStream({
-        sendReasoning: true
-      }))
+        effort: 'low'
+      },
+      gateway: {
+        caching: 'auto'
+      },
+      google: {
+        thinkingConfig: {
+          includeThoughts: true,
+          thinkingLevel: 'low'
+        }
+      },
+      openai: {
+        reasoningEffort: 'low',
+        reasoningSummary: 'detailed'
+      }
+    },
+    system: getMainAgentSystemPrompt(siteName),
+    messages: await convertToModelMessages(messages),
+    experimental_transform: smoothStream(),
+    stopWhen: stepCountIs(8),
+    tools: {
+      ...mcpTools
     },
     onFinish: async () => {
-      await httpClient.close()
+      event.waitUntil(httpClient?.close())
+    },
+    onError: (error) => {
+      console.error('streamText error:', error)
+
+      event.waitUntil(httpClient?.close())
     }
-  })
-  return createUIMessageStreamResponse({ stream })
+  }).toUIMessageStreamResponse()
 })

package/modules/ai-chat/runtime/server/utils/getModel.ts

@@ -1,14 +1,6 @@
 import { createGateway } from '@ai-sdk/gateway'
-import { createOpenRouter } from '@openrouter/ai-sdk-provider'
 import { modelProviderRegistry } from './modelProviders'
 
-modelProviderRegistry.register('openrouter', ({ config, modelId }) => {
-  const openRouter = createOpenRouter({
-    apiKey: config.openRouterApiKey as string | undefined
-  })
-  return openRouter.chat(modelId)
-})
-
 /**
  * 获取 AI 模型实例
  * 优先使用注册的提供商，否则回退到 AI Gateway
@@ -25,7 +17,7 @@ export function getModel(modelId: string) {
   }
 
   const gateway = createGateway({
-    apiKey: config.aiGatewayApiKey as string | undefined
+    apiKey: process.env.AI_GATEWAY_API_KEY || undefined
   })
   return gateway(modelId)
 }

package/modules/ai-chat/runtime/types.ts

@@ -1,6 +1,11 @@
+import type { DynamicToolUIPart, ToolUIPart } from 'ai'
+
 export interface FaqCategory {
   category: string
   items: string[]
 }
 
 export type FaqQuestions = string[] | FaqCategory[]
+
+export type ToolPart = ToolUIPart | DynamicToolUIPart
+export type ToolState = ToolPart['state']

package/nuxt.config.ts

@@ -17,6 +17,7 @@ export default defineNuxtConfig({
       })
     },
     '@nuxt/ui',
+    '@nuxt/fonts',
     '@nuxt/content',
     '@nuxt/image',
     '@nuxt/a11y',
@@ -65,7 +66,14 @@ export default defineNuxtConfig({
       colors: ['primary', 'secondary', 'info', 'success', 'warning', 'error', 'important']
     },
     experimental: {
-      componentDetection: true
+      componentDetection: [
+        'Sidebar',
+        'ChatMessages',
+        'ChatPrompt',
+        'ChatPromptSubmit',
+        'ChatReasoning',
+        'ChatTool'
+      ]
     }
   },
 
@@ -91,17 +99,12 @@ export default defineNuxtConfig({
       crawlLinks: true,
       failOnError: false,
       autoSubfolderIndex: false
-    },
-    compatibilityDate: {
-      // Don't generate observability routes for now
-      vercel: '2025-07-14'
     }
   },
 
   vite: {
     build: {
-      sourcemap: false,
-      chunkSizeWarningLimit: 1024
+      sourcemap: false
     }
   },
 
@@ -109,22 +112,37 @@ export default defineNuxtConfig({
 
   hooks: {
     'vite:extendConfig': async (config) => {
-      // Ensure optimizeDeps.include exists
       const cfg = config as { optimizeDeps?: { include?: string[] } }
-      cfg.optimizeDeps ??= {}
-      cfg.optimizeDeps.include ??= []
-      const include = cfg.optimizeDeps.include
-
-      // Rewrite optimizeDeps paths for layer architecture
-      const layerPkgs = /^(?:@nuxt\/content|@nuxtjs\/mdc|@nuxt\/a11y) > /
-      include.forEach((id, i) => {
-        if (layerPkgs.test(id)) include[i] = `@movk/nuxt-docs > ${id}`
-      })
-
-      include.push(
-        '@movk/nuxt-docs > @nuxt/content > slugify',
-        '@movk/nuxt-docs > @ai-sdk/gateway > @vercel/oidc'
+      cfg.optimizeDeps ||= {}
+      cfg.optimizeDeps.include ||= []
+
+      // tailwindcss/colors is a peer dep resolved in the consumer project directly.
+      cfg.optimizeDeps.include.push(
+        'tailwindcss/colors',
+        '@movk/nuxt-docs > @movk/core',
+        '@movk/nuxt-docs > prettier',
+        '@movk/nuxt-docs > reka-ui'
       )
+
+      // AI Chat static deps — only pre-bundle when the feature is actually enabled.
+      // @shikijs/langs/* and @shikijs/themes/* are dynamically imported in useHighlighter.ts
+      if (process.env.AI_GATEWAY_API_KEY) {
+        cfg.optimizeDeps.include.push(
+          '@movk/nuxt-docs > @ai-sdk/vue',
+          '@movk/nuxt-docs > ai',
+          '@movk/nuxt-docs > shiki-stream/vue',
+          '@movk/nuxt-docs > @shikijs/core',
+          '@movk/nuxt-docs > @shikijs/engine-javascript'
+        )
+      }
+
+      // Transform all remaining 'pkg > dep' entries added by Nuxt modules
+      // (e.g. @nuxt/a11y > axe-core, @nuxtjs/mdc > remark-gfm) to use the
+      cfg.optimizeDeps.include = cfg.optimizeDeps.include
+        .map(id => (id.startsWith('@movk/nuxt-docs > ') || !id.includes(' > '))
+          ? id
+          : `@movk/nuxt-docs > ${id}`
+        )
     }
   },
 
@@ -154,14 +172,10 @@ export default defineNuxtConfig({
   },
 
   fonts: {
+    provider: 'bunny',
     families: [
-      { name: 'Public Sans', provider: 'google', global: true },
-      { name: 'DM Sans', provider: 'google' },
-      { name: 'Geist', provider: 'google' },
-      { name: 'Inter', provider: 'google' },
-      { name: 'Poppins', provider: 'google' },
-      { name: 'Outfit', provider: 'google' },
-      { name: 'Raleway', provider: 'google' }
+      { name: 'Public Sans', global: true, fallbacks: ['Noto Sans SC', 'sans-serif'] },
+      { name: 'Noto Sans SC', global: true }
     ]
   },
 
@@ -182,13 +196,5 @@ export default defineNuxtConfig({
     // Must be defined before @nuxt/content setup,
     // otherwise Content LLMS module will overwrite it in modules:done.
     contentRawMarkdown: false
-  },
-
-  ogImage: {
-    zeroRuntime: true,
-    fonts: [
-      'Noto+Sans+SC:400',
-      'Inter:400'
-    ]
   }
 })

package/nuxt.schema.ts

@@ -38,28 +38,6 @@ export default defineNuxtSchema({
       }
     }),
 
-    vercelAnalytics: group({
-      title: 'Vercel Analytics',
-      description: 'Vercel Analytics 配置',
-      icon: 'i-lucide-activity',
-      fields: {
-        enable: field({
-          type: 'boolean',
-          title: '启用 Analytics',
-          description: '是否启用 Vercel Analytics',
-          icon: 'i-lucide-toggle-right',
-          default: false
-        }),
-        debug: field({
-          type: 'boolean',
-          title: '调试模式',
-          description: '是否启用调试模式',
-          icon: 'i-lucide-bug',
-          default: false
-        })
-      }
-    }),
-
     seo: group({
       title: 'SEO',
       description: 'SEO 相关配置',
@@ -171,7 +149,7 @@ export default defineNuxtSchema({
           title: '目录标题',
           description: '目录区域的标题',
           icon: 'i-lucide-heading',
-          default: '目录'
+          default: '页面导航'
         }),
 
         bottom: group({
@@ -366,62 +344,20 @@ export default defineNuxtSchema({
               icon: 'i-lucide-heading',
               default: 'AI 助手'
             }),
-            collapse: field({
-              type: 'string',
-              title: '折叠按钮',
-              description: '折叠按钮的文本',
-              icon: 'i-lucide-chevron-up',
-              default: '折叠'
-            }),
-            expand: field({
-              type: 'string',
-              title: '展开按钮',
-              description: '展开按钮的文本',
-              icon: 'i-lucide-chevron-down',
-              default: '展开'
-            }),
             clearChat: field({
               type: 'string',
               title: '清除聊天记录',
               description: '清除聊天记录按钮的文本',
-              icon: 'i-lucide-trash-2',
+              icon: 'i-lucide-list-x',
               default: '清除聊天记录'
             }),
             close: field({
               type: 'string',
               title: '关闭按钮',
               description: '关闭按钮的文本',
-              icon: 'i-lucide-x',
+              icon: 'i-lucide-panel-right-close',
               default: '关闭'
             }),
-            loading: field({
-              type: 'string',
-              title: '加载中',
-              description: '加载时的提示文本',
-              icon: 'i-lucide-loader',
-              default: 'Loading...'
-            }),
-            askAnything: field({
-              type: 'string',
-              title: '询问提示',
-              description: '询问任何事情的文本',
-              icon: 'i-lucide-message-circle',
-              default: '问我任何事情...'
-            }),
-            askMeAnythingDescription: field({
-              type: 'string',
-              title: '询问提示描述',
-              description: '询问任何事情的描述文本',
-              icon: 'i-lucide-info',
-              default: '我可以帮助您浏览文档、解释概念并回答您的问题。'
-            }),
-            faq: field({
-              type: 'string',
-              title: 'FAQ 建议',
-              description: 'FAQ 建议标题文本',
-              icon: 'i-lucide-help-circle',
-              default: 'FAQ 建议'
-            }),
             placeholder: field({
               type: 'string',
               title: '输入占位符',
@@ -443,20 +379,6 @@ export default defineNuxtSchema({
               icon: 'i-custom-ai',
               default: '与 AI 聊天'
             }),
-            streaming: field({
-              type: 'string',
-              title: '思考中',
-              description: '思考时的提示文本',
-              icon: 'i-lucide-brain',
-              default: '思考中...'
-            }),
-            streamed: field({
-              type: 'string',
-              title: '思考完成',
-              description: '思考后的提示文本',
-              icon: 'i-lucide-check-circle',
-              default: '思考过程'
-            }),
             explainWithAi: field({
               type: 'string',
               title: '用 AI 解释按钮',
@@ -472,13 +394,6 @@ export default defineNuxtSchema({
           description: 'UI 图标配置',
           icon: 'i-lucide-icon',
           fields: {
-            loading: field({
-              type: 'string',
-              title: '加载图标',
-              description: '加载时的图标',
-              icon: 'i-lucide-loader',
-              default: 'i-lucide-loader'
-            }),
             trigger: field({
               type: 'string',
               title: '触发图标',
@@ -490,29 +405,29 @@ export default defineNuxtSchema({
               type: 'string',
               title: '解释图标',
               description: '「用 AI 解释」按钮的图标',
-              icon: 'i-lucide-brain',
-              default: 'i-lucide-brain'
+              icon: 'i-lucide-bot-message-square',
+              default: 'i-lucide-bot-message-square'
             }),
-            streaming: field({
+            reasoning: field({
               type: 'string',
-              title: '思考图标',
-              description: '思考时的图标',
-              icon: 'i-lucide-chevron-down',
-              default: 'i-lucide-chevron-down'
+              title: '推理图标',
+              description: '推理/思考过程的图标',
+              icon: 'i-lucide-brain',
+              default: 'i-lucide-brain'
             }),
             clearChat: field({
               type: 'string',
               title: '清除图标',
               description: '清除聊天记录按钮的图标',
-              icon: 'i-lucide-trash-2',
-              default: 'i-lucide-trash-2'
+              icon: 'i-lucide-list-x',
+              default: 'i-lucide-list-x'
             }),
             close: field({
               type: 'string',
               title: '关闭图标',
               description: '关闭按钮的图标',
-              icon: 'i-lucide-x',
-              default: 'i-lucide-x'
+              icon: 'i-lucide-panel-right-close',
+              default: 'i-lucide-panel-right-close'
             }),
             providers: field({
               type: 'object',