同期

書いたものは、最初から暗号化された workspace に入ります。手元のファイルをあとからクラウドへ写す「バックアップ」ではなく、workspace が唯一の保管先です。同じ workspace にサインインしていれば、どの端末やブラウザからでも同じ中身が開きます。

workspace に入るもの

アプリが扱うものは、ひととおり workspace の中にあります。

中身	workspace の中の場所
書きかけの note	`inbox/`
アーカイブした note	`archives/`
pin	`pins/`
設定	`.zudotext.settings.json`
frontmatter のスキーマと skill	`.zudotext/`

画像や添付ファイルは、これとは別の暗号化された領域に置かれます。入れかたと使いかたは画像・添付ファイルで扱います。

手元のディスクにあるファイルを直接開いて書き換える画面だけは例外で、そのファイルは workspace に取り込まれません。この扱いは外部ファイルの編集にまとめています。

端末をまたぐ設定

配色、エディタの設定、ショートカット、pin、画面の分けかたは、すべて設定として workspace の中にあります。ある端末で変えれば、同じ workspace を開いた別の端末でも同じ状態になります。

設定は 1 つのファイルとしてまとめて送られます。2 台で同時に別々の項目を変えると、あとから保存したほうが丸ごと残り、もう一方の変更は消えます。設定が書き込まれるのは設定の画面を開いているあいだだけなので、実際に困ることはまれです。端末ごとに変えたい項目はデバイスごとの設定で扱います。

同期の状態表示

アプリ上部の toolbar に、同期の状態を示す小さな印が出ます。マウスを乗せると、状態の説明が出ます。

表示	意味
薄い点だけ	待機中で、送るものがありません
点滅する点と Syncing	いま送受信しています
横線 2 本と Offline	通信できていません
赤い点と Error	同期に失敗しています

サインインが切れているときも赤い印になり、説明に Sign in to enable sync と出ます。この場合はもう一度サインインすると直ります。

保存と送信のタイミング

保存のボタンはありません。入力が止まっておよそ 0.5 秒で、note は workspace に書き込まれます。

書き込まれた変更は送信待ちの列に積まれます。入力が止まってから 10 秒ほどでまとめて送られ、書き続けているあいだも最長 60 秒に一度は送られます。

待たずにすぐ送りたいときは、Command Palette（Mod+K で開く、コマンドの検索窓）の Sync Now を実行します。このコマンドには最初キーが割り当てられていません。キーで実行したい場合は、先に Settings → Shortcuts の Sync Now に割り当ててください。

Real-time sync

Settings → Sync の Real-time sync を入れておくと、別の端末での変更がその場で届きます。最初から入った状態です。切ると、変更が動くのは保存のときと Sync Now を実行したときだけになります。

この切り替えがあるのはデスクトップアプリだけです。ブラウザでは常に入った状態で、切り替えの代わりに Real-time sync is always on in the browser. と表示されます。

同じ note を 2 台で直したとき

あとから届いた変更が残ります。どちらを残すか尋ねる画面は出ません。同じ note を同時に 2 台で書き直すのは避けてください。

自分の端末が送った変更が、そのまま自分に返ってきて上書きになることはありません。

オフラインのとき

通信できない状態でも、書くことと読むことはそのまま続けられます。

保存は送信待ちの列に積まれます。列は暗号化されたまま端末に残るので、アプリを終了しても消えません。次につながったときにまとめて送られます。
note を消したことも同じ列を通ります。オフラインで消した note が、再起動で戻ってしまうことはありません。
読むほうは、その端末に置かれた暗号化された控えから読み込まれます。この控えはユーザーが開けるファイルの置き場ではなく、オフラインで読むためだけのものです。

通信が無いまま起動したときは、画面の上に Working offline. Your workspace will sync once connection is back. と出ます。下のエディタはそのまま使えます。この帯は、最初につながった時点で消えます。

初回だけネットワークが要るとき

その端末でまだ一度も workspace を開いていない場合は、控えが無いので起動できません。You're Offline と書かれた画面が出るので、つながってから Try Again を押します。通信が戻ると自動で先へ進みます。

一度オンラインで開いたあとは、その端末はオフラインでも起動できます。Sign out すると控えも鍵も消えるので、次に入るときはまたネットワークが必要です。

Settings → Sync

同期にかかわる項目は Settings → Sync にまとまっています。

Encryption — 暗号化の準備ができているかどうかの表示です。済んでいれば、データがこの端末を離れる前に暗号化されている旨が出ます。
Workspace ID — このアプリが結び付いている workspace の識別子です。
Sync Server URL — つないでいるサーバーの場所です。
Device Name — 同期のネットワークの中でこの端末を見分けるための名前です。
Always require password to unlock — 入れると、この端末は master password を覚えなくなり、開くたびに入力を求められます。切ってあるのが最初の状態です。
Real-time sync — 上で説明した切り替えです。

一番下の Sync History には、最近の同期が新しい順に並びます。うまくいったときは送った数と受け取った数が、失敗したときはその理由が出ます。状態表示が赤くなったときは、まずここを見ます。

同期