@mingxy/ocosay 1.0.0

package/TECH_PLAN.md

@@ -0,0 +1,352 @@
+# ocosay - OpenCode TTS 播放插件技术方案
+
+## 项目概述
+
+**ocosay** 是 OpenCode 的 TTS（文本转语音）播放插件，支持：
+- 文本转语音自动播放
+- 暂停/停止/恢复控制
+- 多 TTS 模型可扩展架构
+- 同步/异步/流式 多种合成模式
+
+## 架构设计
+
+### 核心原则
+- **可扩展架构**：抽象 TTS Provider 接口，MiniMax 作为第一个实现，未来可扩展其他提供商
+- **Provider 隔离**：每个 TTS 模型独立 Provider 实现，核心逻辑与模型无关
+- **合成模式可配置**：通过 `model` 参数指定 `sync` | `async` | `stream`
+
+### 目录结构
+
+```
+ocosay/
+├── src/
+│   ├── providers/
+│   │   ├── base.ts           # TTS Provider 接口定义
+│   │   ├── minimax.ts         # MiniMax TTS Provider
+│   │   └── index.ts          # Provider 导出
+│   ├── core/
+│   │   ├── player.ts         # 音频播放引擎
+│   │   ├── speaker.ts        # 统一调用入口
+│   │   └── types.ts          # 公共类型定义
+│   ├── tools/
+│   │   └── tts.ts            # OpenCode 自定义工具
+│   ├── index.ts              # Plugin 入口
+│   └── config.ts             # 配置管理
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+---
+
+## 核心接口设计
+
+### 错误类型
+
+```typescript
+// 错误类型定义
+enum TTSErrorCode {
+  NETWORK = 'NETWORK',
+  AUTH = 'AUTH',
+  QUOTA = 'QUOTA',
+  INVALID_VOICE = 'INVALID_VOICE',
+  INVALID_PARAMS = 'INVALID_PARAMS',
+  PLAYER_ERROR = 'PLAYER_ERROR',
+  UNKNOWN = 'UNKNOWN'
+}
+
+class TTSError extends Error {
+  constructor(
+    message: string,
+    code: TTSErrorCode,
+    provider: string,
+    details?: unknown
+  ) {
+    super(message)
+    this.name = 'TTSError'
+    this.code = code
+    this.provider = provider
+    this.details = details
+  }
+  
+  code: TTSErrorCode
+  provider: string
+  details?: unknown
+}
+```
+
+### 音色定义
+
+```typescript
+interface Voice {
+  id: string
+  name: string
+  language?: string  // 'zh-CN' | 'en-US' 等
+  gender?: 'male' | 'female' | 'neutral'
+  previewUrl?: string  // 音色预览 URL
+}
+```
+
+### 能力定义
+
+```typescript
+interface TTSCapabilities {
+  // 基础能力（必有）
+  speak: true
+  
+  // 高级能力
+  voiceClone?: boolean   // 音色克隆支持
+  stream?: boolean       // 流式合成支持
+  voiceList?: boolean    // 音色列表支持
+  
+  // 合成模式支持
+  sync?: boolean         // 同步合成支持
+  async?: boolean        // 异步合成支持
+}
+```
+
+### 合成配置
+
+```typescript
+// 合成模式枚举
+type SynthesisModel = 'sync' | 'async' | 'stream'
+
+// Speak 配置参数
+interface SpeakOptions {
+  voice?: string                    // 音色 ID
+  model?: SynthesisModel           // 合成模式，默认 stream
+  speed?: number                   // 语速 0.5-2.0
+  volume?: number                  // 音量 0-100
+  pitch?: number                   // 音调 0.5-2.0
+  
+  // 音色克隆参数（可选）
+  sourceVoice?: string             // 克隆源音色 URL
+}
+
+interface AudioResult {
+  audioData: Buffer | ReadableStream
+  sampleRate?: number
+  channels?: number
+  duration?: number
+  format: string  // 'mp3' | 'wav' | 'flac'
+  isStream: boolean
+}
+```
+
+### TTSProvider 接口
+
+```typescript
+interface TTSProvider {
+  name: string
+  capabilities: TTSCapabilities
+  
+  // 生命周期
+  initialize(): Promise<void>
+  destroy(): Promise<void>
+  
+  // 核心能力
+  speak(text: string, options?: SpeakOptions): Promise<AudioResult>
+  pause(): Promise<void>
+  resume(): Promise<void>
+  stop(): Promise<void>
+  listVoices(): Promise<Voice[]>
+  
+  // 查询能力
+  getCapabilities(): TTSCapabilities
+}
+```
+
+### Provider 注册机制
+
+```typescript
+// 静态注册
+const providers = new Map<string, TTSProvider>()
+
+export function registerProvider(name: string, provider: TTSProvider): void {
+  providers.set(name, provider)
+}
+
+export function getProvider(name: string): TTSProvider {
+  const provider = providers.get(name)
+  if (!provider) {
+    throw new TTSError(
+      `TTS Provider "${name}" not found`,
+      TTSErrorCode.UNKNOWN,
+      'system'
+    )
+  }
+  return provider
+}
+
+export function listProviders(): string[] {
+  return Array.from(providers.keys())
+}
+
+export function hasProvider(name: string): boolean {
+  return providers.has(name)
+}
+```
+
+---
+
+## 事件系统
+
+```typescript
+// 事件类型
+type TTSEvent = 
+  | 'start'      // 开始播放
+  | 'end'        // 播放结束
+  | 'error'      // 错误发生
+  | 'progress'  // 播放进度（流式场景）
+  | 'pause'      // 暂停
+  | 'resume'     // 恢复
+  | 'stop'       // 停止
+
+// 事件处理器
+interface SpeakerEvents {
+  on(event: 'start', handler: (text: string) => void): void
+  on(event: 'end', handler: (text: string) => void): void
+  on(event: 'error', handler: (error: TTSError) => void): void
+  on(event: 'progress', handler: (progress: { current: number; total: number }) => void): void
+  on(event: 'pause', handler: () => void): void
+  on(event: 'resume', handler: () => void): void
+  on(event: 'stop', handler: () => void): void
+  
+  off(event: TTSEvent, handler: Function): void
+}
+```
+
+---
+
+## OpenCode Plugin 集成
+
+```typescript
+// src/index.ts
+export default {
+  name: 'ocosay',
+  version: '1.0.0',
+  
+  tools: [
+    {
+      name: 'tts_speak',
+      description: '将文本转换为语音并播放',
+      input: {
+        text: { type: 'string', required: true },
+        provider: { type: 'string', default: 'minimax' },
+        voice: { type: 'string', optional: true },
+        model: { type: 'string', enum: ['sync', 'async', 'stream'], default: 'stream' },
+        speed: { type: 'number', optional: true },
+        volume: { type: 'number', optional: true },
+        pitch: { type: 'number', optional: true }
+      }
+    },
+    {
+      name: 'tts_stop',
+      description: '停止当前播放'
+    },
+    {
+      name: 'tts_pause',
+      description: '暂停当前播放'
+    },
+    {
+      name: 'tts_resume',
+      description: '恢复暂停的播放'
+    },
+    {
+      name: 'tts_list_voices',
+      description: '列出可用音色',
+      input: {
+        provider: { type: 'string', default: 'minimax' }
+      }
+    },
+    {
+      name: 'tts_list_providers',
+      description: '列出所有已注册的 TTS 提供商'
+    }
+  ],
+  
+  session: {
+    idle: () => { /* 清理资源 - 调用所有 Provider.destroy() */ }
+  }
+}
+```
+
+---
+
+## MiniMax Provider 实现
+
+### API 能力映射
+
+| MiniMax API | 映射到 ocosay | 说明 |
+|-------------|--------------|------|
+| T2A v2.5 (WebSocket) | `model: 'stream'` | 流式播放 |
+| T2A v3 (同步) | `model: 'sync'` | 同步返回 |
+| T2A v2 (异步) | `model: 'async'` | 异步轮询 |
+| 音色列表 | `listVoices()` | |
+| 音色克隆 | `voiceClone()` (via sourceVoice) | 通过 sourceVoice 参数指定克隆源 |
+
+### 配置项
+
+```typescript
+interface MiniMaxConfig {
+  apiKey: string
+  appId?: string
+  voiceId?: string           // 默认音色
+  model?: SynthesisModel     // 默认合成模式
+  audioFormat?: 'mp3' | 'wav' | 'flac'
+  speed?: number            // 0.5 - 2.0
+  volume?: number           // 0 - 100
+  pitch?: number            // 0.5 - 2.0
+}
+
+function validateConfig(config: MiniMaxConfig): void {
+  if (!config.apiKey) {
+    throw new TTSError('API key is required', TTSErrorCode.AUTH, 'minimax')
+  }
+  if (config.speed !== undefined && (config.speed < 0.5 || config.speed > 2.0)) {
+    throw new TTSError('Speed must be between 0.5 and 2.0', TTSErrorCode.INVALID_PARAMS, 'minimax')
+  }
+  if (config.volume !== undefined && (config.volume < 0 || config.volume > 100)) {
+    throw new TTSError('Volume must be between 0 and 100', TTSErrorCode.INVALID_PARAMS, 'minimax')
+  }
+}
+```
+
+---
+
+## 评审修复记录
+
+| 日期 | 修复内容 | 评审来源 |
+|------|---------|---------|
+| 2026-04-04 | speak() 添加 SpeakOptions 配置参数 | 萍萍 |
+| 2026-04-04 | pause()/stop()/resume() 改为返回 Promise | 凤雏 |
+| 2026-04-04 | 添加 TTSError 类型定义 | 凤雏 |
+| 2026-04-04 | 同步/异步/流式 改为 model 参数可配置 | 老爷确认 |
+| 2026-04-04 | 添加 Speaker 事件系统 | 小猪 |
+| 2026-04-04 | 添加 listProviders() 方法 | 萍萍 |
+| 2026-04-04 | 添加 Provider 生命周期 initialize()/destroy() | 凤雏 |
+
+---
+
+## 技术栈
+
+- **语言**: TypeScript
+- **运行时**: Node.js
+- **音频播放**: node-simplespeaker / node-player / play-sound
+- **HTTP 客户端**: axios
+- **WebSocket**: ws (for MiniMax 流式)
+- **构建**: npm
+
+## 下一步计划
+
+1. 创建项目结构
+2. 实现 types.ts - 核心类型定义
+3. 实现 base.ts - Provider 接口
+4. 实现 config.ts - 配置管理
+5. 实现 MiniMax Provider
+6. 实现 player.ts - 音频播放引擎
+7. 实现 speaker.ts - 统一调用入口
+8. 实现 tools/tts.ts - OpenCode 工具
+9. 实现 index.ts - Plugin 入口
+10. 单元测试
+11. 文档编写

package/__mocks__/@opencode-ai/plugin.ts

@@ -0,0 +1,32 @@
+const schema = {
+  string: () => ({
+    describe: (desc: string) => ({ describe: desc }),
+    optional: () => ({
+      describe: (desc: string) => ({ describe: desc })
+    }),
+    number: () => ({
+      describe: (desc: string) => ({ describe: desc }),
+      optional: () => ({
+        describe: (desc: string) => ({ describe: desc })
+      })
+    }),
+    enum: (values: string[]) => ({
+      describe: (desc: string) => ({ describe: desc }),
+      optional: () => ({
+        describe: (desc: string) => ({ describe: desc })
+      })
+    })
+  })
+}
+
+function tool({ description, args, execute }: any) {
+  return {
+    description,
+    args,
+    execute,
+    schema
+  }
+}
+
+export { tool, schema }
+export const Plugin = jest.fn()

package/dist/config.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Configuration Management
+ * 配置管理模块
+ */
+import { GlobalConfig, ProviderConfig, OcosayConfig } from './core/types';
+declare const DEFAULT_CONFIG: OcosayConfig;
+declare class ConfigManager {
+    private config;
+    private configPath;
+    private providers;
+    constructor(configPath?: string);
+    private loadConfig;
+    saveConfig(): void;
+    getGlobal(): OcosayConfig;
+    getProviderConfig(providerName: string): ProviderConfig | undefined;
+    setProviderConfig(providerName: string, config: ProviderConfig): void;
+    getDefaultProvider(): string;
+    setDefaultProvider(provider: string): void;
+    validateApiKey(provider: string, apiKey: string): void;
+    validateStreamConfig(): void;
+}
+export declare const configManager: ConfigManager;
+export { ConfigManager, DEFAULT_CONFIG };
+export type { OcosayConfig, GlobalConfig, ProviderConfig };
+export default configManager;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAKzE,QAAA,MAAM,cAAc,EAAE,YAarB,CAAA;AAED,cAAM,aAAa;IACjB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,SAAS,CAAqC;gBAE1C,UAAU,CAAC,EAAE,MAAM;IAO/B,OAAO,CAAC,UAAU;IAelB,UAAU,IAAI,IAAI;IAalB,SAAS,IAAI,YAAY;IAIzB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAInE,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IAKrE,kBAAkB,IAAI,MAAM;IAI5B,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK1C,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAUtD,oBAAoB,IAAI,IAAI;CAgB7B;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAA;AAEhD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,CAAA;AACxC,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,CAAA;AAC1D,eAAe,aAAa,CAAA"}

package/dist/config.js

@@ -0,0 +1,95 @@
+/**
+ * Configuration Management
+ * 配置管理模块
+ */
+import { TTSError, TTSErrorCode } from './core/types';
+import fs from 'fs';
+import path from 'path';
+const DEFAULT_CONFIG = {
+    enabled: true,
+    autoPlay: false,
+    autoRead: false, // 豆包模式开关
+    streamMode: true, // 流式朗读模式
+    streamBufferSize: 30, // 缓冲字符数
+    streamBufferTimeout: 2000, // 缓冲区超时(ms)
+    provider: 'minimax',
+    ttsModel: 'speech-02-turbo',
+    baseURL: 'https://api.minimax.io',
+    speed: 1.0,
+    volume: 80,
+    pitch: 1.0
+};
+class ConfigManager {
+    config;
+    configPath;
+    providers = {};
+    constructor(configPath) {
+        this.configPath = configPath || './config.json';
+        const loaded = this.loadConfig();
+        this.config = loaded;
+        this.providers = loaded.providers || {};
+    }
+    loadConfig() {
+        try {
+            if (fs.existsSync(this.configPath)) {
+                const content = fs.readFileSync(this.configPath, 'utf-8');
+                const parsed = JSON.parse(content);
+                this.providers = parsed.providers || {};
+                const { providers, ...config } = parsed;
+                return { ...DEFAULT_CONFIG, ...config };
+            }
+        }
+        catch (error) {
+            console.warn('Failed to load config, using defaults');
+        }
+        return { ...DEFAULT_CONFIG };
+    }
+    saveConfig() {
+        try {
+            const dir = path.dirname(this.configPath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            const configWithProviders = { ...this.config, providers: this.providers };
+            fs.writeFileSync(this.configPath, JSON.stringify(configWithProviders, null, 2));
+        }
+        catch (error) {
+            console.error('Failed to save config:', error);
+        }
+    }
+    getGlobal() {
+        return this.config;
+    }
+    getProviderConfig(providerName) {
+        return this.providers[providerName];
+    }
+    setProviderConfig(providerName, config) {
+        this.providers[providerName] = { enabled: true, ...config };
+        this.saveConfig();
+    }
+    getDefaultProvider() {
+        return this.config.provider || 'minimax';
+    }
+    setDefaultProvider(provider) {
+        this.config.provider = provider;
+        this.saveConfig();
+    }
+    validateApiKey(provider, apiKey) {
+        if (!apiKey) {
+            throw new TTSError(`API key is required for provider "${provider}"`, TTSErrorCode.AUTH, provider);
+        }
+    }
+    validateStreamConfig() {
+        if ((this.config.streamBufferSize ?? 30) < 5) {
+            throw new TTSError('streamBufferSize must be at least 5', TTSErrorCode.INVALID_PARAMS, 'config');
+        }
+        if ((this.config.streamBufferTimeout ?? 2000) < 500) {
+            throw new TTSError('streamBufferTimeout must be at least 500ms', TTSErrorCode.INVALID_PARAMS, 'config');
+        }
+    }
+}
+// 单例导出
+export const configManager = new ConfigManager();
+export { ConfigManager, DEFAULT_CONFIG };
+export default configManager;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/core/backends/afplay-backend.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Afplay Backend - macOS 平台音频播放后端
+ * 使用系统内置的 afplay 命令
+ */
+import { AudioBackend, BackendOptions } from './base';
+/**
+ * AfplayBackend - macOS 原生音频播放后端
+ * 不支持真正的流式播放，需要先将数据写入临时文件
+ */
+export declare class AfplayBackend implements AudioBackend {
+    readonly name = "afplay";
+    readonly supportsStreaming = false;
+    private process?;
+    private tempFile?;
+    private events?;
+    private _started;
+    private _paused;
+    private _stopped;
+    private chunks;
+    private hasEnded;
+    constructor(options?: BackendOptions);
+    start(filePath: string): void;
+    write(chunk: Buffer): void;
+    end(): void;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    setVolume(_volume: number): void;
+    destroy(): void;
+    private cleanup;
+    private handleError;
+}
+//# sourceMappingURL=afplay-backend.d.ts.map

package/dist/core/backends/afplay-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"afplay-backend.d.ts","sourceRoot":"","sources":["../../../src/core/backends/afplay-backend.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAsB,cAAc,EAAE,MAAM,QAAQ,CAAA;AAQzE;;;GAGG;AACH,qBAAa,aAAc,YAAW,YAAY;IAChD,QAAQ,CAAC,IAAI,YAAW;IACxB,QAAQ,CAAC,iBAAiB,SAAQ;IAElC,OAAO,CAAC,OAAO,CAAC,CAAc;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAAQ;IACzB,OAAO,CAAC,MAAM,CAAC,CAAoB;IACnC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAQ;IAExB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAQ;gBAEZ,OAAO,GAAE,cAAmB;IAIxC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAgC7B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM1B,GAAG,IAAI,IAAI;IAaX,KAAK,IAAI,IAAI;IAcb,MAAM,IAAI,IAAI;IAcd,IAAI,IAAI,IAAI;IAsBZ,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhC,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,WAAW;CAGpB"}

package/dist/core/backends/afplay-backend.js

@@ -0,0 +1,144 @@
+/**
+ * Afplay Backend - macOS 平台音频播放后端
+ * 使用系统内置的 afplay 命令
+ */
+import { execFile } from 'child_process';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { writeFileSync, unlinkSync, existsSync } from 'fs';
+// 白名单：只允许特定路径格式（禁止 - 防止命令注入）
+const SAFE_PATH_REGEX = /^[\w\/\.]+$/;
+/**
+ * AfplayBackend - macOS 原生音频播放后端
+ * 不支持真正的流式播放，需要先将数据写入临时文件
+ */
+export class AfplayBackend {
+    name = 'afplay';
+    supportsStreaming = false;
+    process;
+    tempFile;
+    events;
+    _started = false;
+    _paused = false;
+    _stopped = false;
+    // P0-4: 缓冲所有chunk，等end()时一次性写入文件
+    chunks = [];
+    hasEnded = false;
+    constructor(options = {}) {
+        this.events = options.events;
+    }
+    start(filePath) {
+        if (this._started)
+            return;
+        if (!SAFE_PATH_REGEX.test(filePath)) {
+            throw new Error(`Invalid file path: ${filePath}`);
+        }
+        this.tempFile = filePath;
+        this._started = true;
+        this._stopped = false;
+        this.events?.onStart?.();
+        // 启动播放进程
+        this.process = execFile('afplay', [filePath], (error) => {
+            if (this._stopped)
+                return;
+            if (error) {
+                this.handleError(error);
+                return;
+            }
+            // 播放正常结束
+            this._started = false;
+            this.events?.onEnd?.();
+        });
+        this.process.on('error', (error) => {
+            this.handleError(error);
+        });
+    }
+    write(chunk) {
+        if (this._stopped)
+            return;
+        // P0-4: 缓冲所有chunk，等end()时一次性写入
+        this.chunks.push(chunk);
+    }
+    end() {
+        if (this._stopped || this.hasEnded)
+            return;
+        this.hasEnded = true;
+        if (this.chunks.length === 0)
+            return;
+        // P0-4: 所有chunk缓冲完毕后，一次性写入文件并播放
+        this.tempFile = join(tmpdir(), `ocosay-${Date.now()}.wav`);
+        writeFileSync(this.tempFile, Buffer.concat(this.chunks));
+        this.chunks = [];
+        this.start(this.tempFile);
+    }
+    pause() {
+        if (!this._started || this._paused || this._stopped)
+            return;
+        if (this.process) {
+            try {
+                this.process.kill('SIGSTOP');
+                this._paused = true;
+                this.events?.onPause?.();
+            }
+            catch (e) {
+                // SIGSTOP 可能失败
+            }
+        }
+    }
+    resume() {
+        if (!this._paused || this._stopped)
+            return;
+        if (this.process) {
+            try {
+                this.process.kill('SIGCONT');
+                this._paused = false;
+                this.events?.onResume?.();
+            }
+            catch (e) {
+                // SIGCONT 可能失败
+            }
+        }
+    }
+    stop() {
+        this._stopped = true;
+        this._started = false;
+        this._paused = false;
+        if (this.process) {
+            try {
+                this.process.kill('SIGTERM');
+            }
+            catch (e) {
+                // 忽略错误
+            }
+            this.process = undefined;
+        }
+        // 清理临时文件
+        this.cleanup();
+        this.chunks = [];
+        this.hasEnded = false;
+        this.events?.onStop?.();
+    }
+    setVolume(_volume) {
+        // afplay 不支持命令行设置音量
+    }
+    destroy() {
+        this.stop();
+    }
+    cleanup() {
+        if (this.tempFile && this.tempFile.startsWith(tmpdir())) {
+            try {
+                if (existsSync(this.tempFile)) {
+                    unlinkSync(this.tempFile);
+                }
+            }
+            catch (e) {
+                // 忽略清理错误
+            }
+            this.tempFile = undefined;
+        }
+    }
+    handleError(error) {
+        this.events?.onError?.(error);
+    }
+}
+//# sourceMappingURL=afplay-backend.js.map