核心用法
feishu-img-msg 是面向飞书开放平台的企业级图片消息操作技能,提供完整的图片生命周期管理:
- 上传:本地图片 → 飞书服务器,返回
image_key - 发送:通过
image_key或本地路径向群聊/用户推送图片消息 - 获取:从飞书下载图片到本地存储
- 查看:获取 Base64 编码供 AI 直接分析图片内容
底层基于飞书官方 IM v1 API,封装 im:resource、im:message、im:message:send_as_bot 三大 Scope 的调用逻辑,支持 Python 脚本直接执行或命令行调用。
显著优点
- 官方 API 封装:直接使用飞书开放平台的
image.create、message.create、image.get等标准接口,协议合规、文档完备 - 双模式发送:支持本地文件直发(自动上传+发送)或复用已有
image_key,灵活适配不同场景 - AI 友好:
view命令输出 Base64,便于大模型直接读取图片内容进行分析 - 多账户支持:通过
--account参数可管理多套飞书应用凭证 - Token 自动刷新:内置 tenant_access_token 续期机制,降低运维成本
潜在缺点与局限性
- 格式限制:仅支持 JPEG/PNG/GIF/BMP/WebP,单文件 30MB 上限,超规需预处理
- 权限耦合:需提前配置飞书机器人 Scope 并加入目标群聊,权限管理较繁琐
- 单租户架构:基于 tenant_access_token,暂不支持个人自建应用的多租户隔离
- 无状态设计:本地无缓存机制,频繁调用同一
image_key需重复下载 - 企业专属:仅兼容飞书平台,与钉钉、企业微信等平台不互通
适合人群
- 企业 IT 管理员:批量推送监控图表、报表截图到运维群
- 自动化运维开发者:集成 CI/CD 流程,发送构建结果可视化反馈
- AI Agent 构建者:实现"看图说话"工作流,结合 LLM 分析飞书图片消息
- 飞书生态集成商:快速搭建客服机器人、内容审核等业务场景
常规风险
- Token 泄露风险:tenant_access_token 存储于本地,需确保文件权限
chmod 600 - 数据出境合规:图片上传至飞书服务器,敏感图像需评估数据合规要求
- Rate Limit:高频发送可能触发飞书 API 限流(默认 20 QPS/应用),需设计退避重试
- 图片内容安全:机器人发送的图片同样受飞书内容安全策略审查,违规图片将被拦截