使用文件 / 帳號與同步
衝突處理
兩台電腦都改過同一份提示詞時會發生什麼、ZeroType 保留哪一份,以及怎麼比對合併與避免再發生。
最後更新
衝突是怎麼來的
同步不是單純複製檔案。ZeroType 每次同步都比較三個版本:上次同步的基準、這台電腦現在的內容、雲端現在的內容。
只要同一個位置在兩邊都有改動,就沒有安全的自動答案,這時會產生衝突。常見情境:
- 公司的電腦改了
USER.md,家裡的電腦也改了同一份。 - 你改了提示詞,同時在網站上編輯同一份。
- 一邊刪掉某個檔案,另一邊修改了它。
各種情況的處理方式
| 狀況 | 結果 |
|---|---|
| 只有一邊改動 | 套用有改動的那一邊,包含刪除 |
| 兩邊內容一致 | 直接接受相同內容 |
| 改的是不同偏好設定欄位或不同檔案 | 自動合併,不算衝突 |
| 同一個偏好設定欄位被改成不同值 | 本機值留在目前設定,完整雲端設定另存副本 |
| 同一份提示詞兩邊都修改 | 本機內容留在原檔,雲端內容另存副本 |
| 一邊刪除、另一邊修改 | 保留修改後的內容,並顯示衝突狀態 |
| 上傳時雲端又被人改動 | 重新讀取再合併,最多嘗試三次,仍不成等下一次同步 |
衝突時保留什麼
原檔一律是這台電腦的版本。 唯一的例外是「本機刪除、雲端修改」:這時會還原雲端的內容。
另一邊的內容不會被丟掉,而是寫成同步副本:
- 本機副本放在
sync-conflicts資料夾。 - 同一批副本也會以
conflicts/的檔名同步到雲端與其他電腦,任何一邊的內容都不會消失。 - 副本檔名標示來源與時間,例如
雲端版本 2026-10-06 0308 a109af48-SYSTEM.md。
副本只會標「雲端版本」或「本機版本」,不會標示是哪一台電腦上傳的,因為雲端沒有記錄這項資訊。
怎麼處理衝突
同步完成後,帳號視窗會用白話說明哪些檔案兩邊都改過,例如「4 個檔案在這台電腦和雲端都改過:原檔沿用這台電腦的版本,雲端版本另存為同步副本」。
- 帳號視窗會出現「合併衝突處理(N)」,N 是實際的副本數量;沒有衝突時這個按鈕不會出現。
- 按下後會開啟
sync-conflicts資料夾(Windows 用檔案總管,macOS 用 Finder)。 - 逐份比對副本與原檔,把要留下的內容手動合併進原檔。
- 確認完成後,按「比對完成,刪除副本」,再確認一次。
刪除副本只會清掉這批同步副本並移除衝突提示,原檔與 account-sync-backups 的備份都不受影響。自動同步開啟時,下一次同步會把雲端與其他電腦上的同一批副本一併移除;自動同步關閉時只刪除本機的副本。資料夾裡不符合命名規則的其他檔案不會被算進數量,也不會被刪除。
偏好設定衝突要看哪裡
偏好設定(appsettings.json)衝突時,你目前的設定維持本機值,不會被遠端悄悄改掉;被取代的雲端版本完整存成副本,打開就能對照是哪幾個欄位不同。若只是不同欄位各自被改,ZeroType 會自動合併,不會打擾你。
如何避免
- 同一時間只在一台電腦修改同一份提示詞。
- 改完之後,等帳號視窗顯示同步完成,再換另一台動手。
- 不要在兩台電腦同時開著同一份提示詞的編輯器改內容。
- 網站上的提示詞編輯器與 App 內的編輯器不要同時改同一份檔案。
另外要注意:同一台 Mac 上的正式版與開發版使用不同的設定資料夾。兩者登入同一個帳號時,等於兩台電腦互相同步,任一邊改提示詞都可能在另一邊產生副本。
處理完後怎麼驗證
- 帳號視窗的狀態文字不再提到衝突,且「合併衝突處理」按鈕消失。
- 打開
sync-conflicts資料夾,確認已經沒有需要處理的副本。 - 按一次「立即同步」,確認結果是同步完成。
- 到另一台電腦同步一次,確認看到的提示詞內容就是你合併後的版本。
若同一份內容反覆產生副本,先確認是不是有另一台電腦或網站工具還開著同一份檔案。
同步的範圍與時機見 帳號同步。
這一頁有錯、或有沒寫到的地方?寫信到 training [at] miniasp.com,我們會依實際行為更新文件。