@movk/nuxt-docs 1.8.0 → 1.8.1

package/app/app.config.ts

@@ -108,8 +108,7 @@ export default defineAppConfig({
       streaming: 'i-lucide-chevron-down',
       providers: {
         mistral: 'i-simple-icons-mistralai',
-        kwaipilot: 'i-lucide-wand',
-        zai: 'i-lucide-wand'
+        kwaipilot: 'i-lucide-wand'
       }
     }
   }

package/app/components/content/Mermaid.vue

@@ -81,10 +81,11 @@ const diagramRef = ref<HTMLElement | null>(null)
 const isRendered = ref(false)
 const hasError = ref(false)
 const errorMessage = ref('')
+const hasBeenVisible = ref(false)
 
 const [isFullscreen, toggleFullscreen] = useToggle(false)
 const { copy, copied } = useClipboard({ source: () => props.code })
-const isVisible = useElementVisibility(containerRef)
+const isVisible = useElementVisibility(containerRef, { threshold: 0.1 })
 
 async function renderMermaid() {
   if (!props.code || isRendered.value || !diagramRef.value) return
@@ -127,7 +128,11 @@ async function reRender() {
 watch(
   [isVisible, diagramRef],
   ([visible, el]) => {
-    if (visible && el && !isRendered.value) {
+    // 记录曾经可见状态，避免快速滚动时错过渲染
+    if (visible) {
+      hasBeenVisible.value = true
+    }
+    if (hasBeenVisible.value && el && !isRendered.value) {
       renderMermaid()
     }
   },

package/modules/ai-chat/index.ts

@@ -22,7 +22,7 @@ export interface AiChatModuleOptions {
    */
   mcpPath?: string
   /**
-   * 通过 AI SDK Gateway 、OpenRouter 使用的 AI 模型
+   * 使用的 AI 模型
    */
   model?: string
   /**
@@ -46,7 +46,7 @@ export default defineNuxtModule<AiChatModuleOptions>({
     models: []
   },
   setup(options, nuxt) {
-    const hasApiKey = !!(process.env.AI_GATEWAY_API_KEY || process.env.OPENROUTER_API_KEY)
+    const hasApiKey = !!(process.env.AI_GATEWAY_API_KEY || process.env.OPENROUTER_API_KEY || process.env.ZHIPU_API_KEY)
 
     const { resolve } = createResolver(import.meta.url)
 
@@ -77,7 +77,7 @@ export default defineNuxtModule<AiChatModuleOptions>({
     }
 
     if (!hasApiKey) {
-      log.warn('[ai-chat] Module disabled: no AI_GATEWAY_API_KEY or OPENROUTER_API_KEY found')
+      log.warn('[ai-chat] Module disabled: no API key found in environment variables.')
       return
     }
 

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

@@ -1,23 +1,29 @@
 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 模型实例
- * @param modelId - 模型标识符,格式为 "provider/model" 或 "model"
- * @returns AI SDK 模型实例
+ * 优先使用注册的提供商，否则回退到 AI Gateway
  */
 export function getModel(modelId: string) {
   const config = useRuntimeConfig()
+  const parsed = modelProviderRegistry.parseModelId(modelId)
 
-  // OpenRouter 模型:以 "openrouter/" 开头
-  if (modelId.startsWith('openrouter/')) {
-    const openRouter = createOpenRouter({
-      apiKey: config.openRouterApiKey as string | undefined
-    })
-    return openRouter.chat(modelId.replace('openrouter/', ''))
+  if (parsed) {
+    const factory = modelProviderRegistry.get(parsed.prefix)
+    if (factory) {
+      return factory({ config, modelId: parsed.modelId })
+    }
   }
 
-  // AI Gateway 模型(默认)
   const gateway = createGateway({
     apiKey: config.aiGatewayApiKey as string | undefined
   })

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

@@ -0,0 +1,34 @@
+import type { LanguageModel } from 'ai'
+
+export interface ModelProviderContext {
+  config: ReturnType<typeof useRuntimeConfig>
+  modelId: string
+}
+
+export type ModelProviderFactory = (context: ModelProviderContext) => LanguageModel
+
+/**
+ * 模型提供商注册表
+ */
+class ModelProviderRegistry {
+  private providers = new Map<string, ModelProviderFactory>()
+
+  register(prefix: string, factory: ModelProviderFactory): void {
+    this.providers.set(prefix, factory)
+  }
+
+  get(prefix: string): ModelProviderFactory | undefined {
+    return this.providers.get(prefix)
+  }
+
+  parseModelId(modelId: string): { prefix: string, modelId: string } | null {
+    const separatorIndex = modelId.indexOf('/')
+    if (separatorIndex === -1) return null
+    return {
+      prefix: modelId.slice(0, separatorIndex),
+      modelId: modelId.slice(separatorIndex + 1)
+    }
+  }
+}
+
+export const modelProviderRegistry = new ModelProviderRegistry()

package/modules/config.ts

@@ -10,6 +10,9 @@ export default defineNuxtModule({
   },
   async setup(_options, nuxt) {
     const { resolve } = createResolver(import.meta.url)
+
+    nuxt.options.alias['#ai-chat'] = resolve('./ai-chat/runtime')
+
     const dir = nuxt.options.rootDir
     const url = inferSiteURL()
     const meta = await getPackageJsonMetadata(dir)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@movk/nuxt-docs",
   "type": "module",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "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>",
@@ -28,9 +28,9 @@
     "README.md"
   ],
   "dependencies": {
-    "@ai-sdk/gateway": "^3.0.17",
+    "@ai-sdk/gateway": "^3.0.19",
     "@ai-sdk/mcp": "^1.0.11",
-    "@ai-sdk/vue": "^3.0.42",
+    "@ai-sdk/vue": "^3.0.45",
     "@iconify-json/lucide": "^1.2.86",
     "@iconify-json/ph": "^1.2.2",
     "@iconify-json/simple-icons": "^1.2.67",
@@ -41,7 +41,7 @@
     "@nuxt/content": "^3.11.0",
     "@nuxt/image": "^2.0.0",
     "@nuxt/kit": "^4.2.2",
-    "@nuxt/ui": "^4.3.0",
+    "@nuxt/ui": "^4.4.0",
     "@nuxtjs/mcp-toolkit": "^0.6.2",
     "@nuxtjs/seo": "^3.3.0",
     "@octokit/rest": "^22.0.1",
@@ -50,9 +50,9 @@
     "@vercel/speed-insights": "^1.3.1",
     "@vueuse/core": "^14.1.0",
     "@vueuse/nuxt": "^14.1.0",
-    "ai": "^6.0.42",
+    "ai": "^6.0.45",
     "defu": "^6.1.4",
-    "dompurify": "^3.2.6",
+    "dompurify": "^3.3.1",
     "exsolve": "^1.0.8",
     "git-url-parse": "^16.1.0",
     "mermaid": "^11.12.2",
@@ -63,7 +63,7 @@
     "ohash": "^2.0.11",
     "pathe": "^2.0.3",
     "pkg-types": "^2.3.0",
-    "prettier": "^3.8.0",
+    "prettier": "^3.8.1",
     "scule": "^1.3.0",
     "shiki": "^3.21.0",
     "shiki-stream": "^0.1.4",