@mingxy/ocosay 1.0.0

package/dist/tools/tts.js

@@ -0,0 +1,232 @@
+/**
+ * OpenCode TTS 工具定义
+ * 用于 OpenCode Plugin 注册
+ */
+import { speak, stop, pause, resume, listVoices, getDefaultSpeaker } from '../core/speaker';
+import { TTSError, TTSErrorCode } from '../core/types';
+import { isStreamEnabled, isAutoReadEnabled, getStreamStatus, getStreamReader, getStreamingSynthesizer, getStreamPlayer } from '../index';
+/**
+ * OpenCode TTS 工具定义
+ * 用于 OpenCode Plugin 注册
+ */
+export const ttsTools = [
+    {
+        name: 'tts_speak',
+        description: '将文本转换为语音并播放',
+        input: {
+            type: 'object',
+            properties: {
+                text: {
+                    type: 'string',
+                    description: '要转换的文本内容'
+                },
+                provider: {
+                    type: 'string',
+                    description: 'TTS 提供商名称',
+                    default: 'minimax'
+                },
+                voice: {
+                    type: 'string',
+                    description: '音色 ID'
+                },
+                model: {
+                    type: 'string',
+                    enum: ['sync', 'async', 'stream'],
+                    description: '合成模式',
+                    default: 'stream'
+                },
+                speed: {
+                    type: 'number',
+                    description: '语速 0.5-2.0'
+                },
+                volume: {
+                    type: 'number',
+                    description: '音量 0-100'
+                },
+                pitch: {
+                    type: 'number',
+                    description: '音调 0.5-2.0'
+                }
+            },
+            required: ['text']
+        }
+    },
+    {
+        name: 'tts_stop',
+        description: '停止当前 TTS 播放'
+    },
+    {
+        name: 'tts_pause',
+        description: '暂停当前 TTS 播放'
+    },
+    {
+        name: 'tts_resume',
+        description: '恢复暂停的 TTS 播放'
+    },
+    {
+        name: 'tts_list_voices',
+        description: '列出可用的音色',
+        input: {
+            type: 'object',
+            properties: {
+                provider: {
+                    type: 'string',
+                    description: 'TTS 提供商名称',
+                    default: 'minimax'
+                }
+            }
+        }
+    },
+    {
+        name: 'tts_list_providers',
+        description: '列出所有已注册的 TTS 提供商'
+    },
+    {
+        name: 'tts_status',
+        description: '获取当前 TTS 播放状态',
+        output: {
+            type: 'object',
+            properties: {
+                isPlaying: { type: 'boolean' },
+                isPaused: { type: 'boolean' }
+            }
+        }
+    },
+    {
+        name: 'tts_stream_speak',
+        description: '启动流式朗读（豆包模式），订阅AI回复并边生成边朗读',
+        input: {
+            type: 'object',
+            properties: {
+                text: {
+                    type: 'string',
+                    description: '初始文本（可选）'
+                },
+                voice: {
+                    type: 'string',
+                    description: '音色ID'
+                },
+                model: {
+                    type: 'string',
+                    enum: ['sync', 'async', 'stream'],
+                    default: 'stream'
+                }
+            }
+        }
+    },
+    {
+        name: 'tts_stream_stop',
+        description: '停止当前流式朗读'
+    },
+    {
+        name: 'tts_stream_status',
+        description: '获取当前流式朗读状态',
+        output: {
+            type: 'object',
+            properties: {
+                isActive: { type: 'boolean' },
+                bytesWritten: { type: 'number' },
+                state: { type: 'string' }
+            }
+        }
+    }
+];
+/**
+ * 工具执行处理器
+ */
+export async function handleToolCall(toolName, args) {
+    try {
+        switch (toolName) {
+            case 'tts_speak':
+                await speak(args?.text, {
+                    provider: args?.provider,
+                    voice: args?.voice,
+                    model: args?.model,
+                    speed: args?.speed,
+                    volume: args?.volume,
+                    pitch: args?.pitch
+                });
+                return { success: true, message: 'Speech completed' };
+            case 'tts_stop':
+                await stop();
+                return { success: true, message: 'Stopped' };
+            case 'tts_pause':
+                pause();
+                return { success: true, message: 'Paused' };
+            case 'tts_resume':
+                resume();
+                return { success: true, message: 'Resumed' };
+            case 'tts_list_voices':
+                const voices = await listVoices(args?.provider);
+                return { success: true, voices };
+            case 'tts_list_providers':
+                const speaker = getDefaultSpeaker();
+                const providers = speaker.getProviders();
+                return { success: true, providers };
+            case 'tts_status':
+                const s = getDefaultSpeaker();
+                return {
+                    success: true,
+                    isPlaying: s.isPlaying(),
+                    isPaused: s.isPausedState()
+                };
+            case 'tts_stream_speak':
+                if (!isAutoReadEnabled()) {
+                    throw new TTSError('Stream mode is not enabled. autoRead must be enabled in configuration to use tts_stream_speak.', TTSErrorCode.UNKNOWN, 'tts_stream');
+                }
+                if (!isStreamEnabled()) {
+                    throw new TTSError('Stream components not initialized. Please initialize with autoRead enabled.', TTSErrorCode.UNKNOWN, 'tts_stream');
+                }
+                const streamReader = getStreamReader();
+                const synthesizer = getStreamingSynthesizer();
+                if (streamReader && synthesizer) {
+                    streamReader.start();
+                    if (args?.text) {
+                        synthesizer.synthesize(args.text);
+                    }
+                    return { success: true, message: 'Stream speak started' };
+                }
+                throw new TTSError('Stream components not available', TTSErrorCode.UNKNOWN, 'tts_stream');
+            case 'tts_stream_stop':
+                if (!isStreamEnabled()) {
+                    throw new TTSError('Stream mode is not enabled. Please enable autoRead in configuration.', TTSErrorCode.UNKNOWN, 'tts_stream');
+                }
+                const player = getStreamPlayer();
+                if (player) {
+                    player.stop();
+                    return { success: true, message: 'Stream stopped' };
+                }
+                throw new TTSError('Stream player not available', TTSErrorCode.UNKNOWN, 'tts_stream');
+            case 'tts_stream_status':
+                if (!isStreamEnabled()) {
+                    return {
+                        success: true,
+                        isActive: false,
+                        bytesWritten: 0,
+                        state: 'not_initialized'
+                    };
+                }
+                return {
+                    success: true,
+                    ...getStreamStatus()
+                };
+            default:
+                throw new TTSError(`Unknown tool: ${toolName}`, TTSErrorCode.UNKNOWN, 'tools');
+        }
+    }
+    catch (error) {
+        if (error instanceof TTSError) {
+            return {
+                success: false,
+                error: error.message,
+                code: error.code,
+                provider: error.provider
+            };
+        }
+        return {
+            success: false,
+            error: String(error)
+        };
+    }
+}
+//# sourceMappingURL=tts.js.map

