@lee-zg/melange 1.2.2 → 1.2.5

package/dist/plugins/index.d.ts

@@ -1,797 +1,150 @@
+import { as as FingerprintCollector, am as FingerprintValue, ao as FingerprintComponentMap, al as FingerprintHashAlgorithm } from '../generator-D7ofMxfc.js';
+export { a1 as AWSSpeechConfig, c as AWSSynthesisAdapter, t as AlibabaAdapter, d as AlibabaSynthesisAdapter, n as AudioUtils, v as AzureAdapter, $ as AzureSpeechConfig, A as AzureSynthesisAdapter, r as BaiduAdapter, B as BaiduSynthesisAdapter, H as BaseSpeechConfig, a5 as CloudAudioFormat, ac as CloudTransportType, a2 as CustomProviderConfig, aw as FINGERPRINT_GENERATOR, av as FINGERPRINT_VERSION, ar as FingerprintCollectorContext, an as FingerprintComponent, ai as FingerprintComponentKey, aj as FingerprintComponentSource, ap as FingerprintConfidence, au as FingerprintGenerator, F as FingerprintGeneratorImpl, at as FingerprintOptions, ak as FingerprintPrivacyMode, aq as FingerprintResult, o as GenericAdapter, G as GenericSynthesisAdapter, u as GoogleAdapter, a0 as GoogleSpeechConfig, b as GoogleSynthesisAdapter, ag as IAdvancedRecognitionConfig, a9 as IAdvancedSynthesisConfig, af as IAudioConfig, ah as ICloudRecognitionAdapter, aa as ICloudSynthesisAdapter, a8 as ICloudVoice, ae as IRecognitionError, ad as IRecognitionResult, a7 as ISynthesisError, a6 as ISynthesisResult, a3 as ProviderConfig, Q as RecognitionConfig, ab as RecognitionEngineMode, W as RecognitionEvent, Y as RecognitionEventHandler, U as RecognitionEventType, Z as RecognitionProvider, P as RecognitionResult, O as RecognitionResultItem, R as RecognitionStatus, E as SpeechError, C as SpeechProviderType, _ as SpeechRecognizer, h as SpeechRecognizerImpl, D as SpeechServiceStatus, N as SpeechSynthesizer, e as SpeechSynthesizerImpl, a as SynthesisAudioUtils, I as SynthesisConfig, a4 as SynthesisEngineMode, K as SynthesisEvent, L as SynthesisEventHandler, J as SynthesisEventType, M as SynthesisProvider, S as SynthesisStatus, q as TencentAdapter, T as TencentSynthesisAdapter, V as VoiceInfo, p as XunfeiAdapter, X as XunfeiSynthesisAdapter, w as createFingerprintGenerator, j as createSpeechRecognizer, f as createSpeechSynthesizer, x as getFingerprint, z as isFingerprintSupported, k as isSpeechRecognitionSupported, i as isSpeechSynthesisSupported, l as listen, m as listenWithTimeout, y as registerFingerprintPlugin, s as speak, g as speakWithCloud } from '../generator-D7ofMxfc.js';
+import '../container-n8Q2Xa_y.js';
+import '../types-BtOUCLB-.js';
+
 /**
- * @fileoverview 语音模块类型定义
- * @module melange/plugins/speech/types
- * @description 语音合成和语音识别的类型定义
- */
-/**
- * 语音服务提供商类型
- */
-type SpeechProviderType = 'browser' | 'azure' | 'google' | 'aws' | 'custom';
-/**
- * 语音服务状态
- */
-type SpeechServiceStatus = 'idle' | 'loading' | 'ready' | 'error';
-/**
- * 语音服务错误
- */
-interface SpeechError {
-    /** 错误代码 */
-    code: string;
-    /** 错误信息 */
-    message: string;
-    /** 原始错误对象 */
-    originalError?: Error;
-}
-/**
- * 语音服务基础配置
- */
-interface BaseSpeechConfig {
-    /** 语言代码 (如 'zh-CN', 'en-US') */
-    lang?: string;
-    /** 首选提供商 */
-    preferredProvider?: SpeechProviderType;
-    /** 是否自动降级 */
-    autoFallback?: boolean;
-    /** 降级提供商列表 */
-    fallbackProviders?: SpeechProviderType[];
-}
-/**
- * 语音信息
- */
-interface VoiceInfo {
-    /** 语音唯一标识 */
-    id: string;
-    /** 语音名称 */
-    name: string;
-    /** 语言代码 */
-    lang: string;
-    /** 是否为本地语音 */
-    localService: boolean;
-    /** 是否为默认语音 */
-    default: boolean;
-    /** 提供商类型 */
-    provider: SpeechProviderType;
-}
-/**
- * 语音合成配置
- */
-interface SynthesisConfig extends BaseSpeechConfig {
-    /** 语音对象或语音名称 */
-    voice?: VoiceInfo | string;
-    /** 音量 (0-1) */
-    volume?: number;
-    /** 语速 (0.1-10) */
-    rate?: number;
-    /** 音调 (0-2) */
-    pitch?: number;
-}
-/**
- * 语音合成事件类型
- */
-type SynthesisEventType = 'start' | 'end' | 'pause' | 'resume' | 'boundary' | 'mark' | 'error';
-/**
- * 语音合成事件数据
- */
-interface SynthesisEvent {
-    /** 事件类型 */
-    type: SynthesisEventType;
-    /** 当前字符索引 */
-    charIndex?: number;
-    /** 当前字符长度 */
-    charLength?: number;
-    /** 经过的时间（毫秒） */
-    elapsedTime?: number;
-    /** 边界名称 */
-    name?: string;
-    /** 错误信息 */
-    error?: SpeechError;
-}
-/**
- * 语音合成事件处理器
- */
-type SynthesisEventHandler = (event: SynthesisEvent) => void;
-/**
- * 语音合成提供商接口
- */
-interface SynthesisProvider {
-    /** 提供商类型 */
-    readonly type: SpeechProviderType;
-    /** 检查是否可用 */
-    isAvailable(): boolean;
-    /** 获取可用语音列表 */
-    getVoices(): Promise<VoiceInfo[]>;
-    /** 朗读文本 */
-    speak(text: string, config?: SynthesisConfig): Promise<void>;
-    /** 暂停 */
-    pause(): void;
-    /** 继续 */
-    resume(): void;
-    /** 取消 */
-    cancel(): void;
-    /** 是否正在朗读 */
-    isSpeaking(): boolean;
-    /** 是否已暂停 */
-    isPaused(): boolean;
-    /** 添加事件监听 */
-    on(event: SynthesisEventType, handler: SynthesisEventHandler): void;
-    /** 移除事件监听 */
-    off(event: SynthesisEventType, handler: SynthesisEventHandler): void;
-}
-/**
- * 语音合成器接口
- */
-interface SpeechSynthesizer {
-    /** 当前使用的提供商 */
-    readonly currentProvider: SpeechProviderType;
-    /** 服务状态 */
-    readonly status: SpeechServiceStatus;
-    /** 初始化 */
-    initialize(config?: SynthesisConfig): Promise<void>;
-    /** 获取可用语音列表 */
-    getVoices(): Promise<VoiceInfo[]>;
-    /** 朗读文本 */
-    speak(text: string, config?: SynthesisConfig): Promise<void>;
-    /** 暂停 */
-    pause(): void;
-    /** 继续 */
-    resume(): void;
-    /** 取消 */
-    cancel(): void;
-    /** 是否正在朗读 */
-    isSpeaking(): boolean;
-    /** 是否已暂停 */
-    isPaused(): boolean;
-    /** 添加事件监听 */
-    on(event: SynthesisEventType, handler: SynthesisEventHandler): void;
-    /** 移除事件监听 */
-    off(event: SynthesisEventType, handler: SynthesisEventHandler): void;
-    /** 销毁实例 */
-    dispose(): void;
-}
-/**
- * 识别结果项
- */
-interface RecognitionResultItem {
-    /** 识别的文本 */
-    transcript: string;
-    /** 置信度 (0-1) */
-    confidence: number;
-    /** 是否为最终结果 */
-    isFinal: boolean;
-}
-/**
- * 识别结果
- */
-interface RecognitionResult {
-    /** 结果列表 */
-    results: RecognitionResultItem[];
-    /** 最佳结果 */
-    bestTranscript: string;
-    /** 最佳置信度 */
-    bestConfidence: number;
-    /** 是否为最终结果 */
-    isFinal: boolean;
-}
-/**
- * 语音识别配置
- */
-interface RecognitionConfig extends BaseSpeechConfig {
-    /** 是否连续识别 */
-    continuous?: boolean;
-    /** 是否返回中间结果 */
-    interimResults?: boolean;
-    /** 最大备选结果数 */
-    maxAlternatives?: number;
-    /** 语法列表 (仅部分浏览器支持) */
-    grammars?: string[];
-}
-/**
- * 语音识别事件类型
- */
-type RecognitionEventType = 'start' | 'end' | 'result' | 'error' | 'soundstart' | 'soundend' | 'speechstart' | 'speechend' | 'audiostart' | 'audioend' | 'nomatch';
-/**
- * 语音识别事件数据
- */
-interface RecognitionEvent {
-    /** 事件类型 */
-    type: RecognitionEventType;
-    /** 识别结果 (仅 result 事件) */
-    result?: RecognitionResult;
-    /** 错误信息 (仅 error 事件) */
-    error?: SpeechError;
-}
-/**
- * 语音识别事件处理器
- */
-type RecognitionEventHandler = (event: RecognitionEvent) => void;
-/**
- * 语音识别提供商接口
- */
-interface RecognitionProvider {
-    /** 提供商类型 */
-    readonly type: SpeechProviderType;
-    /** 检查是否可用 */
-    isAvailable(): boolean;
-    /** 开始识别 */
-    start(config?: RecognitionConfig): Promise<void>;
-    /** 停止识别 */
-    stop(): void;
-    /** 中止识别 */
-    abort(): void;
-    /** 是否正在识别 */
-    isListening(): boolean;
-    /** 添加事件监听 */
-    on(event: RecognitionEventType, handler: RecognitionEventHandler): void;
-    /** 移除事件监听 */
-    off(event: RecognitionEventType, handler: RecognitionEventHandler): void;
-}
-/**
- * 语音识别器接口
- */
-interface SpeechRecognizer {
-    /** 当前使用的提供商 */
-    readonly currentProvider: SpeechProviderType;
-    /** 服务状态 */
-    readonly status: SpeechServiceStatus;
-    /** 初始化 */
-    initialize(config?: RecognitionConfig): Promise<void>;
-    /** 开始识别 */
-    start(config?: RecognitionConfig): Promise<void>;
-    /** 停止识别 */
-    stop(): void;
-    /** 中止识别 */
-    abort(): void;
-    /** 是否正在识别 */
-    isListening(): boolean;
-    /** 添加事件监听 */
-    on(event: RecognitionEventType, handler: RecognitionEventHandler): void;
-    /** 移除事件监听 */
-    off(event: RecognitionEventType, handler: RecognitionEventHandler): void;
-    /** 销毁实例 */
-    dispose(): void;
-}
-/**
- * Azure 语音服务配置
- */
-interface AzureSpeechConfig {
-    /** 订阅密钥 */
-    subscriptionKey: string;
-    /** 服务区域 */
-    region: string;
-    /** 自定义端点 */
-    endpoint?: string;
-}
-/**
- * Google Cloud Speech 配置
- */
-interface GoogleSpeechConfig {
-    /** API 密钥 */
-    apiKey: string;
-    /** 项目 ID */
-    projectId?: string;
-}
-/**
- * AWS Polly/Transcribe 配置
- */
-interface AWSSpeechConfig {
-    /** 访问密钥 ID */
-    accessKeyId: string;
-    /** 秘密访问密钥 */
-    secretAccessKey: string;
-    /** 区域 */
-    region: string;
-}
-/**
- * 自定义提供商配置
- */
-interface CustomProviderConfig {
-    /** 合成 API 端点 */
-    synthesisEndpoint?: string;
-    /** 识别 API 端点 */
-    recognitionEndpoint?: string;
-    /** 自定义请求头 */
-    headers?: Record<string, string>;
-    /** 认证令牌 */
-    authToken?: string;
-}
-/**
- * 提供商配置联合类型
+ * @fileoverview 指纹识别模块内置采集器
+ * @module melange/plugins/fingerprint/collectors
+ * @description
+ * 提供默认的低敏浏览器/设备环境采集器。采集器只读取同步可得的环境信息，
+ * 不触发权限弹窗，不渲染 Canvas/WebGL，不枚举字体或插件，也不写入持久化存储。
  */
