@yh-ui/hooks 0.1.12 → 0.1.16

package/dist/index.cjs

@@ -608,6 +608,37 @@ const qwenParser = (raw) => {
   }
   return text || null;
 };
+const claudeParser = (raw) => {
+  const lines = raw.split("\n");
+  let text = "";
+  for (const line of lines) {
+    if (!line.startsWith("data: ")) continue;
+    const data = line.slice(6).trim();
+    try {
+      const json = JSON.parse(data);
+      if (json?.type === "content_block_delta" && json?.delta?.text) {
+        text += json.delta.text;
+      }
+    } catch {
+    }
+  }
+  return text || null;
+};
+const geminiParser = (raw) => {
+  const lines = raw.split("\n");
+  let text = "";
+  for (const line of lines) {
+    const content = line.startsWith("data: ") ? line.slice(6).trim() : line.trim();
+    if (!content) continue;
+    try {
+      const json = JSON.parse(content);
+      const part = json?.candidates?.[0]?.content?.parts?.[0]?.text;
+      if (part) text += part;
+    } catch {
+    }
+  }
+  return text || null;
+};
 const plainTextParser = (raw) => raw || null;
 class TypewriterThrottle {
   queue = [];
@@ -731,7 +762,14 @@ function useAiStream(options) {
     fetchStream,
     stop,
     // 暴露解析器供测试/自定义使用
-    parsers: { openaiParser, ernieParser, qwenParser, plainTextParser }
+    parsers: {
+      openaiParser,
+      ernieParser,
+      qwenParser,
+      claudeParser,
+      geminiParser,
+      plainTextParser
+    }
   };
 }
 
@@ -1157,13 +1195,259 @@ function useAiConversations(options = {}) {
   };
 }
 
