触发: 用户在飞书中 @AionBot 或私聊发送消息
过程: 飞书机器人接收消息 → 转发给 Aion Agent → LLM 处理
结果: 处理完成后通过飞书消息卡片推送结果给用户

┌─────────────────────────────────────────────────────────────┐
│ Step 1: 创建应用                                            │
│   飞书开放平台 → 创建企业自建应用 → 获取 App ID/Secret      │
├─────────────────────────────────────────────────────────────┤
│ Step 2: 开启机器人能力                                      │
│   应用能力 → 机器人 → 开启                                  │
├─────────────────────────────────────────────────────────────┤
│ Step 3: 配置权限                                            │
│   权限管理 → 添加以下权限:                                  │
│   • im:message (获取与发送单聊、群组消息)                   │
│   • im:message.group_at_msg (接收群聊@机器人消息)           │
│   • im:chat (获取群组信息)                                  │
│   • contact:user.id:readonly (获取用户 ID)                  │
├─────────────────────────────────────────────────────────────┤
│ Step 4: 发布应用                                            │
│   版本管理与发布 → 创建版本 → 申请发布                      │
├─────────────────────────────────────────────────────────────┤
│ Step 5: 配置 AionUi                                         │
│   设置 → Channels → 飞书 → 粘贴 App ID/Secret → 启动       │
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│ ① 用户在飞书中发起                                         │
│    用户 → @AionBot: 任意消息                               │
├─────────────────────────────────────────────────────────────┤
│ ② Bot 返回配对请求（消息卡片）                              │
│    ┌────────────────────────────────────────┐              │
│    │ 👋 欢迎使用 Aion 助手！                │              │
│    │                                        │              │
│    │ 🔑 配对码: ABC123                      │              │
│    │ 请在 AionUi 中批准此配对               │              │
│    │                                        │              │
│    │ [📖 使用指南]  [🔄 刷新状态]           │              │
│    └────────────────────────────────────────┘              │
├─────────────────────────────────────────────────────────────┤
│ ③ AionUi 显示待批准请求                                    │
│    设置页面展示: 用户名、配对码、请求时间、[批准]/[拒绝]   │
├─────────────────────────────────────────────────────────────┤
│ ④ 用户在 AionUi 点击 [批准]                                │
├─────────────────────────────────────────────────────────────┤
│ ⑤ Bot 推送配对成功消息                                     │
│    Bot → 用户: "✅ 配对成功！现在可以开始对话了"           │
└─────────────────────────────────────────────────────────────┘

{
  "config": {
    "wide_screen_mode": true
  },
  "header": {
    "title": {
      "tag": "plain_text",
      "content": "Aion 助手"
    }
  },
  "elements": [
    {
      "tag": "markdown",
      "content": "消息内容..."
    },
    {
      "tag": "action",
      "actions": [
        {
          "tag": "button",
          "text": { "tag": "plain_text", "content": "🆕 新对话" },
          "type": "primary",
          "value": { "action": "session.new" }
        }
      ]
    }
  ]
}

┌─────────────────────────────────────────────────────────────┐
│                    消息卡片 (Message Card)                   │
├─────────────────────────────────────────────────────────────┤
│  ✅ 配对成功！现在可以开始对话了                            │
│                                                             │
│  ┌─────────────────────────────────────────────────────┐   │
│  │ [🆕 新对话]  [🔄 Agent]  [📊 状态]  [❓ 帮助]       │   │
│  └─────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│                    消息卡片 (Message Card)                   │
├─────────────────────────────────────────────────────────────┤
│  这是一个快速排序的实现：                                   │
│                                                             │
│  ```python                                                  │
│  def quicksort(arr):                                        │
│      if len(arr) <= 1:                                      │
│          return arr                                         │
│      ...                                                    │
│  ```                                                        │
│                                                             │
│  ┌─────────────────────────────────────────────────────┐   │
│  │ [📋 复制]  [🔄 重新生成]  [💬 继续]                  │   │
│  └─────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────┐
│                    消息卡片 (Message Card)                   │
├─────────────────────────────────────────────────────────────┤
│  🔄 切换 Agent                                              │
│                                                             │
│  选择一个 AI Agent：                                        │
│  当前: 🤖 Gemini                                            │
│                                                             │
│  ┌─────────────────────────────────────────────────────┐   │
│  │ [✓ 🤖 Gemini]  [🧠 Claude]  [⚡ Codex]              │   │
│  └─────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘

src/channels/
├── plugins/
│   ├── telegram/              # 现有 Telegram 插件
│   │   ├── TelegramPlugin.ts
│   │   ├── TelegramAdapter.ts
│   │   ├── TelegramKeyboards.ts
│   │   └── index.ts
│   │
│   └── lark/                  # 新增飞书插件
│       ├── LarkPlugin.ts      # 飞书插件主类
│       ├── LarkAdapter.ts     # 消息格式转换
│       ├── LarkCards.ts       # 消息卡片模板
│       └── index.ts
│
├── types.ts                   # 需要新增 'lark' 到 PluginType
└── ...

class LarkPlugin extends BasePlugin {
  // 生命周期
  async initialize(config: LarkPluginConfig): Promise<void>;
  async start(): Promise<void>;
  async stop(): Promise<void>;

  // 消息处理
  async sendMessage(chatId: string, message: IUnifiedOutgoingMessage): Promise<string>;
  async editMessage(chatId: string, messageId: string, message: IUnifiedOutgoingMessage): Promise<void>;

  // 事件处理
  private handleMessageEvent(event: LarkMessageEvent): void;
  private handleCardAction(action: LarkCardAction): void;

  // Token 管理
  private async refreshAccessToken(): Promise<void>;
}

interface LarkPluginConfig {
  appId: string;
  appSecret: string;
  mode: 'websocket' | 'webhook';
  webhookUrl?: string;
  encryptKey?: string; // 事件加密密钥
  verificationToken?: string; // 事件验证令牌
}