# Đồng bộ hóa đám mây với Dropbox

Sao lưu các dự án trong thư viện và cài đặt của bạn vào Dropbox của chính bạn và mở chúng trên các máy tính khác của bạn. Những gì được đồng bộ, xung đột và việc xóa tệp được xử lý ra sao, và mỗi thông báo có ý nghĩa gì.

Đồng bộ hóa đám mây giữ một bản sao các dự án trong thư viện và cài đặt của bạn trong Dropbox của chính bạn. Kết nối cùng một Dropbox trên một máy tính khác, tải các dự án về đó, và cả hai máy tính sẽ giữ chúng luôn đồng bộ với nhau.

Mở **Settings → Data Storage → Cloud sync** để thiết lập.

## Trước khi bắt đầu

- Bạn cần một tài khoản Dropbox. Tài khoản Dropbox Basic miễn phí có 2 GB.
- Đồng bộ hóa đám mây hoạt động trên macOS, Windows và Linux.
- Oleafly chỉ đồng bộ khi nó đang mở, kể cả khi nó được thu nhỏ hoặc cửa sổ của nó bị ẩn. Không có gì được đồng bộ khi Oleafly đã đóng.
- Oleafly giao tiếp trực tiếp với Dropbox. Không có máy chủ Oleafly nào đứng giữa.

## Kết nối Dropbox

1. Mở **Settings → Data Storage → Cloud sync** và chọn **Connect Dropbox**.
2. Trình duyệt của bạn mở trang đăng nhập và phê duyệt của Dropbox. Đăng nhập ở đó và phê duyệt Oleafly.
3. Oleafly hoàn tất việc kết nối, rồi trình duyệt hiển thị "You're connected". Nếu có sự cố sau khi bạn phê duyệt, trình duyệt báo rằng việc đăng nhập chưa hoàn tất, và Oleafly hiển thị điều đã xảy ra.

Bạn đăng nhập trên trang của chính Dropbox, nên Oleafly không bao giờ thấy mật khẩu Dropbox của bạn.

### Nếu trình duyệt không chuyển lại được về Oleafly

Sau khi bạn phê duyệt, Dropbox đưa trình duyệt của bạn đến một địa chỉ cục bộ trên máy tính của bạn (127.0.0.1), và Oleafly nhận thông tin đăng nhập từ đó. Nếu cách đó không hoạt động, hãy chọn **Trouble signing in? Paste a code instead**. Dropbox sẽ hiển thị một mã cho bạn. Hãy sao chép mã đó và dán vào Oleafly.

### Những gì Oleafly có thể truy cập

- Oleafly chỉ có thể mở thư mục ứng dụng riêng của nó trong Dropbox của bạn, `Apps/Oleafly`. Nó không thể thấy bất kỳ tệp Dropbox nào khác của bạn.
- Oleafly yêu cầu Dropbox cấp bốn quyền và không yêu cầu quyền nào khác. `account_info.read` cho phép hiển thị địa chỉ email của bạn và dung lượng bạn đã dùng. `files.metadata.read`, `files.content.read` và `files.content.write` cho phép nó liệt kê, đọc và ghi các tệp trong thư mục riêng của nó.
- Việc đăng nhập dùng OAuth với PKCE.
- Trên macOS và Windows, mã thông báo đăng nhập được giữ trong chuỗi khóa của hệ điều hành. Trên Linux, hoặc khi chuỗi khóa không khả dụng, nó được giữ trong một tệp đã mã hóa trong thư mục dữ liệu của Oleafly.
- Mã thông báo không bao giờ được đồng bộ. Mỗi máy tính tự kết nối riêng.

### Thẻ Cloud sync

Sau khi đã kết nối, thẻ hiển thị:

- Địa chỉ email của tài khoản Dropbox.
- Một vòng tròn cho biết Dropbox của bạn đã dùng bao nhiêu. Nó chuyển từ xanh lá sang vàng, cam rồi đỏ khi Dropbox của bạn dần đầy, và có màu đỏ từ mức 80%.
- **Sync on this computer**, công tắc bật hoặc tắt đồng bộ tại máy này.
- **Sync automatically**, công tắc cho phép Oleafly tự đồng bộ.
- Tên của máy tính này. Bấm vào để đổi tên máy tính.
- Danh sách **Projects**.
- **Advanced**, cùng với **Disconnect**.

