@huyooo/ai-chat-bridge-electron 0.2.11 → 0.2.13

package/dist/main/index.d.ts

@@ -3,6 +3,158 @@ export { AgentConfig, ChatEvent, ChatMode, ChatOptions, MODELS, ProviderType } f
 import { StorageContext, StorageAdapter } from '@huyooo/ai-chat-storage';
 export { MessageRecord, SessionRecord, StorageAdapter, StorageContext } from '@huyooo/ai-chat-storage';
 
+/** ASR 请求配置 */
+interface AsrRequestConfig {
+    /** 用户相关配置 */
+    user?: {
+        uid?: string;
+        did?: string;
+        platform?: string;
+        sdk_version?: string;
+        app_version?: string;
+    };
+    /** 音频配置 */
+    audio: {
+        format: 'pcm' | 'wav' | 'ogg' | 'mp3';
+        codec?: 'raw' | 'opus';
+        rate?: number;
+        bits?: number;
+        channel?: number;
+        /** 语种（仅流式输入模式支持） */
+        language?: string;
+    };
+    /** 请求配置 */
+    request: {
+        model_name: 'bigmodel';
+        /** 启用 ITN（数字规整） */
+        enable_itn?: boolean;
+        /** 启用标点 */
+        enable_punc?: boolean;
+        /** 启用语义顺滑 */
+        enable_ddc?: boolean;
+        /** 输出语音停顿、分句、分词信息 */
+        show_utterances?: boolean;
+        /** 结果返回方式：full(全量)/single(增量) */
+        result_type?: 'full' | 'single';
+        /** 启用首字返回加速 */
+        enable_accelerate_text?: boolean;
+        /** 首字返回加速率 (0-20) */
+        accelerate_score?: number;
+        /** 语义切句最大静音阈值 (ms) */
+        vad_segment_duration?: number;
+        /** 强制判停时间 (ms) */
+        end_window_size?: number;
+        /** 热词等语料配置 */
+        corpus?: {
+            boosting_table_name?: string;
+            boosting_table_id?: string;
+            correct_table_name?: string;
+            correct_table_id?: string;
+            context?: string;
+        };
+    };
+}
+/** ASR 识别结果 */
+interface AsrResult {
+    result?: {
+        text: string;
+        utterances?: Array<{
+            text: string;
+            start_time: number;
+            end_time: number;
+            definite: boolean;
+            words?: Array<{
+                text: string;
+                start_time: number;
+                end_time: number;
+                blank_duration: number;
+            }>;
+        }>;
+    };
+    audio_info?: {
+        duration: number;
+    };
+}
+
+/**
+ * 火山引擎大模型流式语音识别 - WebSocket 客户端
+ *
+ * 在 Electron 主进程中运行，处理与火山引擎 ASR 服务的通信
+ */
+
+/** ASR 客户端配置 */
+interface AsrClientConfig {
+    /** 火山引擎 App ID */
+    appId: string;
+    /** 火山引擎 Access Key */
+    accessKey: string;
+    /** 资源 ID */
+    resourceId?: string;
+    /** 使用双向流式优化版 */
+    useAsyncMode?: boolean;
+}
+/** ASR 事件回调 */
+interface AsrCallbacks {
+    /** 连接成功 */
+    onConnected?: () => void;
+    /** 收到识别结果 */
+    onResult?: (result: AsrResult, isLast: boolean) => void;
+    /** 发生错误 */
+    onError?: (error: Error) => void;
+    /** 连接关闭 */
+    onClose?: () => void;
+}
+/** ASR 会话配置 */
+interface AsrSessionConfig {
+    /** 音频格式 */
+    format?: 'pcm' | 'wav';
+    /** 采样率 */
+    sampleRate?: number;
+    /** 启用标点 */
+    enablePunc?: boolean;
+    /** 启用 ITN（数字规整） */
+    enableItn?: boolean;
+    /** 启用语义顺滑 */
+    enableDdc?: boolean;
+    /** 输出分句信息 */
+    showUtterances?: boolean;
+}
+
+/**
+ * ASR 模块导出
+ */
+
+/** ASR 桥接配置 */
+interface AsrBridgeConfig {
+    /** IPC channel 前缀 */
+    channelPrefix?: string;
+    /** 火山引擎 App ID */
+    appId: string;
+    /** 火山引擎 Access Key */
+    accessKey: string;
+    /** 资源 ID */
+    resourceId?: string;
+}
+/**
+ * 创建 ASR Electron 桥接
+ *
+ * 在主进程中调用，注册 ASR 相关的 IPC handlers
+ *
+ * @example
+ * ```ts
+ * import { createAsrBridge } from '@huyooo/ai-chat-bridge-electron/main';
+ *
+ * createAsrBridge({
+ *   appId: process.env.VOLC_APP_ID!,
+ *   accessKey: process.env.VOLC_ACCESS_KEY!,
+ * });
+ * ```
+ */
+declare function createAsrBridge(config: AsrBridgeConfig): {
+    /** 清理所有会话 */
+    cleanup: () => void;
+};
+
 /**
  * Electron 主进程桥接
  *
@@ -58,4 +210,4 @@ declare function createElectronBridge(options: ElectronBridgeOptions): Promise<{
     storage: StorageAdapter;
 }>;
 
-export { type ElectronBridgeOptions, type FileInfo, createElectronBridge };
+export { type AsrBridgeConfig, type AsrCallbacks, type AsrClientConfig, type AsrRequestConfig, type AsrResult, type AsrSessionConfig, type ElectronBridgeOptions, type FileInfo, createAsrBridge, createElectronBridge };