@astro-minimax/ai 0.8.2 → 0.9.0

package/dist/provider-manager/manager.js

@@ -0,0 +1,122 @@
+import { parseProviderConfigs, validateProviderConfig } from "./config.js";
+import { OpenAIAdapter } from "./openai.js";
+import { WorkersAIAdapter } from "./workers.js";
+import { MockAdapter } from "./mock.js";
+class ProviderManager {
+  providers = [];
+  mockAdapter;
+  options;
+  constructor(env, options) {
+    this.options = {
+      unhealthyThreshold: options?.unhealthyThreshold ?? 3,
+      healthRecoveryTTL: options?.healthRecoveryTTL ?? 6e4,
+      enableMockFallback: options?.enableMockFallback ?? true,
+      onProviderSwitch: options?.onProviderSwitch,
+      onStreamError: options?.onStreamError,
+      onHealthChange: options?.onHealthChange
+    };
+    this.mockAdapter = new MockAdapter();
+    this.initializeProviders(env);
+  }
+  initializeProviders(env) {
+    const configs = parseProviderConfigs(env);
+    for (const config of configs) {
+      if (config.enabled === false) continue;
+      const validationError = validateProviderConfig(config);
+      if (validationError) {
+        console.warn(`[ProviderManager] Skipping invalid config: ${validationError}`);
+        continue;
+      }
+      try {
+        const adapter = this.createAdapter(config, env);
+        if (adapter) {
+          this.providers.push(adapter);
+        }
+      } catch (error) {
+        console.warn(`[ProviderManager] Failed to create adapter for ${config.id}:`, error);
+      }
+    }
+    this.providers.sort((a, b) => b.weight - a.weight);
+  }
+  createAdapter(config, env) {
+    switch (config.type) {
+      case "openai":
+        return new OpenAIAdapter(config);
+      case "workers":
+        return new WorkersAIAdapter(config, env);
+      default:
+        return null;
+    }
+  }
+  async getAvailableProvider() {
+    for (const provider of this.providers) {
+      if (await provider.isAvailable()) {
+        return provider;
+      }
+    }
+    return null;
+  }
+  async streamText(options) {
+    let lastProviderId = null;
+    let lastError = null;
+    for (const provider of this.providers) {
+      const isAvailable = await provider.isAvailable();
+      if (!isAvailable) continue;
+      try {
+        const result = await provider.streamText(options);
+        provider.recordSuccess();
+        if (lastProviderId && lastProviderId !== provider.id) {
+          this.options.onProviderSwitch?.(lastProviderId, provider.id, "fallback success");
+        }
+        return result;
+      } catch (error) {
+        lastError = error instanceof Error ? error : new Error(String(error));
+        lastProviderId = provider.id;
+        provider.recordFailure(lastError);
+        this.options.onStreamError?.(provider.id, lastError);
+        if (!provider.getHealth().healthy) {
+          this.options.onHealthChange?.(provider.id, false);
+        }
+      }
+    }
+    if (this.options.enableMockFallback) {
+      this.options.onProviderSwitch?.(lastProviderId, "mock", "all providers failed");
+      return this.mockAdapter.streamText(options);
+    }
+    throw lastError || new Error("No providers available");
+  }
+  getProviderStatus() {
+    return this.providers.map((provider) => ({
+      id: provider.id,
+      type: provider.type,
+      weight: provider.weight,
+      enabled: true,
+      health: provider.getHealth(),
+      model: provider.model
+    }));
+  }
+  hasProviders() {
+    return this.providers.length > 0;
+  }
+  getProviderCount() {
+    return this.providers.length;
+  }
+  async getAvailableAdapter() {
+    return this.getAvailableProvider();
+  }
+}
+let managerInstance = null;
+function getProviderManager(env, options) {
+  if (!managerInstance) {
+    managerInstance = new ProviderManager(env, options);
+  }
+  return managerInstance;
+}
+function resetProviderManager() {
+  managerInstance = null;
+}
+export {
+  ProviderManager,
+  getProviderManager,
+  resetProviderManager
+};

package/dist/provider-manager/mock.js