+function useAiRequest(options) {
+  const loading = vue.ref(false);
+  const data = vue.ref("");
+  const error = vue.ref(null);
+  const send = async (query, ...args) => {
+    loading.value = true;
+    error.value = null;
+    try {
+      const result = await options.request(query, ...args);
+      data.value = result;
+      options.onSuccess?.(result);
+      return result;
+    } catch (e) {
+      const err = e instanceof Error ? e : new Error(String(e));
+      error.value = err;
+      options.onError?.(err);
+      throw err;
+    } finally {
+      loading.value = false;
+    }
+  };
+  return {
+    loading,
+    data,
+    error,
+    send
+  };
+}
+
+function useAiVoice(options = {}) {
+  const {
+    language = "zh-CN",
+    interimResults = true,
+    continuous = false,
+    vad = true,
+    vadThreshold = 2e3,
+    volumeThreshold = 0.05,
+    waveCount = 20,
+    useSTT = true
+  } = options;
+  const isRecording = vue.ref(false);
+  const transcript = vue.ref("");
+  const interimTranscript = vue.ref("");
+  const volume = vue.ref(0);
+  const amplitudes = vue.ref(new Array(waveCount).fill(5));
+  const audioBlob = vue.ref(null);
+  const recognition = vue.shallowRef(null);
+  const audioContext = vue.shallowRef(null);
+  const analyser = vue.shallowRef(null);
+  const stream = vue.shallowRef(null);
+  const mediaRecorder = vue.shallowRef(null);
+  let chunks = [];
+  let animationId = null;
+  let silenceStart = null;
+  const _window = typeof window !== "undefined" ? window : null;
+  const SpeechRecognition = _window?.SpeechRecognition || _window?.webkitSpeechRecognition;
+  const sttSupported = !!SpeechRecognition;
+  const initMediaRecorder = (mediaStream) => {
+    chunks = [];
+    const recorder = new MediaRecorder(mediaStream);
+    recorder.ondataavailable = (e) => {
+      if (e.data.size > 0) chunks.push(e.data);
+    };
+    recorder.onstop = () => {
+      audioBlob.value = new Blob(chunks, { type: "audio/webm" });
+      if (isRecording.value === false && chunks.length > 0) {
+        options.onStop?.(transcript.value, audioBlob.value);
+      }
+    };
+    mediaRecorder.value = recorder;
+  };
+  const initRecognition = () => {
+    if (!sttSupported || !useSTT) return;
+    const recognitionInstance = new SpeechRecognition();
+    recognitionInstance.lang = language;
+    recognitionInstance.interimResults = interimResults;
+    recognitionInstance.continuous = continuous;
+    recognitionInstance.onresult = (event) => {
+      let currentInterim = "";
+      for (let i = event.resultIndex; i < event.results.length; ++i) {
+        if (event.results[i].isFinal) {
+          transcript.value += event.results[i][0].transcript;
+          options.onResult?.(transcript.value);
+        } else {
+          currentInterim += event.results[i][0].transcript;
+        }
+      }
+      interimTranscript.value = currentInterim;
+      options.onPartialResult?.(currentInterim);
+    };
+    recognitionInstance.onerror = (event) => {
+      if (event.error !== "no-speech" && event.error !== "aborted") {
+        options.onError?.(event);
+      }
+    };
+    recognition.value = recognitionInstance;
+  };
+  const initAudioAnalyzer = async (mediaStream) => {
+    try {
+      const AudioCtx = window.AudioContext || window.webkitAudioContext;
+      audioContext.value = new AudioCtx();
+      if (audioContext.value.state === "suspended") {
+        await audioContext.value.resume();
+      }
+      analyser.value = audioContext.value.createAnalyser();
+      analyser.value.fftSize = 256;
+      const source = audioContext.value.createMediaStreamSource(mediaStream);
+      source.connect(analyser.value);
+      const bufferLength = analyser.value.frequencyBinCount;
+      const dataArray = new Uint8Array(bufferLength);
+      const process = () => {
+        if (!isRecording.value) {
+          amplitudes.value = new Array(waveCount).fill(5);
+          volume.value = 0;
+          return;
+        }
+        animationId = requestAnimationFrame(process);
+        analyser.value.getByteFrequencyData(dataArray);
+        let total = 0;
+        for (let i = 0; i < bufferLength; i++) total += dataArray[i];
+        const avg = total / bufferLength;
+        volume.value = Math.min(100, avg / 128 * 100);
+        const step = Math.floor(bufferLength / waveCount);
+        const newAmps = [];
+        for (let i = 0; i < waveCount; i++) {
+          const val = dataArray[i * step];
+          newAmps.push(6 + val / 255 * 34);
+        }
+        amplitudes.value = newAmps;
+        if (vad) {
+          const normalizedVol = avg / 255;
+          if (normalizedVol < volumeThreshold) {
+            if (silenceStart === null) silenceStart = Date.now();
+            else if (Date.now() - silenceStart > vadThreshold) {
+              stop();
+            }
+          } else {
+            silenceStart = null;
+          }
+        }
+      };
+      process();
+    } catch (err) {
+      options.onError?.(err);
+    }
+  };
+  const start = async () => {
+    if (isRecording.value) return;
+    try {
+      transcript.value = "";
+      interimTranscript.value = "";
+      audioBlob.value = null;
+      silenceStart = null;
+      stream.value = await navigator.mediaDevices.getUserMedia({ audio: true });
+      isRecording.value = true;
+      initMediaRecorder(stream.value);
+      initRecognition();
+      await initAudioAnalyzer(stream.value);
+      mediaRecorder.value?.start(1e3);
+      recognition.value?.start();
+      options.onStart?.();
+    } catch (err) {
+      isRecording.value = false;
+      if (stream.value) {
+        stream.value.getTracks().forEach((t) => t.stop());
+        stream.value = null;
+      }
+      console.error("[yh-ui/hooks] useAiVoice start failed:", err);
+      options.onError?.(err);
+    }
+  };
+  const stop = () => {
+    if (!isRecording.value) return;
+    isRecording.value = false;
+    if (stream.value) {
+      stream.value.getTracks().forEach((track) => track.stop());
+      stream.value = null;
+    }
+    if (recognition.value) {
+      try {
+        recognition.value.stop();
+      } catch {
+      }
+    }
+    if (mediaRecorder.value && mediaRecorder.value.state !== "inactive") {
+      try {
+        mediaRecorder.value.stop();
+      } catch {
+      }
+    }
+    cleanup();
+  };
+  const cancel = () => {
+    if (!isRecording.value) return;
+    isRecording.value = false;
+    if (stream.value) {
+      stream.value.getTracks().forEach((track) => track.stop());
+      stream.value = null;
+    }
+    if (recognition.value) {
+      try {
+        recognition.value.abort();
+      } catch {
+      }
+    }
+    if (mediaRecorder.value && mediaRecorder.value.state !== "inactive") {
+      try {
+        mediaRecorder.value.stop();
+      } catch {
+      }
+    }
+    cleanup();
+  };
+  const cleanup = () => {
+    if (animationId) {
+      cancelAnimationFrame(animationId);
+      animationId = null;
+    }
+    if (audioContext.value && audioContext.value.state !== "closed") {
+      audioContext.value.close().catch((_err) => {
+      });
+      audioContext.value = null;
+    }
+    amplitudes.value = new Array(waveCount).fill(5);
+    volume.value = 0;
+  };
+  vue.onUnmounted(() => {
+    if (isRecording.value) stop();
+    else cleanup();
+  });
+  return {
+    isRecording,
+    transcript,
+    interimTranscript,
+    amplitudes,
+    volume,
+    audioBlob,
+    start,
+    stop,
+    cancel,
+    sttSupported
+  };
+}
+
 exports.FormContextKey = FormContextKey;
 exports.FormItemContextKey = FormItemContextKey;
 exports.IndexedDBAdapter = IndexedDBAdapter;