-type ProviderConfig = AzureSpeechConfig | GoogleSpeechConfig | AWSSpeechConfig | CustomProviderConfig;
 
 /**
- * @fileoverview 语音合成 (TTS) 实现 - 商业级版本 v2.0
- * @module melange/plugins/speech/synthesis
- * @description 生产级 Web 语音合成插件
+ * 内置低敏指纹组件采集器。
  *
- * 架构：
- * [UI层] -> [SpeechSynthesizerImpl] -> [NativeStrategy / CloudStrategy]
- *                                          |
- *                                          +-> [音频核心]: AudioContext, 流式播放
- *                                          +-> [适配器]: AzureAdapter, GoogleAdapter, TencentAdapter...
+ * @description
+ * 采集器按数组顺序注册，但最终哈希输入会按组件键排序，因此顺序不会影响
+ * `visitorId`。每个采集器都提供 `confidence`，用于最终置信度估算。
  *
- * 功能特性：
- * 1. 多模式: 支持原生 Web Speech API & 云端 TTS 服务
- * 2. 状态机: IDLE -> LOADING -> SPEAKING -> PAUSED
- * 3. 插件化: 内置 Azure/Google/AWS/讯飞/腾讯/百度/阿里 适配器
- * 4. 核心: AudioContext 流式播放 + 音频队列管理
- * 5. 兼容性: 多浏览器支持 + 自动降级处理
+ * @remarks
+ * 这里刻意不包含 Canvas、音频、WebGL 渲染、字体探测、浏览器插件枚举等
+ * 高熵或更易引发隐私争议的采集方式。
  */
