添加飞书权限配置文档

FEISHU_SCOPES.md

@@ -0,0 +1,109 @@
+# 飞书应用权限配置
+
+## 权限配置
+
+请在飞书开放平台配置以下权限：
+
+```json
+{
+  "scopes": {
+    "tenant": [
+      "im:chat",
+      "aily:file:read",
+      "aily:file:write",
+      "cardkit:card:read",
+      "cardkit:card:write",
+      "cardkit:template:read",
+      "corehr:file:download",
+      "event:ip_list",
+      "im:app_feed_card:write",
+      "im:chat.access_event.bot_p2p_chat:read",
+      "im:message",
+      "im:message.p2p_msg:readonly",
+      "im:message:readonly",
+      "im:resource"
+    ],
+    "user": [
+      "aily:file:read",
+      "aily:file:write",
+      "im:chat.access_event.bot_p2p_chat:read",
+      "im:message.p2p_msg:get_as_user"
+    ]
+  }
+}
+```
+
+## 配置步骤
+
+### 1. 打开飞书开放平台
+
+访问：https://open.feishu.cn/app/cli_a92ce47b02381bcc/auth
+
+### 2. 添加权限
+
+#### 租户权限（tenant）
+在"权限管理"页面，搜索并添加以下权限：
+
+| 权限代码 | 说明 |
+|---------|------|
+| `im:chat` | 发送消息 |
+| `aily:file:read` | 读取文件 |
+| `aily:file:write` | 写入文件 |
+| `cardkit:card:read` | 读取卡片 |
+| `cardkit:card:write` | 写入卡片 |
+| `cardkit:template:read` | 读取卡片模板 |
+| `corehr:file:download` | 下载文件 |
+| `event:ip_list` | 查看 IP 列表 |
+| `im:app_feed_card:write` | 发送应用消息卡片 |
+| `im:chat.access_event.bot_p2p_chat:read` | 读取机器人私聊事件 |
+| `im:message` | 发送消息 |
+| `im:message.p2p_msg:readonly` | 读取私聊消息 |
+| `im:message:readonly` | 读取消息 |
+| `im:resource` | 访问消息中的资源（文件） |
+
+#### 用户权限（user）
+在"用户权限"页面，搜索并添加以下权限：
+
+| 权限代码 | 说明 |
+|---------|------|
+| `aily:file:read` | 读取文件 |
+| `aily:file:write` | 写入文件 |
+| `im:chat.access_event.bot_p2p_chat:read` | 读取机器人私聊事件 |
+| `im:message.p2p_msg:get_as_user` | 以用户身份获取私聊消息 |
+
+### 3. 提交审核
+
+部分权限需要管理员审核：
+1. 点击"申请权限"
+2. 填写申请理由（例如：用于七牛云文件上传功能）
+3. 提交等待审核（通常很快）
+
+### 4. 发布版本
+
+权限配置完成后：
+1. 点击"版本管理"
+2. 点击"发布"
+3. 确认发布
+
+---
+
+## 权限说明
+
+### 核心权限
+- `im:message` + `im:message:readonly` - 发送和接收消息
+- `im:resource` - **关键权限**：下载用户上传的文件
+- `im:message.p2p_msg:readonly` - 读取私聊消息
+
+### 卡片权限
+- `cardkit:*` - 发送交互式卡片
+
+### 文件权限
+- `aily:file:read` + `aily:file:write` - 文件读写
+
+---
+
+## 验证权限
+
+配置完成后，在飞书开放平台的"权限管理"页面应该看到所有权限状态为"已申请"或"已授权"。
+
+如有问题，请查看：https://open.feishu.cn/document/ukTMukTMukTM/uEjNwUjLxYDM14SM2ATN