Send rich interactive cards with embedded images in Feishu group chats. Use when reporting progress, sharing analysis results, or presenting any content that benefits from mixed text+image layout in Feishu. Combines SVG UI templates (or matplotlib/PIL charts) with Feishu Card Kit API.
在飞书群聊中发送图文并茂的交互式卡片,用于汇报进展、展示分析结果、项目状态等。
生成图片(SVG→PNG / matplotlib / PIL)
↓
上传图片到飞书 → 获取 image_key
↓
构造 Card JSON (schema 2.0) → 嵌入 img 元素 + markdown 元素
↓
调用飞书 API 发送 interactive 消息
图片来源可以是:
svg-ui-templates skill 生成 SVG → cairosvg 转 PNG使用 references/send_card.py 中的辅助函数:
# 完整用法参见 references/send_card.py
from send_card import FeishuCardSender
sender = FeishuCardSender() # 自动读取 openclaw.json 凭证
# 发送图文卡片
sender.send_rich_card(
chat_id="oc_xxx",
title="📊 分析报告",
elements=[
{"type": "markdown", "content": "## 结果摘要\n\n发现 **3 个**显著差异基因"},
{"type": "image", "path": "/tmp/volcano_plot.png", "alt": "火山图"},
{"type": "markdown", "content": "> Gene X: FC=2.5, p<0.001"},
{"type": "hr"},
{"type": "image", "path": "/tmp/heatmap.png", "alt": "热图"},
{"type": "markdown", "content": "**结论:** 样本间差异显著,建议进一步验证。"},
],
header_template="blue" # blue/indigo/green/red/purple/violet/wathet/turquoise/yellow/grey
)
sender.send_image_report(
chat_id="oc_xxx",
title="🧬 单细胞分析完成",
intro="UMAP 降维完成,共识别 12 个细胞群:",
image_path="/tmp/umap.png",
conclusion="Cluster 5 为目标细胞群,marker: CD8A, GZMB, PRF1",
header_template="indigo"
)
| Element | Tag | 说明 |
|---|---|---|
| Markdown | markdown | 支持加粗、斜体、链接、列表、引用块、代码块 |
| Image | img | 需要 image_key(上传后获取) |
| Divider | hr | 水平分割线 |
| Column Set | column_set | 多列并排布局 |
| Note | note | 底部灰色备注 |
blue wathet turquoise green yellow orange red carmine violet purple indigo grey
image_key,不能用 URL"2.0"img 元素NO_REPLY 避免当需要专业级可视化时,结合 svg-ui-templates skill:
# 1. 生成 SVG(用模板或自定义)
# 2. 转 PNG
python3 -c "import cairosvg; cairosvg.svg2png(url='report.svg', write_to='report.png', output_width=2400)"
# 3. 用本 skill 上传并发送卡片
通过环境变量配置:FEISHU_DEFAULT_CHAT_ID(在 .env 中设置)