数据、配置与缓存
先区分三类数据
| 类型 | 示例 | 权威位置 | 清理结果 |
|---|---|---|---|
| 阅读器设置 | 图片比例、字体、布局、性能 | 当前浏览器 | 恢复显示和行为默认值 |
| 导入字体 | 用户选择的 WOFF2、WOFF、TTF 或 OTF 文件 | 当前浏览器的独立 IndexedDB | 只在字体设置中逐项删除；不属于普通缓存 |
| 阅读器本地数据 | 历史、主题快照、用户卡、消息分页、离线 Topic Artifact | 当前浏览器；启用 WebDAV 后普通记录进入远端 JSON，离线 Topic 使用独立清单和 HTML 对象 | 缓存可重建；已成功同步的所选记录和离线 HTML 可从远端合并恢复 |
| 原站账号数据 | 帖子、消息、收藏、回应、已读状态 | LINUX DO | 只有对应业务操作才能改变 |
缓存清理不会撤销原站收藏或回应，也不会删除帖子和真实消息。
先选择正确动作
| 目标 | 应使用的入口 | 不会发生什么 |
|---|---|---|
| 备份或迁移界面、阅读与快捷方式配置 | 数据管理 → 导出设置 | 不导出历史、正文、Cookie 或秘密凭据 |
| 应用另一份配置 | 数据管理 → 导入设置 | 无效文件、取消或写入失败不会留下半套配置 |
| 回到初始设置 | 数据管理 → 恢复全部默认 | 不删除队列条目、历史、离线 Topic 或缓存 |
| 修复单个主题的本地数据 | 标题栏“清除当前帖子缓存并刷新” | 不需要清空所有缓存 |
| 回收某类派生数据 | 数据管理中的六类缓存清理 | 不改原站账号状态，也不直接删除 WebDAV 远端记录 |
| 在设备间交换所选数据 | WebDAV 同步 | 默认不运行；关闭的类别不会上传、下载或删除 |
WebDAV 跨设备记录
1.1.0 起，设置中的 WebDAV 同步 可在多个浏览器之间合并浏览历史、收藏记录、设置配置、阅读队列、阅读位置与窗口状态、自定义适用站点和 Connect 本机观察历史；1.2.0 起另可独立同步 AI 服务集合与已翻译 Section 缓存。1.3.0 再增加默认关闭的“离线 Topic 下载”：本地按当前站点账号保存由元数据和完整 HTML 组成的专用 Artifact，远端按同一账号 scope 保存轻量清单与独立 HTML 对象。下载、离线查看和删除范围见离线 Topic 下载。
这条链路与缓存清理分开：普通正文、图片、附件、短期限流状态和页面缓存不会上传；离线 Topic 只有单独勾选后才上传完整明文 HTML，图片和附件仍保留原 URL；译文缓存只在单独勾选后同步且不含原文，翻译 API Key 只以 WebDAV 应用密码加密后的载荷出现。同步不是整份覆盖；每轮先读取远端，以本机上次成功同步基线执行三方合并，并通过 ETag 条件写入。只有远端写入成功后才应用本机合并结果。
定时同步默认关闭，可选 15 分钟到 6 小时；坚果云通常建议 1 小时。需要跨设备立即核对时，应在两端分别执行“立即同步”。
导出设置
“导出设置”生成 JSON，包含：
- 当前脚本版本；
- 图片和灯箱；
- 字体、布局、浮窗和外观；
- 跳转闪烁和等待动画；
- 性能、主题与其他开关；
- 规范化后的共享/独立形态配置。
- 其他适用站点；
- AI 服务的 URL、缓存模型目录，以及翻译业务选择、Prompt、速率和动画等非敏感规则；
- 公共模型能力目录另存为 7 天本机派生缓存，不属于 AI 服务集合，也不参与 WebDAV 合并；缓存过期不会阻止先查看旧数据，后台完整刷新或用户强制刷新成功后才原子替换。供应商
/models目录只保存实际可用项，详情展示按精确 ID 临时叠加公共资料，因此公共缓存更新不需要重新保存供应商服务。 - WebDAV 地址、远端路径、同步类别、间隔和开关等非敏感选项。
不包含：
- 浏览历史；
- 帖子正文或 API 响应；
- 图片、头像和表情资源；
- 用户导入的字体文件；
- Cookie、账号资料、翻译 API Key、WebDAV 用户名或密码。
导入前建议先导出当前配置作为回退。
导入和恢复默认
- v9 文件包含 85 项偏好、AI 服务模型目录与安全组合设置，同时继续接受 v8/v7/v6 组合文件和 v5 偏好文件；旧结构迁移只对对应旧版本生效，缺字段的 v9 文件会拒绝；
- 导入会规范化数值和缺失字段；
- 无效文件不会部分写入；任一仓储写入失败时会逆序恢复已写设置；
- 导入和恢复全部默认都先经统一确认弹层；
- 同 URL 的翻译 API Key 可继续复用本机值；WebDAV 地址变化或本机没有同地址凭据时会清空连接凭据并关闭定时同步；
- 成功后立即投影，无需依赖整页刷新。
“恢复全部默认”会覆盖普通偏好、其他适用站点、翻译和 WebDAV 设置，清除本机翻译 API Key 与 WebDAV 用户名、密码，并把阅读队列图标恢复到默认位置。它会保留“不想再看”的手动记录、自动过滤历史与自动过滤设置，也不会删除阅读队列条目、浏览历史、离线下载、缓存或改动原站账号。 只恢复图片、字体、布局、外观或动效等一个范围时，使用对应设置面板自己的恢复按钮。
六类缓存
从“设置 → 数据管理”先核对六类缓存的数量与保留期，再选择目标类别清理；设置、历史、队列和原站收藏不属于缓存，不会被连带删除。
| 类型 | 包含 | 不包含 |
|---|---|---|
| 浏览历史 | 主题、最近楼层、查看时间 | 浏览器访问历史 |
| 主题与楼层 | 主题元数据、楼层正文、关系、分类标签图标 | 原站帖子 |
| 用户卡 | 简介、徽章、用户组、资料快照 | 头像二进制资源 |
| 消息 | 通知分页、已读摘要、跳转位置 | 原站真实消息 |
| API 响应 | 收藏、回应、点赞、表情注册表等 | 原站业务状态 |
| 头像与图片 | 头像、Boost 表情、实际查看过的原图 | 线上源文件 |
统计会区分业务对象和底层记录，并尽量去重；浏览器存储 API 的估算值不一定等于磁盘文件大小。
分层存储
阅读器按数据类型使用：
- 内存缓存；
localStorage；- Cache Storage；
- IndexedDB。
每层有最大条目、最大字节或保留期。新鲜数据直接读取，过期后联网校准；网络异常时，部分类型可以回退到仍在保留期内的旧数据。
当前通用响应内存层最多保留 72 条、16 MiB；宿主预热与 Reader 之间的一次性主题快照交接最多保留 3 个主题、8 MiB、60 秒。主题定向失效会同时丢弃匹配交接并只取消匹配 identity 的在途请求，不会阻断无关请求完成写入。
导入字体虽然使用独立 IndexedDB，但它是用户文件而不是可重建缓存：六类缓存清理和“恢复全部默认”都不会删除它；需要释放这部分空间时，使用“字体设置 → 共享字体库”的删除入口。
安全清理顺序
- 先导出设置。
- 若只影响一个主题，优先清理当前主题缓存。
- 若用户卡或消息显示旧值，只清理相应类型。
- 只有配置本身异常时才恢复全部默认。
一次完整的配置与同步闭环
- 先导出当前设置，保留可回退的本机配置文件。
- 修改设置或快捷方式，按该面板的即时保存或统一保存规则提交。
- 需要跨设备时，在来源设备核对 WebDAV 地址、账号、远端文件和类别，并完成一次“立即同步”。
- 在目标设备导入配置；秘密凭据不会随文件迁移，需要在本机重新填写或复用同地址已有凭据。
- 在目标设备执行“测试连接”和“立即同步”，确认所选记录已经合并。
- 若问题只涉及缓存，按最小类别清理；若配置整体异常，再使用恢复全部默认。
- 清理后重新打开相关主题或面板并复现。
勾选类别并点击“清理已选缓存”后，必须先在二次确认中核对类别清单。确认框会明确说明：这里只删除本机缓存，不删除站点账号或 WebDAV 远端数据；已同步记录可能在后续同步时重新合并回来。
不要把“清空全部历史”用于一般加载故障。未启用 WebDAV 时，历史只有本地副本；启用后也应先确认最近一次同步成功，再执行会传播删除标记的业务删除。
数据管理中的缓存清理不是 WebDAV 业务删除。历史、通知、收藏/回应涉及同步投影时，阅读器会先等待同步并取得清理屏障；无法安全解除本机基线的类别不会删除且保留勾选。清理成功后远端记录仍可在下一轮恢复，只有建立成功基线后的业务记录删除才通过 tombstone 跨设备传播。