keepwork-sdk 1.0.0

package/dist-npm/types/src/audio/Speech.d.ts

@@ -0,0 +1,247 @@
+/**
+ * Speech.ts — 浏览器端 TTS/STT 助手（TypeScript 完整实现）
+ *
+ * 提供三大功能：
+ * 1. Keepwork TTS 播放（playKeepworkAudio）—— 百度 TTS，按年龄/性别自动选音色
+ * 2. Volcano TTS 播放（playSynthesizedAudio）—— 火山 TTS，支持多种音色
+ * 3. 麦克风录音 + 转写（speechToText）—— MediaRecorder + 服务端 STT
+ */
+import AudioEngine from './AudioEngine';
+/** TTS 失败回退模式 */
+export type FallbackMode = 'system' | 'silent' | 'retry';
+/** 年龄性别音色配置 */
+interface VoiceConfig {
+    child: {
+        male: number;
+        female: number;
+    };
+    teen: {
+        male: number;
+        female: number;
+    };
+    adult: {
+        male: number;
+        female: number;
+    };
+    senior: {
+        male: number;
+        female: number;
+    };
+}
+/** Keepwork TTS 请求选项 */
+export interface PlayKeepworkAudioOptions {
+    /** 发音人 ID（数字或字符串，内部统一转换） */
+    per?: string | number;
+    spd?: number;
+    pit?: number;
+    vol?: number;
+    age?: number;
+    gender?: 'male' | 'female';
+    key?: string;
+    useCache?: boolean;
+    fallbackMode?: FallbackMode;
+    onLoaded?: () => void;
+    onEnded?: () => void;
+    onError?: (error: unknown) => void;
+    [key: string]: unknown;
+}
+/** Volcano TTS 选项 */
+export interface PlaySynthesizedAudioOptions {
+    voiceType?: string;
+    encoding?: string;
+    speedRatio?: number;
+    loudnessRatio?: number;
+    explicitLanguage?: string;
+    fallbackMode?: FallbackMode;
+    onLoaded?: () => void;
+    onEnded?: () => void;
+    onError?: (error: unknown) => void;
+    [key: string]: unknown;
+}
+/** speechToText 配置 */
+export interface SpeechToTextOptions {
+    maxDuration?: number;
+    sampleRate?: number;
+    format?: string;
+    onStart?: () => void;
+    onStop?: () => void;
+    onError?: (error: Error) => void;
+    onResult?: (result: unknown) => void;
+    [key: string]: unknown;
+}
+/** speechToText 返回的录音控制器 */
+export interface SpeechToTextRecorder {
+    start: () => void;
+    stop: () => void;
+    getState: () => string;
+    isRecording: () => boolean;
+}
+/** TTS 服务配置 */
+interface TTSServiceConfig {
+    url: string;
+    voiceType: string;
+    encoding: string;
+    speedRatio: number;
+    loudnessRatio: number;
+    explicitLanguage: string;
+}
+/** 浏览器兼容性检测结果 */
+export interface BrowserCompatibilityResult {
+    isSupported: boolean;
+    errors: string[];
+    warnings: string[];
+    supportedFormats: string[];
+}
+/**
+ * Speech — 浏览器端 TTS/STT 助手。
+ *
+ * 通常通过 `window.keepwork.speech` 访问共享实例；
+ * 也可直接 `new Speech(sdk)` 创建独立实例。
+ */
+declare class Speech {
+    sdk: unknown;
+    api: string;
+    rate: number;
+    volume: number;
+    pitch: number;
+    ttsService: TTSServiceConfig;
+    /**
+     * TTS 失败时的全局回退模式（可被单次调用的 options.fallbackMode 覆盖）：
+     * - `'system'`（默认）：回退到浏览器原生 speechSynthesis
+     * - `'silent'`：静默失败，不播放任何音频
+     * - `'retry'`：重试一次远程 TTS，仍失败则静默
+     */
+    fallbackMode: FallbackMode;
+    constructor(sdk: unknown);
+    /**
+     * 提取主域名（去掉子域名前缀）。
+     * localhost / 127.x / 192.168.x 回退到 keepwork.com。
+     */
+    extractMainDomain(hostname: string): string;
+    setRate(rate: number): void;
+    setVolume(volume: number): void;
+    setPitch(pitch: number): void;
+    /**
+     * 设置全局 TTS 回退模式。
+     * 无效值会被忽略并发出警告。
+     */
+    setFallbackMode(mode: FallbackMode): void;
+    /** 获取共享 AudioEngine 实例（优先 sdk.audioEngine，否则 AudioEngine.getShared()）。 */
+    getAudioEngine(): ReturnType<typeof AudioEngine.getShared>;
+    /**
+     * 恢复共享 AudioEngine 的 AudioContext（绕过浏览器自动播放策略）。
+     * 失败时静默忽略。
+     */
+    resumeSharedAudioEngine(options?: Record<string, unknown>): Promise<unknown> | null;
+    /**
+     * 将 AudioBuffer 重采样到目标采样率（使用 OfflineAudioContext）。
+     * 若浏览器不支持或采样率已匹配则原样返回。
+     */
+    resampleAudioBuffer(audioBuffer: AudioBuffer, targetSampleRate: number): Promise<AudioBuffer>;
+    /**
+     * 调用 Keepwork TTS API，返回音频 URL。
+     * @param text    - 要转换的文字
+     * @param options - 发音人 / 语速 / 音量等参数
+     */
+    textToAudio(text: string, options?: PlayKeepworkAudioOptions): Promise<{
+        data?: string;
+        [key: string]: unknown;
+    }>;
+    /**
+     * 获取年龄/性别对应的 Keepwork 发音人 ID 配置表。
+     */
+    getVoiceConfig(): VoiceConfig;
+    /**
+     * 根据年龄和性别获取对应的发音人 ID。
+     * @param age    - 说话人年龄
+     * @param gender - 性别（'male' | 'female'，默认 'female'）
+     */
+    getVoiceIdByAgeGender(age: number, gender: string): number;
+    /**
+     * 播放 Keepwork TTS 音频。
+     * 若指定了 `age` / `gender` 则自动映射发音人 ID。
+     * 支持 AudioEngine 缓存（传入 `useCache: true`）。
+     *
+     * @param text    - 要朗读的文字
+     * @param options - 播放选项（发音人/语速/音量/缓存/回调等）
+     */
+    playKeepworkAudio(text: string, options?: PlayKeepworkAudioOptions): Promise<unknown>;
+    /**
+     * 调用火山 TTS API，返回 base64 音频数据。
+     */
+    synthesizeAudio(text: string, options?: PlaySynthesizedAudioOptions): Promise<{
+        data?: {
+            audioBase64?: string;
+        };
+    }>;
+    /**
+     * 播放火山 TTS 合成音频。
+     * 自动处理 base64 → Audio 元素播放，失败时按 fallbackMode 回退。
+     *
+     * @param text    - 要合成的文字
+     * @param options - 音色/语速/编码/回调等
+     */
+    playSynthesizedAudio(text: string, options?: PlaySynthesizedAudioOptions): Promise<unknown>;
+    /**
+     * 统一处理 TTS 失败后的回退逻辑。
+     * - `silent`：静默 resolve
+     * - `retry`：重试一次，失败后 silent
+     * - `system`（默认）：使用浏览器 speechSynthesis
+     * @private
+     */
+    _handleFallback(text: string, safeOptions: Record<string, unknown>, safeResolve: (v: unknown) => void, resultData: unknown, retryFn: () => Promise<unknown>): Promise<void>;
+    /**
+     * 使用浏览器原生 speechSynthesis 朗读文字（TTS 失败时的回退路径）。
+     */
+    playSystemAudio(text: string, options?: Record<string, unknown>): Promise<void>;
+    /**
+     * 停止所有音频播放（AudioEngine + speechSynthesis + 所有 audio 元素）。
+     */
+    stopAllAudio(): void;
+    /** 停止所有音频（stopAllAudio 的别名）。 */
+    stop(): void;
+    /** 播放有道词典发音（英语词汇朗读）。 */
+    playYouDaoAudio(text: string): void;
+    /**
+     * 创建麦克风录音控制器，并返回 start / stop / getState / isRecording 方法。
+     * 录音停止后自动调用服务端 STT API 并通过 `options.onResult` 回调结果。
+     *
+     * @param options - 录音配置（maxDuration / sampleRate / 各种回调）
+     * @throws 浏览器不支持 / 非 HTTPS 环境时抛出错误
+     */
+    speechToText(options?: SpeechToTextOptions): Promise<SpeechToTextRecorder>;
+    /** 获取当前浏览器支持的录音 MIME 类型（优先 opus/webm）。 */
+    getSupportedMimeType(): string;
+    /**
+     * 返回当前浏览器支持的录音音频格式简称（如 `webm` / `mp4` / `ogg`），
+     * 便于 UI 展示或作为文件扩展名。无法检测时回退为 `webm`。
+     */
+    getSupportedAudioFormat(): string;
+    /**
+     * 将音频 Blob 转换为 WAV 格式的 base64 字符串。
+     * 内部使用 Web Audio API 解码 + 必要时重采样。
+     */
+    convertToWavBase64(audioBlob: Blob, sampleRate?: number): Promise<string>;
+    /** 将 ArrayBuffer 分块转换为 base64 字符串（避免大缓冲区栈溢出）。 */
+    arrayBufferToBase64(buffer: ArrayBuffer): string;
+    /** 将 AudioBuffer 编码为 WAV ArrayBuffer（16-bit PCM）。 */
+    audioBufferToWav(buffer: AudioBuffer): ArrayBuffer;
+    /**
+     * 调用服务端 STT API（Keepwork audioEncode2Text）。
+     * @param speechBase64 - WAV base64 字符串
+     * @param format       - 音频格式（默认 'wav'）
+     */
+    callSpeechToTextAPI(speechBase64: string, format?: string): Promise<unknown>;
+    /**
+     * 检查当前浏览器是否支持录音功能。
+     * @returns 兼容性检测结果（isSupported / errors / warnings / supportedFormats）
+     */
+    checkBrowserCompatibility(): BrowserCompatibilityResult;
+    /**
+     * 一键录音识别（自动启动录音，录音停止后返回识别结果）。
+     * @param options - 同 speechToText 选项
+     */
+    quickSpeechToText(options?: SpeechToTextOptions): Promise<unknown>;
+}
+export default Speech;
+//# sourceMappingURL=Speech.d.ts.map