+declare const defaultFingerprintCollectors: readonly FingerprintCollector[];
 
 /**
- * 合成器状态枚举
- */
-declare enum SynthesisStatus {
-    /** 空闲状态 */
-    IDLE = "IDLE",
-    /** 加载中（获取语音/准备中） */
-    LOADING = "LOADING",
-    /** 正在播放 */
-    SPEAKING = "SPEAKING",
-    /** 已暂停 */
-    PAUSED = "PAUSED"
-}
-/**
- * 合成引擎模式
+ * @fileoverview 指纹识别模块工具函数
+ * @module melange/plugins/fingerprint/utils
+ * @description
+ * 提供稳定序列化、哈希计算和隐私友好的归一化工具。
+ * 这些工具是生成 `visitorId` 的底层能力，也可以被业务侧复用来测试
+ * 自定义组件的稳定性。
  */
-type SynthesisEngineMode = 'native' | 'cloud' | 'auto';
-/**
- * 云端 TTS 音频格式
- */
-type CloudAudioFormat = 'mp3' | 'wav' | 'ogg' | 'pcm';
-/**
- * 云端合成结果接口
- */
-interface ISynthesisResult {
-    /** 音频数据 */
-    audioData: ArrayBuffer;
-    /** 音频格式 */
-    format: CloudAudioFormat;
-    /** 音频时长 (ms) */
-    duration?: number;
-    /** 原始响应数据 */
-    original?: unknown;
-}
-/**
- * 云端语音信息
- */
-interface ICloudVoice {
-    /** 语音 ID */
-    id: string;
-    /** 语音名称 */
-    name: string;
-    /** 语言代码 */
-    lang: string;
-    /** 性别 */
-    gender?: 'male' | 'female' | 'neutral';
-    /** 提供商名称 */
-    provider: string;
-}
-/**
- * 高级合成配置
- */
-interface IAdvancedSynthesisConfig extends SynthesisConfig {
-    /** 合成引擎模式 */
-    mode?: SynthesisEngineMode;
-    /** 云端适配器 */
-    cloudAdapter?: ICloudSynthesisAdapter;
-    /** 音频格式偏好 */
-    audioFormat?: CloudAudioFormat;
-    /** 是否启用 SSML */
-    enableSSML?: boolean;
-    /** 是否预加载音频 */
-    preload?: boolean;
-    /** 音频缓存大小 */
-    cacheSize?: number;
-}
-/**
- * 云端合成适配器接口
- * 提供统一的第三方语音合成服务集成接口
- */
-interface ICloudSynthesisAdapter {
-    /** 适配器名称 */
-    readonly name: string;
-    /**
-     * 合成语音
-     * @param text 要合成的文本
-     * @param config 合成配置
-     * @returns 合成结果（音频数据）
-     */
-    synthesize(text: string, config?: IAdvancedSynthesisConfig): Promise<ISynthesisResult>;
-    /**
-     * 获取可用语音列表
-     * @returns 语音列表
-     */
-    getVoices?(): Promise<ICloudVoice[]>;
-    /**
-     * 检查适配器是否可用
-     * @returns 是否可用
-     */
-    isAvailable?(): boolean;
-}
-/**
- * 语音合成器实现
- * 统一封装原生合成和云端合成
- */
-declare class SpeechSynthesizerImpl implements SpeechSynthesizer {
-    private strategy;
-    private config;
-    private _currentProvider;
-    private _status;
-    private eventHandlers;
-    private customProviders;
-    get currentProvider(): SpeechProviderType;
-    get status(): SpeechServiceStatus;
-    /**
-     * 获取当前合成状态
-     */
-    get synthesisStatus(): SynthesisStatus;
-    /**
-     * 初始化语音合成器
-     */
-    initialize(config?: SynthesisConfig): Promise<void>;
-    /**
-     * 初始化合成策略
-     */
-    private initializeStrategy;
-    /**
-     * 转发策略事件
-     */
-    private forwardStrategyEvents;
-    /**
-     * 获取可用语音列表
-     */
-    getVoices(): Promise<VoiceInfo[]>;
-    /**
-     * 朗读文本
-     */
-    speak(text: string, config?: SynthesisConfig): Promise<void>;
-    /**
-     * 暂停朗读
-     */
-    pause(): void;
-    /**
-     * 继续朗读
-     */
-    resume(): void;
-    /**
-     * 取消朗读
-     */
-    cancel(): void;
-    /**
-     * 是否正在朗读
-     */
-    isSpeaking(): boolean;
-    /**
-     * 是否已暂停
-     */
-    isPaused(): boolean;
-    /**
-     * 添加事件监听
-     */
-    on(event: SynthesisEventType, handler: SynthesisEventHandler): void;
-    /**
-     * 移除事件监听
-     */
-    off(event: SynthesisEventType, handler: SynthesisEventHandler): void;
-    /**
-     * 触发事件
-     */
-    private emit;
-    /**
-     * 销毁实例
-     */
-    dispose(): void;
-    /**
-     * 注册自定义提供商
-     */
-    registerProvider(type: SpeechProviderType, provider: SynthesisProvider): void;
-    /**
-     * 使用云端适配器
-     */
-    useCloudAdapter(adapter: ICloudSynthesisAdapter): void;
-}
+
 /**
- * 创建语音合成器实例
- * @param config - 可选的合成配置
- * @returns 语音合成器实例
+ * 稳定序列化指纹值，保证对象键顺序不影响哈希。
+ *
+ * @description
+ * JavaScript 对象的键顺序可能受构造顺序影响。为了让相同组件值在不同
+ * 采集顺序下得到相同哈希，本函数会递归排序对象键，再生成 JSON 兼容字符串。
  *
  * @example
  * ```typescript
- * // 使用原生合成
- * const synthesizer = await createSpeechSynthesizer({
- *   lang: 'zh-CN',
- *   rate: 1.0,
- * });
- *
- * // 使用云端合成 (Azure)
- * const azureAdapter = new AzureSynthesisAdapter('key', 'eastasia');
- * const cloudSynthesizer = await createSpeechSynthesizer({
- *   mode: 'cloud',
- *   cloudAdapter: azureAdapter,
- * });
- *
- * await synthesizer.speak('你好，世界！');
+ * stableStringify({ b: 2, a: 1 }) === stableStringify({ a: 1, b: 2 });
  * ```
+ *
+ * @param value - 要序列化的值
+ * @returns 稳定 JSON 字符串
  */
