Feishu Card

飞书互动卡片发送技能(国际版 Feishu 兼容)。当需要发送格式丰富的飞书卡片消息时使用。支持标题、Markdown 内容、颜色主题。关键:必须使用 schema 2.0 格式 + 双重 JSON stringify,否则国际版飞书(Feishu)无法渲染。

安装

概览

什么是Feishu Card

飞书互动卡片发送技能是一项专为国际版飞书(Feishu)设计的消息推送能力,旨在帮助用户通过结构化、富文本格式的消息提升沟通效率与视觉表现力。该技能的核心在于支持使用 schema 2.0 标准的卡片格式发送交互式消息,兼容飞书客户端多个版本(包括中文与英文界面),并确保跨平台渲染一致性。与传统文本消息不同,飞书卡片允许开发者自定义标题、颜色主题以及丰富的 Markdown 内容布局,从而在通知、提醒或信息展示场景中提供更直观的用户体验。值得注意的是,该技能强调必须采用双重 JSON stringify 的方式处理 `content` 字段,即先序列化卡片对象为字符串,再将该字符串二次序列化为 JSON 字符串,否则飞书 API 将无法正确解析内容,导致发送失败或显示异常。这一机制是成功调用飞书消息接口的关键前提,也是区别于其他聊天机器人平台的重要技术细节。

核心功能特点

  1. 支持飞书 schema 2.0 标准卡片格式,兼容中英文版本及飞书 7.x 客户端
  2. 可自定义卡片标题、颜色主题(蓝/绿/红/橙/紫/灰)和 Markdown 内容排版
  3. 必须使用双重 JSON.stringify 处理 content 字段,确保 API 正确解析
  4. 支持发送含加粗、斜体、代码块、链接等富文本元素的 Markdown 内容
  5. 提供脚本、message tool 和 curl 三种调用方式,适配不同开发场景

适用场景

飞书互动卡片适用于多种需要结构化信息展示的沟通场景。在企业内部系统中,当用户触发告警事件(如服务器宕机、数据库异常)时,可通过红色主题卡片快速传递关键状态信息,配合 Markdown 描述故障详情与处理建议,使运维团队能立即响应。在自动化工作流中,例如 CI/CD 流水线构建完成后,系统可自动发送绿色卡片通知开发团队:标题标明‘构建成功’,正文列出测试覆盖率、部署地址等摘要信息,提升反馈效率。此外,对外服务通知也极为适用——比如订单状态变更、预约确认等场景,使用蓝色或紫色卡片呈现客户姓名、时间、地点等结构化数据,既美观又便于阅读。由于飞书卡片支持交互元素(如按钮跳转),还可用于引导用户完成后续操作,如‘确认收货’或‘查看发票’,进一步增强消息实用性。无论是内部协作还是客户服务,飞书互动卡片都能显著提升信息传达的专业性与用户体验。