+exports.claudeParser = claudeParser;
 exports.configProviderContextKey = configProviderContextKey;
 exports.createZIndexCounter = createZIndexCounter;
 exports.defaultNamespace = defaultNamespace;
 exports.ernieParser = ernieParser;
+exports.geminiParser = geminiParser;
 exports.getDayjsLocale = getDayjsLocale;
 exports.getNextZIndex = getNextZIndex;
 exports.idInjectionKey = idInjectionKey;
@@ -1178,7 +1462,9 @@ exports.setDayjsLocaleSync = setDayjsLocaleSync;
 exports.updateDayjsMonths = updateDayjsMonths;
 exports.useAiChat = useAiChat;
 exports.useAiConversations = useAiConversations;
+exports.useAiRequest = useAiRequest;
 exports.useAiStream = useAiStream;
+exports.useAiVoice = useAiVoice;
 exports.useCache = useCache;
 exports.useClickOutside = useClickOutside;
 exports.useConfig = useConfig;

package/dist/index.d.cts

@@ -268,6 +268,16 @@ declare const ernieParser: StreamChunkParser;
  * data: {"output":{"text":"hello"},"finish_reason":null}
  */
 declare const qwenParser: StreamChunkParser;
+/**
+ * Anthropic / Claude 格式解析器
+ * data: {"type":"content_block_delta","delta":{"type":"text_delta","text":"hello"}}
+ */
+declare const claudeParser: StreamChunkParser;
+/**
+ * Google / Gemini 格式解析器
+ * data: {"candidates":[{"content":{"parts":[{"text":"hello"}]}}]}
+ */
+declare const geminiParser: StreamChunkParser;
 /**
  * 纯文本流解析器（AsyncGenerator 输出的原始字符串）
  */
@@ -313,6 +323,8 @@ declare function useAiStream(options: AiStreamOptions): {
         openaiParser: StreamChunkParser;
         ernieParser: StreamChunkParser;
         qwenParser: StreamChunkParser;
+        claudeParser: StreamChunkParser;
+        geminiParser: StreamChunkParser;
         plainTextParser: StreamChunkParser;
     };
 };
@@ -581,5 +593,107 @@ declare function useAiConversations(options?: UseAiConversationsOptions): {
     clear: () => Promise<void>;
 };
 
