再也不丢稿:易创 160ms 自动落盘与章节历史版本恢复机制详解
再也不丢稿:易创 160ms 自动落盘与章节历史版本恢复机制详解
写网文最怕什么?不是卡文,而是手滑删错一段或者软件闪退后刚写的两小时没了。易创(easy-writing)是一款纯本地、开源的 AI 网文写作桌面软件,它内置了 160ms 自动落盘机制——你停手不到 0.2 秒,章节正文就已写入本地数据库;配合按「5 分钟或 200 字」节流的章节历史版本快照,误删、闪退、误覆盖都有据可查,真正做到再也不丢稿。
自动落盘:停手 160ms,正文已入库
易创的编辑页不需要你手动按保存。每次敲下字符,编辑器都会标记草稿为「脏」状态,然后启动一个 160 毫秒的防抖计时器:只要你还在连续打字,计时器就不断重置;一旦你停手,最多 160ms 后整章草稿就会写入本地 SQLite 库。
这套逻辑在 WritingEditor.vue 的 queueLocalDraftSnapshot 中实现,几个关键细节保证了既快又稳:
- 互斥锁:
currentSavePromise保证同一时刻只有一次落盘在跑,后到的请求会挂起排队,不会并发写坏数据; - 拼音组词保护:中文输入法组词期间不落盘,避免把拼音串存进正文;
- 轻量刷新:落盘时只发一个轻量的字数更新事件,不再像早期版本那样每次保存都重建整棵目录树——这正是「本地模式下打字每 160ms 重建一次目录」卡顿问题的根治方案。
写作页底部的「本地保存」状态就是这套机制的直观反馈。哪怕你写到一半强制退出软件,最多也只可能损失 0.16 秒内敲下的那几个字。
历史版本快照:不是每次都存,而是「该存才存」
正文每 160ms 落一次盘,如果每次都留一个版本,数据库很快就会被上千份几乎相同的快照塞满。易创在 local-version-service.ts 中设计了一套节流策略,满足任一条件才存一版:
| 条件 | 阈值 | 说明 |
|---|---|---|
| 时间间隔 | 距上一版 ≥ 5 分钟 | 覆盖长时间连续写作 |
| 字数变化 | 变化 ≥ 200 字 | 覆盖短时间大段增删 |
| 基线版本 | 字数 ≥ 50 字 | 新章节敲下第一个字不算,写出有回退价值的片段才立基线 |
其他两个贴心设计:
- 保留份数有限:每章只保留最近的 N 版,N 跟随「保留份数」设置(
backupRetention,默认 20,可在 设置中心 的「保留份数」中调为 1–100),超出部分自动清理,不会无限膨胀; - AI 生成内容不留版:工作流流式预览和输入法组词期间的内容属于「中间态」,一律跳过,版本列表里只留你真正的手稿。
快照存在本地 SQLite 的 chapter_versions 表中(见 sqlite-writing-storage.ts),全部留在你的电脑上,不上传任何服务器。
一键恢复:预览、逐字对比、确认还原
写砸了怎么办?在编辑页右上角点击「历史」按钮,打开章节历史弹窗(ChapterHistoryModal.vue),整个恢复流程分三步:
- 选版本:左侧列表按时间列出所有本地快照,每条都标注了来源(本地快照)、字数、时间和正文预览,一眼定位「事故前」的那一版;
- 看差异:右侧可切换「内容预览」和「与当前对比」两种视图。对比模式不是简单的整行标红——它先做行级 diff,再对配对的删除/新增行做字符级对比,把真正改动的几个字用底色单独标出来。网文一段往往上百字,只改了三五个字,你不用肉眼找茬;
- 点恢复:点击「恢复此版本」,弹窗会明确警告「当前正文将被替换」,确认后选中版本的正文写回当前草稿,并自动重置节流基线,避免刚恢复完就立刻又存一版几乎相同的快照。
一个小提示:AI 正在生成正文期间可以查看和对比历史版本,但需要暂停生成后才能执行恢复,防止两边同时写正文互相覆盖。
写入取证日志:丢稿争议不用猜
「我明明写进去了,怎么找不到了?」这类问题的最大障碍是事后无法证明数据写到哪一步了。易创在 write-journal.ts 中内置了写入取证日志:每一次章节落盘、读取、版本快照都会留下一行记录,包含时间、存储键、字数、后端和成功状态。
它的策略很克制——成功记录在内存里攒批(5 秒或 20 条写一次盘),而失败记录立即落盘,因为出问题的那一条最不能丢。桌面端日志写在应用数据目录的 logs/write-journal.log,遇到报障时把这份文件发回来即可精确定位,不再靠推理。
写在最后
对网文作者来说,断更比卡文可怕,丢稿比断更更可怕。易创用三个层层递进的机制兜底:
- 160ms 自动落盘:正文永不离开你的磁盘;
- 节流版本快照:每 5 分钟或 200 字留一份可回退的基线,默认保留 20 版;
- 历史版本恢复:预览、逐字对比、一键还原,误操作三分钟回到事故前。
而且这一切都发生在纯本地环境——正文、版本、日志全部只存在你自己的电脑上。如果你也在找一款开源、本地优先的 AI 网文写作工具,不妨了解一下易创的完整机制文档,例如 docs/storage-safety-verification.md 中记录的存储安全验收过程,看看它是怎么把「不丢稿」写进每一条代码路径的。