-declare function createSpeechSynthesizer(config?: SynthesisConfig | IAdvancedSynthesisConfig): Promise<SpeechSynthesizer>;
-/**
- * 检查当前环境是否支持语音合成
- * @returns 是否支持语音合成
- */
-declare function isSpeechSynthesisSupported(): boolean;
+declare function stableStringify(value: FingerprintValue): string;
 /**
- * 快速朗读文本（一次性使用）
- * @param text - 要朗读的文本
- * @param config - 可选的合成配置
+ * 将组件集合转换为稳定的哈希输入。
  *
- * @example
- * ```typescript
- * // 快速朗读
- * await speak('你好，世界！');
+ * @description
+ * 仅组件的 `value` 会参与哈希计算，`duration`、`source` 和 `confidence`
+ * 只用于调试和置信度说明。组件键会先排序，避免对象插入顺序影响输出。
  *
- * // 带配置的朗读
- * await speak('Hello World', { lang: 'en-US', rate: 0.8 });
- * ```
+ * @param components - 指纹组件集合
+ * @param salt - 命名空间盐值，用于隔离不同业务域或用途
+ * @returns 稳定的哈希输入字符串
  */
-declare function speak(text: string, config?: SynthesisConfig | IAdvancedSynthesisConfig): Promise<void>;
-
+declare function serializeComponents(components: FingerprintComponentMap, salt: string): string;
 /**
- * @fileoverview 语音识别 (STT) 实现 - 商业级版本 v2.0
- * @module melange/plugins/speech/recognition
- * @description 生产级 Web 语音识别插件
+ * 计算 FNV-1a 64 位哈希。
  *
- * 架构：
- * [UI层] -> [SpeechRecognizerImpl] -> [NativeStrategy / CloudStrategy]
- *                                          |
- *                                          +-> [音频核心]: Worklet, VAD, Resample
- *                                          +-> [适配器]: BaiduAdapter, XunfeiAdapter, TencentAdapter...
+ * @description
+ * FNV-1a 是非加密哈希，速度快、实现小，适合生成本地稳定标识。
+ * 它不具备抗碰撞或安全签名能力，不应作为密码学用途。
  *
- * 功能特性：
- * 1. 多模式: 支持 WebSocket 流式识别 & HTTP 短语音识别
- * 2. 状态机: IDLE -> CONNECTING -> RECORDING -> PROCESSING
- * 3. 插件化: 内置 讯飞/腾讯/百度/阿里/Google/Azure 适配器
- * 4. 核心: AudioWorklet + VAD + 自动重采样 + WAV编码
- * 5. 兼容性: 自动降级处理 (ScriptProcessor) + 断网缓冲队列
- */
-
-declare global {
-    interface Window {
-        SpeechRecognition?: unknown;
-        webkitSpeechRecognition?: unknown;
-        webkitAudioContext?: typeof AudioContext;
-    }
-}
-/**
- * 识别器状态枚举
+ * @param input - 输入字符串
+ * @returns 16 位十六进制哈希
  */
