# 一起工作

查看谁在共享项目里，跟随他们的光标，跳转到某位合作者，读懂同步状态，在项目中聊天，并编译出一致的 PDF。

在共享项目中，每个人同时在相同的文件里输入。编辑在你输入时合并，所以两个人可以在同一个段落里工作。你从不需要按保存或发送。

## 查看谁在这里

工具栏上的头像是此刻在项目中的人。把鼠标悬停在某个头像上，可以看到此人的姓名、角色和他们打开的文件。访客还会带有**访客**徽章。当在项目中的人多到放不下时，会用一个数字代表其余的人。悬停在它上面可以查看名单。

**实时协作**窗格的**人员**部分列出了项目中的所有人，你排在最前。每个名字下面你会看到他们的角色和所在位置：

- **当前在 … 中**加一个文件路径：他们在项目中，并且打开了那个文件。
- **当前在此项目中**：他们在项目中，但没有打开文件。
- **当前不在此项目中**：他们没有打开这个项目。

在资源管理器中，每个人打开的文件旁边都有一个用此人颜色标示的小圆点。把鼠标悬停在圆点上可以看到是谁。

## 光标与选区

每个人都有自己的颜色。他们的光标在编辑器中显示为一条细线，上方带有他们的名字，他们选中的文本会用他们的颜色着色。你只能在自己打开的文件里看到这些，而且只能看到愿意共享光标的人。

每个人在**设置 → 协作**的**其他人看到的内容**下选择别人能看到什么。请阅读[选择其他人看到的内容](/docs/collaboration/get-started/#choose-what-others-see)。

## 跳转到合作者

点击工具栏上某人的头像，或**人员**下他们所在的那一行，就能去到他们所在的位置。Oleafly 会打开他们的文件，滚动到他们的光标处，并把那一行用他们的颜色短暂着色。在那个文件里，你自己的光标和选区保持原位，所以你不会丢失自己的位置。

当某人不在任何文件中时，他们的头像会显示“未在任何文件中，无法前往”，点击它不会有任何反应。

## 同步状态

**实时协作**窗格顶部、**管理共享**旁边的图标显示你的工作是否已到达所有人。工具栏上**共享**按钮的提示显示相同的状态。把鼠标悬停在图标上或点击它可以查看详情：服务器的名称和地址、你的角色，以及有多少更改在等待。

| 状态 | 含义 |
| --- | --- |
| **已是最新** | 服务器已有你的所有更改，你也已有其他人的所有更改。 |
| **正在同步** | 更改正在发送途中。 |
| **离线。等待同步的更改：** 加一个数字 | 没有网络连接。这么多更改在这台电脑上等待，重新连接后会发出。 |
| **正在重新连接** | 连接断开了，Oleafly 正在重试。你没有任何更改在等待。 |
| **未登录** | 这台电脑已退出服务器的登录。点击**登录**。你的更改会保留在这台电脑上。 |
| **账户已停用** | 管理员停用了你的账户。你的更改会保留在这台电脑上，账户重新启用后你就可以再次登录。 |
| **无访问权限** | 你已无法访问该服务器。你的副本会保留在这台电脑上。 |
| **访问权限已移除** | 所有者把你从项目中移除了。 |
| **共享已停止** | 所有者停止了共享项目，或者管理员归档了它。 |
| **已暂停** | 这台电脑上的同步已停止。下次你打开项目时会重新开始。 |

最后几项在[访问权限变化时](/docs/collaboration/access-changes/)中有详细说明。

## 撤销

撤销只会撤回你自己的编辑。如果合作作者在同一个段落里输入了内容，他们的文本会留在原处。

## 活动

**实时协作**窗格的**活动**部分保留了项目的简短历史：

- 有人打开和关闭项目、加入项目和离开项目
- 有人被添加到项目或从项目中移除，以及你的角色变化
- 离线和恢复在线，以及你离开期间合并了多少来自他人的更改
- 项目中的某人在新设备上登录
- 你的重命名与别人对同一文件的重命名发生冲突
- 有人在评论中提到你，并附有**查看评论**

合并记录带有**显示文件**，用来列出发生更改的文件。**查看**会打开这些更改的只读视图，按**按人员**和**按文件**分组。

## 聊天

项目侧栏上的**聊天**会为项目中的所有人打开同一个对话。它适合与某一段文字无关的事情，例如谁负责哪个章节。如果要针对具体文字发表意见，请改为[添加评论](/docs/collaboration/comments/)。

- 在**消息**框中输入，然后选择**发送**。所有者、编辑者、审阅者和评论者可以发送消息。查看者可以阅读聊天内容，但不能发送消息。
- 只有项目已连接时你才能发送消息。离线时，聊天会显示“此项目当前未连接，所以你无法发送消息。”
- **聊天**图标上出现圆点，表示你关闭聊天期间有人发了消息。
- 顶部的**显示更早的消息**会显示较早的消息。
- 要删除你写的消息，请在它上面选择**删除消息**。它会对所有人删除，原处显示“此消息已删除。”
- 所有者可以用**清空聊天**移除所有消息。此操作无法撤销。

和评论一样，聊天与共享项目放在一起。它永远不会进入你的文件。

## 编译与导出

每个人在自己的电脑上编译，构建文件也留在那里。所有者或编辑者编译成功时，Oleafly 还会把新的 PDF 发送到服务器，每分钟最多一次。[在浏览器中](/docs/collaboration/browser/)打开项目的人阅读的就是这个 PDF。

项目的编译设置是共享的，所以对每个人都一样：主文档、编译器、拼写检查语言，对于 Typst 项目还有 Typst 版本、字体和构建选项。有人更改其中一项时，所有人的副本都会随之更改，**活动**会写明谁改了什么。如果有人重命名或移动了主文档，它仍然是主文档。只有所有者和编辑者可以更改这些设置。对审阅者、评论者和查看者，这些设置显示为灰色。

每个人仍然需要在自己的电脑上安装那个引擎，或者使用 Oleafly 自带的引擎。[选择引擎](/docs/engines/)解释了各种选项。

允许外部命令，也叫 shell escape，不会共享。每个人为自己的电脑决定。开启之前，Oleafly 会警告你：任何能编辑该项目的人，随后都可以在你编译时在你的电脑上运行程序。请阅读[允许外部命令](/docs/latex-engines/#allow-external-commands)。

如果人们使用系统的 TeX 安装来编译，不同安装之间的细微差别仍可能改变 PDF。请让每个人的 TeX 保持相近的版本。

PDF 来自文件的当前状态，所以其中包含仍在等待审阅的任何建议。你编译时，Oleafly 会告诉你有多少条这样的建议。[文件里有什么](/docs/collaboration/suggesting/#whats-in-the-file)解释了原因。

导出的方式与任何项目相同。它使用你电脑上的文件，一旦你的状态显示**已是最新**，这些文件就与其他所有人的一致。
