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