ファイルをリモートワークスペースに転送し、Agent に処理させてから結果を取り戻します。同期は差分方式——変更されたファイルのみ転送します。
## 仕組み
各同期セッションはリモートデバイス上の**ワークスペース**(Tai Link のデータルートディレクトリ、デフォルト `/data/volumes` 以下のディレクトリ)を対象にします。Yao は Agent がファイルへのアクセスを必要とするときにワークスペースを自動的に管理します。
同期プロトコルは gRPC で双方向に動作します:
- **プッシュ(Push)** — Yao がファイルマニフェストを送信し、Tai Link がローカルの状態と差分を比較して不足・変更ファイルのみ要求し、ディスクに書き込みます。
- **プル(Pull)** — Tai Link がワークスペースをスキャンし、Yao が提供するマニフェストと比較して、新規・変更ファイルをストリームで返送します。
ファイルは転送時に圧縮され 256 KB のチャンクに分割されるため、大規模プロジェクトでもメモリ使用量を抑えられます。
## ワークスペース
Tai Link パネルでデバイスを開き、**ワークスペース**をクリックするとアクティブなワークスペースを確認できます。

各ワークスペースカードに表示される情報:
- ワークスペース ID(通常は Agent セッションと一致)
- ファイル数と合計サイズ
- 最終同期日時
ワークスペースをクリックするとファイルの閲覧・ドキュメントのプレビュー・個別ファイルのダウンロードができます。

## 除外パターン
同期すべきでないファイルもあります——`node_modules`・`.git`・ビルド成果物など。`config.yml` で除外ルールを設定します:
```yaml
sync:
exclude:
- "node_modules"
- ".git"
- "__pycache__"
- "*.pyc"
```
除外ルールはそのデバイスのすべてのワークスペースに適用されます。
## 手動同期
Agent が自動的に同期を処理するため、手動でトリガーする必要はほとんどありません:
- **プッシュ**は、Agent がリモートデバイスのファイルを必要とする新しいタスクを開始するときに発生します。
- **プル**は、Agent が結果(レポート・ビルド成果物・エクスポートデータ)を取得するときに発生します。
ワークスペース詳細で同期ステータス(「同期中...」または「最新」)を確認できます。

## 次のステップ
- [リモートデスクトップ](/docs/ja-jp/tai-link/remote-desktop) — リモートの画面を確認・操作する
- [セキュリティとプライバシー](/docs/ja-jp/tai-link/security-and-privacy) — データがデバイス上に留まる仕組み