User Documentation
从 Readwise 导入
当你希望迁移已保存在 Readwise 中的高亮时,请使用 Readwise 导入。
对大多数人来说,最稳妥的迁移路径是:先从 Readwise CSV 导出开始,导入一个小样本,确认预览看起来正确,然后再导入完整文件。
Acorny 支持通过 CSV 上传或一次性 API 导入来迁移 Readwise 数据。
对大多数用户,请从以下路径之一开始:
- Readwise API:使用 Import from API,并粘贴来自 https://readwise.io/access_token 的 Readwise API 令牌。
- Readwise CSV:从 Readwise 导出一个 CSV 文件,然后在 Acorny 中上传它。

如果你使用 API 路径,请从 Readwise 访问令牌页面复制令牌,并仅在导入界面要求时才将其粘贴到 Acorny 中。

会保留哪些内容
Section titled “会保留哪些内容”Readwise 导入旨在保留让一条高亮在 Acorny 中有用的数据:
- 高亮文本
- 来源标题
- 来源 URL(如有提供)
- 作者(如有提供)
- 笔记(如有提供)
- 标签(如有提供)
- 高亮或创建日期(如有提供)
- Acorny 可用于日后识别同一条高亮的信息
这些信息有助于在你再次导入同一个库时避免重复。
不会保留哪些内容
Section titled “不会保留哪些内容”Acorny 不会尝试重建每一个 Readwise 账户设置。例如,它不会导入 Readwise 的邮件设置、每日复习偏好,或在 Readwise 内配置的集成。
某些导出也会省略可选字段。如果某个字段不在 CSV 或 API 结果中,Acorny 无法在事后推断它。
如果你有数千条高亮,请先导入一个较小的导出。在预览中检查以下项目:
- 来源标题看起来正确。
- 高亮文本可读。
- 笔记和标签出现在预期位置。
- 导入数量接近你的预期。
- 重复处理没有创建重复记录。
在小批量导入成功后,再运行完整迁移。大批量迁移可能会让复习显得繁忙,但你的高亮不需要一次性全部变成复习卡。
导入的高亮会出现在你的高亮页面中,并可进入复习会话。如果导入的高亮已存在,Acorny 会保留现有记录,而不是创建重复项。
确认导入后,请打开高亮页面。用导出中的某个书名或文章标题进行搜索。稍后打开复习,练习由导入高亮生成的复习卡。
如果上传失败,请确认该文件是 Readwise CSV 导出,而不是以其他格式保存的电子表格。如果预览看起来是空的,请在本地打开该 CSV 并检查它是否包含高亮文本。
如果 API 导入失败,请创建一个新的 Readwise API 令牌,并只粘贴来自 https://readwise.io/access_token 的令牌值。不要把你的 Readwise 密码粘贴到 API 令牌字段中。