核心用法
feishu-audio 是一个专注于飞书生态的语音消息推送技能，其核心功能是将本地音频文件（如 MP3、WAV 等）自动转码为飞书要求的 opus 格式，并通过飞书开放平台 API 发送为可播放的语音消息。该技能采用 Shell 脚本实现，主要包含 send_audio.sh 脚本，支持两种使用模式：直接发送已有音频文件，或结合 TTS 工具（如 edge-tts）先合成语音再推送。使用时需配置飞书应用凭证（FEISHU_APP_ID、FEISHU_APP_SECRET）及接收者 Open ID，脚本会自动完成格式转换、文件上传和消息发送的全流程。
显著优点
1. 格式兼容性优：自动调用 ffmpeg 完成音频转码，严格遵循飞书语音消息的技术规范（opus 格式、24000Hz 采样率、单声道），无需用户手动处理复杂的格式转换。
2. 集成门槛低：仅依赖系统级工具（ffmpeg、curl、jq），无额外的第三方依赖包，部署轻量，适合快速集成到现有工作流。
3. 场景覆盖全：既支持直接发送预录制音频，也支持与 TTS 工具链配合实现"文字→语音→飞书消息"的完整闭环，满足朗读、播报、通知等多样化需求。
4. 行为透明可控：代码结构清晰，功能与声明完全一致，无隐藏操作或越权行为，仅调用飞书官方 API，数据传输全程 HTTPS 加密。
潜在缺点与局限性
1. 环境依赖刚性：必须预先安装 ffmpeg，且需手动配置飞书开放平台应用并获取凭证，对非技术用户存在一定门槛。
2. 平台绑定性强：功能完全依赖飞书生态，无法迁移至企业微信、钉钉等其他 IM 平台，灵活性受限。
3. 无高级音频处理：仅提供基础转码功能，不支持音量调节、降噪、分段裁剪等音频编辑能力，复杂场景需前置处理。
4. 开源透明度不足：开发者仅发布于 ClawHub 平台，无 GitHub 开源仓库，社区审查和持续维护的可视性较弱。
适合的目标群体
- 企业运维/开发者：需要在飞书群内实现自动化语音告警、定时播报通知的技术团队。
- 内容运营人员：希望通过 TTS 生成语音内容并推送到飞书，用于每日晨报、知识分享等场景。
- 教育/培训机构：将课程音频或讲解语音批量推送至学员飞书账号，替代传统文件发送方式。
- 个人效率爱好者：搭建私有化工作流，实现"文字输入→语音合成→飞书收听"的个人助理场景。
使用风险
1. 数据跨境传输：音频文件需上传至飞书服务器（位于中国境内），涉及数据出境合规考量，敏感内容需谨慎评估。
2. 凭证泄露风险：飞书应用密钥通过环境变量传入，若配置不当（如硬编码、日志泄露）可能导致未授权访问。
3. 外部服务依赖：功能强依赖飞书开放平台的 API 可用性，若平台限流、接口变更或网络故障将直接影响服务连续性。
4. 输入验证有限：脚本对音频文件路径的检查较基础，建议生产环境增加路径规范化处理，防范符号链接攻击等边缘风险。
5. 运维可观测性：当前错误处理机制较简单，生产环境建议补充日志采集、重试机制和监控告警，提升稳定性。