feishu-rich-card

name	feishu-rich-card
description	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.

Repository note: Stored at repo/Skills/Research_Tools/Reporting/feishu-rich-card with helper scripts in references/. Works best with the neighboring svg-ui-templates skill for high-fidelity graphics.

Feishu Rich Card — 飞书图文混排卡片

在飞书群聊中发送图文并茂的交互式卡片，用于汇报进展、展示分析结果、项目状态等。

When to Use

• 汇报任务进展、项目状态
• 展示数据分析结果（图表 + 解读）
• 发送研究简报、阶段性成果
• 任何需要图文混排的飞书消息

Architecture

生成图片(SVG→PNG / matplotlib / PIL)
        ↓
上传图片到飞书 → 获取 image_key
        ↓
构造 Card JSON (schema 2.0) → 嵌入 img 元素 + markdown 元素
        ↓
调用飞书 API 发送 interactive 消息

Workflow

Step 1: Prepare Images

图片来源可以是：

• SVG UI 模板 → 用 svg-ui-templates skill 生成 SVG → cairosvg 转 PNG
• matplotlib/seaborn → 直接 savefig 为 PNG
• PIL/Pillow → 程序化生成图片
• 已有文件 → 直接使用本地 PNG/JPG

Step 2: Upload & Send

使用 references/send_card.py 中的辅助函数：

# 完整用法参见 references/send_card.py
from send_card import FeishuCardSender

sender = FeishuCardSender()  # 自动读取 openclaw.json 凭证

# 发送图文卡片
sender.send_rich_card(
    chat_id=,
    title=,
    elements=[
        {: , : },
        {: , : , : },
        {: , : },
        {: },
        {: , : , : },
        {: , : },
    ],
    header_template=  
)