技能概述
feishu-media 是一款面向飞书平台的媒体文件发送技能，通过封装飞书开放平台的消息接口，实现多种媒体类型的自动化投递。该技能定位为办公场景下的文件分发工具，核心价值在于统一了飞书生态内复杂的消息类型处理流程。
核心功能与用法
技能采用单一工具入口 message，通过参数组合覆盖7大类媒体场景：
基础媒体发送：支持本地文件（PDF/Office/文本等）、图片（JPG/PNG/GIF等）、URL图片的直接发送。图片类消息以内嵌形式展示，文档视频类以文件卡片呈现。
语音消息处理：该技能的特色功能。由于飞书语音消息要求严格的 Ogg/Opus 格式，技能内置了 ffmpeg 转换工作流，可自动将 MP3 转为合规格式并提取时长元数据，最终渲染为可播放语音条。
批量打包策略：针对多文件场景或格式限制，提供 zip/tar.gz 两种压缩方案，解决飞书单消息附件数量限制问题。
显著优势
1. 格式兼容性全面：覆盖飞书支持的全部媒体类型，语音场景尤为突出，自动化解决了格式转换痛点
2. 参数设计简洁：单一工具多形态复用，降低调用方的认知成本
3. 技术细节透明：文档明确标注底层 API 调用逻辑（如 im.file.create 和 msg_type: audio），便于开发者二次调试
局限性与约束
- 外部依赖刚性：语音功能强制依赖 ffmpeg/ffprobe，环境缺失将导致功能不可用
- 权限门槛明确：需预申请
im:message、im:resource两项飞书应用权限 - 单文件大小限制：30MB 上限为飞书平台限制，非技能本身问题
- 无智能内容识别：仅作传输通道，不处理文件内容校验或敏感信息检测
适用人群
主要面向飞书机器人开发者、自动化工作流构建者，以及需要将外部系统文件推送至飞书群聊的企业用户。特别适合有语音消息自动化需求的客服、通知类场景。
风险提示
该技能为纯执行型工具，不涉及内容安全审查。用户需自行确保发送内容符合飞书平台规范及企业数据合规要求。URL 图片发送存在外链失效风险，建议优先使用本地文件路径。