云端版本与本地缓存

数据、同步与账户

云端版本与本地缓存

谁是权威版本、编辑怎么落盘、图片如何上云,以及未登录时剩下的能力。

谁是权威版本,谁是缓存

普通免费账号的项目保存在本机,登录不会自动上传。三档有效订阅均不限云端项目数量;有效订阅或已登记的 Global 历史权益下,新建、导入或打开的当前项目会自动开启同步,完整上传正文、图片与项目附属记录,设备保留本地副本。不会扫描并上传未打开的其他项目。Web 使用当前浏览器的 IndexedDB,桌面端使用本地项目文件夹与 SQLite 库。不限项目数量不代表无限存储容量,单文件与上传大小仍有技术限制。

打开一个已链接项目时按这个顺序判断:

  • 先用项目列表里的摘要比对版本:云端没变、本地也没有待上传内容,就跳过整包拉取,直接开写。
  • 云端有更新而本地干净(没有任何待上传修改)时,拉最新稿覆盖本地缓存;桌面端随后回写设计文件与派生档案。
  • 本地有待上传内容(包括那 350 毫秒防抖里还没落盘的编辑)且云端也有新版时,进入冲突,两边都留。

自动开启同步与项目 AI 前的版本校验以当前网页版为准;桌面端需使用支持这些功能的客户端,旧版行为可能不同。

保存与上传的次序

每一次编辑先保存到本地,不等待网络。有有效云权益时,保存成功后的修改在后台合并上传;日常写作不保证每次按键都立即上传。网络失败不会撤销本机修改;恢复连接且权益有效时会重试最新稿。订阅到期或权益查询失败只暂停上传,本地写作继续。

  • 保存提示区分「本机已保存」与「云端已同步」。本机保存成功不代表上传完成;日常自动保存和后台同步不会反复弹出提示,异常或状态恢复时会另行提示。
  • 打开的已链接项目会在窗口重新聚焦和每 60 秒各做一次摘要心跳;后台标签不跑定时,切走或关掉项目就停。心跳不会在你还打字时悄悄换稿。
  • 每一轮项目对话、一次性技能、改写、出图、导入分析及自动维护都先检查云权益,并确认本地最新内容已同步。离线、冲突或同步失败时停止本轮 AI;积分包不单独开通云权益。尚无项目的起始流程与纯费用估算另行处理。

图片怎么上云

上行时会先把正文与资料里的长 data URL 图片拆成内容寻址数据:同一项目内的相同图片复用同一份资产,项目 JSON 里只留轻量引用;打开与对账时再按引用把图片还原回本地。首次上云也走同一条路径——图没传完会把刚建的云端项目丢进回收站、本地不建链接,不留半成品。

  • 拉不到的图片引用会原样留在稿里并标同步错误,不会被悄悄删掉。
  • 单张图超过 20 MB 原始字节、或拆完图之后正文仍超过 32 MB,会标错误态且相同内容不再反复重传。这种项目请拆分或压缩图片后再传。

未登录与离线时

未登录或普通免费账号的本地项目不自动上传。浏览器作品依赖当前浏览器的数据存储,清除网站数据会删除仅在本机的项目与未上传修改;换浏览器或设备请先导出项目包。桌面端使用本地项目文件夹,可以自行拷贝备份。

离线时可以继续本地写作,云同步权限有效时联网后补传。订阅到期不删除已有作品,本机仍可编辑、保存和导出,已有云端项目仍可读取、导出或删除;续购后先核对双方版本再恢复同步。云端项目被删除时,本地链接会拆除,本机作品保留。

限制与排错

  • 同步是内容级的整包对账,不做字段级三方合并——所以冲突的处理方式是「两边都留」,不是自动合稿。
  • 遇到同步错误先保留当前页面与本地项目,不要清网站数据;请查看错误原因,恢复网络或有效权益后再重试。
  • 换设备前先确认当前项目已同步,再用同一账号打开云端版本。仅本地项目或尚未上传的修改请先导出 .quill.json 项目包;不要复制浏览器缓存来迁移。

冲突之后怎么找回内容见 冲突副本,备份与迁移见 导出与导入项目包。