-export { FormContextKey, FormItemContextKey, IndexedDBAdapter, configProviderContextKey, createZIndexCounter, defaultNamespace, ernieParser, getDayjsLocale, getNextZIndex, idInjectionKey, localStorageAdapter, namespaceContextKey, openaiParser, plainTextParser, qwenParser, resetZIndex, setDayjsLocale, setDayjsLocaleSync, updateDayjsMonths, useAiChat, useAiConversations, useAiStream, useCache, useClickOutside, useConfig, useEventListener, useFormItem, useGlobalNamespace, useId, useIdInjection, useLocale, useNamespace, useScrollLock, useVirtualScroll, useZIndex, zIndexContextKey, zIndexCounterKey };
-export type { AiChatMessage, AiConversation, AiStreamOptions, ConfigProviderContext, ConversationGroup, FormContext, FormItemContext, StorageAdapter, StreamChunkParser, UseAiChatOptions, UseAiConversationsOptions, UseCacheReturn, UseFormItemReturn, UseIdReturn, UseLocaleReturn, UseNamespaceReturn, UseZIndexReturn, VirtualScrollOptions, VirtualScrollReturn };
+interface AiRequestOptions {
+    /**
+     * 请求函数
+     */
+    request: (query: string, ...args: unknown[]) => Promise<string> | string;
+    onSuccess?: (content: string) => void;
+    onError?: (err: Error) => void;
+}
+/**
+ * useAiRequest - 简单的 AI 非流式请求 Hook
+ */
+declare function useAiRequest(options: AiRequestOptions): {
+    loading: vue.Ref<boolean, boolean>;
+    data: vue.Ref<string, string>;
+    error: vue.Ref<Error | null, Error | null>;
+    send: (query: string, ...args: unknown[]) => Promise<string>;
+};
+
+interface UseAiVoiceOptions {
+    /**
+     * 语言代码 (用于 SpeechRecognition)
+     * @default 'zh-CN'
+     */
+    language?: string;
+    /**
+     * 是否需要临时结果（在说话过程中实时返回）
+     * @default true
+     */
+    interimResults?: boolean;
+    /**
+     * 是否连续识别
+     * @default false
+     */
+    continuous?: boolean;
+    /**
+     * 智能静音检测（VAD）
+     * 开启后，当检测到长时间无声会自动停止录音
+     * @default true
+     */
+    vad?: boolean;
+    /**
+     * 静音检测阈值 (ms)
+     * @default 2000
+     */
+    vadThreshold?: number;
+    /**
+     * 音量变化敏感度 (0-1)
+     * @default 0.05
+     */
+    volumeThreshold?: number;
+    /**
+     * 返回波形柱的数量（对应 AiVoiceTrigger 的 amplitudes）
+     * @default 20
+     */
+    waveCount?: number;
+    /**
+     * 是否在开始时自动执行浏览器语音识别 (SpeechRecognition)
+     * 如果关闭，则只进行物理音频录制
+     * @default true
+     */
+    useSTT?: boolean;
+    /** 回调事件 */
+    onStart?: () => void;
+    /** 停止回调，包含最终转写文本和录音文件 Blob */
+    onStop?: (transcript: string, blob: Blob | null) => void;
+    onResult?: (transcript: string) => void;
+    onPartialResult?: (transcript: string) => void;
+    onError?: (error: unknown) => void;
+}
+interface UseAiVoiceReturn {
+    /** 是否正在录音 */
+    isRecording: vue.Ref<boolean>;
+    /** 最终转写文本 */
+    transcript: vue.Ref<string>;
+    /** 过程中的临时文本 */
+    interimTranscript: vue.Ref<string>;
+    /** 实时波形数据 */
+    amplitudes: vue.Ref<number[]>;
+    /** 实时音量 (0-100) */
+    volume: vue.Ref<number>;
+    /** 录音文件的 Blob */
+    audioBlob: vue.Ref<Blob | null>;
+    /** 开始录音 */
+    start: () => Promise<void>;
+    /** 停止录音 */
+    stop: () => void;
+    /** 取消并放弃当前结果 */
+    cancel: () => void;
+    /** 浏览器是否支持 SpeechRecognition (用于显示警告) */
+    sttSupported: boolean;
+}
+/**
+ * useAiVoice - 专业级 AI 语音交互 Hook
+ *
+ * 核心能力：
+ * 1. 【音频录制】：通过 MediaRecorder 真实录制音频并导出 Blob 文件。
+ * 2. 【视觉分析】：通过 Web Audio API 实时输出驱动 AiVoiceTrigger 的波形数组。
+ * 3. 【智能 VAD】：多维检测静音状态，支持自动停顿结束。
+ * 4. 【语音转写】：内置 Web Speech API 实时转写及临时结果反馈。
+ */
+declare function useAiVoice(options?: UseAiVoiceOptions): UseAiVoiceReturn;
+
+export { FormContextKey, FormItemContextKey, IndexedDBAdapter, claudeParser, configProviderContextKey, createZIndexCounter, defaultNamespace, ernieParser, geminiParser, getDayjsLocale, getNextZIndex, idInjectionKey, localStorageAdapter, namespaceContextKey, openaiParser, plainTextParser, qwenParser, resetZIndex, setDayjsLocale, setDayjsLocaleSync, updateDayjsMonths, useAiChat, useAiConversations, useAiRequest, useAiStream, useAiVoice, useCache, useClickOutside, useConfig, useEventListener, useFormItem, useGlobalNamespace, useId, useIdInjection, useLocale, useNamespace, useScrollLock, useVirtualScroll, useZIndex, zIndexContextKey, zIndexCounterKey };
+export type { AiChatMessage, AiConversation, AiRequestOptions, AiStreamOptions, ConfigProviderContext, ConversationGroup, FormContext, FormItemContext, StorageAdapter, StreamChunkParser, UseAiChatOptions, UseAiConversationsOptions, UseAiVoiceOptions, UseAiVoiceReturn, UseCacheReturn, UseFormItemReturn, UseIdReturn, UseLocaleReturn, UseNamespaceReturn, UseZIndexReturn, VirtualScrollOptions, VirtualScrollReturn };

