兩臺設(shè)備的編輯如何安全合并ZenNotes云同步與三方合并沖突解決機制解析【免費下載鏈接】zennotesKeyboard-first local Markdown notes with Vim motions, diagrams, and MCP integration.項目地址: https://gitcode.com/gh_mirrors/zenn/zennotesZenNotes 是一款本地優(yōu)先的 Markdown 筆記應(yīng)用支持 Vim 鍵盤操作、圖表與 MCP 集成。它的云同步Cloud Sync功能能讓筆記本和手機上的同一篇筆記安全合并互不重疊的修改會自動三方合并three-way merge只有兩臺設(shè)備改了同一句話時才需要你做一次明確的選擇——整個過程不會丟失任何一方的內(nèi)容。本文面向普通用戶用通俗的方式講清楚 ZenNotes 云同步?jīng)_突解決機制的運作原理以及當(dāng)你看到1 file needs review提示時該怎么做。為什么兩臺設(shè)備同時編輯容易撞車想象這個場景你在筆記本電腦上修改了筆記的開頭出門后又用手機改了同一篇筆記的結(jié)尾兩邊都沒有先同步。很多同步工具遇到這種情況會做兩件令人頭疼的事直接讓后保存的一方覆蓋先保存的一方另一方的修改悄悄丟失生成一個xxx (cloud conflict)的副本文件塞進你的筆記庫之后還混進搜索、任務(wù)列表和備份里清理起來很麻煩。ZenNotes 的做法是第三條路先自動合并能合并的合并不了的絕不猜而是排隊等你決策。這套機制在 2.44.0 版本發(fā)布說明 中有完整描述設(shè)計規(guī)格見 docs/specs/cloud-conflict-resolution.md。云同步如何三方合并自動合并互不重疊的修改ZenNotes 的自動合并基于經(jīng)典的**三方合并diff3**算法核心邏輯在 packages/shared-domain/src/cloud-sync-merge.ts 中實現(xiàn)。它同時持有三個版本版本界面上的叫法含義基準(zhǔn)版本Last synced上次同步兩臺設(shè)備最后一次達成一致的內(nèi)容本地版本This device本設(shè)備你當(dāng)前設(shè)備上編輯后的內(nèi)容云端版本Other device另一設(shè)備云端保存的另一臺設(shè)備的最新內(nèi)容合并規(guī)則非常簡單行級差異比對——把本地版本和云端版本分別與基準(zhǔn)版本逐行對比找出各自的改動塊改動塊不重疊 → 自動合并——比如你改了第 3 段、手機改了第 8 段兩處改動直接拼在一起作為新的共同版本上傳兩臺設(shè)備最終收斂到同一份內(nèi)容你全程無感知改動塊重疊 → 進入沖突隊列——如果兩邊改了同一行或相鄰行ZenNotes 不會擅自選一個贏家而是把這段改動標(biāo)記為待決沖突。細節(jié)上它還有不少貼心設(shè)計自動識別 CRLF / LF 換行符避免 Windows 和 macOS 設(shè)備互相制造差異基準(zhǔn)文件最后一行沒有換行符時也不會被錯誤地粘到下一行。這些邊界情況的測試全部包含在 packages/shared-domain/src/cloud-sync-merge.test.ts 對應(yīng)套件中。同一處被修改時沖突隊列與手動解決步驟當(dāng)確實發(fā)生重疊編輯時ZenNotes 會在工作區(qū)狀態(tài)欄顯示一個常駐的入口1 file needs review · Review now。同樣的隊列也能從 設(shè)置 → Cloud、命令面板Review Cloud Sync Conflicts或 Vim 快捷鍵Space r打開。打開后你會看到等待處理的全部文件列表界面用大白話標(biāo)簽而不是版本號或哈希值呈現(xiàn)三個版本并給出高亮標(biāo)記的合并預(yù)覽。你可以對每一處模糊改動單獨選擇Use this device—— 采用本設(shè)備的寫法Use other device—— 采用另一設(shè)備的寫法Keep both changes—— 兩處改動都保留也可以直接編輯合并后的完整筆記最后點Save combined note保存。隊列會按文件逐個處理解決完一個自動跳到下一個多文件的沖突也走同一個持久化隊列不會散落各處。第一次同步誠實的兩個版本如果這篇筆記從來沒有共同基準(zhǔn)例如第一次把兩個庫接入云同步ZenNotes 不會假裝能推斷出合并結(jié)果。它會完整展示兩個版本、解釋為什么無法判斷哪個更新讓你選擇保留其一、以你起的名字兩者都保留或手動合并。用完整版本替換另一版本時還需要一次獨立確認——寧可多問一句不可悄悄丟字。稍后處理進度不會丟沒想好點Finish later。關(guān)閉前會彈出明確警告并要求確認且會先保存你當(dāng)前的編輯草稿。此時你的本地筆記依然在原處可見、可編輯云端對比版本、上次同步版本和草稿存放在私有應(yīng)用存儲里絕不會變成筆記庫里的影子文件也不會混進搜索、備份或第三方文件同步?jīng)_突文件的同步暫時暫停其他所有筆記照常同步互不阻塞下次重新打開隊列時草稿和進度原樣恢復(fù)。另外筆記等待決策期間其中的任務(wù)數(shù)據(jù)會從 Tasks、日歷和看板視圖中暫時隱去避免兩臺設(shè)備上出現(xiàn)分身任務(wù)沖突解決后自動恢復(fù)。安全保證為什么這個機制值得信任ZenNotes 在 docs/specs/cloud-conflict-resolution.md 的 Boundaries 一節(jié)中明確了幾條不可逾越的底線值得普通用戶了解永不靜默選定贏家——重疊修改必須經(jīng)你確認過期操作無效——保存合并結(jié)果前會重新校驗本地文件和云端版本的最新狀態(tài)防止一次過期的選擇覆蓋掉你剛做的新編輯所有版本可恢復(fù)——沖突跨越應(yīng)用重啟、多次同步周期都逐字節(jié)可恢復(fù)舊版沖突文件不自動刪除——早期版本留下的(cloud conflict)副本只會被識別并建議你手動審查ZenNotes 絕不替你刪除刪除、移動、二進制文件、文件重名等所有類型的沖突都走同一個帶完整選項的持久化隊列。同步協(xié)調(diào)器的排隊、暫停與恢復(fù)行為由 packages/shared-domain/src/cloud-sync-coordinator.ts 負責(zé)界面部分在 packages/app-core/src/components/CloudConflictDialog.tsx 與 packages/app-core/src/components/CloudPendingConflictResolver.tsx 中?？偨Y(jié)一套自動化 人工決策的安全合并模型一句話概括 ZenNotes 云同步的沖突解決哲學(xué)能自動合并的絕不打擾你必須人決定的絕不猜所有版本在你點確認之前都安全保存。對于在多臺設(shè)備間使用 Markdown 筆記的用戶來說這套機制意味著日常多端編輯完全無感真正沖突時有一個清晰、可暫停、可恢復(fù)的決策入口而不是滿庫的重復(fù)文件和丟失的段落。如果你想進一步了解整個應(yīng)用的本地優(yōu)先架構(gòu)可以閱讀 docs/explanation/how-zennotes-works.md。【免費下載鏈接】zennotesKeyboard-first local Markdown notes with Vim motions, diagrams, and MCP integration.項目地址: https://gitcode.com/gh_mirrors/zenn/zennotes創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考