# 飞书接入说明

## 飞书应用权限

建议先申请最小权限：

- 发送消息
- 读取群信息
- 接收消息事件
- 卡片消息

后续再逐步增加：

- 多维表格
- 审批
- 文档/Wiki
- 任务
- 日历

## 配置项

```text
FEISHU_APP_ID=
FEISHU_APP_SECRET=
FEISHU_VERIFICATION_TOKEN=
FEISHU_DEFAULT_CHAT_ID=
```

## 推送文本

```text
POST /api/v1/integrations/feishu/send-text
```

```json
{
  "receive_id": "oc_xxx",
  "receive_id_type": "chat_id",
  "text": "项目日报测试"
}
```

## 推送卡片

```text
POST /api/v1/integrations/feishu/send-card
```

## Webhook

```text
POST /api/v1/integrations/feishu/webhook
```

当前 Webhook 已支持 challenge 验证和事件审计。后续可在这里接入：

- 飞书群聊问答
- 审批回调
- 卡片按钮回调
- 任务状态同步

## 消息命令

Webhook 已支持基础命令路由：

```text
日报 / 晨报 -> 每日经营晨报
周报 / 项目周报 -> 项目周报
风险 / 预警 -> 风险摘要
问 xxx / AI xxx -> AI 问答
```

本地预览：

```text
POST /api/v1/integrations/feishu/commands/preview
```

```json
{
  "text": "日报",
  "auto_reply": false
}
```