教程
让工坊用官方接口读飞书资料
你给岗位一条飞书链接（文档、电子表格、多维表格、知识库页），让它读、导入知识库、读表发帖时，工坊按这个顺序读：
- 先走飞书官方接口：用你在「设置 → 消息渠道」里接好的那个飞书应用去读。这一路读得最全：正文、每个分表、多维表格的每张表、文档里的图、表格里的附件（PDF 说明书这类）都能读进来。
- 官方接口读不了，就自动改用 ego 读：浏览器设置是 ego 时，不先问你，直接用你在 ego 里登录的飞书账号打开这份资料读。这一路只读得到页面上的字，图和附件读不到。
- 读完说一句：哪几份是官方读不了、改用 ego 读的，审核卡上会写明原因，附上这篇教程。同一份资料只在第一次说，之后再读同一份就不再提。
先看一眼：这份资料是谁家的
飞书应用只在建它的那家公司的飞书里有权限。所以：
- 你自己建的、你们公司飞书里的资料：可以走官方接口，照下面两步开好权限，读得最全。
- 别家公司的飞书资料（比如合作方、甲方发给你的链接，网址开头是他们公司的飞书域名）：你接的应用进不了他们的飞书，官方接口一般读不了。这种用 ego 读就行，不用折腾权限。要读到图和附件，只能请对方把文件另发给你，再传进知识库。
一、给飞书应用开读权限
这一步在飞书开放平台做，要能管这个应用的人。用的是「消息渠道」里接的同一个应用；还没接的话，先照飞书机器人：建应用、开长连接、拿凭据接好。
- 进应用 → 权限管理，搜索并开通下面这几项（都是只读）：
- 查看新版文档（
docx:document:readonly） - 查看电子表格（
sheets:spreadsheet:readonly） - 查看多维表格（
bitable:app:readonly） - 查看知识库（
wiki:wiki:readonly）：资料放在知识库里时要 - 查看、下载云空间中的文件（
drive:drive:readonly）：读文档里的图和表格里的附件要
- 版本管理与发布 → 创建版本 → 申请发布，等企业管理员通过。
已经为读表发帖、红人同步开过可编辑权限（bitable:app、sheets:spreadsheet）的，那两项不用再开只读的。
二、把资料开给这个应用
开了权限，应用还要能「看到」这份资料：
- 一份文档或表格：在飞书里打开它 → 右上角「…」→「…更多」→「添加文档应用」→ 选你接的那个应用，给「可阅读」就够。
- 一整个文件夹：飞书不让应用直接当文件夹协作者。建一个群，把这个应用的机器人拉进去，再把文件夹共享给这个群。
- 一整个知识库：知识库设置 → 成员设置，把有这个机器人的群加成成员。
开好以后，回工坊再说一次「导入这份资料」或「重新读一下」，这次就走官方接口了，卡上「读了：」那一行会写「飞书接口」。
常见问题
- 卡上说「飞书应用没有这份资料的权限」：第二步没做，或者加的不是「消息渠道」里接的那个应用。
- 卡上说「还没接飞书应用」：先在「设置 → 消息渠道」接上飞书机器人。
- 开了权限还是读不了：多半是别家公司的资料，看上面「这份资料是谁家的」。用 ego 读就行。
- ego 里也打不开：你在 ego 里登录的飞书账号也没这份的权限。去找资料的主人开；工坊不会替你点「申请权限」。
- ego 读的会漏什么：图、附件（PDF 说明书这类）读不到，卡上「读不了」那一栏会照实列出来。每周复查这几份时也一样用 ego 读，同样读不到图和附件。