# 共享历史记录

回顾共享项目的每一处更改，打开较早的版本，比较两个版本，为版本命名，并恢复一个文件或整个项目。

共享项目会保留完整的更改历史，项目中的每个人看到的都是同一份历史。你可以阅读项目在任意时间点的样子，查看两个时间点之间发生了哪些变化，并找回某个文件或整个项目的较早版本。

## 找到历史记录

从项目侧栏打开**实时协作**窗格，展开**历史记录**。只要项目处于共享状态，它就在那里。**刷新历史记录**会更新列表。

更改按天分组。每个条目显示：

- 更改的时间，可能是一个时间点，也可能是一个时间段，例如“10:02 至 10:41”
- 做出更改的人，最多显示三个名字，之后显示“和另外 2 人”
- 更改的文件，或更改了多少个文件，例如“更改的文件：4”
- 版本的名称，如果有人为它命名过

底部的**显示更早的更改**会加载更多条目。Oleafly 开始记录每处更改的时间之前所做的更改，会归入**更早的更改**。

## 打开版本

在条目上选择**打开**，可以查看这些更改之后项目的样子。窗口会列出这些更改涉及的文件。选择一个文件，可以阅读它当时的内容。你在那里做的任何操作都不会更改项目。当时还不存在的文件会显示“此版本中不存在该文件。”

项目中的任何人都可以打开版本，无论角色是什么。

## 比较两个版本

1. 在第一个版本上选择**比较**。
2. Oleafly 会请你再选择一个版本。在那个版本上选择**与此版本比较**。**取消**会停止比较。
3. **两个版本之间的更改**会打开，列出发生更改的文件。选择一个文件，可以查看其中更改了什么。

如果两个版本之间没有文本更改，它会显示“这两个版本之间没有文本更改。”

## 为版本命名

给版本起个名字，方便以后再找到它，例如“已发送给审稿人”。在条目上选择**为此版本命名**，输入**版本名称**，然后选择**保存**。名称会显示在条目上，所有人都能看到。**重命名**可以更改名称，**移除名称**可以去掉它。

项目处于连接状态时，所有者和编辑者可以为版本命名。

## 恢复一个文件或整个项目

打开你想找回的版本，然后选择：

- **恢复此文件**：把一个文件恢复成它在该版本中的样子。
- **恢复整个项目**：把每个文件都恢复成它们在该版本中的样子。

Oleafly 会先询问你，因为这一更改会传到项目中的每个人。恢复在历史记录中是一次新的更改，所以不会丢失任何内容：恢复之前的文本会保留在历史记录中，你可以用同样的方式回到它。

恢复会放回每个文件的文本，并找回该版本之后被删除的文件。之后添加的文件会留在项目中。图片和其他非文本文件保持当前版本。

只有所有者和编辑者可以恢复。恢复整个项目之前，请先告诉你的合作作者，因为这会为所有人更改文件。

## 你自己的历史记录

共享历史记录与每个人在自己电脑上保存的历史并存。[已保存的检查点](/docs/checkpoints/)和你的 [Git 提交](/docs/git-history/)仍然只属于你自己。[外部编辑与版本](/docs/collaboration/outside-edits/#version-history)对它们做了比较。