package/dist/index.d.mts

@@ -268,6 +268,16 @@ declare const ernieParser: StreamChunkParser;
  * data: {"output":{"text":"hello"},"finish_reason":null}
  */
 declare const qwenParser: StreamChunkParser;
+/**
+ * Anthropic / Claude 格式解析器
+ * data: {"type":"content_block_delta","delta":{"type":"text_delta","text":"hello"}}
+ */
+declare const claudeParser: StreamChunkParser;
+/**
+ * Google / Gemini 格式解析器
+ * data: {"candidates":[{"content":{"parts":[{"text":"hello"}]}}]}
+ */
+declare const geminiParser: StreamChunkParser;
 /**
  * 纯文本流解析器（AsyncGenerator 输出的原始字符串）
  */
@@ -313,6 +323,8 @@ declare function useAiStream(options: AiStreamOptions): {
         openaiParser: StreamChunkParser;
         ernieParser: StreamChunkParser;
         qwenParser: StreamChunkParser;
+        claudeParser: StreamChunkParser;
+        geminiParser: StreamChunkParser;
         plainTextParser: StreamChunkParser;
     };
 };
@@ -581,5 +593,107 @@ declare function useAiConversations(options?: UseAiConversationsOptions): {
     clear: () => Promise<void>;
 };
 
