没有网络也能写笔记：Poznote 离线模式双机制详解（离线缓存 + 离线导出）

Poznote 是一款功能强大的自托管笔记软件，它的离线模式由两套互补机制组成：离线缓存让你在没有网络时照常打开、阅读甚至编辑最近修改的笔记；离线导出则把整个笔记库打包成一个可离线浏览的只读档案。无论你是通勤路上、教室里还是野外作业，这篇教程都会带你快速上手 Poznote 离线笔记的全部用法。

为什么需要离线笔记？

自托管笔记服务有一个天然痛点：服务器在哪，笔记就在哪。一旦断网，整个应用似乎就"消失"了。Poznote 的解法是双管齐下：

官方文档中对这一章节的完整说明见 README.zh-cn.md。

机制一：离线缓存 —— 断网也能读写笔记

工作原理简述

Poznote 会利用浏览器的Service Worker和IndexedDB存储，在你在线时悄悄做三件事：

1. 保存离线页面：把与在线版长得一模一样的界面（侧边栏、编辑器、工具栏、标签页）缓存到本地，断网时由 sw.js 接管请求并展示它；
2. 下载笔记副本：按规则拉取该保留的笔记内容、标题、版本号和附件图片，存进 offline-store.js 管理的本地数据库；
3. 定时刷新：在线时每几分钟轮询一次清单接口，只下载内容有变化的笔记，几乎不浪费流量。

保留哪些笔记、按什么顺序、装不下时先丢弃谁，全部由纯函数模块 lib/offline.php 决定，清单接口实现在 OfflineController.php。

哪些笔记会被缓存？

按优先级从高到低共有 4 类原因（见 lib/offline.php）：

1. 笔记级"离线保留"：在笔记菜单中选择"离线保留"，无论多久前编辑都会保留，且包含全部附件（PDF、音频、文件等）；
2. 文件夹级"离线保留"：标记的文件夹及其所有子文件夹内的笔记都会保留；
3. 收藏：收藏的笔记始终保留；
4. 最近修改：默认保留最近 5 天内修改过的笔记（可在设置中改为最多 30 天）。

💡 小技巧：在"笔记"或"文件夹"页面，可离线使用的条目旁会有小圆点标记（可在"设置 → 显示"中开关），"离线"页面还能展示每条笔记被保留的具体原因。

快速配置步骤

1. 进入设置 → 同步与历史 → 离线笔记，设置保留天数（0 表示关闭，见 settings.php）；
2. 对特别重要的笔记/文件夹，在菜单中点"离线保留"；
3. 点击图标侧栏的"离线"按钮，随时查看当前浏览器里已保存的副本清单（页面源码：offline_notes.php）；
4. 断网时直接访问 Poznote 地址：输入上次登录的密码即可本地验证进入（密码以 PBKDF2 验证器形式存放，明文不落盘，逻辑见 offline-login.js）。

离线状态下富文本笔记、Markdown 笔记和任务列表都可以正常打开和编辑，/菜单与右键菜单大部分可用（上传文件、模板等依赖服务器的命令除外）。

容量限制与隐私

• 文本副本：最多 300 条笔记、50 MB 文本，超限时优先保留最近修改的；
• 图片/附件：单个最大 25 MB，共 400 个、200 MB，且绝不超过浏览器剩余空间的一半；
• 隐私：只缓存你自己账户的笔记，共享给你的账户/工作区不会被缓存；副本未加密存储在浏览器中，退出登录即删除（含尚未发送的修改，删除前会警告）。

恢复联网后会发生什么？

修改会自动发送。若服务器上的同一笔记在此期间也被改过，Poznote 会尽可能合并两个版本；合并不了时你的离线版本会另存为一条名为"…（离线副本）"的笔记，不会丢内容。

机制二：离线导出 —— 一份随身的只读档案

如果说离线缓存是"随身背包"，离线导出就是"整箱打包"。它不需要任何前置条件，适合把笔记发给别人、迁移设备，或纯粹想留一份永不依赖服务器的备份。

三步完成离线导出

1. 打开设置 → 备份/导出页面（backup_export.php），找到"📦完整备份"；
2. 选择用户后点击"下载完整备份"——档案在服务器端生成，大账户可离开页面稍后再来取（后台任务见 api_backup_job.php）；
3. 下载 ZIP，解压后在任意浏览器中打开index.html即可离线浏览全部笔记。

这个 ZIP 里有什么？

归档包含数据库转储、全部笔记文件（entries/目录）、附件（attachments/目录），以及一份自动生成的 index.html。这份索引页按工作区 → 文件夹层级列出所有笔记标题，每行还带有标签和可下载的附件链接，实现逻辑在 backup_zip.php。

⚠️ 注意：离线导出是只读的，不能编辑笔记；它也不等于 Poznote 的完整功能界面，只是一个轻量的离线浏览器。需要继续编辑，请使用机制一的离线缓存。

两种机制怎么选？

常见问题

Q：为什么我的浏览器没有离线副本？Poznote 必须通过HTTPS提供服务（http://localhost除外），而且登录后的第一个浏览器里要至少在线打开过一次应用，副本才会开始创建（同步入口：offline-sync.js）。

Q：离线缓存的笔记安全吗？副本以未加密形式存在浏览器本地，且仅限自己账户。在公用电脑上用完请退出登录，副本（包括未发送的修改）会被立即清除。

Q：设了 0 天会怎样？该账户的离线笔记功能即被关闭，浏览器会清空已保存的副本。

Q：离线时能登录别人的共享工作区吗？不能。离线副本只对账户所有者生效，通过授权共享给你的账户不会生成副本（接口会直接返回 403）。

小结

Poznote 的离线模式用离线缓存 + 离线导出两条路径覆盖了"随时读写"与"离线归档"两大需求：前者依托 Service Worker 与 IndexedDB 在浏览器内维护一份可编辑的随身副本，后者用一个带index.html的 ZIP 让笔记脱离服务器也能被翻阅。两者搭配，真正做到"Powerful note-taking without the hassle"——写笔记，从此不受网络束缚。