01 它是干嘛的
飞书是一体化协同办公平台：即时通讯、文档、表格、日历、视频会议、审批、目标管理等功能共享同一套账号与数据。它的核心主张是「协作要在一个地方发生」，用文档与消息的深度打通，替代过去「聊天工具 + 邮件 + 本地附件」的割裂体验。
02 为什么会有它
2019 年之前：改一个文件，要在聊天、邮件和本地文件夹之间来回倒
过去团队的日常是这样的：要紧的事在聊天软件里说，正式的文档用邮件发，文档本身存在每个人自己的电脑里。一个方案要三个人改，就会出现「方案第二版最终版张三改」这种文件名，谁手上的才是最新版，全靠猜。
更麻烦的是信息分散：决策留在聊天记录里，结论写在附件里，任务记在某人脑子里。新人入职想弄明白一件事的来龙去脉，得翻无数个群和邮件。
飞书最早是字节内部为了自己高效协作而做的工具，先用顺了再对外。它的关键设计是「文档与消息是同一个东西的两面」：在聊天里直接发一篇文档，多人同时编辑，改动实时同步，评论与提醒都和账号体系打通，于是「版本」这件事被彻底消灭。
03 它怎么工作
协同编辑的核心是「同步操作」：每个人敲下的不是一整篇文档，而是一个个小操作，这些操作被实时广播给所有正在看的人，冲突由算法自动化解。
两个人同时编辑一篇文档，为什么不会互相覆盖
- 1① 打开文档并建立连接
你打开文档时，客户端与服务器建立长连接，拉取当前最新内容与在线成员列表。
- 2② 你的一次编辑被拆成操作
输入一个字、删掉一行、移动光标，都会被描述成一条带位置信息的操作指令。
- 3③ 服务器排序并广播
所有操作发到服务器后按统一顺序定序，再广播给所有在线的协作者。
- 4④ 客户端合并冲突
两个人同时改同一处时，合并算法（如 OT 或 CRDT）决定最终结果，保证每个人看到的内容一致。
- 5⑤ 持久化与版本追溯
合并后的内容定期存盘，同时保留历史版本，随时能查看谁在什么时候改了什么。
04 谁在用它
群聊、话题讨论与文档结合，重要结论沉淀成可检索的文档，而不是埋在聊天记录里。
日历约会议，一键拉起视频会议，纪要自动落在同一处并分派任务。
请假、报销、采购等审批流在线走完，进度可追踪，不必线下找领导签字。
把制度、方案、复盘集中存放，用搜索取代「翻群找记录」。
05 怎么用
普通成员几乎零学习成本，会用聊天软件就会用；管理员需要规划组织架构与权限。
- 01企业管理员创建组织、导入成员，或让成员用企业邮箱自助加入。
- 02安装桌面端与移动端，登录后即可使用聊天、文档、日历等全部功能。
- 03在云文档里新建文档，点击分享并设置「可编辑」权限，邀请同事一起改。
- 04把常用文档固定在群公告或知识库里，形成团队固定的信息入口。
- 05（开发者）在开放平台创建应用，用机器人把系统通知推送到群里。
curl -X POST https://open.feishu.cn/open-apis/bot/v2/hook/你的webhook地址 \
-H "Content-Type: application/json" \
-d '{
"msg_type": "text",
"content": {"text": "部署完成：订单服务 v2.3.1 已上线"}
}'避坑提示
- !分享链接前先检查权限范围，默认「组织内可编辑」比「互联网上任何人可编辑」安全得多。
- !重要决策不要只留在聊天里，及时转成文档，否则三个月后没人找得到。
- !机器人 webhook 地址等同密码，泄露后任何人都能往群里发消息，注意保密。
06 关键概念
- 云文档
- 内容存在云端而不是本地文件，多人可同时打开与编辑，天然没有版本号问题。
- 协同编辑
- 多人同时修改同一份内容并实时同步，靠操作合并算法避免冲突。
- 单点登录
- 一次登录即可使用所有内部系统，不用为每个系统记一套密码。
- 开放平台
- 面向开发者的接口与机器人能力，可把飞书与自有系统打通。