===========================================
ATOM-DELIVERY-013 - 本地播放语音（V2.0）
===========================================

【这个动作是干啥的】
自动查找并播放最新的 TTS 语音文件，锁屏时不播放。

【什么时候用】
- TTS 语音生成后自动播放
- 飞书发送语音后本地同步播放
- 用户想听最新语音

【核心变化 V2.0】
- ✅ 查找路径：Temp/tts-*/voice-*.mp3 → workspace/tts/voice-*.mp3
- ✅ 统一归档：所有 TTS 文件在同一个文件夹
- ✅ 智能播放：锁屏时跳过，活跃时自动播放

【操作步骤】
1. 在 workspace/tts/文件夹查找最新 MP3
2. 按 LastWriteTime 降序排序，取第一个
3. 检测锁屏状态（LockApp 进程）
4. 锁屏时：跳过播放（记录日志）
5. 活跃时：Start-Process 播放
6. 记录播放日志

【举个例子】
场景：优先级提醒飞书发送完成
    ↓
调用：ATOM-DELIVERY-013
    ↓
处理：
  - 查找：workspace/tts/voice-*.mp3
  - 找到：voice-1772864000000.mp3（最新）
  - 检测：屏幕未锁定
  - 播放：Start-Process
    ↓
输出：本地播放语音（0 步操作）

【对应阿福的 MD 文件】
atomic-actions/03-delivery/ATOM-DELIVERY-013-本地播放语音.md

【关联动作】
- ATOM-VISUAL-008：生成 TTS 语音（前置）
- ATOM-DELIVERY-011：飞书发送语音（前置）
- 组合使用：生成 TTS → 飞书发送 → 本地播放

【常见错误】
❌ 错误：找不到文件
✅ 正确：检查 workspace/tts/文件夹是否有 voice-*.mp3

❌ 错误：锁屏时播放（浪费）
✅ 正确：检测 LockApp 进程，锁屏时跳过

❌ 错误：系统静音
✅ 正确：检查系统音量设置

【核心原则】
> 锁屏时不播放（浪费资源），活跃时 0 步自动播放！

【播放条件】
- ✅ 屏幕未锁定
- ✅ 有空闲时间（<300 秒）
- ✅ 系统音量未静音
- ❌ 锁屏时：跳过播放

【日志记录】
- 路径：Temp\voice-playback-log.txt
- 内容：播放时间、文件名、跳过原因
- 用途：调试和审计

【V2.0 升级点】
1. 查找路径统一（workspace/tts/）
2. 不再在 Temp 各个子目录查找
3. 查找速度更快（单一目录）
4. 已移动 27 个历史文件到新位置

===========================================
创建时间：2026-03-07
最后更新：2026-03-07 15:18
版本：V2.0（存储位置升级）
===========================================
