飞书机器人消息推送

┌─────────────────────────────────────────────────────────────┐
│  BotPanel (React)                                           │
│  ┌───────────────────┐     ┌──────────────────────────────┐ │
│  │ Webhook 模式       │     │ API 模式                      │ │
│  │ 用户贴 Webhook URL │     │ 自动拉群列表 / 手动输入 ID    │ │
│  └────────┬──────────┘     └──────────┬───────────────────┘ │
│           │     useFeishuBot hook     │                      │
│           └───────────┬───────────────┘                      │
│                       │ supabase.functions.invoke             │
│                       │ (feishu-contacts)                     │
└───────────────────────┼─────────────────────────────────────┘
                        ▼
┌─────────────────────────────────────────────────────────────┐
│  Edge Function: feishu-contacts                              │
│                                                              │
│  ┌─ Webhook 通道 ────────────────────────────────────────┐  │
│  │ action: send_webhook                                   │  │
│  │ → POST https://open.feishu.cn/open-apis/bot/v2/hook/   │  │
│  │   {webhook_token}                                      │  │
│  │ → 不需要 token，URL 本身即鉴权                          │  │
│  └────────────────────────────────────────────────────────┘  │
│                                                              │
│  ┌─ API 通道 ────────────────────────────────────────────┐  │
│  │ ① APP_ID + APP_SECRET → tenant_access_token            │  │
│  │ ② action: list_chats → GET /im/v1/chats               │  │
│  │ ③ action: send_message → POST /im/v1/messages          │  │
│  └────────────────────────────────────────────────────────┘  │
└──────────────────────────────────────────────────────────────┘

用户在 BotPanel 选择「Webhook」模式
    │
    ▼
粘贴 Webhook URL
（格式: https://open.feishu.cn/open-apis/bot/v2/hook/{token}）
    │
    ▼
选择消息类型 → 编辑消息内容
    │
    ▼
调用 supabase.functions.invoke("feishu-contacts", {
  body: { action: "send_webhook", webhook_url, msg_type, content }
})
    │
    ▼
Edge Function 构造 payload:
  ├─ text/post: { msg_type, content: {...} }
  └─ interactive: { msg_type: "interactive", card: {...} }
    │
    ▼
POST 到 webhook_url → 飞书群收到消息

用户在 BotPanel 选择「API 发送」模式
    │
    ▼
面板自动调用 list_chats action
→ Edge Function 获取 tenant_access_token
→ GET /im/v1/chats?page_size=50
→ 返回机器人所在群列表
    │
    ▼
用户选择目标群（或手动输入 receive_id）
    │
    ▼
选择消息类型 → 编辑消息内容
    │
    ▼
调用 supabase.functions.invoke("feishu-contacts", {
  body: { action: "send_message", receive_id, receive_id_type, msg_type, content }
})
    │
    ▼
Edge Function:
  ① 获取 tenant_access_token
  ② content 做 JSON.stringify（飞书 API 要求 content 是 JSON 字符串）
  ③ POST /im/v1/messages?receive_id_type={type}
    │
    ▼
飞书群 / 个人收到消息

// Edge Function — send_webhook action
// 关键点：interactive 类型用 card 字段，其他用 content 字段
const payload = msgType === "interactive"
  ? { msg_type: msgType, card: content }     // 卡片消息用 card 字段
  : { msg_type: msgType, content: content };  // 其他消息用 content 字段

const response = await fetch(webhookUrl, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(payload),
});
const result = await response.json();
// 成功: { StatusCode: 0, StatusMessage: "success" }
// 失败: { StatusCode: 9499, StatusMessage: "invalid hook" }

// Edge Function — list_chats action
const response = await fetch(
  `https://open.feishu.cn/open-apis/im/v1/chats?page_size=50`,
  {
    headers: {
      Authorization: `Bearer ${accessToken}`,
      "Content-Type": "application/json",
    },
  }
);
const result = await response.json();
// result.data.items: [{ chat_id: "oc_xxx", name: "群名", owner_id: "ou_xxx", ... }]
// result.data.has_more: boolean
// result.data.page_token: string（用于翻页）

// Edge Function — send_message action
// ⚠️ 关键：content 必须是 JSON 字符串！
const contentString = typeof content === "string" ? content : JSON.stringify(content);

const response = await fetch(
  `https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=${receiveIdType}`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${accessToken}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      receive_id: receiveId,
      msg_type: msgType,
      content: contentString,  // 必须是 JSON 字符串
    }),
  }
);
const result = await response.json();
// 成功: { code: 0, data: { message_id: "om_xxx", ... } }

{
  "zh_cn": {
    "title": "项目更新",
    "content": [
      [
        { "tag": "text", "text": "项目状态：" },
        { "tag": "text", "text": "已完成", "style": ["bold"] }
      ],
      [
        { "tag": "a", "text": "查看详情", "href": "https://example.com" }
      ]
    ]
  }
}

const {
  // 发送模式
  sendMode,           // "webhook" | "api"
  setSendMode,        // 切换模式

  // 群列表（API 模式）
  chats,              // ChatItem[] - 机器人所在群列表
  chatStatus,         // "idle" | "loading" | "ready" | "error"
  chatError,          // string | null
  fetchChats,         // () => Promise<void> - 手动拉取群列表

  // 发送状态
  sendStatus,         // "idle" | "sending" | "success" | "error"
  sendError,          // string | null
  sendHistory,        // SendRecord[] - 发送历史记录

  // 发送方法
  sendWebhookMessage, // (url: string, msgType: string, content: object) => Promise<void>
  sendApiMessage,     // (receiveId: string, receiveIdType: string, msgType: string, content: string | object) => Promise<void>
  clearSendStatus,    // () => void - 清空发送状态
} = useFeishuBot();

interface ChatItem {
  chat_id: string;        // 群唯一标识
  name: string;           // 群名称
  avatar: string;         // 群头像 URL
  owner_id: string;       // 群主 open_id
  chat_mode: string;      // "group" 群组 | "p2p" 单聊
  external: boolean;      // 是否外部群
}

interface SendRecord {
  id: string;             // 记录 UUID
  mode: "webhook" | "api";
  target: string;         // Webhook URL 或 receive_id
  msgType: string;        // text | post | interactive
  status: "success" | "error";
  message: string;        // 结果描述
  timestamp: Date;
}

┌─ Header ────────────────────────────────────────────────────────┐
│ 飞书机器人消息                                    [连接状态徽标]  │
├─ Mode Tabs ─────────────────┬───────────────────────────────────┤
│ [Webhook] [API 发送]         │                                   │
├─ Target Area ───────────────┤  发送历史                          │
│ Webhook: URL input          │  ┌──────────────────────────────┐  │
│ API: 群列表 + 手动输入       │  │ ✅ 14:32 文本 → 技术群       │  │
├─ MsgType Tabs ──────────────┤  │ ❌ 14:28 卡片 → webhook      │  │
│ [文本] [富文本] [交互卡片]   │  │ ✅ 14:25 文本 → 张三         │  │
├─ Content Editor ────────────┤  │ ...                          │  │
│ textarea / JSON editor      │  └──────────────────────────────┘  │
├─ Send Bar ──────────────────┤                                   │
│ [发送消息]                   │                                   │
└──────────────────────────────┴───────────────────────────────────┘

[
  { "scope": "im:message:send_as_bot", "name": "以应用身份发送消息", "type": "tenant" },
  { "scope": "im:chat:readonly", "name": "获取机器人所在群列表", "type": "tenant" }
]

{
  "scopes": {
    "tenant": ["im:message:send_as_bot", "im:chat:readonly"],
    "user": []
  }
}