-declare enum RecognitionStatus {
-    /** 空闲状态 */
-    IDLE = "IDLE",
-    /** 连接中 */
-    CONNECTING = "CONNECTING",
-    /** 录音中 */
-    RECORDING = "RECORDING",
-    /** 处理中/上传中 */
-    PROCESSING = "PROCESSING"
-}
+declare function fnv1a64(input: string): string;
 /**
- * 识别引擎模式
- */
-type RecognitionEngineMode = 'native' | 'cloud' | 'auto';
-/**
- * 云端传输协议类型
- */
-type CloudTransportType = 'websocket' | 'http';
-/**
- * 识别结果接口
- */
-interface IRecognitionResult {
-    /** 识别文本 */
-    transcript: string;
-    /** 是否为最终结果 */
-    isFinal: boolean;
-    /** 置信度 (0-1) */
-    confidence: number;
-    /** 原始响应数据 */
-    original?: unknown;
-}
-/**
- * 音频配置接口
- */
-interface IAudioConfig {
-    /** 目标采样率 (默认 16000) */
-    sampleRate?: number;
-    /** VAD 阈值 (0.01 ~ 0.5) */
-    vadThreshold?: number;
-    /** VAD 静音超时 (ms) */
-    vadDuration?: number;
-    /** 是否启用回声消除 */
-    echoCancellation?: boolean;
-    /** 是否启用噪声抑制 */
-    noiseSuppression?: boolean;
-    /** 是否启用自动增益控制 */
-    autoGainControl?: boolean;
-}
-/**
- * 高级识别配置
+ * 计算 SHA-256 哈希。
+ *
+ * @description
+ * 优先使用标准 Web Crypto API。部分非浏览器或旧浏览器环境可能没有
+ * `crypto.subtle`，此时返回 `null`，由上层决定是否降级。
+ *
+ * @param input - 要计算哈希的输入字符串
+ * @returns 十六进制哈希；不可用时返回 null
  */