package/dist-npm/types/src/audio/Speech.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Speech.d.ts","sourceRoot":"","sources":["../../../../src/audio/Speech.ts"],"names":[],"mappings":"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"}

package/dist-npm/types/src/core/AgentConfig.d.ts

@@ -0,0 +1,104 @@
+/**
+ * AgentConfig.ts — Agent 配置读取器（完整 TypeScript 实现）
+ *
+ * 统一入口：从 JSON / YAML / Markdown(frontmatter) / Markdown 表格 多种格式
+ * 读取并解析 agent 配置。原先是 DigitalHuman 的静态方法，抽出后任何模块
+ * （SummarizeTool / AIChatRTC / 独立脚本等）都可加载配置而不依赖 DigitalHuman。
+ *
+ * @example
+ *   import AgentConfig from './AgentConfig';
+ *   const cfg = await AgentConfig.fetch('https://example.com/agent.yaml'); // URL（.json/.yml/.yaml/.md）
+ *   const cfg2 = AgentConfig.parse('{ "llm_model": "keepwork-flash" }');   // 内联 JSON 字符串
+ *   const cfg3 = AgentConfig.normalize({ workspace: 'ws', content: 'You are a helper.' }); // 仅归一化
+ */
+/** 配置文件格式 */
+export type AgentConfigFormat = 'json' | 'yml' | 'md';
+/** fileOps 工具配置 */
+export interface AgentFileOpsConfig {
+    enabled?: boolean;
+    workspace?: string;
+    mountFolder?: string | Record<string, unknown>;
+    [key: string]: unknown;
+}
+/** 归一化后的 agent 配置对象 */
+export interface NormalizedAgentConfig {
+    /** 系统提示词（由 .md frontmatter 的 content 转换而来） */
+    system_prompt?: string;
+    /** 顶层工作区，会传播到 tools.fileOps.workspace */
+    workspace?: string;
+    /** 挂载文件夹，会传播到 tools.fileOps.mountFolder */
+    mountFolder?: string | Record<string, unknown>;
+    /** 历史长度（history_length 的 camelCase 别名） */
+    historyLength?: number;
+    /** 工具配置块 */
+    tools?: {
+        fileOps?: AgentFileOpsConfig;
+        [category: string]: unknown;
+    };
+    /** Markdown frontmatter 的正文（解析后会转为 system_prompt 并删除） */
+    content?: string;
+    /** snake_case 历史长度（解析后会转为 historyLength 并删除） */
+    history_length?: number;
+    [key: string]: unknown;
+}
+/**
+ * 根据 URL 文件扩展名检测配置格式。匹配前会剥离 query / fragment。
+ */
+declare function detectFormat(url: string): AgentConfigFormat | null;
+/**
+ * 就地归一化已解析的配置对象：
+ * - .md frontmatter 的 `content` → `system_prompt`
+ * - 顶层 `workspace`   → `tools.fileOps.workspace`
+ * - 顶层 `mountFolder` → `tools.fileOps.mountFolder`
+ * - `history_length`   → `historyLength`
+ */
+declare function normalize(config: NormalizedAgentConfig): NormalizedAgentConfig;
+/**
+ * 把 Markdown 表格解析为对象或对象数组。
+ *
+ * 期望管道分隔的表格（含表头行 + 分隔行）：
+ *   | key        | value          |
+ *   |------------|----------------|
+ *   | llm_model  | keepwork-flash |
+ *
+ * 两列 key/value 表会折叠为一个扁平对象；多列则返回按表头键名的行对象数组。
+ */
+declare function parseTable(tableText: string): Record<string, unknown> | Array<Record<string, unknown>>;
+/**
+ * 把配置字符串（JSON / YAML / Markdown frontmatter / Markdown 表格）解析为
+ * 归一化配置对象。**不**发起任何网络请求。
+ *
+ * 检测顺序：
+ *   1. JSON（以 `{` 或 `[` 开头）
+ *   2. Markdown frontmatter（以 `---` 开头）
+ *   3. Markdown 表格（首个非空行以 `|` 开头）
+ *   4. 纯 YAML
+ *
+ * @param text       - 原始配置文本
+ * @param formatHint - 来自 URL 扩展名的可选格式提示
+ */
+declare function parse(text: string, formatHint?: AgentConfigFormat | null): NormalizedAgentConfig;
+/**
+ * 从 URL / 内联 JSON 字符串 / 对象异步获取并解析 agent 配置。
+ *
+ * 支持的来源：
+ *   - 普通对象 → 归一化后原样返回
+ *   - JSON 字符串（以 `{`/`[` 开头）→ JSON.parse
+ *   - `.json` URL → fetch + JSON.parse
+ *   - `.yml`/`.yaml` URL → fetch + YMLParser
+ *   - `.md` URL → fetch + YMLParser frontmatter
+ *   - 未知扩展名 URL → 自动检测（JSON → frontmatter → YAML）
+ */
+declare function fetchConfig(source: string | Record<string, unknown>): Promise<NormalizedAgentConfig>;
+/** AgentConfig 模块公开 API */
+export interface IAgentConfig {
+    detectFormat(url: string): AgentConfigFormat | null;
+    normalize(config: NormalizedAgentConfig): NormalizedAgentConfig;
+    parse(text: string, formatHint?: AgentConfigFormat | null): NormalizedAgentConfig;
+    parseTable(tableText: string): Record<string, unknown> | Array<Record<string, unknown>>;
+    fetch(source: string | Record<string, unknown>): Promise<NormalizedAgentConfig>;
+}
+declare const AgentConfig: IAgentConfig;
+export default AgentConfig;
+export { detectFormat, normalize, parse, parseTable, fetchConfig };
+//# sourceMappingURL=AgentConfig.d.ts.map