@@ -0,0 +1,77 @@
+import { BaseProviderAdapter } from "./base.js";
+import { getMockResponse } from "../providers/mock.js";
+const MOCK_WEIGHT = 0;
+const CHAR_DELAY_MS = 15;
+class MockAdapter extends BaseProviderAdapter {
+  id = "mock";
+  type = "mock";
+  weight = MOCK_WEIGHT;
+  model = "mock";
+  keywordModel = "mock";
+  evidenceModel = "mock";
+  timeout = 0;
+  constructor() {
+    super({ unhealthyThreshold: 999 });
+  }
+  async isAvailable() {
+    return true;
+  }
+  async streamText(options) {
+    const { userQuestion = "", lang = "zh" } = options;
+    const text = getMockResponse(userQuestion, lang);
+    const partId = `mock-${Date.now()}`;
+    const encoder = new TextEncoder();
+    const stream = new ReadableStream({
+      async start(controller) {
+        const write = (event) => controller.enqueue(encoder.encode(`data: ${JSON.stringify(event)}
+
+`));
+        write({ type: "text-start", id: partId });
+        for (let i = 0; i < text.length; ) {
+          const chunkSize = Math.random() < 0.3 ? 3 : Math.random() < 0.5 ? 2 : 1;
+          const chunk = text.slice(i, i + chunkSize);
+          i += chunkSize;
+          controller.enqueue(
+            encoder.encode(
+              `data: ${JSON.stringify({ type: "text-delta", id: partId, delta: chunk })}
+
+`
+            )
+          );
+          await new Promise((r) => setTimeout(r, CHAR_DELAY_MS + Math.random() * 20));
+        }
+        controller.enqueue(
+          encoder.encode(`data: ${JSON.stringify({ type: "text-end", id: partId })}
+
+`)
+        );
+        controller.enqueue(
+          encoder.encode(
+            `data: ${JSON.stringify({ type: "finish", finishReason: "stop" })}
+
+`
+          )
+        );
+        controller.close();
+      }
+    });
+    const response = new Response(stream, {
+      headers: {
+        "Content-Type": "text/event-stream; charset=utf-8",
+        "Cache-Control": "no-cache, no-store",
+        "Access-Control-Allow-Origin": "*"
+      }
+    });
+    return {
+      toUIMessageStreamResponse: () => response,
+      providerId: this.id,
+      isMock: true
+    };
+  }
+  getProvider() {
+    throw new Error("Mock provider does not support chatModel interface");
+  }
+}
+export {
+  MockAdapter
+};

package/dist/provider-manager/openai.js

@@ -0,0 +1,106 @@
+import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
+import { streamText, convertToModelMessages } from "ai";
+import { BaseProviderAdapter } from "./base.js";
+let proxyInitialized = false;
+async function setupGlobalProxy() {
+  if (proxyInitialized) return;
+  if (typeof process === "undefined" || !process.env) {
+    return;
+  }
+  const proxyUrl = process.env.https_proxy || process.env.HTTPS_PROXY || process.env.http_proxy || process.env.HTTP_PROXY;
+  if (!proxyUrl) {
+    return;
+  }
+  try {
+    const undici = await import("undici");
+    if (typeof undici.setGlobalDispatcher !== "function" || typeof undici.ProxyAgent !== "function") {
+      console.log("[OpenAIAdapter] undici APIs not available, skipping proxy setup (likely Edge Runtime)");
+      return;
+    }
+    undici.setGlobalDispatcher(new undici.ProxyAgent(proxyUrl));
+    console.log("[OpenAIAdapter] Global proxy dispatcher set:", proxyUrl);
+    proxyInitialized = true;
+  } catch (e) {
+    console.log("[OpenAIAdapter] Proxy setup skipped:", e instanceof Error ? e.message : String(e));
+  }
+}
+let proxySetupPromise = null;
+function ensureProxySetup() {
+  if (!proxySetupPromise) {
+    proxySetupPromise = setupGlobalProxy();
+  }
+  return proxySetupPromise;
+}
+class OpenAIAdapter extends BaseProviderAdapter {
+  id;
+  type = "openai";
+  weight;
+  model;
+  keywordModel;
+  evidenceModel;
+  timeout;
+  provider;
+  config;
+  constructor(config) {
+    super({
+      unhealthyThreshold: config.maxRetries ? config.maxRetries + 2 : 3
+    });
+    this.id = config.id;
+    this.weight = config.weight ?? 100;
+    this.model = config.model;
+    this.keywordModel = config.keywordModel ?? config.model;
+    this.evidenceModel = config.evidenceModel ?? this.keywordModel;
+    this.timeout = config.timeout ?? 3e4;
+    this.config = config;
+    this.provider = createOpenAICompatible({
+      name: `openai-${config.id}`,
+      baseURL: config.baseURL,
+      apiKey: config.apiKey,
+      includeUsage: true
+    });
+    ensureProxySetup().catch(() => {
+    });
+  }
+  async streamText(options) {
+    await ensureProxySetup();
+    const { system, messages, temperature = 0.7, maxOutputTokens, topP, abortSignal, onError } = options;
+    const abortController = new AbortController();
+    const timeoutId = setTimeout(() => abortController.abort(), this.timeout);
+    if (abortSignal) {
+      abortSignal.addEventListener("abort", () => abortController.abort());
+    }
+    try {
+      const result = streamText({
+        model: this.provider.chatModel(this.model),
+        system,
+        messages: await convertToModelMessages(messages),
+        temperature,
+        maxOutputTokens,
+        topP,
+        abortSignal: abortController.signal,
+        onError: ({ error }) => {
+          onError?.(error instanceof Error ? error : new Error(String(error)));
+        }
+      });
+      const streamResult = {
+        toUIMessageStreamResponse: (responseOptions) => result.toUIMessageStreamResponse(responseOptions),
+        providerId: this.id,
+        isMock: false
+      };
+      clearTimeout(timeoutId);
+      return streamResult;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      throw error;
+    }
+  }
+  getConfig() {
+    return { ...this.config };
+  }
+  getProvider() {
+    return this.provider;
+  }
+}
+export {
+  OpenAIAdapter
+};

