diff --git a/FEISHU_PERMISSIONS.md b/FEISHU_PERMISSIONS.md index ddcd6d7..3412d39 100644 --- a/FEISHU_PERMISSIONS.md +++ b/FEISHU_PERMISSIONS.md @@ -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`,因为文件是上传到七牛云,不是飞书云空间) --- diff --git a/README.md b/README.md index c2b5bd1..2410623 100644 --- a/README.md +++ b/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. 配置事件订阅