# Dropbox とのクラウド同期

ライブラリのプロジェクトと設定を自分の Dropbox にバックアップし、別のコンピュータで開きます。同期の対象、競合と削除の扱い、各メッセージの意味を説明します。

クラウド同期は、ライブラリのプロジェクトと設定のコピーを、あなた自身の Dropbox に保ちます。別のコンピュータで同じ Dropbox に接続してプロジェクトをダウンロードすれば、2 台のコンピュータでプロジェクトが同期された状態に保たれます。

**設定 → データの保存 → クラウド同期**を開いて、設定します。

## 始める前に

- Dropbox アカウントが必要です。無料の Dropbox Basic アカウントの容量は 2 GB です。
- クラウド同期は macOS、Windows、Linux で動作します。
- Oleafly が同期するのは、開いている間だけです。最小化されている間や、ウィンドウが隠れている間も含みます。Oleafly を閉じている間は、何も同期されません。
- Oleafly は Dropbox と直接やり取りします。間に Oleafly のサーバーはありません。

## Dropbox を接続する

1. **設定 → データの保存 → クラウド同期**を開き、 **Dropbox を接続**を選びます。
2. ブラウザで Dropbox のサインインと承認のページが開きます。そこでサインインし、Oleafly を承認します。
3. Oleafly が接続を完了すると、ブラウザに「接続されました」と表示されます。承認のあとで問題が起きた場合は、ブラウザにサインインが完了しなかったと表示され、Oleafly が何が起きたかを知らせます。

サインインは Dropbox 自身のページで行うので、Oleafly があなたの Dropbox のパスワードを目にすることはありません。

### ブラウザから Oleafly に戻れない場合

承認すると、Dropbox はブラウザを、お使いのコンピュータ上のローカルアドレス (127.0.0.1) に移動させ、Oleafly はそこからサインインを受け取ります。うまくいかない場合は、 **サインインできませんか？ コードを貼り付けてください**を選びます。Dropbox にコードが表示されます。それをコピーして Oleafly に貼り付けます。

### Oleafly がアクセスできるもの

- Oleafly が開けるのは、Dropbox 内の Oleafly 専用のアプリフォルダ `Apps/Oleafly` だけです。Dropbox のそれ以外のファイルは一切見えません。
- Oleafly が Dropbox に求める権限は 4 つだけで、それ以外は求めません。`account_info.read` で、メールアドレスと使用済みの容量を表示します。`files.metadata.read`、`files.content.read`、`files.content.write` で、専用フォルダ内のファイルの一覧表示、読み取り、書き込みを行います。
- サインインには、PKCE 付きの OAuth を使います。
- macOS と Windows では、サインインのトークンは OS のキーチェーンに保存されます。Linux、またはキーチェーンを使えない場合は、Oleafly のデータフォルダ内の暗号化されたファイルに保存されます。
- トークンが同期されることはありません。各コンピュータは、それぞれ個別に接続します。

### クラウド同期のカード

接続すると、カードに次の内容が表示されます。

- Dropbox アカウントのメールアドレス。
- Dropbox の使用量を示すリング。Dropbox がいっぱいに近づくにつれて、緑から黄色、オレンジ、赤へと変わり、80% からは赤になります。
- **このコンピューターで同期**。このコンピュータでの同期をオンまたはオフにするスイッチです。
- **自動で同期**。Oleafly が自動で同期するかどうかを切り替えるスイッチです。
- このコンピュータの名前。クリックすると名前を変更できます。
- **プロジェクト**の一覧。
- **詳細設定**。 **接続を解除**があります。

## 同期されるもの

### プロジェクト

ライブラリのすべてのプロジェクトが、そのファイルとともに同期されます。メイン文書をコンパイルするフォルダも含まれます。次のものは、どのプロジェクトでも、通知なしに対象から外されます。

- `.aux` や `.log` ファイル、コンパイルしたメインの PDF などのビルド出力。Git で追跡している結果のログなどのビルドファイルは、引き続き Dropbox にバックアップされます。
- Python の `__pycache__` フォルダ
- `.git` フォルダ
- Oleafly 自身の作業フォルダ
- エディタの一時ファイル
- `.DS_Store` などのシステムファイル

