# 实时协作

与他人实时共同撰写一个项目。每个人都在自己的电脑上保留真实文件，更改通过你们小组运行的服务器传递。

:::note[实时协作处于测试阶段]
它需要 Oleafly 0.4.7-rc。请从[发布页面](https://github.com/Oleafly/Oleafly/releases/tag/v0.4.7-rc)下载。下载页面仍然提供 0.4.6，它没有实时协作。如果你运行服务器，请按[用一条命令安装](/docs/collaboration/server/#install-with-one-command)所示安装 Oleafly Server 0.1.1-rc。
:::

实时协作让多个人同时撰写同一个项目。你输入时可以看到彼此的光标。你们可以对文字发表评论、建议更改和聊天，每个人在自己的电脑上编译 PDF。

每个人都在自己的库中以普通文件的形式保留整个项目。更改通过协作服务器在这些副本之间传递，例如你的实验室、院系或机构运行的服务器，或位于 `collab.oleafly.com` 的 Oleafly 服务器。由服务器决定谁可以加入。这里没有 Oleafly 账户。你用已有的账户登录，例如你的大学登录或 GitHub。

## 它是如何工作的

每个人都有项目的完整副本。编辑在人们输入时逐字符合并，所以两个人可以在同一个段落里工作而不会相互覆盖。

连接中断时你可以继续工作。你的更改会留在电脑上等待，并在你重新连接时发出。[离线与重新连接](/docs/collaboration/offline/)说明了那时会发生什么。

服务器存储每个共享项目，并在项目中的人之间传递更改。它可以读取共享在其上的项目的文件，**共享**对话框会在你共享之前告诉你这一点。[服务器安全](/security/)介绍了它如何处理登录、设备密钥和日志。

每个人在自己的电脑上编译，使用项目为所有人设置的引擎和主文档。构建输出、Oleafly 设置和 Git 历史留在每台电脑上，所以你的 Git 提交和[已保存的检查点](/docs/checkpoints/)只属于你自己。例外是所有者或编辑者最近一次编译出的 PDF：Oleafly 会把它发送到服务器，让在浏览器中工作的合作作者可以阅读。项目的[共享历史记录](/docs/collaboration/history/)随共享项目一起传递，所以每个人看到的是相同的版本。

## 适合谁

- 一起撰写论文、基金申请书和学位论文的实验室和研究小组，整个小组共用一台服务器。
- 其他机构的合作作者。项目所有者可以邀请他们成为访客，他们只能看到那个项目。如果服务器开启了浏览器访问，他们无需安装 Oleafly，就可以[在浏览器中工作](/docs/collaboration/browser/)。
- 应当评论或建议更改、但不直接编辑文本的导师和审稿人。
- 学生和教学人员共享草稿并对其发表评论的课程。
- 审核和运行服务器的 IT 和安全人员。请从[运行协作服务器](/docs/collaboration/server/)和[安全页面](/security/)开始。

## 快速浏览

打开一个共享项目，你会发现这些：

| 位置 | 你看到什么 |
| --- | --- |
| 库 | **与你共享的项目**列出别人与你共享、但还不在这台电脑上的项目。你库中的共享项目带有**已共享**标记。 |
| 工具栏 | 此刻在项目中的人的头像、**编辑**和**建议**切换开关，以及**共享**按钮。 |
| 编辑器 | 其他人的光标和选区，每个人用各自的颜色显示，并带有他们的名字。 |
| 资源管理器 | 在某人打开的文件旁，有一个此人颜色的小圆点。 |
| **实时协作**窗格 | **人员**、**活动**、**历史记录**和**最近删除**。顶部的图标显示你的更改是否已是最新。 |
| **评论**窗格 | 评论讨论串和建议的更改，按文件分组。 |
| **聊天**窗格 | 发给项目中所有人的消息。 |
| **设置 → 协作** | 你的服务器、你的设备，以及你工作时别人能看到你的哪些内容。 |

**实时协作**、**评论**和**聊天**窗格从项目侧栏打开。任何一个窗格上出现圆点，说明那里有新的动态。

## 接下来去哪里

- 有人邀请了你：[开始使用](/docs/collaboration/get-started/)。
- 你想共享一个项目：[共享项目](/docs/collaboration/sharing/)。
- 你正在与他人一起写作：[一起工作](/docs/collaboration/working-together/)。
- 你想找回较早的版本：[共享历史记录](/docs/collaboration/history/)。
- 某位合作作者没有 Oleafly：[在浏览器中工作](/docs/collaboration/browser/)。
- 你运行服务器：[运行协作服务器](/docs/collaboration/server/)。
