🌐 04. 部落格發布與同步 (Blog & Sync)

解釋內容如何從本地走向其他平台。
FlashNote 不僅是離線速記本，更原生設計為現代技術部落格（如基於 VitePress 深度訂製的個人開源部落格主題 MagicNote）與外部靜態網站的可視化寫作與發布中樞。

📑 本篇大綱

1. 部落格直通的配置與使用
2. 發布前預覽與發布後檢查
3. 「待同步」狀態是什麼意思？
4. 備份、還原與多裝置同步
5. 發布失敗、同步衝突如何處理？

1. 部落格直通的配置與使用

1.1 為什麼需要部落格直通？

傳統靜態部落格維護必須依賴本地終端機、手寫易錯的 FrontMatter 頭資訊、手動搬運截圖。FlashNote 將瀏覽器側邊欄打造為即時寫作與直接發布的無縫通道：

• 可視化寫作免除手工配置：在富文本環境中直接寫作，自動補齊標題、日期、標籤與別名；
• 私有與公開物理隔離：只有開啟直通的公開目錄才會參與編譯發布，私密日記絕不洩漏。

1.2 直通目錄配置步驟

1. 打開 FlashNote 「設定」 -> 「部落格直通與發布」；
2. 綁定本地或線上部落格站點的儲存庫根目錄或目標生成目錄；
3. 為需要公開發布的分類或資料夾（如 tech、posts）勾選開啟 【部落格直通】；
4. 未開啟直通的私有資料夾（如 private、work-logs）受到嚴格的沙盒物理隔離保護。

2. 發布前預覽與發布後檢查

為避免線上死鏈與排版錯亂，FlashNote 內建了發布前三態門禁 (Readiness Gate)：

發布流程檢查項：

1. 預覽排版：切換至「預覽視界」，檢查代碼塊高亮、公式渲染與表格展示；
2. Slug 唯一性校驗：系統自動檢測同目錄下是否存在同名別名，防止同名覆蓋；
3. 安全路徑穿越防護：發布器嚴格過濾 ../ 等逃逸符號，確保產物絕對收斂於部落格指定目錄內。

3. 「待同步」狀態是什麼意思？

在使用雲端同步或網盤漫遊時，FlashNote 狀態欄會顯示同步指示燈。底層嚴格遵循四態原子狀態機：

• idle (就緒空閒)：本地與雲端資料指紋一致，所有改動已安全對齊；
• pending (待同步)：本地產生了新的筆記修改或新增條目，排入微任務同步佇列；
• syncing (正在同步)：後台正在與 WebDAV / 百度網盤 / OneDrive 等遠端進行特徵指紋比對與差量資料傳輸；
• error (同步異常)：網路中斷、憑證過期或遭遇版本衝突，指示燈變紅並提示原因。

原子狀態機嚴格攔截高併發重入，絕不會因網路抖動造成資料髒寫。

4. 備份、還原與多裝置同步

• 基於 RFC 9562 UUID v7 單調主鍵：每條筆記和章節的主鍵內建時間戳順序遞增，即便在兩台電腦同時離線寫作，聯網合併時也能精準還原時間先後順序；
• 分塊特徵雜湊差量傳輸：只上傳變動的文本增量，大幅減少頻寬消耗與同步耗時；
• 多裝置無感漫遊：在辦公電腦與家用電腦輸入同一雲端配置，筆記即可實現秒級雙向無感同步。

5. 發布失敗、同步衝突如何處理？

5.1 部落格發布失敗排查

• 提示 Blocked：檢查當前文章是否缺失標題或 Slug 是否與其他文章重複；
• 目標路徑不可寫：檢查瀏覽器對本地檔案系統 API (File System Access) 的授權是否仍然有效。

5.2 多端同步衝突策略

若兩台裝置在離線狀態下修改了同一篇筆記的同一段落：

1. FlashNote 會優先保留最近修改時間戳的內容；
2. 同時將另一台裝置的版本另存為 《原標題 - 衝突副本 [時間戳]》；
3. 工作台會彈出衝突提示，創作者可在雙欄視圖中對比合併兩篇內容，絕不靜默丟失任何一字。