free-feishu-voice 是一个轻量级命令行工具，专为开发者设计，用于通过飞书开放平台 API 将文本自动转换为语音并发送到指定的飞书聊天群组或个人。该工具支持两种主流 TTS（文本转语音）引擎：系统内置的 espeak-ng 和微软 Edge TTS，后者能提供更高音质和更丰富的音色选择。整个流程无需手动干预，只需配置一次凭证，即可快速发送语音消息，非常适合需要自动化通知、定时提醒或远程交互的场景。工具的核心优势在于完全去除了硬编码配置，所有敏感信息如 APP ID、APP Secret 和 Chat ID 均通过配置文件或环境变量管理，既保障了安全性，又提升了灵活性。此外，脚本在首次运行时还会自动生成标准配置模板，大幅降低了初次使用的门槛。
核心功能特点
- 支持通过配置文件和环境变量管理飞书 API 凭证，彻底移除代码中的硬编码信息
- 提供基础版（espeak-ng）与增强版（Edge TTS）两种语音生成方案，后者音质更优且支持多音色切换
- 自动检测依赖项（jq、ffmpeg、python3、edge_tts），缺失时提示安装或自动补装
- 智能配置加载机制：环境变量 > 配置文件 > 默认值，支持多场景灵活切换
- 完善的错误处理与日志输出，每一步操作均有明确成功/失败反馈及原因说明
- 安全清理临时文件，避免因异常中断导致磁盘残留
适用场景
free-feishu-voice 特别适合需要远程状态通知或无人值守场景下的自动化沟通需求。例如，运维人员可在服务器监控到异常时，自动调用此脚本向值班群发送告警语音，实现‘听得见’的即时响应；开发者在部署 CI/CD 流水线完成后，也可通过发送语音消息告知团队构建结果，提升协作效率。对于远程办公团队而言，该工具还能用于每日站会签到提醒、会议纪要播报等高频沟通任务，让信息传递更具人性化温度。由于其完全基于命令行运行，天然适配 Linux/macOS 服务器环境，无需图形界面即可长期稳定工作。同时，结合 crontab 定时任务，用户可轻松实现每天固定时间播报天气、日程提醒等功能，形成个性化的智能助理体系。无论是个人项目还是企业级应用集成，该工具都能以极简方式打通飞书生态，释放自动化潜力。