docs: 修正飞书权限说明
- 移除不准确的权限代码(im:resource) - 使用实际导出的权限:im:message, im:message:readonly, aily:file:read, aily:file:write
This commit is contained in:
@@ -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`,因为文件是上传到七牛云,不是飞书云空间)
|
||||
|
||||
---
|
||||
|
||||
|
||||
17
README.md
17
README.md
@@ -16,25 +16,16 @@
|
||||
|
||||
### 2. 配置权限
|
||||
|
||||
在"权限管理"中添加以下权限(根据飞书开放平台实际权限代码):
|
||||
|
||||
**方式一:标准权限(推荐)**
|
||||
|
||||
| 权限 | 说明 |
|
||||
|------|------|
|
||||
| `im:message` | 发送和接收消息 |
|
||||
| `im:resource` | 访问消息中的资源(文件、图片等) |
|
||||
|
||||
**方式二:批量导出权限(如果显示以下权限)**
|
||||
在"权限管理"中添加以下权限:
|
||||
|
||||
```json
|
||||
{
|
||||
"scopes": {
|
||||
"tenant": [
|
||||
"im:message",
|
||||
"im:message:readonly",
|
||||
"aily:file:read",
|
||||
"aily:file:write",
|
||||
"im:message"
|
||||
"aily:file:write"
|
||||
],
|
||||
"user": [
|
||||
"aily:file:read",
|
||||
@@ -51,8 +42,6 @@
|
||||
| `aily:file:read` | 读取文件 |
|
||||
| `aily:file:write` | 写入文件 |
|
||||
|
||||
> **💡 提示:** 不同飞书版本可能显示不同的权限代码,以上两种都可以使用。
|
||||
|
||||
详细权限配置请查看 [`FEISHU_PERMISSIONS.md`](./FEISHU_PERMISSIONS.md)
|
||||
|
||||
### 3. 配置事件订阅
|
||||
|
||||
Reference in New Issue
Block a user