OTA 空中自动更新 —— 新版本直接在设备上升级
为什么 OTA 重要
没有 OTA 的时代——更新 KOReader 意味着：下载安装包 → 解压缩 → USB 连设备 → 替换文件 → 重启。对 Kobo/PocketBook 还不太麻烦，但 Kindle 和 reMarkable 就折腾了。
KOReader 的 OTA 让所有平台的更新都变成"点一下就行"。
基本流程
- KOReader 启动时自动检查更新（可关闭）
- 有新版本 → 弹出通知
- 点击"下载并安装"
- KOReader 下载更新包（Wi-Fi 或移动数据）
- 下载完成后自动安装
- 重启 KOReader 即完成
设置 OTA
自动检查
进入「设置 → 更新」：
- 自动检查更新：开启后 KOReader 启动时检查
- 检查频率：每次启动、每天一次、每周一次、每月一次（避免每次启动都联网）
- Wi-Fi 时才检查：避免消耗移动流量
手动检查
任何时候都可以在「设置 → 更新」中手动点击「检查更新」。
更新类型
KOReader 发布三种更新：
| 类型 | 频率 | 稳定性 | 说明 |
|---|---|---|---|
| 稳定版（推荐） | 每月一次 | 高 | 经过社区充分测试，适合日常使用 |
| Beta 版 | 不定期 | 中 | 新功能预发布，可能有问题 |
| Nightly 版 | 每天 | 低 | 每日构建，包含最新提交，但不保证可用 |
OTA 设置中选择你想接收的更新通道。普通用户选稳定版即可。
跨大版本升级
偶尔 KOReader 发布大版本更新（功能或架构有大变化）。此时 OTA 可能需要：
- 先升级到某个中间版本（不能从 v1 直接跳到 v3）
- 升级后首次启动慢（数据库/配置需要迁移）
- 某些旧配置可能失效，需要重新设置
升级前强烈建议备份配置目录。备份方法：复制整个 KOReader 配置目录到电脑（Linux: ~/.config/koreader/，其他平台类似）。
更新失败怎么办
OTA 应该是幂等的——下载失败或安装中断，重新启动 KOReader 会恢复。但如果遇到启动崩溃：
- 手动下载安装包：从 GitHub Releases 下载最新对应平台的安装包
- 覆盖安装：按对应平台的安装方式重新部署（见第二章各平台安装）
- 安装后重启 KOReader
覆盖安装不会丢失书籍、高亮、笔记、配置——只要 KOReader 配置目录没被删除。
Android 的特殊情况
Android 版 KOReader OTA 有两种：
- APK 直装版：OTA 下载新 APK 覆盖安装
- F-Droid 版：由 F-Droid 商店管理更新（OTA 被禁用，在 F-Droid 里更）
如果你装的是 F-Droid 版，OTA 设置会显示"由 F-Droid 管理"，你需要去 F-Droid 里更新。
OTA 不支持的情况
某些特殊情况 OTA 可能不可用：
- 离线 Kindle：没有 Wi-Fi 的 Kindle 无法 OTA，需要手动 USB 更新
- 企业/校园网络：某些网络可能屏蔽 GitHub Releases 域名
- reMarkable：reMarkable 的 OTA 能力取决于你的安装方式（Toltec 或社区安装包）
遇到这些情况，手动下载安装包更新。
更新后要做什么
- 首次启动会显示更新日志（新增了什么、修了什么）
- 打开一两本常用书确认排版和笔记都正常
- 如果有新功能感兴趣，去 KOReader 官方博客或社区看新功能介绍
常见问题
OTA 检查更新很慢？
取决于网络到 GitHub 的速度。GitHub Releases 在某些地区访问可能较慢。可以考虑从 SourceForge 镜像手动下载更新。
自动更新占移动流量？
如果担心，把"Wi-Fi 时才检查"打开。下载时 KOReader 也会确认"当前使用移动数据，确定下载吗"。
更新后界面变了？
大版本更新可能有界面变化。KOReader 社区一直在迭代，偶尔会有新菜单结构。适应几天就好了。