Feishu Send File Skill

发送任意本地文件到飞书，自动处理大文件和特殊格式。

功能

• 自动检测文件类型（视频、音频、其他）
• 视频/音频：保持原质量，按 20MB 分段
• 其他文件：压缩为 ZIP，如仍超限则分段 ZIP
• 支持任意文件类型

用法

/sendfiles-to-feishu <文件路径> <接收者ID> [ID类型]

参数：

• 文件路径：本地文件（绝对或相对路径）
• 接收者ID：open_id (ou_xxx) 或 union_id (on_xxx)
• ID类型：可选，open_id 或 union_id（默认自动识别）

示例：

/sendfiles-to-feishu "C:\data\report.pdf" "ou_05eb1e0dcc31159ab77432d1d9adf7a3"
/sendfiles-to-feishu "video.mp4" "on_0144493a63e92550a0602e2b632ff597" "union_id"

处理逻辑

文件类型	处理方式
视频（含音频流）	按时间切分，每段 < 20MB，不重新编码
视频（无音频）	先合并音频（如有分离的音频文件），再切分
纯音频	按时间切分
其他（文档、图片、压缩包等）	压缩为 ZIP，如仍 > 20MB 则分段 ZIP

权限要求

飞书应用需：

• im:message.p2p_msg 或 im:message.group_msg
• drive:file:upload
• 机器人能力已开启

配置

环境变量：

• FEISHU_APP_ID
• FEISHU_APP_SECRET

依赖

• Python 3.8+
• requests
• ffmpeg

注意事项

• 视频分割使用 ffmpeg -c copy，无画质损失
• 音频视频分离检测可能不准确，如果遇到问题请手动合并
• ZIP 分割是将同一文件重复打包，接收后需解压并合并（但通常单文件压缩后不会超限）
• 发送前确保与接收者已有会话（在飞书中互发过消息）

故障排除

• 发送失败：检查权限和 token
• 文件过大：自动分段，如果某段仍超限（罕见），手动调整 MAX_FILE_SIZE_MB 常量
• 音视频分离未合并：确保同目录下有匹配的音频/视频文件（同名）