package/dist/tools/tts.js.map

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

package/jest.config.js

@@ -0,0 +1,15 @@
+export default {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/tests', '<rootDir>/src'],
+  testMatch: ['**/*.test.ts'],
+  moduleFileExtensions: ['ts', 'js', 'json'],
+  collectCoverageFrom: ['src/**/*.ts'],
+  coverageDirectory: 'coverage',
+  transform: {
+    '^.+\\.tsx?$': ['ts-jest', { 
+      useESM: true
+    }]
+  },
+  extensionsToTreatAsEsm: ['.ts']
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@mingxy/ocosay",
+  "version": "1.0.0",
+  "description": "OpenCode TTS 播放插件 - 支持豆包模式边接收边朗读",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./plugin": {
+      "import": "./dist/plugin.js",
+      "types": "./dist/plugin.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "test": "jest",
+    "lint": "eslint src --ext .ts"
+  },
+  "keywords": [
+    "tts",
+    "text-to-speech",
+    "opencode",
+    "plugin"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.3.15",
+    "axios": "^1.6.0",
+    "ws": "^8.14.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.5.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/config.ts

@@ -0,0 +1,121 @@
+/**
+ * Configuration Management
+ * 配置管理模块
+ */
+
+import { GlobalConfig, ProviderConfig, OcosayConfig } from './core/types'
+import { TTSError, TTSErrorCode } from './core/types'
+import fs from 'fs'
+import path from 'path'
+
+const DEFAULT_CONFIG: OcosayConfig = {
+  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 {
+  private config: OcosayConfig
+  private configPath: string
+  private providers: Record<string, ProviderConfig> = {}
+
+  constructor(configPath?: string) {
+    this.configPath = configPath || './config.json'
+    const loaded = this.loadConfig()
+    this.config = loaded
+    this.providers = (loaded as Record<string, unknown>).providers as Record<string, ProviderConfig> || {}
+  }
+
+  private loadConfig(): OcosayConfig {
+    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(): void {
+    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(): OcosayConfig {
+    return this.config
+  }
+
+  getProviderConfig(providerName: string): ProviderConfig | undefined {
+    return this.providers[providerName]
+  }
+
+  setProviderConfig(providerName: string, config: ProviderConfig): void {
+    this.providers[providerName] = { enabled: true, ...config }
+    this.saveConfig()
+  }
+
+  getDefaultProvider(): string {
+    return this.config.provider || 'minimax'
+  }
+
+  setDefaultProvider(provider: string): void {
+    this.config.provider = provider
+    this.saveConfig()
+  }
+
+  validateApiKey(provider: string, apiKey: string): void {
+    if (!apiKey) {
+      throw new TTSError(
+        `API key is required for provider "${provider}"`,
+        TTSErrorCode.AUTH,
+        provider
+      )
+    }
+  }
+
+  validateStreamConfig(): void {
+    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 type { OcosayConfig, GlobalConfig, ProviderConfig }
+export default configManager

package/src/core/backends/afplay-backend.ts

@@ -0,0 +1,162 @@
+/**
+ * Afplay Backend - macOS 平台音频播放后端
+ * 使用系统内置的 afplay 命令
+ */
+
+import { execFile, ChildProcess } from 'child_process'
+import { AudioBackend, AudioBackendEvents, BackendOptions } from './base'
+import { tmpdir } from 'os'
+import { join } from 'path'
+import { writeFileSync, unlinkSync, existsSync } from 'fs'
+
+// 白名单：只允许特定路径格式（禁止 - 防止命令注入）
+const SAFE_PATH_REGEX = /^[\w\/\.]+$/
+
+/**
+ * AfplayBackend - macOS 原生音频播放后端
+ * 不支持真正的流式播放，需要先将数据写入临时文件
+ */
+export class AfplayBackend implements AudioBackend {
+  readonly name = 'afplay'
+  readonly supportsStreaming = false
+  
+  private process?: ChildProcess
+  private tempFile?: string
+  private events?: AudioBackendEvents
+  private _started = false
+  private _paused = false
+  private _stopped = false
+  // P0-4: 缓冲所有chunk，等end()时一次性写入文件
+  private chunks: Buffer[] = []
+  private hasEnded = false
+  
+  constructor(options: BackendOptions = {}) {
+    this.events = options.events
+  }
+  
+  start(filePath: string): void {
+    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: Buffer): void {
+    if (this._stopped) return
+    // P0-4: 缓冲所有chunk，等end()时一次性写入
+    this.chunks.push(chunk)
+  }
+  
+  end(): void {
+    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(): void {
+    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(): void {
+    if (!this._paused || this._stopped) return
+    
+    if (this.process) {
+      try {
+        this.process.kill('SIGCONT')
+        this._paused = false
+        this.events?.onResume?.()
+      } catch (e) {
+        // SIGCONT 可能失败
+      }
+    }
+  }
+  
+  stop(): void {
+    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: number): void {
+    // afplay 不支持命令行设置音量
+  }
+  
+  destroy(): void {
+    this.stop()
+  }
+  
+  private cleanup(): void {
+    if (this.tempFile && this.tempFile.startsWith(tmpdir())) {
+      try {
+        if (existsSync(this.tempFile)) {
+          unlinkSync(this.tempFile)
+        }
+      } catch (e) {
+        // 忽略清理错误
+      }
+      this.tempFile = undefined
+    }
+  }
+  
+  private handleError(error: Error): void {
+    this.events?.onError?.(error)
+  }
+}