使用飞书转存专家前,需要在飞书开放平台创建一个企业自建应用,并为应用开通文档转存所需的权限。完成后,将应用的 App ID 和 App Secret 填入飞书转存专家即可。
整个配置过程只需完成四步:
- 创建企业自建应用
- 批量开通应用权限
- 创建并发布应用版本
- 复制 App ID 和 App Secret
配置应用需要拥有所在飞书企业的应用创建权限。如果创建或发布应用时需要管理员审核,请联系企业管理员完成审批。
第一步:创建企业自建应用
打开飞书开放平台,登录需要使用飞书转存专家的飞书账号,然后进入开发者后台。
点击创建企业自建应用,按照截图填写应用信息:
- 应用名称:建议填写“飞书转存专家”,也可以使用便于自己识别的名称。
- 应用描述:填写“飞书转存专家”或其他简短说明。
- 应用图标:可使用平台提供的默认图标,也可以上传自定义图标。确认信息后点击创建。

应用创建完成后,飞书开放平台会自动进入该应用的管理后台。
第二步:开通应用权限
飞书转存专家需要访问飞书多维表格、电子表格和知识库。为避免逐项搜索,可以通过批量导入一次开通所需权限。
1. 打开批量导入权限
在应用后台左侧菜单中点击权限管理,然后点击页面上方的批量导入/导出权限。

2. 导入权限 JSON
在弹窗的导入页签中,删除编辑器里的原有内容,然后粘贴以下 JSON:
{
"scopes": {
"tenant": [
"bitable:app",
"wiki:wiki",
"sheets:spreadsheet"
]
}
}
这三项权限分别用于:
bitable:app:查看、评论、编辑和管理多维表格wiki:wiki:查看、编辑和管理知识库sheets:spreadsheet:查看、评论、编辑和管理电子表格
粘贴完成后,点击下一步,确认新增权限。

3. 申请开通权限
确认页面应显示三项本次新增的应用身份权限。核对无误后,点击申请开通。

返回权限管理页面后,确认以下三项权限的状态均为已开通:
- 查看、评论、编辑和管理电子表格
- 查看、评论、编辑和管理多维表格
- 查看、编辑和管理知识库

第三步:创建并发布版本
刚刚开通的权限只有在应用发布后才会生效。
在左侧菜单中点击版本管理与发布。首次配置时,点击页面顶部提示中的创建版本;进入版本配置页后,填写版本号和更新说明,确认可用范围,然后保存并提交发布。
如果页面显示需要企业管理员审核,请等待管理员审核通过。应用状态变为已启用,且页面提示当前修改均已发布,才表示配置已经生效。

后续如果增加或修改应用权限,也需要重新创建并发布一个版本,否则新的权限不会生效。
第四步:复制应用凭证
应用发布成功后,在左侧菜单中点击凭证与基础信息。在应用凭证区域可以看到:
- App ID:点击右侧复制图标进行复制。
- App Secret:点击眼睛图标显示内容,再点击复制图标进行复制。

将复制的 App ID 和 App Secret 填入飞书转存专家对应的配置项并保存,即可完成飞书应用配置。
App Secret 相当于应用密码,请勿发布到网页、群聊、代码仓库或其他公开位置。如果凭证已经泄露,请立即在飞书开放平台重置 App Secret,并更新飞书转存专家中的配置。
完成检查
开始使用前,请确认以下项目均已完成:
- 已创建企业自建应用
- 多维表格、电子表格和知识库三项权限均显示“已开通”
- 应用版本已经发布,应用状态为“已启用”
- 已将正确的 App ID 和 App Secret 填入飞书转存专家
如果配置后仍然无法访问文档,请优先检查应用版本是否已经发布,以及当前飞书账号是否拥有目标文档、表格或知识库的访问权限。