使用文件 / 帳號與同步

衝突處理

兩台電腦都改過同一份提示詞時會發生什麼、ZeroType 保留哪一份,以及怎麼比對合併與避免再發生。

最後更新

衝突是怎麼來的

同步不是單純複製檔案。ZeroType 每次同步都比較三個版本:上次同步的基準、這台電腦現在的內容、雲端現在的內容。

只要同一個位置在兩邊都有改動,就沒有安全的自動答案,這時會產生衝突。常見情境:

  • 公司的電腦改了 USER.md,家裡的電腦也改了同一份。
  • 你改了提示詞,同時在網站上編輯同一份。
  • 一邊刪掉某個檔案,另一邊修改了它。

各種情況的處理方式

狀況 結果
只有一邊改動 套用有改動的那一邊,包含刪除
兩邊內容一致 直接接受相同內容
改的是不同偏好設定欄位或不同檔案 自動合併,不算衝突
同一個偏好設定欄位被改成不同值 本機值留在目前設定,完整雲端設定另存副本
同一份提示詞兩邊都修改 本機內容留在原檔,雲端內容另存副本
一邊刪除、另一邊修改 保留修改後的內容,並顯示衝突狀態
上傳時雲端又被人改動 重新讀取再合併,最多嘗試三次,仍不成等下一次同步

衝突時保留什麼

原檔一律是這台電腦的版本。 唯一的例外是「本機刪除、雲端修改」:這時會還原雲端的內容。

另一邊的內容不會被丟掉,而是寫成同步副本:

  • 本機副本放在 sync-conflicts 資料夾。
  • 同一批副本也會以 conflicts/ 的檔名同步到雲端與其他電腦,任何一邊的內容都不會消失。
  • 副本檔名標示來源與時間,例如 雲端版本 2026-10-06 0308 a109af48-SYSTEM.md。

副本只會標「雲端版本」或「本機版本」,不會標示是哪一台電腦上傳的,因為雲端沒有記錄這項資訊。

怎麼處理衝突

同步完成後,帳號視窗會用白話說明哪些檔案兩邊都改過,例如「4 個檔案在這台電腦和雲端都改過:原檔沿用這台電腦的版本,雲端版本另存為同步副本」。

  1. 帳號視窗會出現「合併衝突處理(N)」,N 是實際的副本數量;沒有衝突時這個按鈕不會出現。
  2. 按下後會開啟 sync-conflicts 資料夾(Windows 用檔案總管,macOS 用 Finder)。
  3. 逐份比對副本與原檔,把要留下的內容手動合併進原檔。
  4. 確認完成後,按「比對完成,刪除副本」,再確認一次。

刪除副本只會清掉這批同步副本並移除衝突提示,原檔與 account-sync-backups 的備份都不受影響。自動同步開啟時,下一次同步會把雲端與其他電腦上的同一批副本一併移除;自動同步關閉時只刪除本機的副本。資料夾裡不符合命名規則的其他檔案不會被算進數量,也不會被刪除。

偏好設定衝突要看哪裡

偏好設定(appsettings.json)衝突時,你目前的設定維持本機值,不會被遠端悄悄改掉;被取代的雲端版本完整存成副本,打開就能對照是哪幾個欄位不同。若只是不同欄位各自被改,ZeroType 會自動合併,不會打擾你。

如何避免

  • 同一時間只在一台電腦修改同一份提示詞。
  • 改完之後,等帳號視窗顯示同步完成,再換另一台動手。
  • 不要在兩台電腦同時開著同一份提示詞的編輯器改內容。
  • 網站上的提示詞編輯器與 App 內的編輯器不要同時改同一份檔案。

另外要注意:同一台 Mac 上的正式版與開發版使用不同的設定資料夾。兩者登入同一個帳號時,等於兩台電腦互相同步,任一邊改提示詞都可能在另一邊產生副本。

處理完後怎麼驗證

  1. 帳號視窗的狀態文字不再提到衝突,且「合併衝突處理」按鈕消失。
  2. 打開 sync-conflicts 資料夾,確認已經沒有需要處理的副本。
  3. 按一次「立即同步」,確認結果是同步完成。
  4. 到另一台電腦同步一次,確認看到的提示詞內容就是你合併後的版本。

若同一份內容反覆產生副本,先確認是不是有另一台電腦或網站工具還開著同一份檔案。

同步的範圍與時機見 帳號同步。

這一頁有錯、或有沒寫到的地方?寫信到 training [at] miniasp.com,我們會依實際行為更新文件。