ほかにも同期されないものがいくつかあり、プロジェクトの行に、スキップされたものとして理由とともに一覧表示されます。シンボリックリンク、`node_modules` と `.venv` フォルダ、16 GB を超えるファイル、そして[すべてのコンピュータで使えるわけではない名前](#renames-and-file-names)のファイルです。

コンピュータ上のほかの場所にあるフォルダから開いたプロジェクト ([その場で開いたフォルダ](/docs/library/#folders-opened-in-place)) は同期されません。プロジェクトの一覧に、その数が表示されます。

Git の履歴と[チェックポイント](/docs/checkpoints/)は同期されません。

### プロジェクトの詳細

各プロジェクトの `project.json` も同期されるので、名前、メイン文書、エンジン、カバーの色などの詳細もプロジェクトとともに移ります。一部の詳細は 1 台のコンピュータに属し、そこに残ります。

- 書き出し先のパス
- プロジェクトが非表示かどうか
- TeX パッケージの指定
- チェックポイントの取得ポリシー
- フォーク元のプロジェクト

### ノート

個人の[ノート](/docs/notes/)は、ライブラリのプロジェクトと同じように同期され、プロジェクトの中のノートは、そのプロジェクトのファイルと一緒に同期されます。個人のノートが 2 台のコンピュータで変更された場合は、もう一方のコンピュータのバージョンが、`note (Laptop 2026-10-14).md` のような競合コピーとして、ノートのフォルダに保存され、ノートのメニューの**競合コピーと比較**で、どちらかのバージョンを残せます。プロジェクトの中のノートの競合コピーは、ほかのプロジェクトのファイルと同じように、プロジェクトの `notes` フォルダのノートの隣に作られます。

### 設定

アプリの設定は同期されます。AI の指示、AI のペルソナ、カスタム辞書も含まれます。一部の設定は、コンピュータごとに残ります。たとえば、**自動で同期**がオンかどうか、LaTeX の**既定のコンパイルエンジン**、ターミナルの **Shell** と **Shell のパス**、連携の **Computer Use**、実験的な機能の**研究タスク**のスイッチ、研究の**タスクのコマンドに既定でネットワークを許可する**です。そのため、別のコンピュータでオンにしたからといって、このコンピュータでエージェントがデスクトップアプリを使えるようになることはありません。また、TeX をインストールしていないコンピュータは、別のコンピュータが latexmk を使っていても、Tectonic のままです。

AI のチャット、パスワード、API キー、そのほかの秘密情報は同期されません。

## Dropbox の中身

すべて `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
```

プロジェクトのファイルは元の名前のままなので、Dropbox から開けます。`Apps/Oleafly` 内のファイルを手で編集したり移動したりすることは、サポートされていません。Oleafly は、そのフォルダ内のすべてを信頼せず、確認します。

## 同期の 1 回分の流れ

各回は、同じ手順で進みます。

1. Oleafly が Dropbox に、前回以降に変更されたプロジェクトを尋ねます。何も変わっていなければ、リクエストは 1 回で済みます。
2. このコンピュータ上の各プロジェクトのファイルをスキャンします。変更のないファイルは、読み直さずに素早く見分けます。
3. ファイルごとに、3 つの版を比べます。このコンピュータの版、Dropbox の版、両者が最後に一致した版です。これで、どちら側が変更されたかがわかります。
4. ほかのコンピュータからの変更を一時的な場所にダウンロードし、各ファイルを、記録されているフィンガープリント (ハッシュ) と照合します。その後で初めて、ファイルがプロジェクトに入ります。スキャンのあとにこのコンピュータでそのファイルを変更した場合、Oleafly は次の回までそのファイルに手を付けません。
5. このコンピュータからの変更をアップロードし、Dropbox 側のチェックサムと、送った内容を照合します。
6. プロジェクトのバージョン記録を保存します。その間にほかのコンピュータが保存していないかも確認します。保存していた場合は、新しいほうの記録でもう一度同期の回を実行するので、どちらのコンピュータの作業も失われません。
7. 最後に、このコンピュータで削除したファイルを Dropbox から削除します。

## 同期のタイミング

**自動で同期**は、オフにしない限りオンです。オンの間は、ファイルを保存した数秒後と、別のコンピュータが Dropbox を変更した直後に、Oleafly が同期します。それ以外の間は、5 分ごと、Oleafly のウィンドウが隠れている間は 15 分ごとに確認します。最初の回は、Oleafly の起動から約 20 秒後に実行され、設定の変更は、変更から約 3 秒後に同期されます。**自動で同期**をオフにすると、**今すぐ同期**を選んだときと、接続したとき、**このコンピューターで同期**をオンに戻したとき、プロジェクトのスイッチをオンに戻したときに 1 回、Oleafly が同期します。

たとえばオフラインなどで回が失敗すると、Oleafly は 30 秒後に再試行し、失敗するたびに待ち時間を延ばして、最長 5 分（ウィンドウが隠れている間は 15 分）まで待ちます。回が成功すれば、通常のスケジュールに戻ります。コンピュータがオンラインに戻ったときにも同期します。

**今すぐ同期**は、回をすぐに実行し、結果を 1 つのメッセージで表示します。自動の回では、ポップアップは表示されません。状態はプロジェクトのセクションに、時刻付きの「最終同期」、「プロジェクトを同期しています」、または問題を説明する 1 行として表示されます。

Dropbox がいっぱい、プロジェクトの一時停止、競合コピー、設定の選択など、対応が必要なことがあると、設定ボタンに小さなアンバー色の点が表示されます。そのとき設定は「クラウド同期」で開くので、何が問題かを最初に確認できます。

## 競合

同期と同期の間に、同じファイルが 2 台のコンピュータで変更された場合、Oleafly は両方の版を残します。このコンピュータの版は元の名前のままです。もう一方のコンピュータの版は、その隣に、書き込んだコンピュータの名前と日付を付けた名前で保存されます (たとえば `ch1 (Laptop 2026-10-14).tex`)。同じ日に 2 回目の競合が起きると、名前に番号が付きます。競合コピーは、 **閉じる**を選ぶまで、プロジェクトの行に一覧表示されます。

両方のファイルを開き、残したい内容を残して、不要なコピーを削除します。

`project.json` に競合コピーが作られることはありません。代わりに、フィールドがマージされます。各コンピュータの変更が残り、両方のコンピュータが同じフィールドを変更した場合は、このコンピュータの値が優先されます。

### 未保存の編集は安全です

エディタで開いていて未保存の変更があるファイルを、同期が上書きすることはありません。ほかのコンピュータからの変更は待機します。保存すると、次の回ではその編集がほかの編集と同じように扱われるので、両側でファイルが変更されていた場合は、競合コピーができます。

開いていて、まだ変更していないファイルは、ほかのコンピュータからの変更が届くとすぐに、エディタ上で更新されます。編集中に変更が届いた場合は、エディタに、ファイルがディスク上で変更されたと表示されるので、 **再読み込み**か**自分の版を残す**を選びます。新しいファイルと競合コピーはファイルツリーに表示され、ほかのコンピュータで削除されたファイルは、こちらでも閉じられます。

### 名前の変更とファイル名

ファイル名の大文字と小文字だけを変えた場合は、削除ではなく名前の変更として扱われます。

Oleafly は次のファイルをスキップし、プロジェクトの行の下に一覧表示します。

- すべてのコンピュータで使えるわけではない名前のファイル。たとえば `:` を含む名前や、`CON.tex` のような名前
- 同じフォルダ内の別の名前と、大文字と小文字しか違わない名前のファイル。すでに同期されているファイルは、そのまま同期され続けます。

一覧には、Oleafly がここで読み取れなかったファイルや、ダウンロードまたはアップロードできなかったファイルも表示されます。ダウンロードに失敗したファイルは、1 時間後に再試行されます。ファイルが変更された場合は、それより早く再試行されます。

## ファイルの削除

1 台のコンピュータでファイルを削除すると、ほかのコンピュータでも削除されます。ほかのコンピュータでは、ファイルはシステムのごみ箱に移動します。システムにごみ箱がない場合は、Oleafly 専用のごみ箱フォルダに移動します。そこから元に戻せます。

Dropbox から記録が見つからなくなっても、コンピュータ上のファイルが削除されることはありません。誰かが Dropbox 内のプロジェクトのフォルダを手で削除した場合、Oleafly はそのプロジェクトをもう一度アップロードします。Dropbox 側のプロジェクトの記録に `project.json` がない場合、Oleafly はそのファイルを削除せず、もう一度アップロードします。

### 大量のファイル削除に対する保護

1 台のコンピュータで、プロジェクトのファイルの半分を超える数が一度に削除され、しかもその数が 20 件を超える場合、Oleafly は削除を反映しません。プロジェクトのすべてのファイルが削除された場合も同じです。フォルダの移動や名前の変更は、ファイルが残っているので対象になりません。プロジェクトに「ファイルを守るため一時停止しました」と表示され、2 つの選択肢が示されます。

- **ファイルを戻す**を選ぶと、Dropbox からファイルが復元されます。
- **Dropbox からも削除**を選び、確認すると、Dropbox からも削除されます。そのあと、ほかのコンピュータからもファイルがなくなります。

同じ確認は逆向きにも働きます。たとえば記録が古いバージョンから復元された場合など、プロジェクトの Dropbox 上の記録から多数のファイルが突然なくなると、Oleafly はこのコンピュータ上のそれらのファイルを削除しません。プロジェクトに「ファイルを守るため一時停止しました」と表示され、2 つの選択肢が示されます。

- **Dropbox に戻す**を選ぶと、このコンピュータのファイルがもう一度アップロードされます。
- **ここでも削除**を選び、確認すると、それらのファイルがこのコンピュータのごみ箱に移動します。

## プロジェクトの一覧

ライブラリの各プロジェクトには行があり、サイズと最終同期の時刻が表示されます。

- 行のスイッチで、このコンピュータでのプロジェクトの同期をオンにするか、一時停止します。
- Dropbox にしかないプロジェクトには、ダウンロードボタンがあります。 **すべてダウンロード**は、このコンピュータのごみ箱にあるプロジェクトを除く、そうしたプロジェクトすべてをダウンロードします。ダウンロードしたプロジェクトは、ライブラリに表示されます。
- プロジェクトがこのコンピュータのごみ箱にある場合は、ダウンロードすると 2 つ目のコピーを作る代わりに、ごみ箱から復元されます。次の同期で、ほかの場所で行われた変更が取り込まれます。
- Dropbox からダウンロードしたプロジェクトは、そのコンピュータで信頼するまで、制限モードで開きます。[その場で開いたフォルダ](/docs/library/#folders-opened-in-place)と同じ信頼の確認が表示されます。

### プロジェクトを Dropbox から削除する

容量を空けるには、プロジェクトの行の **…** メニューで **Dropbox から削除** を選びます。Dropbox にあるそのプロジェクトのコピーが削除されます。プロジェクトはこのコンピュータに残り、ここでの同期は止まります。ほかのコンピュータでは、コピーはそのまま残り、このコンピュータの名前とともに「Dropbox から削除されました」と表示されます。

プロジェクトのスイッチをもう一度オンにすると、再びアップロードされます。

Dropbox にしかないプロジェクトにも、メニューに **Dropbox から削除** があります。選ぶと Dropbox から削除されるので、そのあとこのコンピュータでダウンロードすることはできません。すでにそのプロジェクトを持っているコンピュータには、コピーが残ります。

Dropbox がフォルダをすぐに削除できない場合でも、プロジェクトは削除済みとして表示され、Oleafly は後の同期で削除を完了します。

## 容量と Dropbox がいっぱいの場合

クラウド同期のカードのリングは、Dropbox の使用量を示し、80% から赤になります。無料の Dropbox Basic アカウントの容量は 2 GB です。

Dropbox がいっぱいになると、アップロードは止まりますが、ダウンロードは引き続き動作します。バナーでお知らせし、アップロードできなかった各プロジェクトにも表示されます。いっぱいの間、Oleafly はアップロードの前に残りの容量を確認するので、収まらないファイルを送ることはありません。空きを作るには、次のいずれかを行います。

- 大きなプロジェクトの同期をオフにする。
- プロジェクトを Dropbox から削除する。
- Dropbox の容量を空ける。

空きができれば、同期は自動で再開します。

## オフラインと中断された同期

オフラインの間も、編集はお使いのコンピュータに残り、何も失われません。接続が戻ると、同期が再開します。

たとえばネットワークが切れた、Oleafly を閉じたなどで回が途中で止まった場合は、次の回が作業を完了させます。最初の長いバックアップでは、200 ファイルまたは 256 MB ごとに進捗が保存されるので、最初からやり直しにはなりません。 **このコンピューターで同期**をオフにすると、実行中の回は停止します。

Git コマンドがプロジェクトのファイルを変更している間は、たとえばターミナルでのチェックアウトやプルの最中は、その回は待機し、次の機会にもう一度試します。Windows では、ほかのプログラムが開いているファイルは、数分後にもう一度試されます。

Dropbox から速度を落とすよう求められた場合や、一時的なエラーが起きた場合は、Oleafly が自動でやり直します。

このコンピュータのディスクの空きが少なくなると、空きを作るまでダウンロードは待機します。アップロードは続きます。

## 設定の同期

コンピュータが初めて接続したとき、Oleafly はそのコンピュータの設定と、Dropbox にある設定を比べます。違いがある場合は、1 度だけ「Oleafly はどちらの設定を使いますか？」と尋ねます。 **Dropbox の設定を使用**か**このコンピュータの設定を保持**を選びます。ダイアログを閉じても、自動で再表示されることはありません。同じ 2 つの選択肢はクラウド同期のカードに残っていて、どちらかを選ぶまで、何も上書きされません。

その後は、設定が自動でマージされます。

- 別々のコンピュータで別々の設定に加えた変更は、すべて残ります。
- 同じ設定が両方で変更された場合は、このコンピュータの値が優先されます。
- 辞書の単語のようなリストは、統合されます。AI のペルソナは 1 つずつマージされるので、2 台のコンピュータで編集されたペルソナも 1 つのペルソナのままです。

Dropbox の設定を自分で読み込むには、 **設定 → 一般 → 読み込む**を開き、 **クラウドからインポート**を選びます。設定ファイルを読み込むときと同じ確認の手順が表示されます。

## コンピュータとアカウント

### このコンピュータに名前を付ける

各コンピュータには名前があります。最初はコンピュータのホスト名です。クラウド同期のカードで名前をクリックすると、変更できます。ほかのコンピュータでは、この名前が競合コピーと「Dropbox から削除」の通知に表示されます。

### 接続を解除する

**詳細設定**を開き、 **接続を解除**を選んで確認します。このコンピュータでの同期が止まり、Oleafly の Dropbox へのアクセスは取り消されます。プロジェクトは、このコンピュータにも Dropbox にも残ります。その時点で Oleafly が Dropbox に接続できない場合でも、このコンピュータでは接続が解除され、その旨が表示されます。Dropbox の連携アプリから Oleafly を自分で削除することもできます。

### 別の Dropbox アカウントに切り替える

別の Dropbox アカウントを接続すると、新しく始まります。以前のアカウントとは何も比較されず、そのために何かが削除されることもありません。

### アクセスが終了したとき

たとえば Dropbox の連携アプリから Oleafly を削除したなどで、Oleafly のアクセスが終了すると、カードに「Dropbox へのアクセスが終了しました。同期を続けるには、もう一度接続してください。」と表示されます。 **もう一度接続**を選びます。

### 別のコンピュータにある新しい Oleafly

別のコンピュータで新しいバージョンの Oleafly が動いていて、プロジェクトを新しい形式で保存した場合、古いバージョンはそのプロジェクトの同期を止め、[Oleafly を更新](/docs/updates/)するよう求めます。

## 安全のための確認

- Dropbox からのファイルは、何かを置き換える前に、記録されているフィンガープリントと照合されます。
- Dropbox からのものが、`.git` の中、プロジェクトフォルダの外、シンボリックリンク経由に書き込まれることはありません。
- このバージョンの Oleafly で開けない Dropbox からの `project.json` が、このコンピュータのものを置き換えることはありません。
- コンパイル時にシェルコマンドの実行を信頼したプロジェクトは、Dropbox からファイルが届くと、次のコンパイルの前にもう一度確認します。Git でプルしたあとと同じです。
- Oleafly は、`Apps/Oleafly` 内のすべてを信頼せず、確認します。
- Oleafly は、Dropbox 上のファイルにエンドツーエンド暗号化を追加しません。ほかのファイルと同じように、Dropbox に保存されます。

## トラブルシューティング

| メッセージまたは症状 | 対処 |
| --- | --- |
| ブラウザから Oleafly に戻らない | **サインインできませんか？ コードを貼り付けてください**を選び、Dropbox が表示するコードを貼り付けます。 |
| 「Dropbox へのアクセスが終了しました。同期を続けるには、もう一度接続してください。」 | **もう一度接続**を選び、ブラウザで Oleafly を承認します。 |
| 「Oleafly はどちらの設定を使いますか？」 | **Dropbox の設定を使用**か**このコンピュータの設定を保持**を選びます。あとでクラウド同期のカードで決めるには、ダイアログを閉じます。何も上書きされません。 |
| 「ファイルを守るため一時停止しました」 | 多数のファイルが、ここまたは Dropbox で一度に削除されました。残すには**ファイルを戻す**か **Dropbox に戻す**を、削除してよい場合は **Dropbox からも削除**か **ここでも削除**を選びます。 |
| `ch1 (Laptop 2026-10-14).tex` のようなファイルが現れた | 名前に付いているコンピュータからの競合コピーです。2 つのファイルを比べ、残したい内容を残して、もう一方を削除します。 |
| プロジェクトの行に、ファイルがスキップされたと表示される | 一覧を開いて、各ファイルとその理由を確認します。すべてのコンピュータで使えない名前や、ほかの名前とぶつかる名前のファイルは、名前を変更します。 |
| 設定ボタンのアンバー色の点 | クラウド同期の対応が必要です。設定を開き、クラウド同期のカードを読みます。 |
| 「Oleafly は Dropbox 上のコピーを読み取れないため、このプロジェクトは同期されていません。」 | **このコンピュータのコピーで置き換え**を選びます。Dropbox のコピーにしかない内容は失われるので、先にほかのコンピュータを確認してください。 |
| 「Oleafly は Dropbox 上の設定を読み取れません。」 | **このコンピュータの設定を使用**を選んで、置き換えます。 |
| 「このコンピュータのディスクの空きが少なくなっています。」 | ディスクの空きを作ります。同期は自動で再開します。 |
| 「このプロジェクトには 100,000 件を超えるファイルがあります。同期するには多すぎます。」 | プロジェクトに不要なファイルを、フォルダの外に移します。 |
| 「Dropbox から削除」とコンピュータの名前 | そのコンピュータがプロジェクトを Dropbox から削除しました。こちらのコピーは無事です。プロジェクトのスイッチをオンにすると、再びアップロードされます。 |
| 「Dropbox がいっぱいです。」 | 大きなプロジェクトの同期をオフにする、プロジェクトを Dropbox から削除する、または Dropbox の容量を空けます。ダウンロードは引き続き動作し、空きができれば同期が再開します。 |
| 「Dropbox の今月のアップロード上限に達しました。」 | Dropbox は、一部のアカウントについて、月ごとのアップロード量に上限を設けています。編集はこのコンピュータに残り、Dropbox が再び許可すればアップロードされます。 |
| 「Dropbox に接続できませんでした。Oleafly がもう一度試します。」 | 接続を確認します。編集はこのコンピュータに残り、オンラインに戻れば Oleafly が同期します。 |
| 「このプロジェクトは、新しいバージョンの Oleafly で同期されました。同期を続けるには Oleafly を更新してください。」 | このコンピュータで [Oleafly を更新](/docs/updates/)します。 |
| ダウンロードしたプロジェクトが制限モードで開く | 中身を確認できたら、このコンピュータで信頼します。 |
| 何も同期されない | **このコンピューターで同期**がオンになっていること、プロジェクトのスイッチがオンになっていることを確認します。Oleafly が同期するのは、開いている間だけです。 **自動で同期**がオフの場合は、 **今すぐ同期**を選びます。 |

代わりに Git でプロジェクトを移したい場合は、[GitHub 同期](/docs/github-sync/)をご覧ください。Oleafly がコンピュータ上に保持するすべてのものについては、[ファイルとデータ](/docs/where-your-data-lives/)をご覧ください。
