# 连接飞书（文档 / 表格）：浏览器里确认两次就好

工坊要读写飞书文档、电子表格、多维表格、知识库（写报告进飞书文档、读飞书资料导入知识库、红人同步表、任务表、记录去处、「去问人」登记到表），**用的是你本人的飞书账号**。在「连接」页点一下，浏览器里确认两次就连好了：不用建机器人，不用去开放平台开权限。

## 怎么连

1. 打开「连接」页，找到**飞书文档 / 表格**这一张，点**连接飞书**。第一次点，工坊会先在本机准备好飞书的命令行工具（要下载一次，卡上会显示进度）。
2. 工坊在卡上给出一个链接，并在浏览器里自动打开（打不开就点卡上的「打开链接」；也可以用飞书扫卡上的二维码）。**要确认两次**：
   - **第一次：创建「个人应用」。** 在飞书里确认，建一个只属于你自己的个人应用。它不是机器人，不用你填 App ID 和 App Secret，也不用管理员审批。
   - **第二次：授权。** 确认让工坊用你的账号访问**文档、云空间、知识库、电子表格、多维表格**。
3. 两次都确认完，回到工坊，卡上会显示**已连接**和你的飞书账号名字。

整个过程大约一两分钟。中途想退出，点卡上的**取消**，不会留下半截的连接。

## 连上之后是什么样

- 「连接」页那一张显示**已连接**、你的飞书账号，以及授权什么时候到期。
- 之后凡是读写飞书文档 / 表格的事，都直接用你的身份做：写报告建在你自己的「我的空间」里；读资料、写表，能不能打开取决于**你的飞书账号**能不能打开那份文件。
- 工坊不会看你账号里没用到的东西，只在你让它读写某份文档 / 表格时才去碰那一份。

## 授权会过期吗

会。飞书的授权**7 天不用就会失效**。工坊每天会自动续一次，所以你只要隔一阵子用一下、工坊开着，就不用管。

如果电脑关了很久、或者飞书那边把授权撤了，授权就会过期。这时**铃铛里会出一条提醒，「连接」页那一张也会显示需要重新连接**。点**连接飞书**，浏览器里再确认一次就好（不用重新建个人应用）。

## 换账号、断开

- **换一个飞书账号**：在那一张卡上点**换账号**，浏览器里用新账号确认。换了以后，之前用旧账号建的文档仍然在旧账号的空间里。
- **断开**：点**断开**，工坊会清掉本机上的授权，不再碰你的飞书文档。已经写好的文档不动。想彻底收回，也可以在飞书里把这个个人应用的授权撤掉。

## 打不开某份文档 / 表格怎么办

工坊是以**你本人**的身份去开的，所以说「没有权限」就是**你的飞书账号打不开那份文件**。请文档 / 表格的主人在飞书里把你加成可编辑（右上角**分享**）。别家公司发给你的文件，只要你本人能在飞书里打开，工坊一般也能读；写就要有可编辑权限。

## 和「消息渠道」里的飞书机器人是什么关系

两件事，各管各的：

| | 管什么 | 在哪里接 |
|---|---|---|
| **飞书机器人** | 收发消息：同事私聊它、群里 @ 它、「去问人」给人发私信或在群里问 | 「设置 → 消息渠道」，见[飞书机器人](https://agentsws.com/docs/im-feishu/) |
| **飞书文档 / 表格**（本篇） | 读写文档、表格、知识库 | 「连接」页，用你本人账号 |

- 只想让工坊读写飞书文档 / 表格，**不用接机器人**。
- 想让同事在飞书里找它聊天，仍然要接机器人。
- 以前已经给机器人应用开过文档权限的老用户：**这一路留作后备**。读写文档 / 表格时，工坊先看你有没有连上本篇这一路；没连，才退回机器人应用。想少操心的话，直接连上本篇这一路就行。

## 常见问题

- **说「还没连上飞书」**：还没连，或者授权过期了。到「连接」页点**连接飞书**。
- **浏览器没自动打开**：点卡上的「打开链接」，或用飞书扫二维码。
- **两次确认之后卡上还是没连上**：回工坊等几秒；仍然不行就点**取消**，再点一次**连接飞书**。
- **说我没有权限**：见上面「打不开某份文档 / 表格怎么办」。