docs: 修正飞书权限说明

- 移除不准确的权限代码(im:resource)
- 使用实际导出的权限:im:message, im:message:readonly, aily:file:read, aily:file:write
This commit is contained in:
饭团
2026-03-05 15:43:40 +08:00
parent ff3ce48207
commit 8e1462a6db
2 changed files with 36 additions and 29 deletions

View File

@@ -6,30 +6,48 @@
### 必选权限
| 权限代码 | 权限名称 | 用途 |
|---------|---------|------|
| `im:message` | 消息 | 发送和接收消息(包含文件消息) |
| `im:resource` | 资源 | 访问消息中的资源(文件、图片等) |
| 权限代码 | 说明 |
|---------|------|
| `im:message` | 发送消息 |
| `im:message:readonly` | 读取消息 |
| `aily:file:read` | 读取文件 |
| `aily:file:write` | 写入文件 |
### 可选权限
### 权限配置示例
| 权限代码 | 权限名称 | 用途 |
|---------|---------|------|
| `contact:group:readonly` | 群组信息 | 读取群组信息 |
```json
{
"scopes": {
"tenant": [
"im:message",
"im:message:readonly",
"aily:file:read",
"aily:file:write"
],
"user": [
"aily:file:read",
"aily:file:write"
]
}
}
```
---
## ⚠️ 常见错误
## ⚠️ 注意事项
### ❌ 错误的权限:`im:file`
### 权限说明
**问题:** 飞书权限中**没有** `im:file` 这个权限代码!
- **`im:message`** - 允许机器人发送消息到聊天
- **`im:message:readonly`** - 允许机器人读取接收到的消息
- **`aily:file:read`** - 允许机器人读取和下载文件
- **`aily:file:write`** - 允许机器人上传文件
**正确做法:** 使用 `im:message` + `im:resource` 组合来实现文件上传下载功能。
### 为什么需要这些权限?
### 为什么没有 `im:file`
飞书的权限设计中,文件被视为一种"资源"resource而不是独立的权限类型。文件消息通过 `im:message` 接收,文件内容通过 `im:resource` 访问。
- 接收飞书消息需要 `im:message` + `im:message:readonly`
- 下载用户上传的文件需要 `aily:file:read`
- (本应用不需要 `aily:file:write`,因为文件是上传到七牛云,不是飞书云空间)
---