高亮导入失败：常见原因和排查步骤
问题一：Kindle 浏览器扩展同步卡住
可能原因
- Amazon 账号登录态过期
- 浏览器网络问题
- Amazon 地区站点不匹配（你在 Amazon.ca 买的书，扩展登的是 Amazon.com）
排查步骤
- 在浏览器里打开 Amazon 的 Your Highlights 页面，确认你能正常看到自己的剪藏
- 如果能看到 → 回到 Readwise 扩展，点击扩展图标 → 重新登录
- 如果看不到 → Amazon 网站本身有问题，检查网络或联系 Amazon 客服
- 确认扩展登录的 Amazon 站点和你买书的站点一致（看 URL 是 amazon.com 还是 amazon.ca 等）
问题二：导入数量比预期少
可能原因
- 高亮质量过滤器过滤了部分低质量高亮
- 同一内容从多个来源导入，被 Readwise 自动去重
- 某些来源平台本身限制了可同步的高亮数量
- 你手动导入时漏了某些内容
排查步骤
- 在 Library 里切换到「显示被质量过滤的高亮」（Account Preferences → Quality Filter → 临时关闭看看）
- 在 Sources 页面，查看每个来源的「上次同步时间」和「已导入数量」
- 确认 CSV 批量导入没有格式错误（回头看 CSV 格式文档）
- 实体书 OCR 扫描的可能识别不准——手动检查一下
问题三：Apple Books 同步不到某些高亮
可能原因
- 你在 Apple Books 里画的高亮是同步到 iCloud 的，但 Mac 工具没读到最新版本
- 部分高亮是在其他设备上画的，本地 Mac 工具需要等 iCloud 同步完成
- Mac 工具版本太旧
排查步骤
- 在 Mac 上打开 Apple Books → 确认那本书的高亮还在
- 确认 Mac 的 iCloud 同步正常（系统设置 → Apple ID → iCloud → 打开「图书」的 iCloud Drive 开关）
- 重新打开 Readwise 的 Apple Books 工具，点击 Rescan 重新扫描
- 检查 Readwise 官网有没有新版 Mac 工具
问题四：Pocket / Instapaper 授权过期
排查步骤
- Readwise Web App → Sources → 找到对应的来源
- 看状态是不是显示「授权已过期」或类似提示
- 点击 重新授权 按钮 → 浏览器弹出 Pocket/Instapaper 的授权页面
- 重新登录并授权
通用排查清单
如果上面都试了还是不行：
- 清浏览器缓存（如果用 Web App 或浏览器扩展）
- 更新 App 到最新版本（App Store/Google Play 里检查）
- 重启 App / 浏览器
- 检查 Readwise 状态页面（status.readwise.io）——可能是 Readwise 这边的问题
- 发邮件给 Readwise 支持（hello@readwise.io）——附上截图和你的账号注册邮箱