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:message` | 发送消息 |
| `im:resource` | 资源 | 访问消息中的资源(文件、图片等) | | `im:message:readonly` | 读取消息 |
| `aily:file:read` | 读取文件 |
| `aily:file:write` | 写入文件 |
### 可选权限 ### 权限配置示例
| 权限代码 | 权限名称 | 用途 | ```json
|---------|---------|------| {
| `contact:group:readonly` | 群组信息 | 读取群组信息 | "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` - 接收飞书消息需要 `im:message` + `im:message:readonly`
- 下载用户上传的文件需要 `aily:file:read`
飞书的权限设计中,文件被视为一种"资源"resource而不是独立的权限类型。文件消息通过 `im:message` 接收,文件内容通过 `im:resource` 访问。 - (本应用不需要 `aily:file:write`,因为文件是上传到七牛云,不是飞书云空间)
--- ---

View File

@@ -16,25 +16,16 @@
### 2. 配置权限 ### 2. 配置权限
在"权限管理"中添加以下权限(根据飞书开放平台实际权限代码) 在"权限管理"中添加以下权限:
**方式一:标准权限(推荐)**
| 权限 | 说明 |
|------|------|
| `im:message` | 发送和接收消息 |
| `im:resource` | 访问消息中的资源(文件、图片等) |
**方式二:批量导出权限(如果显示以下权限)**
```json ```json
{ {
"scopes": { "scopes": {
"tenant": [ "tenant": [
"im:message",
"im:message:readonly", "im:message:readonly",
"aily:file:read", "aily:file:read",
"aily:file:write", "aily:file:write"
"im:message"
], ],
"user": [ "user": [
"aily:file:read", "aily:file:read",
@@ -51,8 +42,6 @@
| `aily:file:read` | 读取文件 | | `aily:file:read` | 读取文件 |
| `aily:file:write` | 写入文件 | | `aily:file:write` | 写入文件 |
> **💡 提示:** 不同飞书版本可能显示不同的权限代码,以上两种都可以使用。
详细权限配置请查看 [`FEISHU_PERMISSIONS.md`](./FEISHU_PERMISSIONS.md) 详细权限配置请查看 [`FEISHU_PERMISSIONS.md`](./FEISHU_PERMISSIONS.md)
### 3. 配置事件订阅 ### 3. 配置事件订阅