核心用法
audio-play 是一个轻量级音频播放技能，通过 Python 脚本调用 Windows 本地媒体播放器实现非阻塞音频播放。用户需提供音频文件的绝对路径，可选通过 JSON 配置文件指定播放器类型（如 VLC）及其可执行文件路径。
显著优点
- 非阻塞执行：播放音频不会阻塞主流程，适合需要并行操作的工作流（如边听边做字幕翻译）
- 灵活配置：支持自定义播放器路径，兼容 VLC、Windows Media Player 等多种播放器
- 跨平台桥接：通过 WSL 调用 Windows Python 环境，实现 Linux 工作流与 Windows 媒体生态的整合
- 结构化输出：返回包含播放时长、使用播放器等信息的 JSON，便于下游流程处理
- 工作流就绪：与
youtube-audio-download、doubao-capture等技能形成完整 YouTube 翻译流水线
潜在缺点与局限性
- Windows 依赖：必须运行于 Windows 环境或 WSL 跨平台调用，纯 Linux/Mac 环境无法直接使用
- GUI 可见性要求：Windows 桌面自动化需要保持可见状态，RDP 断连会导致失败
- 路径硬编码风险：播放器路径需绝对路径配置，迁移环境时需手动更新
- 无音量/进度控制：基础版本未暴露播放器控制接口，无法程序化调节音量或跳转进度
- 错误信息较简略：失败时仅返回
error_code和error_message，缺乏细粒度诊断
适合人群
- 构建 YouTube/视频翻译自动化工作流的技术用户
- 需要在 WSL/Linux 主环境中集成 Windows 媒体能力的开发者
- 追求"下载-播放-翻译-捕获"全链条自动化的效率工作者
常规风险
- 路径注入风险：若
audio_path来源不可信，可能存在命令注入或文件遍历风险 - 播放器劫持：自定义
player_path若指向恶意可执行文件，可能导致代码执行 - 资源泄漏：非阻塞模式下若播放器异常退出，可能出现僵尸进程
- 隐私泄露：音频文件路径可能暴露用户本地目录结构