sa2kit 3.7.0 → 3.8.0

package/dist/common/aiApi/client/index.d.mts

@@ -1,4 +1,5 @@
-import { A as AiClientSettings, a as AiApiResponse, b as AiModelsListResponse, c as AudioStrategy } from '../../../types-CiqMQ-uu.mjs';
+import { A as AiClientSettings, a as AiApiResponse, b as AiModelsListResponse, c as AudioStrategy, d as AiServerConfigStatus } from '../../../types-DgbG0Of-.mjs';
+import React__default from 'react';
 
 declare class AiApiClientError extends Error {
     readonly code?: string | undefined;
@@ -63,9 +64,70 @@ interface AiApiSettings {
 }
 declare const DEFAULT_AI_API_SETTINGS: AiApiSettings;
 declare const AI_API_SETTINGS_STORAGE_KEY = "ai-api-settings";
-declare function loadAiApiSettings(storageKey?: string): AiApiSettings;
+declare function loadAiApiSettings(storageKey?: string, defaults?: AiApiSettings): AiApiSettings;
 declare function saveAiApiSettings(settings: AiApiSettings, storageKey?: string): void;
 declare function toClientSettings(settings: AiApiSettings): AiClientSettings | undefined;
-declare function pickClientSettingsFromStorage(storageKey?: string): AiClientSettings | undefined;
+/**
+ * 浏览器未填写 API Key 时，完全依赖服务端环境变量（AI_API_KEY 等），
+ * 避免 localStorage 中的 baseUrl/model 覆盖宿主 YAML 配置。
+ */
+declare function toServerClientSettings(settings: AiApiSettings): AiClientSettings | undefined;
+/** 仅当浏览器填写了 API Key 时才向服务端传递 clientSettings */
+declare function pickClientSettingsFromStorage(storageKey?: string, defaults?: AiApiSettings): AiClientSettings | undefined;
+
+interface UseAiModelsOptions {
+    modelsEndpoint?: string;
+    debounceMs?: number;
+}
+interface UseAiModelsResult {
+    visionModels: string[];
+    allModels: string[];
+    loading: boolean;
+    error: string | null;
+    refresh: () => void;
+}
+declare function useAiModels(settings: AiApiSettings, onSuggestedModel?: (model: string) => void, options?: UseAiModelsOptions): UseAiModelsResult;
+
+interface UseAiServerConfigOptions {
+    /** 宿主实现的配置状态端点，默认 GET /api/ai/config */
+    configEndpoint?: string;
+}
+declare function useAiServerConfig(options?: UseAiServerConfigOptions): {
+    config: AiServerConfigStatus | null;
+    loading: boolean;
+    error: string | null;
+};
+
+interface AiApiSettingsContextValue {
+    settings: AiApiSettings;
+    updateSettings: (updates: Partial<AiApiSettings>) => void;
+    resetSettings: () => void;
+}
+interface AiApiSettingsProviderProps {
+    children: React__default.ReactNode;
+    /** 宿主可覆盖默认 baseUrl / model（如 MiMo） */
+    defaultSettings?: Partial<AiApiSettings>;
+    storageKey?: string;
+}
+declare function AiApiSettingsProvider({ children, defaultSettings, storageKey, }: AiApiSettingsProviderProps): React__default.JSX.Element;
+declare function useAiApiSettings(): AiApiSettingsContextValue;
+
+interface AiApiSettingsPanelProps {
+    /** 宿主实现的配置状态端点 */
+    serverConfigEndpoint?: string;
+    modelsEndpoint?: string;
+    runEndpoint?: string;
+    /** 未配置服务端时的提示文案 */
+    serverMissingHint?: React__default.ReactNode;
+    apiKeyPlaceholder?: string;
+    baseUrlPlaceholder?: string;
+    visionModelPlaceholder?: string;
+}
+declare function AiApiSettingsPanel({ serverConfigEndpoint, modelsEndpoint, runEndpoint, serverMissingHint, apiKeyPlaceholder, baseUrlPlaceholder, visionModelPlaceholder, }: AiApiSettingsPanelProps): React__default.JSX.Element;
+
+interface AiApiConnectivityTestProps {
+    runEndpoint?: string;
+}
+declare function AiApiConnectivityTest({ runEndpoint }: AiApiConnectivityTestProps): React__default.JSX.Element;
 
-export { AI_API_SETTINGS_STORAGE_KEY, AiApiClientError, type AiApiClientOptions, type AiApiSettings, DEFAULT_AI_API_SETTINGS, aiApiClient, createAiTaskRunner, fetchAiModels, loadAiApiSettings, pickClientSettingsFromStorage, runAiTask, runAiTaskOrThrow, saveAiApiSettings, toClientSettings, useAiTask };
+export { AI_API_SETTINGS_STORAGE_KEY, AiApiClientError, type AiApiClientOptions, AiApiConnectivityTest, type AiApiConnectivityTestProps, type AiApiSettings, type AiApiSettingsContextValue, AiApiSettingsPanel, type AiApiSettingsPanelProps, AiApiSettingsProvider, type AiApiSettingsProviderProps, DEFAULT_AI_API_SETTINGS, type UseAiModelsOptions, type UseAiModelsResult, type UseAiServerConfigOptions, aiApiClient, createAiTaskRunner, fetchAiModels, loadAiApiSettings, pickClientSettingsFromStorage, runAiTask, runAiTaskOrThrow, saveAiApiSettings, toClientSettings, toServerClientSettings, useAiApiSettings, useAiModels, useAiServerConfig, useAiTask };

package/dist/common/aiApi/client/index.d.ts

@@ -1,4 +1,5 @@
-import { A as AiClientSettings, a as AiApiResponse, b as AiModelsListResponse, c as AudioStrategy } from '../../../types-CiqMQ-uu.js';
+import { A as AiClientSettings, a as AiApiResponse, b as AiModelsListResponse, c as AudioStrategy, d as AiServerConfigStatus } from '../../../types-DgbG0Of-.js';
+import React__default from 'react';
 
 declare class AiApiClientError extends Error {
     readonly code?: string | undefined;
@@ -63,9 +64,70 @@ interface AiApiSettings {
 }
 declare const DEFAULT_AI_API_SETTINGS: AiApiSettings;
 declare const AI_API_SETTINGS_STORAGE_KEY = "ai-api-settings";
-declare function loadAiApiSettings(storageKey?: string): AiApiSettings;
+declare function loadAiApiSettings(storageKey?: string, defaults?: AiApiSettings): AiApiSettings;
 declare function saveAiApiSettings(settings: AiApiSettings, storageKey?: string): void;
 declare function toClientSettings(settings: AiApiSettings): AiClientSettings | undefined;
-declare function pickClientSettingsFromStorage(storageKey?: string): AiClientSettings | undefined;
+/**
+ * 浏览器未填写 API Key 时，完全依赖服务端环境变量（AI_API_KEY 等），
+ * 避免 localStorage 中的 baseUrl/model 覆盖宿主 YAML 配置。
+ */
+declare function toServerClientSettings(settings: AiApiSettings): AiClientSettings | undefined;
+/** 仅当浏览器填写了 API Key 时才向服务端传递 clientSettings */
+declare function pickClientSettingsFromStorage(storageKey?: string, defaults?: AiApiSettings): AiClientSettings | undefined;
+
+interface UseAiModelsOptions {
+    modelsEndpoint?: string;
+    debounceMs?: number;
+}
+interface UseAiModelsResult {
+    visionModels: string[];
+    allModels: string[];
+    loading: boolean;
+    error: string | null;
+    refresh: () => void;
+}
+declare function useAiModels(settings: AiApiSettings, onSuggestedModel?: (model: string) => void, options?: UseAiModelsOptions): UseAiModelsResult;
+
+interface UseAiServerConfigOptions {
+    /** 宿主实现的配置状态端点，默认 GET /api/ai/config */
+    configEndpoint?: string;
+}
+declare function useAiServerConfig(options?: UseAiServerConfigOptions): {
+    config: AiServerConfigStatus | null;
+    loading: boolean;
+    error: string | null;
+};
+
+interface AiApiSettingsContextValue {
+    settings: AiApiSettings;
+    updateSettings: (updates: Partial<AiApiSettings>) => void;
+    resetSettings: () => void;
+}
+interface AiApiSettingsProviderProps {
+    children: React__default.ReactNode;
+    /** 宿主可覆盖默认 baseUrl / model（如 MiMo） */
+    defaultSettings?: Partial<AiApiSettings>;
+    storageKey?: string;
+}
+declare function AiApiSettingsProvider({ children, defaultSettings, storageKey, }: AiApiSettingsProviderProps): React__default.JSX.Element;
+declare function useAiApiSettings(): AiApiSettingsContextValue;
+
+interface AiApiSettingsPanelProps {
+    /** 宿主实现的配置状态端点 */
+    serverConfigEndpoint?: string;
+    modelsEndpoint?: string;
+    runEndpoint?: string;
+    /** 未配置服务端时的提示文案 */
+    serverMissingHint?: React__default.ReactNode;
+    apiKeyPlaceholder?: string;
+    baseUrlPlaceholder?: string;
+    visionModelPlaceholder?: string;
+}
+declare function AiApiSettingsPanel({ serverConfigEndpoint, modelsEndpoint, runEndpoint, serverMissingHint, apiKeyPlaceholder, baseUrlPlaceholder, visionModelPlaceholder, }: AiApiSettingsPanelProps): React__default.JSX.Element;
+
+interface AiApiConnectivityTestProps {
+    runEndpoint?: string;
+}
+declare function AiApiConnectivityTest({ runEndpoint }: AiApiConnectivityTestProps): React__default.JSX.Element;
 
-export { AI_API_SETTINGS_STORAGE_KEY, AiApiClientError, type AiApiClientOptions, type AiApiSettings, DEFAULT_AI_API_SETTINGS, aiApiClient, createAiTaskRunner, fetchAiModels, loadAiApiSettings, pickClientSettingsFromStorage, runAiTask, runAiTaskOrThrow, saveAiApiSettings, toClientSettings, useAiTask };
+export { AI_API_SETTINGS_STORAGE_KEY, AiApiClientError, type AiApiClientOptions, AiApiConnectivityTest, type AiApiConnectivityTestProps, type AiApiSettings, type AiApiSettingsContextValue, AiApiSettingsPanel, type AiApiSettingsPanelProps, AiApiSettingsProvider, type AiApiSettingsProviderProps, DEFAULT_AI_API_SETTINGS, type UseAiModelsOptions, type UseAiModelsResult, type UseAiServerConfigOptions, aiApiClient, createAiTaskRunner, fetchAiModels, loadAiApiSettings, pickClientSettingsFromStorage, runAiTask, runAiTaskOrThrow, saveAiApiSettings, toClientSettings, toServerClientSettings, useAiApiSettings, useAiModels, useAiServerConfig, useAiTask };

package/dist/common/aiApi/client/index.js

@@ -1,7 +1,13 @@
 'use strict';
 
+var chunkGJVEYCS4_js = require('../../../chunk-GJVEYCS4.js');
 require('../../../chunk-NSBPE2FW.js');
-var react = require('react');
+var React3 = require('react');
+var lucideReact = require('lucide-react');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var React3__default = /*#__PURE__*/_interopDefault(React3);
 
 // src/common/aiApi/client/settingsCore.ts
 var DEFAULT_AI_API_SETTINGS = {
@@ -13,14 +19,14 @@ var DEFAULT_AI_API_SETTINGS = {
   audioStrategy: "auto"
 };
 var AI_API_SETTINGS_STORAGE_KEY = "ai-api-settings";
-function loadAiApiSettings(storageKey = AI_API_SETTINGS_STORAGE_KEY) {
-  if (typeof window === "undefined") return DEFAULT_AI_API_SETTINGS;
+function loadAiApiSettings(storageKey = AI_API_SETTINGS_STORAGE_KEY, defaults = DEFAULT_AI_API_SETTINGS) {
+  if (typeof window === "undefined") return defaults;
   try {
     const raw = localStorage.getItem(storageKey);
-    if (!raw) return DEFAULT_AI_API_SETTINGS;
-    return { ...DEFAULT_AI_API_SETTINGS, ...JSON.parse(raw) };
+    if (!raw) return defaults;
+    return { ...defaults, ...JSON.parse(raw) };
   } catch {
-    return DEFAULT_AI_API_SETTINGS;
+    return defaults;
   }
 }
 function saveAiApiSettings(settings, storageKey = AI_API_SETTINGS_STORAGE_KEY) {
@@ -40,8 +46,14 @@ function toClientSettings(settings) {
   if (settings.audioStrategy) client.audioStrategy = settings.audioStrategy;
   return Object.keys(client).length > 0 ? client : void 0;
 }
-function pickClientSettingsFromStorage(storageKey = AI_API_SETTINGS_STORAGE_KEY) {
-  return toClientSettings(loadAiApiSettings(storageKey));
+function toServerClientSettings(settings) {
+  if (!settings.apiKey.trim()) {
+    return void 0;
+  }
+  return toClientSettings(settings);
+}
+function pickClientSettingsFromStorage(storageKey = AI_API_SETTINGS_STORAGE_KEY, defaults = DEFAULT_AI_API_SETTINGS) {
+  return toServerClientSettings(loadAiApiSettings(storageKey, defaults));
 }
 
 // src/common/aiApi/client/aiApiClient.ts
@@ -56,7 +68,7 @@ var AiApiClientError = class extends Error {
 async function runAiTask(taskId, input, options) {
   const fetchFn = options?.fetchImpl ?? fetch;
   const endpoint = options?.runEndpoint ?? "/api/ai/run";
-  const clientSettings = options?.clientSettings ?? pickClientSettingsFromStorage();
+  const clientSettings = options !== void 0 && "clientSettings" in options ? options.clientSettings : pickClientSettingsFromStorage();
   const payload = {
     taskId,
     input,
@@ -100,20 +112,24 @@ var aiApiClient = {
 async function fetchAiModels(clientSettings, options) {
   const fetchFn = options?.fetchImpl ?? fetch;
   const endpoint = options?.modelsEndpoint ?? "/api/ai/models";
+  const body = {};
+  if (clientSettings) {
+    body.clientSettings = clientSettings;
+  }
   const response = await fetchFn(endpoint, {
     method: "POST",
     credentials: "include",
     headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ clientSettings }),
+    body: JSON.stringify(body),
     signal: options?.signal
   });
   return await response.json();
 }
 function useAiTask(taskId) {
-  const [loading, setLoading] = react.useState(false);
-  const [error, setError] = react.useState(null);
-  const [result, setResult] = react.useState(null);
-  const execute = react.useCallback(
+  const [loading, setLoading] = React3.useState(false);
+  const [error, setError] = React3.useState(null);
+  const [result, setResult] = React3.useState(null);
+  const execute = React3.useCallback(
     async (input, options) => {
       setLoading(true);
       setError(null);
@@ -140,16 +156,341 @@ function useAiTask(taskId) {
     },
     [taskId]
   );
-  const reset = react.useCallback(() => {
+  const reset = React3.useCallback(() => {
     setLoading(false);
     setError(null);
     setResult(null);
   }, []);
   return { execute, loading, error, result, reset };
 }
+function useAiModels(settings, onSuggestedModel, options) {
+  const [visionModels, setVisionModels] = React3.useState([]);
+  const [allModels, setAllModels] = React3.useState([]);
+  const [loading, setLoading] = React3.useState(false);
+  const [error, setError] = React3.useState(null);
+  const abortRef = React3.useRef(null);
+  const onSuggestedRef = React3.useRef(onSuggestedModel);
+  const settingsRef = React3.useRef(settings);
+  onSuggestedRef.current = onSuggestedModel;
+  settingsRef.current = settings;
+  const load = React3.useCallback(async () => {
+    abortRef.current?.abort();
+    const controller = new AbortController();
+    abortRef.current = controller;
+    setLoading(true);
+    setError(null);
+    const currentSettings = settingsRef.current;
+    try {
+      const clientSettings = toServerClientSettings(currentSettings);
+      const result = await fetchAiModels(clientSettings, {
+        signal: controller.signal,
+        modelsEndpoint: options?.modelsEndpoint
+      });
+      if (controller.signal.aborted) return;
+      if (!result.success) {
+        setVisionModels([]);
+        setAllModels([]);
+        setError(result.error?.message ?? "\u83B7\u53D6\u6A21\u578B\u5217\u8868\u5931\u8D25");
+        return;
+      }
+      setVisionModels(result.visionModels);
+      setAllModels(result.models);
+      if (result.suggestedVisionModel) {
+        const current = currentSettings.visionModel.trim();
+        const shouldAutoSelect = !current || !result.visionModels.includes(current) && !result.models.includes(current);
+        if (shouldAutoSelect) {
+          onSuggestedRef.current?.(result.suggestedVisionModel);
+        }
+      }
+    } catch (err) {
+      if (controller.signal.aborted) return;
+      setVisionModels([]);
+      setAllModels([]);
+      setError(err instanceof Error ? err.message : "\u83B7\u53D6\u6A21\u578B\u5217\u8868\u5931\u8D25");
+    } finally {
+      if (!controller.signal.aborted) {
+        setLoading(false);
+      }
+    }
+  }, [options?.modelsEndpoint, settings.apiKey, settings.baseUrl]);
+  React3.useEffect(() => {
+    const debounceMs = options?.debounceMs ?? 600;
+    const timer = window.setTimeout(() => {
+      void load();
+    }, debounceMs);
+    return () => {
+      window.clearTimeout(timer);
+      abortRef.current?.abort();
+    };
+  }, [load, options?.debounceMs]);
+  return {
+    visionModels,
+    allModels,
+    loading,
+    error,
+    refresh: load
+  };
+}
+function useAiServerConfig(options) {
+  const [config, setConfig] = React3.useState(null);
+  const [loading, setLoading] = React3.useState(true);
+  const [error, setError] = React3.useState(null);
+  const configEndpoint = options?.configEndpoint ?? "/api/ai/config";
+  React3.useEffect(() => {
+    let cancelled = false;
+    async function load() {
+      try {
+        const response = await fetch(configEndpoint, { credentials: "include" });
+        if (!response.ok) {
+          if (!cancelled) {
+            setConfig({ serverConfigured: false });
+            setError(response.status === 401 ? "\u8BF7\u5148\u767B\u5F55" : "\u65E0\u6CD5\u8BFB\u53D6\u670D\u52A1\u7AEF\u914D\u7F6E");
+          }
+          return;
+        }
+        const data = await response.json();
+        if (!cancelled) {
+          setConfig(data);
+          setError(null);
+        }
+      } catch (err) {
+        if (!cancelled) {
+          setConfig({ serverConfigured: false });
+          setError(err instanceof Error ? err.message : "\u65E0\u6CD5\u8BFB\u53D6\u670D\u52A1\u7AEF\u914D\u7F6E");
+        }
+      } finally {
+        if (!cancelled) setLoading(false);
+      }
+    }
+    void load();
+    return () => {
+      cancelled = true;
+    };
+  }, [configEndpoint]);
+  return { config, loading, error };
+}
+var AiApiSettingsContext = React3.createContext(null);
+function AiApiSettingsProvider({
+  children,
+  defaultSettings,
+  storageKey
+}) {
+  const mergedDefaults = React3.useMemo(
+    () => ({ ...DEFAULT_AI_API_SETTINGS, ...defaultSettings }),
+    [defaultSettings]
+  );
+  const [settings, setSettings] = React3.useState(mergedDefaults);
+  React3.useEffect(() => {
+    setSettings(loadAiApiSettings(storageKey, mergedDefaults));
+  }, [storageKey, mergedDefaults]);
+  const persist = React3.useCallback(
+    (next) => {
+      setSettings(next);
+      saveAiApiSettings(next, storageKey);
+    },
+    [storageKey]
+  );
+  const updateSettings = React3.useCallback(
+    (updates) => {
+      setSettings((prev) => {
+        const next = { ...prev, ...updates };
+        saveAiApiSettings(next, storageKey);
+        return next;
+      });
+    },
+    [storageKey]
+  );
+  const resetSettings = React3.useCallback(() => {
+    persist(mergedDefaults);
+  }, [persist, mergedDefaults]);
+  const value = React3.useMemo(
+    () => ({ settings, updateSettings, resetSettings }),
+    [settings, updateSettings, resetSettings]
+  );
+  return /* @__PURE__ */ React3__default.default.createElement(AiApiSettingsContext.Provider, { value }, children);
+}
+function useAiApiSettings() {
+  const ctx = React3.useContext(AiApiSettingsContext);
+  if (!ctx) {
+    throw new Error("useAiApiSettings must be used within AiApiSettingsProvider");
+  }
+  return ctx;
+}
+function AiApiConnectivityTest({ runEndpoint }) {
+  const { settings } = useAiApiSettings();
+  const [status, setStatus] = React3.useState("idle");
+  const [message, setMessage] = React3.useState("");
+  const [meta, setMeta] = React3.useState(null);
+  const handleTest = React3.useCallback(async () => {
+    setStatus("loading");
+    setMessage("");
+    setMeta(null);
+    const started = Date.now();
+    const clientSettings = toServerClientSettings(settings);
+    try {
+      const result = await runAiTask(
+        chunkGJVEYCS4_js.CORE_CONNECTIVITY_TEST_TASK_ID,
+        {},
+        { clientSettings, runEndpoint }
+      );
+      const latencyMs = result.meta?.latencyMs ?? Date.now() - started;
+      if (!result.success) {
+        setStatus("error");
+        setMessage(result.error?.message ?? "\u8FDE\u901A\u6027\u6D4B\u8BD5\u5931\u8D25");
+        setMeta({ latencyMs });
+        return;
+      }
+      setStatus("success");
+      setMessage(result.data?.reply ? `\u54CD\u5E94\uFF1A${result.data.reply}` : "\u8FDE\u63A5\u6B63\u5E38");
+      setMeta({ model: result.meta?.model, latencyMs });
+    } catch (err) {
+      setStatus("error");
+      setMessage(err instanceof Error ? err.message : "\u7F51\u7EDC\u8BF7\u6C42\u5931\u8D25");
+      setMeta({ latencyMs: Date.now() - started });
+    }
+  }, [settings, runEndpoint]);
+  return /* @__PURE__ */ React3__default.default.createElement("div", { className: "rounded-xl border border-slate-200 bg-slate-50/80 p-4" }, /* @__PURE__ */ React3__default.default.createElement("div", { className: "flex flex-wrap items-start justify-between gap-3" }, /* @__PURE__ */ React3__default.default.createElement("div", null, /* @__PURE__ */ React3__default.default.createElement("h3", { className: "text-sm font-medium text-slate-900" }, "\u8FDE\u901A\u6027\u6D4B\u8BD5"), /* @__PURE__ */ React3__default.default.createElement("p", { className: "mt-1 text-xs text-slate-500" }, "\u4F7F\u7528\u5F53\u524D\u586B\u5199\u7684 Key\u3001Base URL \u4E0E\u6A21\u578B\u53D1\u8D77\u4E00\u6B21\u8F7B\u91CF\u8BF7\u6C42\uFF08\u9700\u5DF2\u767B\u5F55\uFF09\u3002\u672A\u586B\u5199 Key \u65F6\u5C06\u4F7F\u7528\u670D\u52A1\u7AEF\u914D\u7F6E\u3002")), /* @__PURE__ */ React3__default.default.createElement(
+    "button",
+    {
+      type: "button",
+      onClick: () => void handleTest(),
+      disabled: status === "loading",
+      className: "inline-flex h-10 items-center gap-2 rounded-lg bg-slate-900 px-4 text-sm font-medium text-white transition-transform hover:bg-slate-800 active:scale-[0.98] disabled:cursor-not-allowed disabled:opacity-60"
+    },
+    status === "loading" ? /* @__PURE__ */ React3__default.default.createElement(lucideReact.Loader2, { className: "h-4 w-4 animate-spin" }) : /* @__PURE__ */ React3__default.default.createElement(lucideReact.Wifi, { className: "h-4 w-4" }),
+    status === "loading" ? "\u6D4B\u8BD5\u4E2D\u2026" : "\u6D4B\u8BD5\u8FDE\u63A5"
+  )), status !== "idle" && /* @__PURE__ */ React3__default.default.createElement(
+    "div",
+    {
+      className: `mt-3 flex items-start gap-2 rounded-lg px-3 py-2.5 text-sm ${status === "success" ? "bg-emerald-50 text-emerald-800" : status === "error" ? "bg-red-50 text-red-800" : "bg-white text-slate-600"}`
+    },
+    status === "loading" && /* @__PURE__ */ React3__default.default.createElement(lucideReact.Loader2, { className: "mt-0.5 h-4 w-4 shrink-0 animate-spin" }),
+    status === "success" && /* @__PURE__ */ React3__default.default.createElement(lucideReact.CheckCircle2, { className: "mt-0.5 h-4 w-4 shrink-0" }),
+    status === "error" && /* @__PURE__ */ React3__default.default.createElement(lucideReact.XCircle, { className: "mt-0.5 h-4 w-4 shrink-0" }),
+    /* @__PURE__ */ React3__default.default.createElement("div", { className: "min-w-0" }, /* @__PURE__ */ React3__default.default.createElement("p", { className: "text-pretty" }, status === "loading" ? "\u6B63\u5728\u8FDE\u63A5 AI \u670D\u52A1\u2026" : message), meta && (meta.model || meta.latencyMs !== void 0) && status !== "loading" && /* @__PURE__ */ React3__default.default.createElement("p", { className: "mt-1 tabular-nums text-xs opacity-80" }, meta.model && /* @__PURE__ */ React3__default.default.createElement("span", null, "\u6A21\u578B ", meta.model), meta.model && meta.latencyMs !== void 0 && /* @__PURE__ */ React3__default.default.createElement("span", null, " \xB7 "), meta.latencyMs !== void 0 && /* @__PURE__ */ React3__default.default.createElement("span", null, meta.latencyMs, " ms")))
+  ));
+}
+
+// src/common/aiApi/client/components/AiApiSettingsPanel.tsx
+function AiApiSettingsPanel({
+  serverConfigEndpoint,
+  modelsEndpoint,
+  runEndpoint,
+  serverMissingHint,
+  apiKeyPlaceholder = "sk-\u2026",
+  baseUrlPlaceholder = "https://api.openai.com/v1",
+  visionModelPlaceholder = "gpt-4o-mini"
+}) {
+  const { settings, updateSettings } = useAiApiSettings();
+  const { config: serverConfig, loading: serverLoading } = useAiServerConfig({
+    configEndpoint: serverConfigEndpoint
+  });
+  const [showOverride, setShowOverride] = React3.useState(false);
+  const hasBrowserKey = Boolean(settings.apiKey.trim());
+  const serverReady = Boolean(serverConfig?.serverConfigured);
+  const useServerOnly = serverReady && !hasBrowserKey && !showOverride;
+  const handleSuggestedModel = React3.useCallback(
+    (model) => {
+      updateSettings({ visionModel: model });
+    },
+    [updateSettings]
+  );
+  const { visionModels, allModels, loading, error, refresh } = useAiModels(
+    settings,
+    handleSuggestedModel,
+    { modelsEndpoint }
+  );
+  const selectableModels = visionModels;
+  const showDropdown = selectableModels.length > 0;
+  const showAllModelsFallback = visionModels.length === 0 && allModels.length > 0;
+  const defaultServerMissingHint = /* @__PURE__ */ React3__default.default.createElement(React3__default.default.Fragment, null, "\u8BF7\u5728\u5BBF\u4E3B\u914D\u7F6E\u6587\u4EF6\u4E2D\u586B\u5199 AI API Key\uFF08\u5982 YAML \u7684 ", /* @__PURE__ */ React3__default.default.createElement("code", { className: "rounded bg-amber-100 px-1" }, "ai.apiKey"), "\uFF09\uFF0C\u6216\u5728\u4E0B\u65B9\u7684\u6D4F\u89C8\u5668\u8BBE\u7F6E\u4E2D\u586B\u5199\u3002");
+  return /* @__PURE__ */ React3__default.default.createElement("div", { className: "space-y-6" }, serverLoading ? /* @__PURE__ */ React3__default.default.createElement("div", { className: "flex items-center gap-2 rounded-lg border border-slate-200 bg-slate-50 px-4 py-3 text-sm text-slate-600" }, /* @__PURE__ */ React3__default.default.createElement(lucideReact.Loader2, { className: "h-4 w-4 animate-spin" }), "\u6B63\u5728\u68C0\u67E5\u670D\u52A1\u7AEF AI \u914D\u7F6E\u2026") : serverReady && !hasBrowserKey ? /* @__PURE__ */ React3__default.default.createElement("div", { className: "rounded-xl border border-emerald-200 bg-emerald-50/80 p-4" }, /* @__PURE__ */ React3__default.default.createElement("div", { className: "flex items-start gap-3" }, /* @__PURE__ */ React3__default.default.createElement(lucideReact.CheckCircle2, { className: "mt-0.5 h-5 w-5 shrink-0 text-emerald-600" }), /* @__PURE__ */ React3__default.default.createElement("div", { className: "min-w-0" }, /* @__PURE__ */ React3__default.default.createElement("h3", { className: "text-sm font-medium text-emerald-900" }, "\u5DF2\u7531\u670D\u52A1\u7AEF\u914D\u7F6E"), /* @__PURE__ */ React3__default.default.createElement("p", { className: "mt-1 text-xs text-emerald-800/90" }, "AI \u529F\u80FD\u5C06\u4F7F\u7528\u670D\u52A1\u7AEF\u914D\u7F6E\u7684 API Key\uFF0C\u65E0\u9700\u5728\u6B64\u91CD\u590D\u586B\u5199\u3002"), /* @__PURE__ */ React3__default.default.createElement("dl", { className: "mt-3 grid gap-1 text-xs text-emerald-900/80" }, serverConfig?.baseUrl && /* @__PURE__ */ React3__default.default.createElement("div", { className: "flex gap-2" }, /* @__PURE__ */ React3__default.default.createElement("dt", { className: "shrink-0 font-medium" }, "Base URL"), /* @__PURE__ */ React3__default.default.createElement("dd", { className: "truncate font-mono" }, serverConfig.baseUrl)), serverConfig?.visionModel && /* @__PURE__ */ React3__default.default.createElement("div", { className: "flex gap-2" }, /* @__PURE__ */ React3__default.default.createElement("dt", { className: "shrink-0 font-medium" }, "\u89C6\u89C9\u6A21\u578B"), /* @__PURE__ */ React3__default.default.createElement("dd", { className: "font-mono" }, serverConfig.visionModel))), /* @__PURE__ */ React3__default.default.createElement(
+    "button",
+    {
+      type: "button",
+      onClick: () => setShowOverride((v) => !v),
+      className: "mt-3 text-xs font-medium text-emerald-700 underline-offset-2 hover:underline"
+    },
+    showOverride ? "\u6536\u8D77\u81EA\u5B9A\u4E49\u914D\u7F6E" : "\u9AD8\u7EA7\uFF1A\u4F7F\u7528\u6D4F\u89C8\u5668\u81EA\u5B9A\u4E49 Key \u8986\u76D6\u670D\u52A1\u7AEF"
+  )))) : !serverReady && !hasBrowserKey ? /* @__PURE__ */ React3__default.default.createElement("div", { className: "rounded-xl border border-amber-200 bg-amber-50/80 p-4" }, /* @__PURE__ */ React3__default.default.createElement("div", { className: "flex items-start gap-3" }, /* @__PURE__ */ React3__default.default.createElement(lucideReact.Server, { className: "mt-0.5 h-5 w-5 shrink-0 text-amber-600" }), /* @__PURE__ */ React3__default.default.createElement("div", null, /* @__PURE__ */ React3__default.default.createElement("h3", { className: "text-sm font-medium text-amber-900" }, "\u670D\u52A1\u7AEF\u672A\u914D\u7F6E AI"), /* @__PURE__ */ React3__default.default.createElement("p", { className: "mt-1 text-xs text-amber-800/90" }, serverMissingHint ?? defaultServerMissingHint)))) : null, !useServerOnly && /* @__PURE__ */ React3__default.default.createElement(React3__default.default.Fragment, null, /* @__PURE__ */ React3__default.default.createElement("div", null, /* @__PURE__ */ React3__default.default.createElement("label", { htmlFor: "ai-api-key", className: "mb-2 block text-sm font-medium text-gray-700" }, "API Key"), /* @__PURE__ */ React3__default.default.createElement(
+    "input",
+    {
+      id: "ai-api-key",
+      type: "password",
+      autoComplete: "off",
+      value: settings.apiKey,
+      onChange: (e) => updateSettings({ apiKey: e.target.value }),
+      placeholder: apiKeyPlaceholder,
+      className: "w-full rounded-md border border-gray-300 px-3 py-2 font-mono text-sm focus:outline-none focus:ring-2 focus:ring-blue-500"
+    }
+  ), /* @__PURE__ */ React3__default.default.createElement("p", { className: "mt-1.5 text-xs text-gray-500" }, "\u4FDD\u5B58\u5728\u672C\u673A\u6D4F\u89C8\u5668\u3002\u586B\u5199\u540E\u5C06\u8986\u76D6\u670D\u52A1\u7AEF\u914D\u7F6E\uFF1B\u7559\u7A7A\u5219\u4F7F\u7528\u670D\u52A1\u7AEF\u5BC6\u94A5\u3002")), /* @__PURE__ */ React3__default.default.createElement("div", null, /* @__PURE__ */ React3__default.default.createElement("label", { htmlFor: "ai-base-url", className: "mb-2 block text-sm font-medium text-gray-700" }, "API Base URL"), /* @__PURE__ */ React3__default.default.createElement(
+    "input",
+    {
+      id: "ai-base-url",
+      type: "url",
+      value: settings.baseUrl,
+      onChange: (e) => updateSettings({ baseUrl: e.target.value }),
+      placeholder: baseUrlPlaceholder,
+      className: "w-full rounded-md border border-gray-300 px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500"
+    }
+  ), /* @__PURE__ */ React3__default.default.createElement("p", { className: "mt-1.5 text-xs text-gray-500" }, "\u586B\u5199 Key \u4E0E\u5730\u5740\u540E\u5C06\u81EA\u52A8\u62C9\u53D6\u53EF\u7528\u6A21\u578B\u5E76\u9009\u62E9\u5408\u9002\u7684\u89C6\u89C9\u6A21\u578B\u3002"))), !useServerOnly && /* @__PURE__ */ React3__default.default.createElement(React3__default.default.Fragment, null, /* @__PURE__ */ React3__default.default.createElement("div", null, /* @__PURE__ */ React3__default.default.createElement("div", { className: "mb-2 flex items-center justify-between gap-2" }, /* @__PURE__ */ React3__default.default.createElement("label", { htmlFor: "ai-vision-model", className: "text-sm font-medium text-gray-700" }, "\u89C6\u89C9\u6A21\u578B"), /* @__PURE__ */ React3__default.default.createElement(
+    "button",
+    {
+      type: "button",
+      onClick: () => void refresh(),
+      disabled: loading,
+      className: "inline-flex items-center gap-1 rounded-md px-2 py-1 text-xs text-gray-500 transition-colors hover:bg-gray-100 hover:text-gray-700 disabled:opacity-50"
+    },
+    loading ? /* @__PURE__ */ React3__default.default.createElement(lucideReact.Loader2, { className: "h-3.5 w-3.5 animate-spin" }) : /* @__PURE__ */ React3__default.default.createElement(lucideReact.RefreshCw, { className: "h-3.5 w-3.5" }),
+    "\u5237\u65B0\u6A21\u578B"
+  )), showDropdown ? /* @__PURE__ */ React3__default.default.createElement(
+    "select",
+    {
+      id: "ai-vision-model",
+      value: settings.visionModel,
+      onChange: (e) => updateSettings({ visionModel: e.target.value }),
+      className: "w-full rounded-md border border-gray-300 px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500"
+    },
+    selectableModels.map((model) => /* @__PURE__ */ React3__default.default.createElement("option", { key: model, value: model }, model)),
+    settings.visionModel && !selectableModels.includes(settings.visionModel) && /* @__PURE__ */ React3__default.default.createElement("option", { value: settings.visionModel }, settings.visionModel, "\uFF08\u5F53\u524D\uFF09")
+  ) : /* @__PURE__ */ React3__default.default.createElement(
+    "input",
+    {
+      id: "ai-vision-model",
+      type: "text",
+      value: settings.visionModel,
+      onChange: (e) => updateSettings({ visionModel: e.target.value }),
+      placeholder: visionModelPlaceholder,
+      className: "w-full rounded-md border border-gray-300 px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500"
+    }
+  ), loading && /* @__PURE__ */ React3__default.default.createElement("p", { className: "mt-1.5 flex items-center gap-1.5 text-xs text-gray-500" }, /* @__PURE__ */ React3__default.default.createElement(lucideReact.Loader2, { className: "h-3.5 w-3.5 animate-spin" }), "\u6B63\u5728\u8BFB\u53D6\u53EF\u7528\u6A21\u578B\u2026"), !loading && error && /* @__PURE__ */ React3__default.default.createElement("p", { className: "mt-1.5 text-xs text-amber-600" }, "\u65E0\u6CD5\u81EA\u52A8\u83B7\u53D6\u6A21\u578B\u5217\u8868\uFF1A", error, "\u3002\u53EF\u624B\u52A8\u586B\u5199\u6A21\u578B\u540D\u79F0\u3002"), !loading && !error && showDropdown && /* @__PURE__ */ React3__default.default.createElement("p", { className: "mt-1.5 text-xs text-gray-500" }, "\u5DF2\u52A0\u8F7D ", selectableModels.length, " \u4E2A", visionModels.length > 0 ? "\u89C6\u89C9" : "\u5BF9\u8BDD", "\u6A21\u578B\uFF0C\u53EF\u624B\u52A8\u5207\u6362\u3002"), !loading && !error && showAllModelsFallback && /* @__PURE__ */ React3__default.default.createElement("p", { className: "mt-1.5 text-xs text-amber-600" }, "\u672A\u8BC6\u522B\u5230\u89C6\u89C9\u6A21\u578B\uFF0C\u8BF7\u624B\u52A8\u586B\u5199\u652F\u6301\u8BC6\u56FE\u7684\u6A21\u578B\u540D\u3002"), !loading && !error && !showDropdown && !showAllModelsFallback && /* @__PURE__ */ React3__default.default.createElement("p", { className: "mt-1.5 text-xs text-gray-500" }, "\u9700\u652F\u6301\u56FE\u7247\u8F93\u5165\u7684\u591A\u6A21\u6001\u6A21\u578B\u3002")), /* @__PURE__ */ React3__default.default.createElement("div", null, /* @__PURE__ */ React3__default.default.createElement("label", { htmlFor: "ai-text-model", className: "mb-2 block text-sm font-medium text-gray-700" }, "\u6587\u672C\u6A21\u578B"), /* @__PURE__ */ React3__default.default.createElement(
+    "input",
+    {
+      id: "ai-text-model",
+      type: "text",
+      value: settings.textModel ?? settings.visionModel,
+      onChange: (e) => updateSettings({ textModel: e.target.value }),
+      placeholder: visionModelPlaceholder,
+      className: "w-full rounded-md border border-gray-300 px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500"
+    }
+  ), /* @__PURE__ */ React3__default.default.createElement("p", { className: "mt-1.5 text-xs text-gray-500" }, "\u7EAF\u6587\u672C\u4E0E STT \u8F6C\u5199\u540E\u7684\u5BF9\u8BDD\uFF1B\u9ED8\u8BA4\u540C\u89C6\u89C9\u6A21\u578B\u3002")), /* @__PURE__ */ React3__default.default.createElement("div", null, /* @__PURE__ */ React3__default.default.createElement("label", { htmlFor: "ai-audio-model", className: "mb-2 block text-sm font-medium text-gray-700" }, "\u8BED\u97F3\u8F6C\u5199\u6A21\u578B\uFF08STT\uFF09"), /* @__PURE__ */ React3__default.default.createElement(
+    "input",
+    {
+      id: "ai-audio-model",
+      type: "text",
+      value: settings.audioModel ?? "whisper-1",
+      onChange: (e) => updateSettings({ audioModel: e.target.value }),
+      placeholder: "whisper-1",
+      className: "w-full rounded-md border border-gray-300 px-3 py-2 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500"
+    }
+  ), /* @__PURE__ */ React3__default.default.createElement("p", { className: "mt-1.5 text-xs text-gray-500" }, "\u591A\u6A21\u6001 auto \u6A21\u5F0F\u4E0B\uFF0C\u4E0D\u652F\u6301\u5185\u5D4C\u97F3\u9891\u65F6\u5C06\u7528\u6B64\u6A21\u578B\u8F6C\u5199\uFF08Whisper \u7B49\uFF09\u3002"))), /* @__PURE__ */ React3__default.default.createElement(AiApiConnectivityTest, { runEndpoint }));
+}
 
 exports.AI_API_SETTINGS_STORAGE_KEY = AI_API_SETTINGS_STORAGE_KEY;
 exports.AiApiClientError = AiApiClientError;
+exports.AiApiConnectivityTest = AiApiConnectivityTest;
+exports.AiApiSettingsPanel = AiApiSettingsPanel;
+exports.AiApiSettingsProvider = AiApiSettingsProvider;
 exports.DEFAULT_AI_API_SETTINGS = DEFAULT_AI_API_SETTINGS;
 exports.aiApiClient = aiApiClient;
 exports.createAiTaskRunner = createAiTaskRunner;
@@ -160,6 +501,10 @@ exports.runAiTask = runAiTask;
 exports.runAiTaskOrThrow = runAiTaskOrThrow;
 exports.saveAiApiSettings = saveAiApiSettings;
 exports.toClientSettings = toClientSettings;
+exports.toServerClientSettings = toServerClientSettings;
+exports.useAiApiSettings = useAiApiSettings;
+exports.useAiModels = useAiModels;
+exports.useAiServerConfig = useAiServerConfig;
 exports.useAiTask = useAiTask;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map