クラウド版とローカルキャッシュ

データ・同期・アカウント

クラウド版とローカルキャッシュ

マスターデータの所在、保存とアップロードの順序、画像のクラウド保存、未ログイン時に利用可能な機能を解説します。

正本(マスター)とキャッシュの役割

通常の無料アカウントのプロジェクトは端末内に保存され、ログインだけではアップロードされません。3つの有料プランはいずれも有効期間中のクラウドプロジェクト数が無制限です。有効なサブスクリプションまたは記録済みの Global 旧利用権があれば、作成・インポート・開いた現在のプロジェクトで同期が自動的に始まり、本文・画像・付随記録を完全にアップロードします。端末のローカルコピーは保持され、開いていない他のプロジェクトは走査・アップロードしません。ブラウザ版は現在のブラウザの IndexedDB、デスクトップ版はローカルフォルダと SQLite を使用します。プロジェクト数の無制限は保存容量の無制限を意味せず、ファイルとアップロードのサイズ制限はあります。

クラウド連携されたプロジェクトを開く際、以下の検証シーケンスが実行されます:

  • まずプロジェクト一覧のサマリー情報とバージョンを比較します。クラウド側に更新がなく、ローカルにも保留中の変更がない場合は、全量ダウンロードを行わず即座に執筆を開始できます。
  • クラウドの方が新しく、ローカルに未保存の変更がない場合:最新データを全量プルしてローカルキャッシュを上書きします。デスクトップ版では設計ファイルとメモリ上の派生データも同期して再構築されます。
  • ローカルに未送信の変更が存在し(350msのデバウンス待機中を含む)、同時にクラウド側のバージョンも進んでいた場合:並行編集による競合と判定され、双方のデータを保護する競合コピー処理が行われます。

自動同期とプロジェクト内 AI の事前バージョン確認は現在のブラウザ版の動作です。デスクトップ版では対応クライアントが必要で、旧版の動作は異なる場合があります。

ローカル保存とクラウド同期の順序

編集はネットワークを待たずに、まずローカルへ保存されます。有効なクラウド利用権があれば、保存後の変更をまとめてバックグラウンドでアップロードします。キー入力ごとの即時送信ではありません。通信障害でローカル保存が取り消されることはなく、利用権が有効なら再接続時に最新稿で再試行します。期限切れや利用権確認の失敗時はアップロードを一時停止し、ローカル執筆は続けられます。

  • 保存通知は「ローカルに保存済み」と「クラウドに同期済み」を区別します。ローカル保存の成功はアップロード完了を意味しません。通常の保存やバックグラウンド同期では通知を繰り返さず、エラーや復旧時に別途知らせます。
  • 開いている連携プロジェクトは、ウィンドウのフォーカス復帰時および60秒間隔のハートビートによって自動照合されます。バックグラウンドのタブではタイマーが停止し、別プロジェクトへの切り替えやプロジェクトを閉じた際も即座に停止します。ハートビートによって入力中の原稿がカーソルの下で勝手にすり替わることはありません。
  • プロジェクト内の対話の各ターン、単発スキル、リライト、画像処理、インポート解析、自動保守は、クラウド利用権と最新のローカル内容の同期完了を先に確認します。オフライン・競合・同期失敗時はその AI タスクを停止します。クレジットパックだけではクラウド利用権は付与されません。プロジェクト作成前の開始フローと料金見積もりのみの処理は別扱いです。

画像データのアップロード仕様

クラウドへの送信時、本文やカード内の長いDataURL画像はコンテンツハッシュに基づく独立したBlobデータへ自動分離されます。クラウド全体で同一画像は1件のみ保存・アップロードされ、プロジェクトJSON内には軽量な参照キーのみが保持されます。プロジェクトを開く際や同期照合時には、これらの参照から画像を復元したうえでローカルキャッシュへ渡します。初回のクラウド作成時も同じ手順を踏みます。画像のアップロードが完了しなかった場合、作成途中だったクラウドプロジェクトは自動的にゴミ箱へ移動され、中途半端な不完全プロジェクトが残るのを防ぎます。

  • 何らかの理由で画像が取得できなかった参照データは、同期エラーのタグを付与したうえで本文内にそのまま維持されます。画像を勝手に削除することはありません。
  • 単体で20MBを超える生バイナリ画像、または画像分離後もドラフトサイズが32MBを超える場合はエラーとして記録され、無駄なアップロードのループを防止します。該当する画像は事前に圧縮または分割してください。

未ログインおよびオフライン時の挙動

未ログイン時のプロジェクトと通常の無料アカウントのプロジェクトは、自動でアップロードされません。ブラウザ版のプロジェクトは現在のブラウザのストレージに依存しており、サイトデータを消去するとローカルのみのプロジェクトや未アップロードの編集は失われます。ブラウザや端末を変更する前に、プロジェクトパックをエクスポートしてください。デスクトップ版はローカルのプロジェクトフォルダを使用しており、フォルダをコピーしてバックアップできます。

オフライン中の執筆はローカルに保存され、クラウドの利用権が有効な間は再接続時にアップロードされます。利用権が切れても既存の作品は削除されません。ローカルでの編集・保存・エクスポートは引き続き行え、既存のクラウドプロジェクトも閲覧・エクスポート・削除が可能です。サブスクリプションを更新すると、同期を再開する前に双方のバージョンを照合します。クラウドプロジェクトが削除された場合はローカルの連携リンクが解除されますが、作品そのものは端末に残ります。

制限事項とトラブルシューティング

  • 本システムの同期はプロジェクト全体の完全バージョン照合を採用しており、フィールド単位の3方向自動マージは行いません。そのため競合が発生した際も勝手な統合を行わず、双方のバージョンを確実に個別保存します。
  • 同期エラーが発生した場合は、ブラウザのタブとローカルプロジェクトをそのまま保持し、ブラウザデータを消去しないでください。再試行に失敗した場合も「Sync failed」の理由が明示されます。
  • 端末を切り替える前に現在のプロジェクトの同期完了を確認し、同じアカウントでクラウド版を開いてください。ローカル専用プロジェクトや未送信の変更は先に .quill.json をエクスポートし、ブラウザ内部ストレージのコピーで移行しないでください。

競合発生時の復旧手順は 競合コピー、バックアップとデータ移行は プロジェクトパックのエクスポートとインポート を参照してください。