package/dist-npm/types/src/core/AgentConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentConfig.d.ts","sourceRoot":"","sources":["../../../../src/core/AgentConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,aAAa;AACb,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;AAEtD,mBAAmB;AACnB,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,uBAAuB;AACvB,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY;IACZ,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,kBAAkB,CAAC;QAC7B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;KAC7B,CAAC;IACF,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID;;GAEG;AACH,iBAAS,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAO3D;AAID;;;;;;GAMG;AACH,iBAAS,SAAS,CAAC,MAAM,EAAE,qBAAqB,GAAG,qBAAqB,CAmCvE;AAID;;;;;;;;;GASG;AACH,iBAAS,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwC/F;AAgBD;;;;;;;;;;;;GAYG;AACH,iBAAS,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAAG,qBAAqB,CA+BzF;AAID;;;;;;;;;;GAUG;AACH,iBAAe,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAgCnG;AAeD,2BAA2B;AAC3B,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAAC;IACpD,SAAS,CAAC,MAAM,EAAE,qBAAqB,GAAG,qBAAqB,CAAC;IAChE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAAG,qBAAqB,CAAC;IAClF,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACxF,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACjF;AAED,QAAA,MAAM,WAAW,EAAE,YAMlB,CAAC;AAEF,eAAe,WAAW,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC"}