核心用法
feishu-card-sender-beautify 是一款面向飞书生态的富文本卡片消息推送工具,通过调用 feishu_im_user_message API 实现 Interactive Card 格式的消息发送。核心功能包括:
- 多场景触发:支持用户主动调用、定时任务推送及格式化通知需求
- 模板化设计:内置 7 种颜色主题(blue/red/green/yellow/wathet/orange/grey),支持宽屏模式与结构化布局
- 灵活路由:通过
receive_id_type参数区分群聊(chat_id)与私聊(open_id),ID 格式严格遵循oc_xxx/ou_xxx规范
典型调用示例
feishu_im_user_message(
action="send",
msg_type="interactive",
receive_id="oc_群聊ID",
receive_id_type="chat_id",
content=json.dumps(card)
)显著优点
1. 视觉层级清晰:卡片式布局替代纯文本,关键信息高亮,支持 Markdown 渲染
2. 企业级集成:原生适配飞书 IM 架构,无需额外中间件
3. 低代码门槛:JSON 配置即可完成复杂排版,开发成本极低
4. 多端一致性:卡片在移动端与桌面端保持统一呈现效果
潜在局限
- 平台锁定:完全依赖飞书生态,无法迁移至其他 IM 平台
- 功能边界:不支持交互式组件(如按钮回调需额外开发)
- ID 管理成本:群聊/用户 ID 需人工维护,大规模场景下易出错
- 频率限制:受飞书开放平台 API 频次限制,高频推送可能触发限流
适合人群
- 企业内部运维/运营团队需发送格式化通知
- 开发者构建飞书机器人应用
- 需要替代传统「@所有人」纯文本公告的场景
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据泄露 | `receive_id` 若配置错误可能导致消息误发至非目标群组 |
| 频次超限 | 未做发送队列控制时可能触发平台限流 |
| 模板注入 | 若 `content` 内容来自用户输入,需防范 JSON 注入攻击 |
总结评估
该 Skill 作为飞书官方能力的封装层,在富文本通知场景下具备实用价值,但功能相对基础,适合作为企业自动化工作流的「最后一公里」消息触达组件,复杂交互需求需结合飞书官方 SDK 二次开发。