# 飞书权限配置指南

## 📋 正确的权限配置

在飞书开放平台创建应用后，需要配置以下权限：

### 必选权限

| 权限代码 | 权限名称 | 用途 |
|---------|---------|------|
| `im:message` | 消息 | 发送和接收消息（包含文件消息） |
| `im:resource` | 资源 | 访问消息中的资源（文件、图片等） |

### 可选权限

| 权限代码 | 权限名称 | 用途 |
|---------|---------|------|
| `contact:group:readonly` | 群组信息 | 读取群组信息 |

---

## ⚠️ 常见错误

### ❌ 错误的权限：`im:file`

**问题：** 飞书权限中**没有** `im:file` 这个权限代码！

**正确做法：** 使用 `im:message` + `im:resource` 组合来实现文件上传下载功能。

### 为什么没有 `im:file`？

飞书的权限设计中，文件被视为一种"资源"（resource），而不是独立的权限类型。文件消息通过 `im:message` 接收，文件内容通过 `im:resource` 访问。

---

## 🔧 配置步骤

### 1. 进入权限管理

1. 访问 [飞书开放平台](https://open.feishu.cn/)
2. 进入你的应用管理页面
3. 点击左侧菜单"权限管理"

### 2. 添加权限

点击"添加权限"，搜索并添加：

1. **im:message**
   - 搜索"消息"
   - 勾选"发送消息"和"读取消息"
   - 点击"确定"

2. **im:resource**
   - 搜索"资源"
   - 勾选"访问消息中的资源"
   - 点击"确定"

### 3. 提交审核

部分权限需要管理员审核：
- 点击"申请权限"
- 填写申请理由（例如：用于文件上传功能）
- 提交等待审核（通常很快）

---

## 📝 权限说明

### im:message

**作用：** 允许机器人发送和接收消息

**包含能力：**
- 接收用户发送给机器人的消息
- 接收群组中 @ 机器人的消息
- 向用户发送消息
- 向群组发送消息
- **接收文件消息**（文件作为一种消息类型）

### im:resource

**作用：** 允许机器人访问消息中的资源

**包含能力：**
- 下载消息中的文件
- 下载消息中的图片
- 下载消息中的视频
- 访问其他附件资源

---

## ✅ 验证权限

配置完成后，在应用管理页面的"权限管理"中应该看到：

```
✅ im:message - 已申请
✅ im:resource - 已申请
```

如果显示"审核中"，需要等待管理员审核通过。

---

## 🔗 相关文档

- [飞书开放平台 - 权限管理](https://open.feishu.cn/document/ukTMukTMukTM/uEjNwUjLxYDM14SM2ATN)
- [消息事件订阅](https://open.feishu.cn/document/ukTMukTMukTM/uYjNwUjL2YDM14iN2ATN)
- [资源访问 API](https://open.feishu.cn/document/ukTMukTMukTM/uQjNwUjLyYDM14iN2ATN)

---

**🍙 祝你配置顺利！**