教程
连接飞书（文档 / 表格）：浏览器里确认两次就好
工坊要读写飞书文档、电子表格、多维表格、知识库（写报告进飞书文档、读飞书资料导入知识库、红人同步表、任务表、记录去处、「去问人」登记到表），用的是你本人的飞书账号。在「连接」页点一下，浏览器里确认两次就连好了：不用建机器人，不用去开放平台开权限。
怎么连
- 打开「连接」页，找到飞书文档 / 表格这一张，点连接飞书。第一次点，工坊会先在本机准备好飞书的命令行工具（要下载一次，卡上会显示进度）。
- 工坊在卡上给出一个链接，并在浏览器里自动打开（打不开就点卡上的「打开链接」；也可以用飞书扫卡上的二维码）。要确认两次：
- 第一次：创建「个人应用」。 在飞书里确认，建一个只属于你自己的个人应用。它不是机器人，不用你填 App ID 和 App Secret，也不用管理员审批。
- 第二次：授权。 确认让工坊用你的账号访问文档、云空间、知识库、电子表格、多维表格。
- 两次都确认完，回到工坊，卡上会显示已连接和你的飞书账号名字。
整个过程大约一两分钟。中途想退出，点卡上的取消，不会留下半截的连接。
连上之后是什么样
- 「连接」页那一张显示已连接、你的飞书账号，以及授权什么时候到期。
- 之后凡是读写飞书文档 / 表格的事，都直接用你的身份做：写报告建在你自己的「我的空间」里；读资料、写表，能不能打开取决于你的飞书账号能不能打开那份文件。
- 工坊不会看你账号里没用到的东西，只在你让它读写某份文档 / 表格时才去碰那一份。
授权会过期吗
会。飞书的授权7 天不用就会失效。工坊每天会自动续一次，所以你只要隔一阵子用一下、工坊开着，就不用管。
如果电脑关了很久、或者飞书那边把授权撤了，授权就会过期。这时铃铛里会出一条提醒，「连接」页那一张也会显示需要重新连接。点连接飞书，浏览器里再确认一次就好（不用重新建个人应用）。
换账号、断开
- 换一个飞书账号：在那一张卡上点换账号，浏览器里用新账号确认。换了以后，之前用旧账号建的文档仍然在旧账号的空间里。
- 断开：点断开，工坊会清掉本机上的授权，不再碰你的飞书文档。已经写好的文档不动。想彻底收回，也可以在飞书里把这个个人应用的授权撤掉。
打不开某份文档 / 表格怎么办
工坊是以你本人的身份去开的，所以说「没有权限」就是你的飞书账号打不开那份文件。请文档 / 表格的主人在飞书里把你加成可编辑（右上角分享）。别家公司发给你的文件，只要你本人能在飞书里打开，工坊一般也能读；写就要有可编辑权限。
和「消息渠道」里的飞书机器人是什么关系
两件事，各管各的：
| 管什么 | 在哪里接 | |
|---|---|---|
| 飞书机器人 | 收发消息：同事私聊它、群里 @ 它、「去问人」给人发私信或在群里问 | 「设置 → 消息渠道」，见飞书机器人 |
| 飞书文档 / 表格（本篇） | 读写文档、表格、知识库 | 「连接」页，用你本人账号 |
- 只想让工坊读写飞书文档 / 表格，不用接机器人。
- 想让同事在飞书里找它聊天，仍然要接机器人。
- 以前已经给机器人应用开过文档权限的老用户：这一路留作后备。读写文档 / 表格时，工坊先看你有没有连上本篇这一路；没连，才退回机器人应用。想少操心的话，直接连上本篇这一路就行。
常见问题
- 说「还没连上飞书」：还没连，或者授权过期了。到「连接」页点连接飞书。
- 浏览器没自动打开：点卡上的「打开链接」，或用飞书扫二维码。
- 两次确认之后卡上还是没连上：回工坊等几秒；仍然不行就点取消，再点一次连接飞书。
- 说我没有权限：见上面「打不开某份文档 / 表格怎么办」。