# 外部編輯與版本

其他編輯器、指令碼和 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)。