-interface IAdvancedRecognitionConfig extends RecognitionConfig {
-    /** 识别引擎模式 */
-    mode?: RecognitionEngineMode;
-    /** 云端适配器 */
-    cloudAdapter?: ICloudRecognitionAdapter;
-    /** 传输协议 */
-    transport?: CloudTransportType;
-    /** 音频配置 */
-    audioConfig?: IAudioConfig;
-    /** 是否启用自动重连 */
-    autoReconnect?: boolean;
-    /** 最大重连次数 */
-    maxReconnectAttempts?: number;
-    /** 重连间隔 (ms) */
-    reconnectInterval?: number;
-}
+declare function sha256(input: string): Promise<string | null>;
 /**
- * 云端识别适配器接口
- * 提供统一的第三方语音识别服务集成接口
+ * 计算指纹哈希。
+ *
+ * @description
+ * 统一封装哈希策略。选择 `sha256` 时，如果当前环境缺少 Web Crypto API，
+ * 会自动降级到 `fnv1a64`，保证指纹生成不会因为环境能力不足而失败。
+ *
+ * @param input - 已稳定序列化的哈希输入
+ * @param algorithm - 哈希算法，默认为 `fnv1a64`
+ * @returns 指纹哈希
  */
-interface ICloudRecognitionAdapter {
-    /** 适配器名称 */
-    readonly name: string;
-    /**
-     * 获取 WebSocket 连接地址
-     * @returns WebSocket URL
-     */
-    getConnectUrl?(): Promise<string> | string;
-    /**
-     * 获取握手参数
-     * @returns 握手消息
-     */
-    getHandshakeParams?(): unknown;
-    /**
-     * HTTP 短语音识别
-     * @param audioData WAV/PCM 二进制数据
-     * @returns 识别结果
-     */
-    recognizeShortAudio?(audioData: ArrayBuffer): Promise<IRecognitionResult>;
-    /**
-     * 转换音频数据格式
-     * @param pcmData PCM 原始数据
-     * @returns 转换后的数据
-     */
-    transformAudioData?(pcmData: ArrayBuffer): ArrayBuffer | string;
-    /**
-     * 解析识别结果
-     * @param data 原始响应数据
-     * @returns 识别结果
-     */
-    parseResult(data: unknown): IRecognitionResult | null;
-    /**
-     * 检查适配器是否可用
-     * @returns 是否可用
-     */
-    isAvailable?(): boolean;
-}
+declare function hashString(input: string, algorithm?: FingerprintHashAlgorithm): Promise<string>;
 /**
- * 语音识别器实现
- * 统一封装原生识别和云端识别
+ * 将数值按指定大小分桶。
+ *
+ * @description
+ * 分桶可以降低精确数值带来的唯一性。例如屏幕高度 1080 在 bucketSize=100
+ * 时会归入 1100 桶，从而避免把过细的设备差异直接写入指纹。
+ *
+ * @param value - 原始数值
+ * @param bucketSize - 分桶大小；小于等于 0 时返回原值
+ * @returns 分桶后的数值
  */
