Lark Card Sender

# Feishu Card Sender Skill

飞书卡片消息发送技能包 - 专业级interactive卡片发送解决方案

## 🎯 功能概述

本技能包提供完整的飞书interactive卡片发送能力，绕过OpenClaw内置限制，直接调用飞书OpenAPI实现专业级卡片消息发送。

## ✨ 核心特性

- **完整API支持**: 直接调用飞书OpenAPI，支持所有卡片类型
- **Schema 2.0标准**: 严格遵循飞书interactive卡片规范
- **多种卡片模板**: 新闻简报、机票特价、任务管理、基础信息等
- **智能错误处理**: 完整的异常捕获和错误码处理机制
- **大小自动验证**: 30KB限制自动检测，避免发送失败
- **Token自动管理**: tenant_access_token自动获取和缓存
- **群组/单聊支持**: 同时支持群组和一对一私人消息

## 🛠️ 核心工具

### 1. 高级卡片发送器 (`feishu_card_sender_advanced.py`)
```python
from feishu_card_sender_advanced import AdvancedFeishuCardSender

sender = AdvancedFeishuCardSender(app_id, app_secret)
result = sender.send_simple_card(
    receive_id="ou_xxx",
    receive_id_type="open_id", 
    title="🎯 测试卡片",
    content="**精彩内容**展示"
)
```

### 2. 基础发送器 (`direct_feishu_card_sender.py`)
```python
from direct_feishu_card_sender import FeishuCardSender

sender = FeishuCardSender(app_id, app_secret)
card = sender.build_interactive_card("标题", "内容")
result = sender.send_interactive_card("ou_xxx", "open_id", card)
```

### 3. 卡片模板库 (`feishu_card_templates.py`)
```python
from feishu_card_templates import (
    build_news_card,
    build_flight_deal_card,
    build_task_management_card
)

# 新闻简报卡片
news_card = build_news_card([
    {"category": "国际新闻", "title": "重大事件", "source": "路透社", "time": "2024-02-28 15:30"}
])

# 机票特价卡片
flight_card = build_flight_deal_card({
    "route": "上海 → 东京",
    "price": 899,
    "original_price": 2500,
    "date": "2024-03-15",
    "discount": "3.6折"
})
```

## 📋 支持的卡片类型

### 📰 新闻简报卡片
- 多段落布局
- 时间线展示
- 来源标注
- 分隔线组织

### ✈️ 机票特价卡片
- 双列字段布局
- 价格对比显示
- 折扣信息突出
- 预订按钮集成

### 📊 任务管理卡片
- 进度状态指示
- 多字段信息展示
- 优先级...

# 🎯 飞书卡片发送器 (Feishu Card Sender)

专业级飞书interactive卡片发送解决方案，绕过OpenClaw限制，直接调用飞书OpenAPI。

## ✨ 核心特性

- **🔧 完整API支持**: 直接调用飞书OpenAPI，支持所有卡片类型
- **📋 Schema 2.0标准**: 严格遵循飞书interactive卡片规范
- **🎨 丰富模板库**: 新闻简报、机票特价、任务管理等多种预设模板
- **⚡ 智能错误处理**: 完整的异常捕获和错误码处理机制
- **📊 大小自动验证**: 30KB限制自动检测，避免发送失败
- **🔑 Token自动管理**: tenant_access_token自动获取和缓存
- **👥 群组/单聊支持**: 同时支持群组和一对一私人消息

## 🚀 快速开始

### 1. 安装
```bash
# 克隆或下载技能包
cd skills/feishu-card-sender

# 运行安装脚本
./scripts/install.sh

# 设置环境变量
export FEISHU_APP_ID="your_app_id"
export FEISHU_APP_SECRET="your_app_secret"
```

### 2. 基础使用
```python
# 导入发送器
from feishu_card_sender_advanced import AdvancedFeishuCardSender

# 初始化发送器
sender = AdvancedFeishuCardSender()

# 发送简单卡片
result = sender.send_simple_card(
    receive_id="ou_xxx",  # 用户open_id
    receive_id_type="open_id",
    title="🎉 欢迎使用",
    content="**飞书卡片**发送成功！"
)

print(f"消息ID: {result['message_id']}")
```

### 3. 高级功能
```python
# 发送新闻简报
news_items = [
    {"category": "🌍 国际新闻", "title": "重大科技突破", "source": "路透社", "time": "2小时前"},
    {"category": "💰 财经动态", "title": "市场分析", "source": "财经网", "time": "1小时前"}
]

result = sender.send_news_card(
    receive_id="oc_xxx",  # 群组chat_id
    receive_id_type="chat_id",
    news_items=news_items
)

# 发送机票特价信息
flight_info = {
    "route": "上海浦东 ✈️ 东京成田",
    "price": 899,
    "original_price": 2500,
    "date": "2024年3月15日",
    "discount": "3.6折 💰",
    "valid_until": "3月1日 23:59",
    "book_advance": "建议提前30天",
    "refund_policy": "免费改期一次",
    "booking_url": "https://example.com/book"
}

result = sender.send_flight_deal_card(
    receive_id="ou_xxx",
    receive_id_type="open_id",
    flight_info=flight_info
)
```

## 📋 支持...