package/dist/provider-manager/workers.js

@@ -0,0 +1,76 @@
+import { createWorkersAI } from "workers-ai-provider";
+import { streamText, convertToModelMessages } from "ai";
+import { BaseProviderAdapter } from "./base.js";
+class WorkersAIAdapter extends BaseProviderAdapter {
+  id;
+  type = "workers";
+  weight;
+  model;
+  keywordModel;
+  evidenceModel;
+  timeout;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  provider;
+  config;
+  constructor(config, env) {
+    super({
+      unhealthyThreshold: config.maxRetries ? config.maxRetries + 2 : 3
+    });
+    this.id = config.id;
+    this.weight = config.weight ?? 90;
+    this.model = config.model;
+    this.keywordModel = config.keywordModel ?? config.model;
+    this.evidenceModel = config.evidenceModel ?? this.keywordModel;
+    this.timeout = config.timeout ?? 3e4;
+    this.config = config;
+    const binding = env[config.bindingName];
+    if (!binding) {
+      throw new Error(`Workers AI binding '${config.bindingName}' not found in environment`);
+    }
+    this.provider = createWorkersAI({ binding });
+  }
+  async streamText(options) {
+    const { system, messages, temperature = 0.7, maxOutputTokens, topP, abortSignal, onError } = options;
+    const abortController = new AbortController();
+    const timeoutId = setTimeout(() => abortController.abort(), this.timeout);
+    if (abortSignal) {
+      abortSignal.addEventListener("abort", () => abortController.abort());
+    }
+    try {
+      const model = this.provider(this.model, { safePrompt: true });
+      const result = streamText({
+        model,
+        system,
+        messages: await convertToModelMessages(messages),
+        temperature,
+        maxOutputTokens,
+        topP,
+        abortSignal: abortController.signal,
+        onError: ({ error }) => {
+          onError?.(error instanceof Error ? error : new Error(String(error)));
+        }
+      });
+      const streamResult = {
+        toUIMessageStreamResponse: (responseOptions) => result.toUIMessageStreamResponse(responseOptions),
+        providerId: this.id,
+        isMock: false
+      };
+      clearTimeout(timeoutId);
+      return streamResult;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      throw error;
+    }
+  }
+  getConfig() {
+    return { ...this.config };
+  }
+  getProvider() {
+    return {
+      chatModel: (modelId) => this.provider(modelId, { safePrompt: true })
+    };
+  }
+}
+export {
+  WorkersAIAdapter
+};

package/dist/providers/mock.js

