# 外部编辑与版本

来自其他编辑器、脚本和 Git 的更改如何进入共享项目，Oleafly 何时会先询问再发送，以及恢复时共享历史记录、检查点和 Git 如何相互配合。

共享项目是你电脑上的一个普通文件夹。其他程序可以更改它的文件，Oleafly 会把这些更改带入共享项目。

## 其他编辑器和脚本

当另一个编辑器、格式化程序、脚本或命令行工具在项目文件夹中保存文件时，Oleafly 会发现并把更改发送给所有人。即使别人正在该文件中输入，它也能工作。

Oleafly 会把保存的文件与它上次在那里写入的版本进行比较。只应用其他程序更改的部分。你的合作作者在此期间输入的文字保持原样。即使某个编辑器在别人输入时每秒保存一次，也没有问题。

## 大量更改会先询问

有些操作会一次更改许多文件：切换 Git 分支、拉取、在项目上解压存档或恢复旧版本。Oleafly 会扣下这样的更改，在它传到所有人之前先询问。当一次有 10 个或更多文件发生变化，或至少有 3 个文件变化且占项目文件的 30% 或更多时，它就会询问。

编辑器上方的横幅会说明有多少文件在 Oleafly 之外发生了变化，并询问是把更改发送给所有人，还是保留在本地：

- **发送**会发送更改。它们会与别人正在输入的内容合并。
- **保留在本地**会让这些文件只在这台电脑上保持现状。其他所有人保留共享的版本。如果你之后编辑其中一个文件，只会发送你新的编辑。

### 项目文件夹消失时

如果项目文件夹变得不可用，例如它所在的驱动器被拔掉，Oleafly 会暂停该项目的同步，而不是把每个文件都当作已删除。它会说明这一点，文件夹恢复后同步会重新开始。

## 共享项目中的 Git

Git 历史不会共享。每个人都可以在项目中保留自己的仓库，并向自己的远程提交和推送。请参阅 [Git 与源代码管理](/docs/git-history/)。

Git 会更改磁盘上的文件，而这些正是 Oleafly 共享的文件。检出另一个分支或拉取会把这些文件发送给所有人，如果许多文件发生变化，则要先回答上面的问题。如果你只想看看另一个分支，请选择**保留在本地**，或使用共享项目之外的单独克隆。

### 差异视图是只读的

在共享项目中，源代码管理里的差异是只读的。差异会显示“此差异在共享项目中是只读的。请在编辑器中编辑文件。”请在编辑器中做出更改，它会在那里与其他所有人的输入合并。

## 版本历史

共享项目有一份所有成员都能看到的[共享历史记录](/docs/collaboration/history/)：每一处更改、由谁在何时做出，其中的版本可以打开、比较、命名和恢复。

每个人还会保存自己的项目历史：

- [已保存的检查点](/docs/checkpoints/)在编译成功后于你的电脑上生成，与任何项目中一样。
- [Git 提交](/docs/git-history/)是你在自己的仓库中所做的提交。
- **活动**中的**查看**会显示你离开期间别人更改了什么。请阅读[重新连接时](/docs/collaboration/offline/#when-you-reconnect)。

## 恢复某个版本

要回到共享历史记录中的某个时间点，请在**历史记录**中打开该版本，然后选择**恢复此文件**或**恢复整个项目**。请阅读[恢复一个文件或整个项目](/docs/collaboration/history/#restore-a-file-or-the-whole-project)。

恢复你自己的检查点和提交，方式与任何项目中相同。打开**版本管理 → 已保存的检查点**或**版本管理 → Git 历史**，在你想要的版本上选择**恢复**。所有者和编辑者可以恢复。

在共享项目中，恢复会为所有人更改共享文件。Oleafly 会把恢复的文本作为一次编辑发送，所以别人此刻正在输入的内容会与它合并，不会丢失。如果恢复会更改许多文件，你会先收到**发送**或**保留在本地**的询问。

因为每个人都会得到结果，所以在恢复之前请告诉你的合作作者。

## 恢复已删除的文件

已删除的文件会等待在**实时协作**窗格的**最近删除**中。选择**恢复**，可为所有人找回一个文件。请阅读[最近删除](/docs/collaboration/files/#recently-deleted)。
