1. tip_toast.py

• TTSAudioThread(QThread)：

  • 每次弹窗需 TTS 时，启动一个独立线程负责调用 generate_speech_sync 生成语音并播放，防止主线程阻塞。
  • 通过全局 tts_is_playing 标志防止多线程重复播报，保证音频整洁。
  • TTS 线程支持中途安全退出，避免资源泄露。
  • 支持模板化文本生成，动态填充如课程名、时间等信息。

• 主类tip_toast：

  • 启动弹窗时，判断 TTS 是否启用，是否有有效语音 ID 和播报文本，若满足条件则自动调用 TTS。
  • 支持中止上一个未完成的 TTS 线程，避免弹窗密集时的语音重叠。
  • 优化窗口关闭流程，确保音频/tts 线程能被安全终止。
  • 弹窗类型（上课/下课/预备/放学/通知）均支持单独配置 TTS 文本模板。
  • 日志细致区分各类异常和流程分支，便于追踪。

2. play_audio.py —— 音频播放底层逻辑

• 支持通过 on_audio_played 回调自动清理临时 TTS 文件。
• 对音频文件的有效性进行了更严格的判断（如文件大小、是否缓存），避免空文件或损坏文件导致死循环或卡死。
• 日志输出全部使用相对路径，便于排查。
• 优化了 pygame mixer 的初始化与异常兜底。
• 支持缓存机制，仅对非缓存目录音频缓存，提升多次播放性能。
• 统一了音量读取与设置逻辑，支持配置。

3. config/default_config.json

• 新增 TTS 配置分区，包括：
  • enable：是否启用 TTS（0/1）
  • engine：TTS 引擎（如 edge/pyttsx3）
  • speed：语速
  • voice_id：可选，具体语音库
  • attend_class/finish_class/prepare_class/after_school/otherwise：各类弹窗的自定义播报模板，支持变量填充。

4. view/menu/sound.ui & tts_settings.ui

• sound.ui：

  • 新增 TTS 语音设置按钮，为后续详细配置预留入口。

• tts_settings.ui：

  • TTS 设置界面，自定义引擎、音色、测试

TTS 配置调整

• 在 config/default_config.json 的 "TTS" 分区可手动调整参数：
  • "enable": 1 开启TTS，0为关闭
  • "engine": "edge" 指定TTS引擎（如 edge/pyttsx3，需环境支持）
  • "speed": 50 语速百分比
  • "voice_id": "" 可选，指定具体音色
  • "attend_class": "活动开始, {lesson_name}" 播报模板，变量支持见下表

支持的模板变量

例如："prepare_class": "活动即将开始, 下一节课 {lesson_name}, 提前 {minutes} 分钟"