-export { FormContextKey, FormItemContextKey, IndexedDBAdapter, configProviderContextKey, createZIndexCounter, defaultNamespace, ernieParser, getDayjsLocale, getNextZIndex, idInjectionKey, localStorageAdapter, namespaceContextKey, openaiParser, plainTextParser, qwenParser, resetZIndex, setDayjsLocale, setDayjsLocaleSync, updateDayjsMonths, useAiChat, useAiConversations, useAiStream, useCache, useClickOutside, useConfig, useEventListener, useFormItem, useGlobalNamespace, useId, useIdInjection, useLocale, useNamespace, useScrollLock, useVirtualScroll, useZIndex, zIndexContextKey, zIndexCounterKey };
-export type { AiChatMessage, AiConversation, AiStreamOptions, ConfigProviderContext, ConversationGroup, FormContext, FormItemContext, StorageAdapter, StreamChunkParser, UseAiChatOptions, UseAiConversationsOptions, UseCacheReturn, UseFormItemReturn, UseIdReturn, UseLocaleReturn, UseNamespaceReturn, UseZIndexReturn, VirtualScrollOptions, VirtualScrollReturn };
+interface AiRequestOptions {
+    /**
+     * 请求函数
+     */
+    request: (query: string, ...args: unknown[]) => Promise<string> | string;
+    onSuccess?: (content: string) => void;
+    onError?: (err: Error) => void;
+}
+/**
+ * useAiRequest - 简单的 AI 非流式请求 Hook
+ */
+declare function useAiRequest(options: AiRequestOptions): {
+    loading: vue.Ref<boolean, boolean>;
+    data: vue.Ref<string, string>;
+    error: vue.Ref<Error | null, Error | null>;
+    send: (query: string, ...args: unknown[]) => Promise<string>;
+};
+
+interface UseAiVoiceOptions {
+    /**
+     * 语言代码 (用于 SpeechRecognition)
+     * @default 'zh-CN'
+     */
+    language?: string;
+    /**
+     * 是否需要临时结果（在说话过程中实时返回）
+     * @default true
+     */
+    interimResults?: boolean;
+    /**
+     * 是否连续识别
+     * @default false
+     */
+    continuous?: boolean;
+    /**
+     * 智能静音检测（VAD）
+     * 开启后，当检测到长时间无声会自动停止录音
+     * @default true
+     */
+    vad?: boolean;
+    /**
+     * 静音检测阈值 (ms)
+     * @default 2000
+     */
+    vadThreshold?: number;
+    /**
+     * 音量变化敏感度 (0-1)
+     * @default 0.05
+     */
+    volumeThreshold?: number;
+    /**
+     * 返回波形柱的数量（对应 AiVoiceTrigger 的 amplitudes）
+     * @default 20
+     */
+    waveCount?: number;
+    /**
+     * 是否在开始时自动执行浏览器语音识别 (SpeechRecognition)
+     * 如果关闭，则只进行物理音频录制
+     * @default true
+     */
+    useSTT?: boolean;
+    /** 回调事件 */
+    onStart?: () => void;
+    /** 停止回调，包含最终转写文本和录音文件 Blob */
+    onStop?: (transcript: string, blob: Blob | null) => void;
+    onResult?: (transcript: string) => void;
+    onPartialResult?: (transcript: string) => void;
+    onError?: (error: unknown) => void;
+}
+interface UseAiVoiceReturn {
+    /** 是否正在录音 */
+    isRecording: vue.Ref<boolean>;
+    /** 最终转写文本 */
+    transcript: vue.Ref<string>;
+    /** 过程中的临时文本 */
+    interimTranscript: vue.Ref<string>;
+    /** 实时波形数据 */
+    amplitudes: vue.Ref<number[]>;
+    /** 实时音量 (0-100) */
+    volume: vue.Ref<number>;
+    /** 录音文件的 Blob */
+    audioBlob: vue.Ref<Blob | null>;
+    /** 开始录音 */
+    start: () => Promise<void>;
+    /** 停止录音 */
+    stop: () => void;
+    /** 取消并放弃当前结果 */
+    cancel: () => void;
+    /** 浏览器是否支持 SpeechRecognition (用于显示警告) */
+    sttSupported: boolean;
+}
+/**
+ * useAiVoice - 专业级 AI 语音交互 Hook
+ *
+ * 核心能力：
+ * 1. 【音频录制】：通过 MediaRecorder 真实录制音频并导出 Blob 文件。
+ * 2. 【视觉分析】：通过 Web Audio API 实时输出驱动 AiVoiceTrigger 的波形数组。
+ * 3. 【智能 VAD】：多维检测静音状态，支持自动停顿结束。
+ * 4. 【语音转写】：内置 Web Speech API 实时转写及临时结果反馈。
+ */
+declare function useAiVoice(options?: UseAiVoiceOptions): UseAiVoiceReturn;
+
+export { FormContextKey, FormItemContextKey, IndexedDBAdapter, claudeParser, configProviderContextKey, createZIndexCounter, defaultNamespace, ernieParser, geminiParser, getDayjsLocale, getNextZIndex, idInjectionKey, localStorageAdapter, namespaceContextKey, openaiParser, plainTextParser, qwenParser, resetZIndex, setDayjsLocale, setDayjsLocaleSync, updateDayjsMonths, useAiChat, useAiConversations, useAiRequest, useAiStream, useAiVoice, useCache, useClickOutside, useConfig, useEventListener, useFormItem, useGlobalNamespace, useId, useIdInjection, useLocale, useNamespace, useScrollLock, useVirtualScroll, useZIndex, zIndexContextKey, zIndexCounterKey };
+export type { AiChatMessage, AiConversation, AiRequestOptions, AiStreamOptions, ConfigProviderContext, ConversationGroup, FormContext, FormItemContext, StorageAdapter, StreamChunkParser, UseAiChatOptions, UseAiConversationsOptions, UseAiVoiceOptions, UseAiVoiceReturn, UseCacheReturn, UseFormItemReturn, UseIdReturn, UseLocaleReturn, UseNamespaceReturn, UseZIndexReturn, VirtualScrollOptions, VirtualScrollReturn };