## Những gì được đồng bộ

### Dự án

Mọi dự án trong thư viện của bạn đều được đồng bộ, cùng các tệp của nó, bao gồm cả thư mục mà tài liệu chính của bạn biên dịch trong đó. Oleafly âm thầm loại bỏ những thứ sau khỏi mọi dự án:

- Kết quả biên dịch, chẳng hạn các tệp `.aux` và `.log` cùng tệp PDF chính đã biên dịch. Tệp biên dịch mà bạn theo dõi bằng Git, chẳng hạn nhật ký kết quả, vẫn được sao lưu vào Dropbox của bạn.
- Các thư mục `__pycache__` của Python
- Thư mục `.git`
- Các thư mục làm việc riêng của Oleafly
- Các tệp tạm thời từ trình soạn thảo
- Các tệp hệ thống như `.DS_Store`

Vài thứ khác cũng không được đồng bộ, và hàng của dự án liệt kê chúng là bị bỏ qua, kèm theo lý do: liên kết tượng trưng (symbolic link), các thư mục `node_modules` và `.venv`, tệp lớn hơn 16 GB, và các tệp có [tên không hoạt động trên mọi máy tính](#renames-and-file-names).

Các dự án bạn mở từ một thư mục ở nơi khác trên máy tính của bạn ([thư mục mở tại chỗ](/docs/library/#folders-opened-in-place)) không được đồng bộ. Danh sách Projects cho bạn biết có bao nhiêu dự án như vậy.

Lịch sử Git và [các điểm kiểm tra](/docs/checkpoints/) không được đồng bộ.

### Chi tiết dự án

Tệp `project.json` của mỗi dự án cũng được đồng bộ, nên tên, tài liệu chính, engine, màu bìa và các chi tiết khác của nó đi theo nó. Vài chi tiết thuộc về một máy tính và ở lại đó:

- Các đường dẫn xuất
- Dự án có bị ẩn hay không
- Đặc tả gói TeX
- Chính sách chụp điểm kiểm tra
- Dự án được sao chép (fork) từ đâu

### Ghi chú

Mỗi [ghi chú](/docs/notes/) cá nhân được đồng bộ như một dự án trong thư viện, và một ghi chú nằm trong một dự án được đồng bộ cùng các tệp của dự án đó. Nếu một ghi chú cá nhân đã thay đổi trên hai máy tính, phiên bản của máy tính kia được lưu trong thư mục của ghi chú dưới dạng bản sao xung đột, chẳng hạn `note (Laptop 2026-10-14).md`, và **Compare conflict copy** trong menu của ghi chú cho phép bạn giữ một phiên bản. Một ghi chú nằm trong một dự án có bản sao xung đột ngay cạnh nó trong thư mục `notes` của dự án, như mọi tệp dự án khác.

### Cài đặt

Cài đặt ứng dụng của bạn được đồng bộ, bao gồm các chỉ dẫn AI, persona AI và từ điển tùy chỉnh của bạn. Một số cài đặt ở lại trên từng máy tính, chẳng hạn việc **Sync automatically** có bật hay không, **Default compile engine** cho LaTeX, **Shell** và **Shell path** của terminal, **Computer Use** trong mục Integrations, công tắc **Research tasks** trong Experimentation, và **Allow network for task commands by default** trong Research. Nhờ đó một agent không bao giờ được dùng các ứng dụng desktop trên một máy tính chỉ vì bạn đã bật chúng ở nơi khác, và một máy tính không cài TeX vẫn giữ Tectonic khi máy khác dùng latexmk.

Các cuộc trò chuyện với AI, mật khẩu, khóa API và các thông tin bí mật khác không bao giờ được đồng bộ.

## Những gì nằm trong Dropbox của bạn

Mọi thứ đều nằm trong thư mục `Apps/Oleafly`:

```text
Apps/Oleafly/
├── projects/
│   └── <project id>/
│       ├── files/          the project's files, under their own names
│       └── version.json    which version of each file belongs to the project
└── settings/
    └── settings.json       your synced settings
```

Các tệp dự án giữ nguyên tên của chúng, nên bạn có thể mở chúng từ Dropbox. Việc chỉnh sửa hoặc di chuyển tay các tệp trong `Apps/Oleafly` không được hỗ trợ. Oleafly coi mọi thứ trong thư mục đó là không đáng tin cậy và kiểm tra nó.

## Một vòng đồng bộ hoạt động như thế nào

Mỗi vòng đều đi qua các bước giống nhau:

1. Oleafly hỏi Dropbox xem dự án nào đã thay đổi kể từ vòng trước. Khi không có gì thay đổi, việc đó chỉ tốn một yêu cầu.
2. Nó quét các tệp của mỗi dự án trên máy tính này. Nó nhận ra các tệp không thay đổi một cách nhanh chóng, không cần đọc lại chúng.
3. Với mỗi tệp, nó so sánh ba phiên bản: phiên bản trên máy tính này, phiên bản trong Dropbox, và phiên bản cuối cùng mà cả hai bên đã thống nhất. Điều đó cho nó biết bên nào đã thay đổi.
4. Nó tải các thay đổi từ những máy tính khác của bạn xuống một nơi tạm thời và kiểm tra từng tệp với dấu vân tay (hash) đã ghi lại cho tệp đó. Chỉ sau đó tệp mới được đưa vào dự án. Nếu bạn đã thay đổi tệp đó trên máy tính này sau lần quét, Oleafly để yên nó cho đến vòng tiếp theo.
5. Nó tải lên các thay đổi từ máy tính này, rồi so sánh checksum của chính Dropbox với những gì nó đã gửi.
6. Nó lưu bản ghi phiên bản của dự án, kèm kiểm tra rằng không máy tính nào khác đã lưu ở giữa. Nếu có, vòng sẽ chạy lại với bản ghi mới hơn, để công việc của không máy tính nào bị mất.
7. Cuối cùng, nó xóa khỏi Dropbox các tệp bạn đã xóa trên máy tính này.

## Khi nào Oleafly đồng bộ

**Sync automatically** được bật trừ khi bạn tắt nó. Khi nó bật, Oleafly đồng bộ vài giây sau khi bạn lưu một tệp và ngay sau khi một máy tính khác thay đổi Dropbox của bạn. Giữa hai lần đó, nó kiểm tra mỗi 5 phút, hoặc mỗi 15 phút khi cửa sổ Oleafly bị ẩn. Vòng đầu tiên chạy khoảng 20 giây sau khi Oleafly khởi động, và các thay đổi cài đặt của bạn được đồng bộ khoảng 3 giây sau khi bạn thực hiện chúng. Khi **Sync automatically** tắt, Oleafly đồng bộ khi bạn chọn **Sync now**, và một lần khi bạn kết nối, bật lại **Sync on this computer**, hoặc bật lại công tắc của một dự án.

Nếu một vòng thất bại, chẳng hạn vì bạn đang ngoại tuyến, Oleafly thử lại sau 30 giây và chờ lâu hơn sau mỗi lần thất bại, tối đa 5 phút, hoặc 15 phút khi cửa sổ bị ẩn. Nó trở lại lịch trình bình thường ngay khi một vòng thành công. Nó cũng đồng bộ khi máy tính của bạn kết nối lại mạng.

**Sync now** chạy một vòng ngay lập tức và hiển thị một thông báo kèm kết quả. Các vòng tự động không bao giờ hiện pop-up. Trạng thái của chúng xuất hiện trong phần Projects: "Last synced" kèm thời gian, "Syncing your projects", hoặc một dòng mô tả vấn đề.

Khi có điều gì đó cần đến bạn, chẳng hạn Dropbox đã đầy, một dự án bị tạm dừng, một bản sao xung đột hoặc một lựa chọn cài đặt, một chấm màu hổ phách nhỏ sẽ xuất hiện trên nút Settings. Settings khi đó sẽ mở ngay vào Cloud sync, để bạn thấy vấn đề trước.

## Xung đột

Nếu cùng một tệp bị thay đổi trên hai máy tính giữa hai lần đồng bộ, Oleafly giữ cả hai phiên bản. Phiên bản của máy tính này giữ nguyên tên gốc. Phiên bản của máy tính kia được lưu ngay cạnh nó, đặt theo máy đã ghi nó và ngày, chẳng hạn `ch1 (Laptop 2026-10-14).tex`. Xung đột thứ hai trong cùng ngày sẽ thêm một số vào tên. Hàng của dự án liệt kê các bản sao xung đột cho đến khi bạn chọn **Dismiss**.

Mở cả hai tệp, giữ lại những gì bạn muốn, và xóa bản sao bạn không cần.

`project.json` không bao giờ có bản sao xung đột. Các trường của nó được hợp nhất với nhau. Thay đổi của mỗi máy tính đều được giữ, và nếu cả hai máy tính thay đổi cùng một trường, giá trị của máy tính này thắng.

### Các chỉnh sửa chưa lưu luôn an toàn

Đồng bộ không bao giờ ghi đè một tệp đang mở trong trình soạn thảo mà có các thay đổi chưa lưu. Các thay đổi từ máy tính khác của bạn phải chờ. Sau khi bạn lưu, vòng tiếp theo đối xử với phần chỉnh sửa của bạn như mọi chỉnh sửa khác, nên nếu cả hai bên đã thay đổi tệp, bạn sẽ nhận được một bản sao xung đột.

Một tệp đang mở mà bạn chưa thay đổi sẽ được cập nhật trong trình soạn thảo ngay khi thay đổi từ máy tính khác đến. Nếu một thay đổi đến trong khi bạn đang chỉnh sửa, trình soạn thảo sẽ báo rằng tệp đã thay đổi trên đĩa, và bạn chọn **Reload** hoặc **Keep mine**. Tệp mới và các bản sao xung đột xuất hiện trong cây tệp, và một tệp bị xóa trên máy tính khác sẽ đóng ở đây.

### Đổi tên và tên tệp

Việc chỉ thay đổi chữ hoa chữ thường của tên tệp được tính là đổi tên, không phải xóa.

Oleafly bỏ qua các tệp sau và liệt kê chúng dưới hàng của dự án:

- Các tệp có tên không hoạt động trên mọi máy tính, chẳng hạn tên chứa `:` hoặc tên như `CON.tex`
- Các tệp có tên chỉ khác chữ hoa chữ thường so với một tên khác trong cùng thư mục. Tệp đã được đồng bộ rồi sẽ tiếp tục được đồng bộ.

Danh sách cũng hiển thị các tệp mà Oleafly không thể đọc ở đây, hoặc không thể tải xuống hay tải lên. Một tệp tải xuống thất bại sẽ được thử lại sau một giờ, hoặc sớm hơn nếu tệp thay đổi.
## Xóa tệp

Khi bạn xóa một tệp trên một máy tính, tệp đó cũng bị xóa trên các máy tính khác của bạn. Ở đó, tệp đi vào Thùng rác hoặc Thùng tái chế của hệ thống, hoặc vào thư mục thùng rác riêng của Oleafly nếu hệ thống không có. Bạn có thể lấy lại tệp từ đó.

Một bản ghi bị thiếu khỏi Dropbox không bao giờ xóa tệp trên máy tính. Nếu ai đó xóa thư mục của một dự án trong Dropbox bằng tay, Oleafly sẽ tải dự án lên lại. Nếu bản ghi của một dự án trong Dropbox thiếu `project.json`, Oleafly tải tệp đó lên lại thay vì xóa nó.

### Bảo vệ trước việc xóa nhiều tệp

Nếu hơn một nửa số tệp của một dự án bị xóa cùng lúc trên một máy tính, và số đó nhiều hơn 20 tệp, Oleafly sẽ không truyền việc xóa đó đi. Điều tương tự xảy ra nếu mọi tệp trong dự án đều bị xóa. Di chuyển hoặc đổi tên một thư mục không bị tính, vì các tệp vẫn còn tồn tại. Dự án hiển thị "Paused to protect your files" với hai lựa chọn:

- **Put them back** khôi phục các tệp từ Dropbox.
- **Delete from Dropbox too** cũng xóa chúng khỏi Dropbox, sau khi bạn xác nhận. Các máy tính khác của bạn khi đó cũng mất chúng.

Cơ chế kiểm tra này cũng hoạt động theo chiều ngược lại. Nếu nhiều tệp đột nhiên biến mất khỏi bản ghi của một dự án trong Dropbox, chẳng hạn vì bản ghi được khôi phục từ một phiên bản cũ hơn, Oleafly sẽ không xóa chúng trên máy tính này. Dự án hiển thị "Paused to protect your files" với hai lựa chọn:

- **Put them back in Dropbox** tải các tệp từ máy tính này lên lại.
- **Delete here too** chuyển chúng vào thùng rác của máy tính này, sau khi bạn xác nhận.

## Danh sách Projects

Mỗi dự án trong thư viện của bạn có một hàng hiển thị kích thước và lần đồng bộ gần nhất của nó.

- Công tắc của hàng đó đồng bộ dự án trên máy tính này hoặc tạm dừng nó tại đây.
- Một dự án chỉ nằm trong Dropbox có một nút tải xuống. **Download all** tải xuống tất cả chúng, trừ các dự án đang nằm trong Thùng tái chế của máy tính này. Dự án đã tải xuống xuất hiện trong thư viện của bạn.
- Nếu dự án đang nằm trong Thùng tái chế của máy tính này, việc tải xuống sẽ khôi phục nó từ Thùng tái chế thay vì tạo một bản sao thứ hai. Lần đồng bộ tiếp theo sẽ đưa vào các thay đổi được thực hiện ở nơi khác.
- Một dự án tải xuống từ Dropbox sẽ mở trong chế độ hạn chế cho đến khi bạn tin tưởng nó trên máy tính đó. Bạn nhận được cùng lời nhắc tin tưởng như với [thư mục mở tại chỗ](/docs/library/#folders-opened-in-place).

### Xóa một dự án khỏi Dropbox

Để giải phóng dung lượng, chọn **Remove from Dropbox** trong menu **…** trên hàng của một dự án. Thao tác này xóa bản sao của dự án trong Dropbox. Dự án vẫn ở lại máy tính này và ngừng đồng bộ tại đây. Các máy tính khác của bạn giữ các bản sao của chúng và hiển thị "Removed from Dropbox on" theo sau là tên máy tính này.

Bật lại công tắc của dự án để tải nó lên lại.

Các dự án chỉ nằm trong Dropbox cũng có **Remove from Dropbox** trong menu của chúng. Thao tác này xóa chúng khỏi Dropbox của bạn, nên sau đó bạn không thể tải chúng xuống trên máy tính này. Các máy tính đã có chúng vẫn giữ các bản sao của mình.

Nếu Dropbox không thể xóa thư mục ngay lập tức, dự án vẫn hiển thị là đã xóa, và Oleafly sẽ hoàn tất việc xóa trong một lần đồng bộ sau.

## Dung lượng và Dropbox bị đầy

Vòng tròn trên thẻ Cloud sync cho biết Dropbox của bạn đã dùng bao nhiêu, và có màu đỏ từ mức 80%. Tài khoản Dropbox Basic miễn phí có 2 GB.

Khi Dropbox của bạn đầy, việc tải lên dừng lại nhưng tải xuống vẫn hoạt động. Một banner thông báo cho bạn, và mỗi dự án không tải lên được cũng hiển thị thông tin đó. Trong lúc Dropbox còn đầy, Oleafly kiểm tra còn bao nhiêu dung lượng trống trước khi tải lên, nên nó không bao giờ gửi một tệp không đủ chỗ chứa. Để tạo dung lượng trống, hãy làm một trong các việc sau:

- Tắt đồng bộ cho các dự án lớn.
- Xóa các dự án khỏi Dropbox.
- Giải phóng dung lượng trong Dropbox.

Đồng bộ tự tiếp tục khi có dung lượng.

## Ngoại tuyến và đồng bộ bị gián đoạn

Khi bạn ngoại tuyến, các chỉnh sửa của bạn vẫn nằm trên máy tính và không có gì bị mất. Đồng bộ tiếp tục khi kết nối trở lại.

Nếu một vòng dừng giữa chừng, chẳng hạn vì mạng bị ngắt hoặc bạn đóng Oleafly, vòng tiếp theo sẽ hoàn tất công việc. Một bản sao lưu đầu tiên dài sẽ lưu tiến độ mỗi 200 tệp hoặc 256 MB, nên nó không phải bắt đầu lại từ đầu. Việc tắt **Sync on this computer** sẽ dừng vòng đang chạy.

Khi một lệnh Git đang thay đổi các tệp của dự án, chẳng hạn checkout hoặc pull trong terminal, vòng sẽ chờ và thử lại vào lần sau. Trên Windows, một tệp đang được chương trình khác mở sẽ được thử lại sau vài phút.

Khi Dropbox yêu cầu Oleafly chậm lại, hoặc gặp một lỗi tạm thời, Oleafly tự thử lại.

Nếu máy tính này sắp hết dung lượng đĩa, việc tải xuống sẽ chờ cho đến khi bạn giải phóng thêm dung lượng. Việc tải lên vẫn tiếp tục.

## Đồng bộ cài đặt

Lần đầu tiên một máy tính kết nối, Oleafly so sánh cài đặt của máy đó với cài đặt trong Dropbox của bạn. Nếu chúng khác nhau, Oleafly hỏi một lần: "Which settings should Oleafly use?" Chọn **Use Dropbox settings** hoặc **Keep this computer's settings**. Nếu bạn đóng hộp thoại, nó sẽ không tự xuất hiện lại. Cùng hai lựa chọn đó vẫn chờ trên thẻ Cloud sync, và không có gì bị ghi đè cho đến khi bạn chọn một.

Sau đó, cài đặt tự hợp nhất:

- Các thay đổi lên các cài đặt khác nhau trên các máy tính khác nhau đều được giữ lại.
- Nếu cùng một cài đặt thay đổi trên cả hai, giá trị của máy tính này thắng.
- Các danh sách, chẳng hạn các từ trong từ điển của bạn, được gộp lại với nhau. Các persona AI được hợp nhất từng cái một, nên một persona được chỉnh sửa trên hai máy tính vẫn chỉ là một persona.

Để tự tải cài đặt từ Dropbox, mở **Settings → General → Import** và chọn **Import from cloud**. Bạn sẽ nhận được cùng bước xem lại như khi nhập một tệp cài đặt.

## Máy tính và tài khoản

### Đặt tên cho máy tính này

Mỗi máy tính có một tên. Ban đầu nó là tên máy (host name) của máy tính. Bấm vào tên trên thẻ Cloud sync để thay đổi nó. Các máy tính khác của bạn hiển thị tên đó trên các bản sao xung đột và trên các ghi chú "Removed from Dropbox".

### Ngắt kết nối

Mở **Advanced**, chọn **Disconnect** và xác nhận. Đồng bộ dừng trên máy tính này và quyền truy cập của Oleafly vào Dropbox của bạn bị thu hồi. Các dự án của bạn vẫn ở lại máy tính này và trong Dropbox của bạn. Nếu lúc đó Oleafly không kết nối được với Dropbox, nó vẫn ngắt kết nối tại máy này và cho bạn biết, và bạn có thể tự xóa Oleafly khỏi các ứng dụng đã kết nối của Dropbox.

### Chuyển sang tài khoản Dropbox khác

Kết nối một tài khoản Dropbox khác sẽ bắt đầu lại từ đầu. Không có gì được so sánh với tài khoản cũ, và không có gì bị xóa vì điều đó.

### Khi quyền truy cập kết thúc

Nếu quyền truy cập của Oleafly kết thúc, chẳng hạn vì bạn đã xóa Oleafly khỏi các ứng dụng đã kết nối của Dropbox, thẻ sẽ hiển thị "Dropbox access ended. Connect again to keep syncing." Chọn **Connect again**.

### Một Oleafly mới hơn trên máy tính khác

Nếu một máy tính khác chạy phiên bản Oleafly mới hơn đã lưu một dự án ở định dạng mới hơn, các phiên bản cũ hơn sẽ dừng đồng bộ dự án đó và yêu cầu bạn [cập nhật Oleafly](/docs/updates/).

## Các kiểm tra an toàn

- Mọi tệp từ Dropbox đều được kiểm tra với dấu vân tay đã ghi lại của nó trước khi thay thế bất cứ thứ gì.
- Không có gì từ Dropbox được ghi vào `.git`, ra ngoài thư mục dự án, hoặc thông qua một liên kết tượng trưng.
- Tệp `project.json` từ Dropbox mà phiên bản Oleafly này không mở được sẽ không bao giờ thay thế tệp trên máy tính này.
- Một dự án bạn đã tin tưởng cho chạy lệnh shell khi biên dịch sẽ hỏi lại trước lần biên dịch tiếp theo sau khi có tệp từ Dropbox về, giống như sau một lần Git pull.
- Oleafly coi mọi thứ trong `Apps/Oleafly` là không đáng tin cậy và kiểm tra nó.
- Oleafly không thêm mã hóa đầu cuối vào các tệp của bạn trong Dropbox. Chúng được lưu trong Dropbox của bạn như bất kỳ tệp nào khác.

## Khắc phục sự cố

| Thông báo hoặc triệu chứng | Cách xử lý |
| --- | --- |
| Trình duyệt không chuyển lại được về Oleafly | Chọn **Trouble signing in? Paste a code instead** và dán mã mà Dropbox hiển thị. |
| "Dropbox access ended. Connect again to keep syncing." | Chọn **Connect again** và phê duyệt Oleafly trong trình duyệt của bạn. |
| "Which settings should Oleafly use?" | Chọn **Use Dropbox settings** hoặc **Keep this computer's settings**. Đóng hộp thoại để quyết định sau trên thẻ Cloud sync. Không có gì bị ghi đè. |
| "Paused to protect your files" | Nhiều tệp đã bị xóa cùng lúc, tại máy này hoặc trong Dropbox. Chọn **Put them back** hoặc **Put them back in Dropbox** để giữ chúng, hoặc **Delete from Dropbox too** hoặc **Delete here too** nếu chúng cần bị xóa. |
| Một tệp như `ch1 (Laptop 2026-10-14).tex` xuất hiện | Đó là bản sao xung đột từ máy tính được nêu trong tên tệp. So sánh hai tệp, giữ lại những gì bạn muốn và xóa tệp còn lại. |
| Hàng của một dự án báo có tệp bị bỏ qua | Mở danh sách để xem từng tệp và lý do. Đổi tên các tệp có tên không hoạt động trên mọi máy tính hoặc xung đột với một tên khác. |
| Một chấm màu hổ phách trên nút Settings | Đồng bộ hóa đám mây cần bạn chú ý. Mở Settings và đọc thẻ Cloud sync. |
| "Oleafly can't read the copy in your Dropbox, so this project isn't syncing." | Chọn **Replace with this computer's copy**. Bất cứ thứ gì chỉ có trong bản sao Dropbox sẽ bị mất, nên hãy kiểm tra các máy tính khác của bạn trước. |
| "Oleafly can't read the settings in your Dropbox." | Chọn **Use this computer's settings** để thay thế chúng. |
| "This computer is running out of disk space." | Giải phóng dung lượng đĩa. Đồng bộ sẽ tự tiếp tục. |
| "This project has more than 100,000 files. That's too many to sync." | Di chuyển các tệp mà dự án không cần ra khỏi thư mục của nó. |
| "Removed from Dropbox on" kèm tên của một máy tính | Máy tính đó đã xóa dự án khỏi Dropbox. Bản sao của bạn tại đây vẫn an toàn. Bật công tắc của dự án để tải nó lên lại. |
| "Your Dropbox is full." | Tắt đồng bộ cho các dự án lớn, xóa các dự án khỏi Dropbox, hoặc giải phóng dung lượng trong Dropbox. Tải xuống vẫn hoạt động, và đồng bộ tiếp tục khi có dung lượng. |
| "Your Dropbox has reached its upload limit for this month." | Dropbox giới hạn lượng dữ liệu mà một số tài khoản được tải lên mỗi tháng. Các thay đổi của bạn vẫn nằm trên máy tính này và sẽ được tải lên khi Dropbox cho phép trở lại. |
| "Couldn't reach Dropbox. Oleafly will try again." | Kiểm tra kết nối của bạn. Các chỉnh sửa của bạn vẫn nằm trên máy tính này, và Oleafly sẽ đồng bộ khi bạn trực tuyến trở lại. |
| "This project was synced by a newer version of Oleafly. Update Oleafly to keep syncing it." | [Cập nhật Oleafly](/docs/updates/) trên máy tính này. |
| Một dự án đã tải xuống mở trong chế độ hạn chế | Hãy tin tưởng nó trên máy tính này khi bạn đã biết trong đó có gì. |
| Không có gì được đồng bộ | Kiểm tra rằng **Sync on this computer** đang bật và công tắc của dự án đang bật. Oleafly chỉ đồng bộ khi nó đang mở. Nếu **Sync automatically** đang tắt, hãy chọn **Sync now**. |

Muốn di chuyển dự án bằng Git thay thế? Xem [Đồng bộ GitHub](/docs/github-sync/). Để biết mọi thứ Oleafly giữ trên máy tính của bạn, xem [Các tệp và dữ liệu của bạn](/docs/where-your-data-lives/).
