# 让工坊用官方接口读飞书资料

你给岗位一条飞书链接（文档、电子表格、多维表格、知识库页），让它读、导入知识库、读表发帖时，工坊按这个顺序读：

1. **先走飞书官方接口**：用你在「设置 → 消息渠道」里接好的那个飞书应用去读。这一路读得最全：正文、每个分表、多维表格的每张表、文档里的图、表格里的附件（PDF 说明书这类）都能读进来。
2. **官方接口读不了，就自动改用 ego 读**：浏览器设置是 ego 时，不先问你，直接用你在 ego 里登录的飞书账号打开这份资料读。这一路只读得到页面上的字，图和附件读不到。
3. **读完说一句**：哪几份是官方读不了、改用 ego 读的，审核卡上会写明原因，附上这篇教程。**同一份资料只在第一次说**，之后再读同一份就不再提。

## 先看一眼：这份资料是谁家的

飞书应用只在**建它的那家公司**的飞书里有权限。所以：

- **你自己建的、你们公司飞书里的资料**：可以走官方接口，照下面两步开好权限，读得最全。
- **别家公司的飞书资料**（比如合作方、甲方发给你的链接，网址开头是他们公司的飞书域名）：你接的应用进不了他们的飞书，官方接口**一般读不了**。这种用 ego 读就行，不用折腾权限。要读到图和附件，只能请对方把文件另发给你，再传进知识库。

## 一、给飞书应用开读权限

这一步在[飞书开放平台](https://open.feishu.cn/app)做，要能管这个应用的人。用的是「消息渠道」里接的同一个应用；还没接的话，先照[飞书机器人：建应用、开长连接、拿凭据](https://agentsws.com/docs/im-feishu/)接好。

1. 进应用 → **权限管理**，搜索并开通下面这几项（都是只读）：
   - 查看新版文档（`docx:document:readonly`）
   - 查看电子表格（`sheets:spreadsheet:readonly`）
   - 查看多维表格（`bitable:app:readonly`）
   - 查看知识库（`wiki:wiki:readonly`）：资料放在知识库里时要
   - 查看、下载云空间中的文件（`drive:drive:readonly`）：读文档里的图和表格里的附件要
2. **版本管理与发布** → 创建版本 → 申请发布，等企业管理员通过。

已经为读表发帖、红人同步开过可编辑权限（`bitable:app`、`sheets:spreadsheet`）的，那两项不用再开只读的。

## 二、把资料开给这个应用

开了权限，应用还要能「看到」这份资料：

- **一份文档或表格**：在飞书里打开它 → 右上角「…」→「…更多」→「添加文档应用」→ 选你接的那个应用，给「可阅读」就够。
- **一整个文件夹**：飞书不让应用直接当文件夹协作者。建一个群，把这个应用的机器人拉进去，再把文件夹共享给这个群。
- **一整个知识库**：知识库设置 → 成员设置，把有这个机器人的群加成成员。

开好以后，回工坊再说一次「导入这份资料」或「重新读一下」，这次就走官方接口了，卡上「读了：」那一行会写「飞书接口」。

## 常见问题

- **卡上说「飞书应用没有这份资料的权限」**：第二步没做，或者加的不是「消息渠道」里接的那个应用。
- **卡上说「还没接飞书应用」**：先在「设置 → 消息渠道」接上飞书机器人。
- **开了权限还是读不了**：多半是别家公司的资料，看上面「这份资料是谁家的」。用 ego 读就行。
- **ego 里也打不开**：你在 ego 里登录的飞书账号也没这份的权限。去找资料的主人开；工坊不会替你点「申请权限」。
- **ego 读的会漏什么**：图、附件（PDF 说明书这类）读不到，卡上「读不了」那一栏会照实列出来。每周复查这几份时也一样用 ego 读，同样读不到图和附件。