🌐 博客直通与网盘差量同步
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] 常见连接或同步疑问：
- ❓ 常见问题与解答。