# 一起工作

查看誰在共用專案中、追蹤他們的游標、跳到某位協作者所在之處、讀取同步狀態、在專案中聊天，並編譯出一致的 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)說明了原因。

匯出的運作方式與任何專案相同。它使用你電腦上的檔案，一旦你的狀態顯示 **已是最新**，這些檔案就會與其他所有人的相符。
