一、使用入口
1. 登录 企业控制台，在左侧菜单栏中选择腾讯乐享知识库。
2. 进入知识管理 > 连接器菜单。
3. 单击飞书连接器，在弹出的表单中按以下说明填写：
| 字段 | 说明 | 是否必填 |
| App ID | “创建飞书自建应用”章节中获取的 App ID（格式为 cli_xxx） | 必填 |
| App Secret | “创建飞书自建应用”章节中获取的 32 位密钥 | 必填 |
注意：安全说明：
二、开始之前
完成飞书自建应用的配置后，乐享即可通过 OAuth 2.0 在用户授权后访问其飞书云文档。
·前置要求：
你需为飞书企业管理员，或可协调企业管理员配合审批。
·整体流程：
创建应用 > 配置基础信息 > 申请自建应用权限 > 配置 redirect_uri > 添加网页应用能力 > 创建并发布版本 > 管理员审批 > 把 App ID/Secret 填入乐享连接器配置 > 重启服务 > 可用
三、进入开放平台
打开飞书开放平台 ，使用企业管理员飞书账号登录。
四、创建应用
1. 单击右上角创建应用 > 自建应用。
2. 填写以下信息：
·应用名称：乐享导入助手（建议包含“乐享”前缀，便于审批识别）。
·应用描述：将飞书云文档/知识库内容批量导入到腾讯乐享知识库。
·应用图标：上传乐享 logo（可选，默认 256×256）。
3. 单击创建。
创建成功后，系统将生成 App ID 和 App Secret，可在“凭证与基础信息”页面查看。请记录这两个值，后续需填入乐享飞书连接器配置中。
示例（请替换为实际值）：
App ID：cli_xxxxxxxxxxxxxxxx
App Secret：xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
五、进入权限管理
在应用详情页左侧菜单中选择权限管理 > API 权限。
六、切到“用户身份权限”标签
此步骤为关键操作。飞书权限分为两种类型：
| 权限类型 | 凭证 | 适用场景 |
| 应用身份权限 | tenant_access_token | 应用以“机器人”身份调用 |
| 用户身份权限 | user_access_token | OAuth 模式，应用代表用户身份调用 |
当前导入逻辑通过 OAuth 获取 user_access_token，因此必须在“用户身份权限”标签下申请权限。
七、逐个搜索并申请以下 11 个 scope
单击开通权限，在搜索框中粘贴权限标识进行搜索（中文搜索易混淆，请使用标识符精确搜索）：
| 序号 | 权限标识 | 中文名 | 用途 |
| 1 | offline_access | 离线访问 | 拿 refresh_token 续期，必须 |
| 2 | drive:drive:readonly | 查看云空间所有文件 | 列出文件 |
| 3 | drive:file:readonly | 查看和下载云空间中的文件 | 下载 PDF/Office |
| 4 | drive:export:readonly | 导出云文档 | docx 导出为其他格式（备用） |
| 5 | drive:drive.metadata:readonly | 查看云空间文件元数据 | 主页“最近访问”列表 |
| 6 | docx:document:readonly | 查看新版文档 | 读 docx 内容 |
| 7 | sheets:spreadsheet:readonly | 查看、评论和导出电子表格 | 读 sheet 内容 |
| 8 | wiki:wiki:readonly | 查看知识库 | 读知识空间内容 |
| 9 | wiki:space:retrieve | 查看知识空间列表 | 列出所有 wiki 空间 |
| 10 | wiki:node:retrieve | 查看知识空间节点列表 | 必须，否则知识库目录树是空的 |
| 11 | bitable:app:readonly | 查看、评论和导出多维表格 | 备用（一期不导入 bitable） |
八、等待管理员审批
·企业管理员：前往“飞书管理后台 > 应用审核 > 待审核应用”中审批通过。
·非管理员：请联系企业管理员在“飞书管理后台 > 工作台 > 应用审核 > 待审核应用”中完成审批。
审批通过后，权限状态变为“已开通”。
九、配置 OAuth 重定向 URL
在应用详情页左侧导航中选择“安全设置”，找到“重定向 URL”（Redirect URL）。
单击添加，填入乐享导入服务的回调地址：
https://lexiangla.com/c/app-auth-callback
注意：说明：
十、添加网页应用能力
应用详情页左侧 >“应用能力”>“添加应用能力”> 选择“网页”
填写：
·PC 端主页：https://lexiang.tencent.com/
·移动端主页：（可留空）
·桌面端主页：（可留空）
注意：说明：
注意：添加网页应用能力后，飞书才会将该应用识别为“网页应用”，从而允许 OAuth 跳转。
十一、创建应用版本并发布
注意：此步骤最易遗漏：即使权限已审批通过，未发布版本也不会生效。
十二、进入版本管理
在应用详情页左侧导航中选择“版本管理与发布”，单击创建版本。
十三、填写版本信息
·版本号：如 1.0.0，按序递增即可。
·更新说明：首次发布，支持以 OAuth 授权方式访问云文档与知识库。
·可用范围：选择允许使用此应用的飞书用户或部门（一般选择“全员可用”。实际导入时，员工还需通过 OAuth 授权，确保仅能导入其有权限的飞书文档）。
十四、申请发布
单击保存并申请发布。
该操作同样需要管理员审批，审批通过后版本状态变为“已发布”。
十五、验证发布状态
返回“权限管理”页面，确认所有 11 个权限的状态均为“已开通”（而非“审批中”）。