本文介绍如何在腾讯乐享知识库中配置飞书连接器，包括连接器配置入口、飞书自建应用（OAuth 2.0 模式）的创建与发布、权限申请及 OAuth 重定向 URL 配置等步骤。
使用入口
1. 登录 企业管理后台，在左侧菜单栏中选择腾讯乐享知识库。
2. 进入知识管理 > 连接器菜单。
3. 单击飞书连接器，在弹出的表单中按以下说明填写：
字段 | 说明 | 是否必填 |
App ID | “创建飞书自建应用”章节中获取的 App ID（格式为 cli_xxx） | 必填 |
App Secret | “创建飞书自建应用”章节中获取的 32 位密钥 | 必填 |
安全说明：
App Secret 在乐享侧加密存储（KMS 等），后台 UI 仅显示掩码（如****abc8）。
凭证只有在 OAuth 换 token 这一步会被后端解密使用，不会出现在日志、前端、API 响应里。
如需更换 App Secret，先在飞书开放平台“凭证与基础信息”单击重置，再回到乐享集成中心“编辑”该应用，更新 App Secret 即可。
飞书自建应用配置指南（OAuth 2.0 模式）
开始之前
完成飞书自建应用的配置后，乐享即可通过 OAuth 2.0 在用户授权后访问其飞书云文档。
前置要求：
您需为飞书企业管理员，或可协调企业管理员配合审批。
整体流程：
创建应用 > 配置基础信息 > 申请自建应用权限 > 配置 redirect_uri > 添加网页应用能力 > 创建并发布版本 > 管理员审批 > 把 App ID/Secret 填入乐享连接器配置 > 重启服务 > 可用
创建飞书自建应用
进入开放平台
创建应用
1. 单击右上角创建应用 > 自建应用。
2. 填写以下信息：
应用名称：乐享导入助手（建议包含“乐享”前缀，便于审批识别）。
应用描述：将飞书云文档/知识库内容批量导入到腾讯乐享知识库。
应用图标：上传乐享 logo（可选，默认 256x256）。
3. 单击创建。
创建成功后，系统将生成 App ID 和 App Secret，可在“凭证与基础信息”页面查看。请记录这两个值，后续需填入乐享飞书连接器配置中。
示例（请替换为实际值）：
App ID：cli_xxxxxxxxxxxxxxxxApp Secret：xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
申请 11 个权限（scope）
进入权限管理
在应用详情页左侧菜单中选择权限管理 > 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说明：
回调地址必须与上述地址完全一致，包括协议（http/https）、端口和路径，不能包含多余的斜杠，否则将导致授权失败。
飞书支持同时配置多个 redirect_uri（如开发、测试、生产环境各配置一个），可按需添加。
添加网页应用能力
应用详情页左侧 >“应用能力”>“添加应用能力”> 选择“网页”
填写：
PC 端主页：
https://lexiang.tencent.com/移动端主页：（可留空）
桌面端主页：（可留空）
说明：
添加网页应用能力后，飞书才会将该应用识别为“网页应用”，从而允许 OAuth 跳转。
创建应用版本并发布
注意：
此步骤最易遗漏：即使权限已审批通过，未发布版本也不会生效。
进入版本管理
在应用详情页左侧导航中选择“版本管理与发布”，单击创建版本。
填写版本信息
版本号：如 1.0.0，按序递增即可。
更新说明：首次发布，支持以 OAuth 授权方式访问云文档与知识库。
可用范围：选择允许使用此应用的飞书用户或部门（一般选择“全员可用”。实际导入时，员工还需通过 OAuth 授权，确保仅能导入其有权限的飞书文档）。
申请发布
单击保存并申请发布。
该操作同样需要管理员审批，审批通过后版本状态变为“已发布”。
验证发布状态
返回“权限管理”页面，确认所有 11 个权限的状态均为“已开通”（而非“审批中”）。
