核心用法
飞书语音消息发送技能是一套完整的文本转语音并推送至飞书的自动化工作流。用户仅需提供目标文本，系统即自动完成 TTS 生成（依赖 coze-tts）、语速调整（0.5-2.0x）、格式转换（MP3 → opus）、时长读取、飞书服务器上传及消息发送六大步骤。
使用方式极为简洁：
bash scripts/send_voice.sh "语音内容" [voice_id] [语速] [接收者]
显著优点
1. 全流程自动化：从文本输入到消息送达零人工干预，脚本内部已封装错误处理与临时文件清理
2. 格式精准适配：严格遵循飞书语音规范（opus/24k/24kHz/单声道），规避因格式不符导致的播放失败
3. 灵活参数控制：支持 4 种音色切换与连续语速调节，满足多样化播报需求
4. 多应用架构：通过 _B 后缀变量支持双应用并行，便于跨部门或隔离环境部署
5. 企业级集成：基于飞书开放平台的官方 API，消息送达稳定可追踪
潜在局限
- 外部依赖较重：需同时维护 Coze API 密钥与飞书应用凭据，任一服务异常将导致链路中断
- Linux/macOS 限定：依赖 ffmpeg、ffprobe、jq 等二进制工具，Windows 需额外配置环境
- 无内置重试机制：网络抖动或 API 限流时可能单次失败，需外围调度器兜底
- TTS 长度受限：受 Coze 平台单次文本长度限制，超长内容需手动分段
适合人群
- 企业运维/行政团队：自动化日报、告警、会议提醒等播报场景
- 智能客服开发者：快速构建语音触达能力，降低人工坐席压力
- DevOps 工程师：集成至 CI/CD 流水线，实现构建结果的语音通知
常规风险
- 密钥泄露风险：FEISHU_APP_SECRET 与 COZE_API_KEY 以环境变量形式存在，共享环境或日志打印可能导致泄露，建议配合密钥管理服务使用
- API 额度消耗：Coze TTS 与飞书消息接口均存在调用频次或额度上限，高并发场景需评估成本
- 权限过度授予：飞书应用需
im:message与im:message:send_as_bot权限，应遵循最小权限原则定期审计 - 音频内容合规：自动生成的语音内容若涉及敏感信息，需前置文本审核机制