-declare class SpeechRecognizerImpl implements SpeechRecognizer {
-    private strategy;
-    private config;
-    private _currentProvider;
-    private _status;
-    private eventHandlers;
-    private customProviders;
-    get currentProvider(): SpeechProviderType;
-    get status(): SpeechServiceStatus;
-    /**
-     * 获取当前识别状态
-     */
-    get recognitionStatus(): RecognitionStatus;
-    /**
-     * 初始化语音识别器
-     */
-    initialize(config?: RecognitionConfig): Promise<void>;
-    /**
-     * 初始化识别策略
-     */
-    private initializeStrategy;
-    /**
-     * 转发策略事件
-     */
-    private forwardStrategyEvents;
-    /**
-     * 转换识别结果格式
-     */
-    private convertResult;
-    /**
-     * 开始识别
-     */
-    start(config?: RecognitionConfig): Promise<void>;
-    /**
-     * 停止识别
-     */
-    stop(): void;
-    /**
-     * 中止识别
-     */
-    abort(): void;
-    /**
-     * 是否正在识别
-     */
-    isListening(): boolean;
-    /**
-     * 添加事件监听
-     */
-    on(event: RecognitionEventType, handler: RecognitionEventHandler): void;
-    /**
-     * 移除事件监听
-     */
-    off(event: RecognitionEventType, handler: RecognitionEventHandler): void;
-    /**
-     * 触发事件
-     */
-    private emit;
-    /**
-     * 销毁实例
-     */
-    dispose(): void;
-    /**
-     * 注册自定义提供商
-     */
-    registerProvider(type: SpeechProviderType, provider: RecognitionProvider): void;
-    /**
-     * 使用云端适配器
-     */
-    useCloudAdapter(adapter: ICloudRecognitionAdapter): void;
-}
+declare function bucketNumber(value: number, bucketSize: number): number;
 /**
- * 创建语音识别器实例
- * @param config 识别配置
- * @returns 语音识别器实例
+ * 归一化 User-Agent，降低补丁版本和构建号带来的高熵差异。
+ *
+ * @description
+ * User-Agent 中的补丁版本和构建号会频繁变化，也可能提升唯一性。
+ * 本函数保留主版本/次版本等粗粒度信息，同时去除常见构建号细节。
  *
  * @example
  * ```typescript
- * // 使用原生识别
- * const recognizer = await createSpeechRecognizer({
- *   lang: 'zh-CN',
- *   continuous: true,
- * });
- *
- * // 使用云端识别 (百度)
- * const baiduAdapter = new BaiduAdapter('your-access-token');
- * const cloudRecognizer = await createSpeechRecognizer({
- *   mode: 'cloud',
- *   cloudAdapter: baiduAdapter,
- *   transport: 'http',
- * });
- *
- * recognizer.on('result', (event) => {
- *   console.log('识别结果:', event.result?.bestTranscript);
- * });
- *
- * await recognizer.start();
+ * normalizeUserAgent('Chrome/120.0.6099.130');
+ * // 'Chrome/120.0'
  * ```
+ *
+ * @param userAgent - 原始 User-Agent
+ * @returns 归一化后的 User-Agent
  */