@@ -0,0 +1,227 @@
+const MOCK_RESPONSES = [
+  {
+    patterns: [/astro/i, /框架/],
+    zh: `Astro \u662F\u4E00\u4E2A\u73B0\u4EE3\u5316\u7684\u9759\u6001\u7AD9\u70B9\u751F\u6210\u5668\uFF0C\u6838\u5FC3\u4F18\u52BF\u662F"\u5C9B\u5C7F\u67B6\u6784"\u2014\u2014\u9ED8\u8BA4\u96F6 JS\uFF0C\u53EA\u5728\u4EA4\u4E92\u7EC4\u4EF6\u4E0A\u52A0\u8F7D\u811A\u672C\u3002\u672C\u535A\u5BA2\u57FA\u4E8E Astro \u6784\u5EFA\u3002
+
+\u63A8\u8350\u9605\u8BFB\uFF1A
+- [\u5FEB\u901F\u4E0A\u624B\uFF1A\u4E24\u79CD\u96C6\u6210\u65B9\u5F0F](/zh/posts/getting-started) \u2014 \u4E86\u89E3\u5982\u4F55\u642D\u5EFA astro-minimax \u535A\u5BA2
+- [\u5982\u4F55\u914D\u7F6E\u4E3B\u9898](/zh/posts/how-to-configure-astro-minimax-theme) \u2014 \u81EA\u5B9A\u4E49\u4F60\u7684\u535A\u5BA2\u5916\u89C2
+
+\u5916\u90E8\u8D44\u6E90\uFF1A
+- [Astro \u5B98\u65B9\u6587\u6863](https://docs.astro.build) \u2014 \u6DF1\u5165\u5B66\u4E60 Astro \u6846\u67B6
+- [Astro \u4E3B\u9898\u5E02\u573A](https://astro.build/themes/) \u2014 \u53D1\u73B0\u66F4\u591A Astro \u4E3B\u9898`,
+    en: `Astro is a modern static site generator with an "Islands Architecture" \u2014 zero JS by default, loading scripts only for interactive components. This blog is built with Astro.
+
+Recommended reading:
+- [Getting Started: Two Integration Methods](/en/posts/getting-started) \u2014 Learn how to set up an astro-minimax blog
+- [How to Configure the Theme](/en/posts/how-to-configure-astro-minimax-theme) \u2014 Customize your blog
+
+External resources:
+- [Astro Documentation](https://docs.astro.build) \u2014 Learn Astro in depth
+- [Astro Themes](https://astro.build/themes/) \u2014 Discover more themes`
+  },
+  {
+    patterns: [/推荐|文章|看什么|读什么|recommend/i],
+    zh: `\u4EE5\u4E0B\u662F\u4E00\u4E9B\u70ED\u95E8\u6587\u7AE0\u63A8\u8350\uFF1A
+
+**\u5165\u95E8\u7CFB\u5217\uFF1A**
+- [\u5FEB\u901F\u4E0A\u624B\uFF1A\u4E24\u79CD\u96C6\u6210\u65B9\u5F0F](/zh/posts/getting-started) \u2014 \u642D\u5EFA\u4F60\u7684\u7B2C\u4E00\u4E2A\u535A\u5BA2
+- [\u5982\u4F55\u6DFB\u52A0\u65B0\u6587\u7AE0](/zh/posts/adding-new-post) \u2014 \u5185\u5BB9\u521B\u4F5C\u6307\u5357
+- [\u9884\u5B9A\u4E49\u914D\u8272\u65B9\u6848](/zh/posts/predefined-color-schemes) \u2014 \u9009\u4E00\u4E2A\u4F60\u559C\u6B22\u7684\u4E3B\u9898\u8272
+
+**\u6280\u672F\u6DF1\u5EA6\uFF1A**
+- [\u5982\u4F55\u5728\u535A\u5BA2\u4E2D\u4F7F\u7528 LaTeX \u516C\u5F0F](/zh/posts/how-to-add-latex-equations-in-blog-posts) \u2014 \u6570\u5B66\u516C\u5F0F\u652F\u6301
+- [\u52A8\u6001 OG \u56FE\u7247\u751F\u6210](/zh/posts/dynamic-og-images) \u2014 \u81EA\u52A8\u751F\u6210\u793E\u4EA4\u5206\u4EAB\u56FE
+
+\u4F60\u5BF9\u54EA\u4E2A\u65B9\u5411\u7684\u5185\u5BB9\u66F4\u611F\u5174\u8DA3\uFF1F\u6211\u53EF\u4EE5\u505A\u66F4\u7CBE\u51C6\u7684\u63A8\u8350\u3002`,
+    en: `Here are some recommended articles:
+
+**Getting Started:**
+- [Getting Started: Two Integration Methods](/en/posts/getting-started) \u2014 Build your first blog
+- [Adding New Posts](/en/posts/adding-new-post) \u2014 Content creation guide
+- [Predefined Color Schemes](/en/posts/predefined-color-schemes) \u2014 Pick your favorite theme color
+
+**Technical Deep Dives:**
+- [LaTeX Equations in Blog Posts](/en/posts/how-to-add-latex-equations-in-blog-posts) \u2014 Math formula support
+- [Dynamic OG Images](/en/posts/dynamic-og-images) \u2014 Auto-generate social share images
+
+What direction interests you more? I can provide more specific recommendations.`
+  },
+  {
+    patterns: [/博客|blog|功能|feature/i],
+    zh: `\u8FD9\u4E2A\u535A\u5BA2\u57FA\u4E8E **astro-minimax** \u4E3B\u9898\uFF0C\u529F\u80FD\u4E30\u5BCC\uFF1A
+
+\u6838\u5FC3\u529F\u80FD\uFF1AMarkdown/MDX\u3001\u4EE3\u7801\u9AD8\u4EAE\u3001[\u6570\u5B66\u516C\u5F0F(KaTeX)](/zh/posts/how-to-add-latex-equations-in-blog-posts)\u3001[Mermaid \u56FE\u8868](/zh/posts/mermaid-diagrams)\u3001\u6807\u7B7E\u5206\u7C7B\u3001\u5168\u6587\u641C\u7D22(Pagefind)\u3001[Waline \u8BC4\u8BBA](https://waline.js.org)\u3001\u6DF1\u8272\u6A21\u5F0F\u3002
+
+\u4E86\u89E3\u66F4\u591A\uFF1A
+- [\u914D\u7F6E\u6307\u5357](/zh/posts/how-to-configure-astro-minimax-theme) \u2014 \u5B8C\u6574\u914D\u7F6E\u9009\u9879
+- [Markdown \u6269\u5C55\u8BED\u6CD5](/zh/posts/markdown-extended) \u2014 \u6240\u6709\u652F\u6301\u7684\u8BED\u6CD5\u7279\u6027
+
+\u5F00\u6E90\u5730\u5740\uFF1A[souloss/astro-minimax](https://github.com/souloss/astro-minimax)`,
+    en: `This blog uses the **astro-minimax** theme with rich features:
+
+Core features: Markdown/MDX, syntax highlighting, [math equations (KaTeX)](/en/posts/how-to-add-latex-equations-in-blog-posts), [Mermaid diagrams](/en/posts/mermaid-diagrams), tags & categories, full-text search (Pagefind), [Waline comments](https://waline.js.org), dark mode.
+
+Learn more:
+- [Configuration Guide](/en/posts/how-to-configure-astro-minimax-theme) \u2014 Full config options
+- [Extended Markdown](/en/posts/markdown-extended) \u2014 All supported syntax features
+
+Open source: [souloss/astro-minimax](https://github.com/souloss/astro-minimax)`
+  },
+  {
+    patterns: [/主题|theme|暗色|dark|颜色|color|配色/i],
+    zh: `\u535A\u5BA2\u652F\u6301\u4EAE\u8272\u548C\u6697\u8272\u4E3B\u9898\uFF0C\u53F3\u4E0B\u89D2\u6309\u94AE\u5373\u53EF\u5207\u6362\uFF0C\u4E5F\u4F1A\u81EA\u52A8\u68C0\u6D4B\u7CFB\u7EDF\u504F\u597D\u3002
+
+\u914D\u8272\u65B9\u6848\u53EF\u4EE5\u5728\u914D\u7F6E\u4E2D\u81EA\u5B9A\u4E49\uFF0C\u76EE\u524D\u63D0\u4F9B\u591A\u79CD\u9884\u8BBE\uFF1A
+- [\u9884\u5B9A\u4E49\u914D\u8272\u65B9\u6848](/zh/posts/predefined-color-schemes) \u2014 \u67E5\u770B\u6240\u6709\u53EF\u7528\u914D\u8272
+- [\u4E3B\u9898\u914D\u7F6E\u6307\u5357](/zh/posts/how-to-configure-astro-minimax-theme) \u2014 \u521B\u5EFA\u4F60\u81EA\u5DF1\u7684\u914D\u8272
+
+\u53C2\u8003 [Tailwind CSS \u8C03\u8272\u677F](https://tailwindcss.com/docs/customizing-colors) \u83B7\u53D6\u7075\u611F\u3002`,
+    en: `The blog supports light and dark themes \u2014 toggle with the bottom-right button or auto-detect system preference.
+
+Color schemes are customizable:
+- [Predefined Color Schemes](/en/posts/predefined-color-schemes) \u2014 See all available schemes
+- [Theme Configuration Guide](/en/posts/how-to-configure-astro-minimax-theme) \u2014 Create your own
+
+Check [Tailwind CSS Color Palette](https://tailwindcss.com/docs/customizing-colors) for inspiration.`
+  },
+  {
+    patterns: [/搭建|部署|deploy|build|install|安装|搭/i],
+    zh: `\u642D\u5EFA\u7C7B\u4F3C\u7684\u535A\u5BA2\u975E\u5E38\u7B80\u5355\uFF01\u6709\u4E24\u79CD\u65B9\u5F0F\uFF1A
+
+1. **GitHub \u6A21\u677F**\uFF08\u63A8\u8350\u65B0\u624B\uFF09\u2014 \u4E00\u952E Fork\uFF0C\u5F00\u7BB1\u5373\u7528
+2. **NPM \u5305\u96C6\u6210** \u2014 \u9002\u5408\u5185\u5BB9\u4E0E\u7CFB\u7EDF\u5206\u79BB\u7684\u8FDB\u9636\u7528\u6CD5
+
+\u8BE6\u7EC6\u6B65\u9AA4\u8BF7\u770B [\u5FEB\u901F\u4E0A\u624B](/zh/posts/getting-started)\u3002
+
+\u90E8\u7F72\u63A8\u8350 [Cloudflare Pages](https://pages.cloudflare.com)\uFF08\u514D\u8D39\u3001\u5168\u7403 CDN\uFF09\uFF0C\u4E5F\u652F\u6301 [Vercel](https://vercel.com) \u548C [Netlify](https://netlify.com)\u3002`,
+    en: `Setting up a similar blog is easy! Two methods:
+
+1. **GitHub Template** (recommended for beginners) \u2014 One-click fork, ready to use
+2. **NPM Package Integration** \u2014 For advanced content/system separation
+
+See [Getting Started](/en/posts/getting-started) for detailed steps.
+
+Deploy with [Cloudflare Pages](https://pages.cloudflare.com) (free, global CDN), or [Vercel](https://vercel.com) / [Netlify](https://netlify.com).`
+  },
+  {
+    patterns: [/rust/i],
+    zh: `\u535A\u5BA2\u4E2D\u6709\u4E00\u7CFB\u5217 Rust \u6587\u7AE0\uFF1A
+- [Rust \u5165\u95E8\u4ECB\u7ECD](/zh/posts/rust-series-01-introduction) \u2014 \u8BED\u8A00\u57FA\u7840
+- [\u6240\u6709\u6743\u7CFB\u7EDF](/zh/posts/rust-series-02-ownership) \u2014 Rust \u6838\u5FC3\u6982\u5FF5
+- [\u9519\u8BEF\u5904\u7406](/zh/posts/rust-series-03-error-handling) \u2014 Result \u548C Option
+- [\u5E76\u53D1\u7F16\u7A0B](/zh/posts/rust-series-04-concurrency) \u2014 \u5B89\u5168\u7684\u591A\u7EBF\u7A0B
+
+\u5916\u90E8\u5B66\u4E60\u8D44\u6E90\uFF1A
+- [The Rust Book](https://doc.rust-lang.org/book/) \u2014 \u5B98\u65B9\u6559\u7A0B
+- [Rust by Example](https://doc.rust-lang.org/rust-by-example/) \u2014 \u5B9E\u4F8B\u5B66\u4E60`,
+    en: `The blog has a Rust series:
+- [Rust Introduction](/en/posts/rust-series-01-introduction) \u2014 Language basics
+- [Ownership System](/en/posts/rust-series-02-ownership) \u2014 Core Rust concept
+- [Error Handling](/en/posts/rust-series-03-error-handling) \u2014 Result and Option
+- [Concurrency](/en/posts/rust-series-04-concurrency) \u2014 Safe multithreading
+
+External resources:
+- [The Rust Book](https://doc.rust-lang.org/book/) \u2014 Official tutorial
+- [Rust by Example](https://doc.rust-lang.org/rust-by-example/) \u2014 Learn by examples`
+  },
+  {
+    patterns: [/ai|人工智能|助手|assistant|chat/i],
+    zh: `\u6211\u662F\u8FD9\u4E2A\u535A\u5BA2\u7684 AI \u52A9\u624B\uFF01\u5F53\u524D\u8FD0\u884C\u5728 Demo \u6A21\u5F0F\uFF0C\u53EF\u4EE5\uFF1A
+- \u6839\u636E\u4F60\u7684\u95EE\u9898\u63A8\u8350\u76F8\u5173\u535A\u5BA2\u6587\u7AE0
+- \u63A8\u8350\u6709\u7528\u7684\u5916\u90E8\u5B66\u4E60\u8D44\u6E90
+- \u89E3\u7B54\u5173\u4E8E\u535A\u5BA2\u6280\u672F\u6808\u7684\u95EE\u9898
+
+\u542F\u7528\u5B8C\u6574 AI \u529F\u80FD\uFF08RAG \u641C\u7D22\u589E\u5F3A\uFF09\u9700\u8981\u914D\u7F6E \`AI_BASE_URL\` \u548C \`AI_API_KEY\` \u73AF\u5883\u53D8\u91CF\u3002
+
+\u8BD5\u8BD5\u95EE\u6211\uFF1A"\u6709\u54EA\u4E9B\u6587\u7AE0\u63A8\u8350\uFF1F" \u6216 "\u600E\u4E48\u642D\u5EFA\u7C7B\u4F3C\u7684\u535A\u5BA2\uFF1F"`,
+    en: `I'm the blog AI assistant! Currently in Demo mode, I can:
+- Recommend relevant blog articles based on your questions
+- Suggest useful external learning resources
+- Answer questions about the blog's tech stack
+
+For full AI features (RAG search enhancement), configure \`AI_BASE_URL\` and \`AI_API_KEY\` environment variables.
+
+Try asking: "Recommend some articles?" or "How to build a similar blog?"`
+  },
+  {
+    patterns: [/搜索|search|pagefind/i],
+    zh: `\u535A\u5BA2\u96C6\u6210\u4E86 [Pagefind](https://pagefind.app) \u5168\u6587\u641C\u7D22\u5F15\u64CE\uFF0C\u6784\u5EFA\u65F6\u81EA\u52A8\u7D22\u5F15\u3002\u70B9\u51FB\u9875\u9762\u9876\u90E8\u641C\u7D22\u56FE\u6807\u5373\u53EF\u4F7F\u7528\u3002
+
+\u4E86\u89E3\u66F4\u591A\u641C\u7D22\u529F\u80FD\uFF1A
+- [Pagefind \u5B98\u65B9\u6587\u6863](https://pagefind.app/docs/) \u2014 \u5B8C\u6574\u914D\u7F6E\u6307\u5357
+- \u641C\u7D22\u652F\u6301\u4E2D\u6587\u548C\u82F1\u6587\u5185\u5BB9`,
+    en: `The blog integrates [Pagefind](https://pagefind.app) for full-text search, auto-indexed at build time. Click the search icon at the top to use it.
+
+Learn more:
+- [Pagefind Documentation](https://pagefind.app/docs/) \u2014 Complete configuration guide
+- Search supports both Chinese and English content`
+  },
+  {
+    patterns: [/markdown|mdx|语法|syntax|公式|latex|mermaid|图表/i],
+    zh: `\u535A\u5BA2\u652F\u6301\u4E30\u5BCC\u7684\u5185\u5BB9\u8BED\u6CD5\uFF1A
+
+- [Markdown \u57FA\u7840\u8BED\u6CD5](/zh/posts/markdown-basics) \u2014 \u6807\u9898\u3001\u5217\u8868\u3001\u8868\u683C\u7B49
+- [Markdown \u6269\u5C55\u8BED\u6CD5](/zh/posts/markdown-extended) \u2014 \u811A\u6CE8\u3001\u9AD8\u4EAE\u3001\u6298\u53E0\u7B49
+- [LaTeX \u6570\u5B66\u516C\u5F0F](/zh/posts/how-to-add-latex-equations-in-blog-posts) \u2014 KaTeX \u6E32\u67D3
+- [Mermaid \u56FE\u8868](/zh/posts/mermaid-diagrams) \u2014 \u6D41\u7A0B\u56FE\u3001\u65F6\u5E8F\u56FE
+- [Markmap \u601D\u7EF4\u5BFC\u56FE](/zh/posts/markmap-mindmaps) \u2014 \u4EA4\u4E92\u5F0F\u601D\u7EF4\u5BFC\u56FE
+
+\u5916\u90E8\u53C2\u8003\uFF1A[GitHub Flavored Markdown](https://github.github.com/gfm/)`,
+    en: `The blog supports rich content syntax:
+
+- [Markdown Basics](/en/posts/markdown-basics) \u2014 Headings, lists, tables
+- [Extended Markdown](/en/posts/markdown-extended) \u2014 Footnotes, highlights, collapsible
+- [LaTeX Equations](/en/posts/how-to-add-latex-equations-in-blog-posts) \u2014 KaTeX rendering
+- [Mermaid Diagrams](/en/posts/mermaid-diagrams) \u2014 Flowcharts, sequence diagrams
+- [Markmap Mind Maps](/en/posts/markmap-mindmaps) \u2014 Interactive mind maps
+
+Reference: [GitHub Flavored Markdown](https://github.github.com/gfm/)`
+  }
+];
+const FALLBACK = {
+  zh: `\u611F\u8C22\u63D0\u95EE\uFF01\u6211\u76EE\u524D\u5728 Demo \u6A21\u5F0F\u4E0B\uFF0C\u53EF\u4EE5\u63A8\u8350\u535A\u5BA2\u6587\u7AE0\u548C\u5916\u90E8\u8D44\u6E90\u3002
+
+\u8BD5\u8BD5\u8FD9\u4E9B\u8BDD\u9898\uFF1A
+- "\u6709\u54EA\u4E9B\u6587\u7AE0\u63A8\u8350\uFF1F"
+- "Astro \u6846\u67B6\u662F\u4EC0\u4E48\uFF1F"
+- "\u600E\u4E48\u642D\u5EFA\u7C7B\u4F3C\u7684\u535A\u5BA2\uFF1F"
+- "\u652F\u6301\u54EA\u4E9B Markdown \u8BED\u6CD5\uFF1F"`,
+  en: `Thanks for asking! I'm in Demo mode and can recommend blog articles and external resources.
+
+Try these topics:
+- "Recommend some articles?"
+- "What is Astro?"
+- "How to build a similar blog?"
+- "What Markdown syntax is supported?"`
+};
+function getMockResponse(question, lang = "zh") {
+  const q = question.toLowerCase();
+  const isZh = lang !== "en";
+  for (const { patterns, zh, en } of MOCK_RESPONSES) {
+    if (patterns.some((p) => p.test(q))) {
+      return isZh ? zh : en;
+    }
+  }
+  return isZh ? FALLBACK.zh : FALLBACK.en;
+}
+function createMockStream(text) {
+  let index = 0;
+  return new ReadableStream({
+    async pull(controller) {
+      if (index >= text.length) {
+        controller.close();
+        return;
+      }
+      const chunkSize = Math.random() < 0.3 ? 2 : 1;
+      const chunk = text.slice(index, index + chunkSize);
+      index += chunkSize;
+      controller.enqueue(chunk);
+      await new Promise((resolve) => setTimeout(resolve, 12 + Math.random() * 23));
+    }
+  });
+}
+export {
+  createMockStream,
+  getMockResponse
+};

package/dist/search/idf.js

@@ -0,0 +1,24 @@
+function buildIDFMap(documents) {
+  const N = documents.length;
+  if (N === 0) return { weights: /* @__PURE__ */ new Map(), docCount: 0 };
+  const df = /* @__PURE__ */ new Map();
+  for (const doc of documents) {
+    const uniqueTokens = new Set(doc.tokens);
+    for (const token of uniqueTokens) {
+      df.set(token, (df.get(token) || 0) + 1);
+    }
+  }
+  const weights = /* @__PURE__ */ new Map();
+  for (const [term, count] of df) {
+    weights.set(term, Math.log(N / (count + 1)) + 1);
+  }
+  return { weights, docCount: N };
+}
+function getIDFWeight(idfMap, token) {
+  if (!idfMap) return 1;
+  return idfMap.weights.get(token) ?? Math.log(idfMap.docCount + 1) + 1;
+}
+export {
+  buildIDFMap,
+  getIDFWeight
+};