Files

饭团 2bc5c7e0be docs: 添加 Nginx 部署指南和飞书权限说明

新增:
- NGINX.md: Nginx 反向代理部署指南（含 HTTPS 配置）
- FEISHU_PERMISSIONS.md: 飞书权限配置指南

修正:
- README.md: 更正飞书权限（im:file → im:message + im:resource）
- 添加文档链接

2026-03-05 14:48:36 +08:00

2.6 KiB

Raw Blame History

飞书权限配置指南

📋 正确的权限配置

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

必选权限

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

可选权限

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

⚠️ 常见错误

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

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

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

为什么没有 `im:file`？

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

🔧 配置步骤

1. 进入权限管理

访问飞书开放平台
进入你的应用管理页面
点击左侧菜单"权限管理"

2. 添加权限

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

im:message
- 搜索"消息"
- 勾选"发送消息"和"读取消息"
- 点击"确定"
im:resource
- 搜索"资源"
- 勾选"访问消息中的资源"
- 点击"确定"

3. 提交审核

部分权限需要管理员审核：

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

📝 权限说明

im:message

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

包含能力：

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

im:resource

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

包含能力：

下载消息中的文件
下载消息中的图片
下载消息中的视频
访问其他附件资源

✅ 验证权限

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

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

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

🔗 相关文档

🍙 祝你配置顺利！

2.6 KiB Raw Blame History Unescape Escape