-declare function createSpeechRecognizer(config?: RecognitionConfig | IAdvancedRecognitionConfig): Promise<SpeechRecognizer>;
+declare function normalizeUserAgent(userAgent: string): string;
 /**
- * 检查当前环境是否支持语音识别
- * @returns 是否支持
+ * 将硬件线程数分桶，降低唯一性。
+ *
+ * @description
+ * 浏览器暴露的硬件线程数可能比较稳定，但精确值会增加区分度。
+ * balanced 模式下会将常见高线程设备归入 4/8/16 等粗粒度区间。
+ *
+ * @param value - 原始硬件线程数
+ * @returns 分桶后的线程数
  */
-declare function isSpeechRecognitionSupported(): boolean;
+declare function bucketHardwareConcurrency(value: number): number;
 /**
- * 快速进行一次语音识别
- * @param config 识别配置
- * @returns 识别结果
+ * 将设备内存分桶，降低唯一性。
  *
- * @example
- * ```typescript
- * const result = await listen({ lang: 'zh-CN' });
- * console.log('识别结果:', result.bestTranscript);
- * ```
+ * @description
+ * `navigator.deviceMemory` 本身通常已经是粗粒度值，但仍统一归入
+ * 1/2/4/8/16 桶，便于跨浏览器表现一致。
+ *
+ * @param value - 原始设备内存，单位通常为 GB
+ * @returns 分桶后的设备内存
  */
-declare function listen(config?: RecognitionConfig | IAdvancedRecognitionConfig): Promise<RecognitionResult>;
+declare function bucketDeviceMemory(value: number): number;
 
-export { type AWSSpeechConfig, type AzureSpeechConfig, type BaseSpeechConfig, type CustomProviderConfig, type GoogleSpeechConfig, type ProviderConfig, type RecognitionConfig, type RecognitionEvent, type RecognitionEventHandler, type RecognitionEventType, type RecognitionProvider, type RecognitionResult, type RecognitionResultItem, type SpeechError, type SpeechProviderType, type SpeechRecognizer, SpeechRecognizerImpl, type SpeechServiceStatus, type SpeechSynthesizer, SpeechSynthesizerImpl, type SynthesisConfig, type SynthesisEvent, type SynthesisEventHandler, type SynthesisEventType, type SynthesisProvider, type VoiceInfo, createSpeechRecognizer, createSpeechSynthesizer, isSpeechRecognitionSupported, isSpeechSynthesisSupported, listen, speak };
+export { FingerprintCollector, FingerprintComponentMap, FingerprintHashAlgorithm, FingerprintValue, bucketDeviceMemory, bucketHardwareConcurrency, bucketNumber, defaultFingerprintCollectors, fnv1a64, hashString, normalizeUserAgent, serializeComponents, sha256, stableStringify };