🌐 部落格直通與網盤差量同步
FlashNote 不僅是個人靈感速記本，更原生設計為現代技術部落格（如基於 VitePress 深度定制的個人開源部落格主題 MagicNote）的現代化可視化寫作與發布中樞。
1. 為什麼需要部落格直通？
- 告別繁瑣的手工流：傳統靜態部落格維護必須依賴本地終端機、手敲易錯的 Front Matter 屬性頭、費力拷貝插圖；
- 側邊欄隨時隨地開寫：無論查閱資料還是日常瀏覽，隨時喚起 FlashNote，利用富文本排版、Mermaid 圖表與公式暢快寫作，一鍵直通編譯上線；
- 私有與公開物理隔離：只有開啟直通的公開目錄會參與編譯，私密日記絕對隔離，杜絕誤發布。
2. 啟用部落格直通目錄與三態發布門禁
- 在 FlashNote 中進入「設置」 -> 「目錄與分類管理」；
- 為您打算公開發布的物理目錄（如
tech、notes）開啟 【部落格直通】 開關； - 未開啟直通的私有目錄（如
private）將保持絕對物理隔離； - 編譯發布三態門禁 (Readiness Gate)：
- 🟢
ready(就緒)：FrontMatter 元數據完備、語法合法，自動參與構建； - 🟡
draft(草稿)：處於創作階段，僅在本地工作台可見，安全跳過線上發布； - 🔴
blocked(阻斷)：若檢測到同目錄同名 Slug 衝突、缺少標題或路徑越界，系統將主動阻斷構建並給出明確修復提醒，防範線上死鏈。
- 🟢
3. 同目錄 Slug 防衝突與安全路徑
- 同級 Slug 唯一性保護：發布器自動校驗同目錄下的文章別名（Slug），發現同名時智慧預警，絕不出現文件互相覆蓋；
- 全路徑穿越防護：所有文章生成的靜態文件路徑均限制在部落格輸出根目錄下，過濾非法特殊字元與相對逃逸符號。
4. 網盤差量同步與原子狀態機
- 四態原子同步狀態機：遵循
idle -> syncing -> success / error單向狀態流轉，嚴格攔截多端高並發重入，保證數據零髒寫； - 分塊特徵雜湊差量傳輸：基於文件特徵指紋與分塊比對，網路波動自動斷點重試，僅同步變動內容；
- RFC 9562 UUID v7 單調主鍵：時間戳有序遞增，即便離線多端並發新建，連網匯聚時亦能完美自動排序合併。
[!TIP] 常見連接或同步疑問：
- ❓ 常見問題與疑難排解。