# 即時協作

與其他人即時共同撰寫一個專案。每個人在自己的電腦上保有真正的檔案，變更則透過你的團隊執行的伺服器傳遞。

:::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/)。
