refactor: 完成 0.4.0 版本更新

完成 0.4.0 版本更新, 为了消除此前提交消息风格不一致与错误提交超大文件的问题, 维持代码统计数据的准确性和提交消息风格的一致性, 重新初始化仓库; 旧的提交历史在 HeurAMS-legacy 仓库(https://gitea.imwangzhiyu.xyz/ajax/HeurAMS-legacy)

src/heurams/providers/audio/playsound_audio.py

@@ -0,0 +1,21 @@
+"""通用音频适配器
+基于 playsound 库的音频播放器, 在绝大多数 python 环境上提供音频服务
+注意: 在未配置 pulseaudio 的 termux 不可用
+"""
+
+import os
+import pathlib
+import playsound
+from heurams.services.logger import get_logger
+
+logger = get_logger(__name__)
+
+
+def play_by_path(path: pathlib.Path):
+    logger.debug("playsound_audio.play_by_path: 开始播放 %s", path)
+    try:
+        playsound.playsound(str(path))
+        logger.debug("播放完成: %s", path)
+    except Exception as e:
+        logger.error("播放失败: %s, 错误: %s", path, e)
+        raise