🌐 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. 工作台会弹出冲突提示，创作者可在双栏视图中对比合并两篇内容，绝不静默丢失任何一字。