数据可迁移性
如何导出 Goodreads 或 StoryGraph 书库并导入 Leaf
把书库导出来是简单的那一半。这个页面把两半都讲清楚：如何把书导出成 CSV 文件，以及如何把它们导入 Leaf。
第一次听说 Leaf？你的书库可以在这里安家
Leaf 是一款面向 iPhone 和 Android 的免费读书记录 App，围绕每天的阅读习惯而不是社交动态来设计。你设定节奏，每天记录几页，把阅读打卡一天天延续下去。导入时，书籍会带着阅读状态、页数和完成日期一起过来，你可以从中断的地方接着读。
免费读书记录 App
几分钟导入 Goodreads 或 StoryGraph 书库，当天就能开始你的阅读打卡。
从 Goodreads 导入
Leaf 可以导入你的整个 Goodreads 书库：书籍、状态、评分、读完日期和页数。
第 1 步：获取 Goodreads 导出文件
- 1. 前往 goodreads.com，打开“我的书架”
- 2. 点击页面左下角的“导入和导出”
- 3. 点击“导出书库”
- 4. 等待文件生成后下载
第 2 步：导入到 Leaf
还没有 Leaf？它在 iPhone 和 Android 上免费。先安装，然后：
- 1. 打开 Leaf → 设置 → 数据 → “从 Goodreads 导入”
- 2. 点击“选择 CSV 文件”并选择下载的文件
导入的内容
- 书名、作者和 ISBN
- 阅读状态（阅读中、已读完、想读、已放弃）
- 星级评分、读完日期和页数（如果导出文件中有的话）
- 重复项会被自动检测并跳过
从 StoryGraph 导入
Leaf 可以导入你的整个 StoryGraph 书库：书籍、状态、评分和完成日期。
第 1 步：获取 StoryGraph 导出文件
- 1. 前往 app.thestorygraph.com，打开“管理账户”
- 2. 在“管理你的数据”下，点击“导出 StoryGraph 书库”
- 3. 打开 StoryGraph 发来的邮件，下载 CSV 文件
第 2 步：导入到 Leaf
还没有 Leaf？它在 iPhone 和 Android 上免费。先安装，然后：
- 1. 打开 Leaf → 设置 → 数据 → “从 StoryGraph 导入”
- 2. 点击“选择 CSV 文件”并选择下载的文件
导入的内容
- 书名、作者和 ISBN
- 阅读状态（阅读中、已读完、想读、已放弃）
- 星级评分和完成日期
- 重复项会被自动检测并跳过
读者为什么把书库搬到 Leaf
- 全部迁移：书名、作者、ISBN、阅读状态、评分和完成日期。
- 免费使用，Leaf Pro 订阅是可选的。开始时无需注册账号。
- 私密、离线优先：没有关注者，没有公开主页，没有算法推荐流。
- 随时可以把所有内容重新导出为 CSV，不做任何锁定。
免费读书记录 App
几分钟导入 Goodreads 或 StoryGraph 书库，当天就能开始你的阅读打卡。
导出书库
随时获取你的 Leaf 数据完整备份。
打开 Leaf → 设置 → 数据 → “导出书库”，然后将 CSV 文件分享到任何地方：文件、iCloud、邮件、AirDrop 等。
文件包含的内容
Column
Notes
Title
Book title - always present
Author
Author name - empty if not set
ISBN
ISBN-13 - empty if not set
Status
Reading · Want to Read · Finished · Dropped
Date Added
YYYY-MM-DD format
Date Finished
YYYY-MM-DD format - empty if not finished
Current Page
Latest page reached - only for Reading and Dropped books that have logged progress
Cover URL
Book cover image URL - empty if not set
Page Count
Total pages - empty if unknown
Format
physical, ebook, or audiobook - empty if not set
Progress Unit
pages, percent, or minutes - empty if not set
Cover Customized
true if the cover was set manually - empty otherwise
Rating
Half-star rating from 0.5 to 5 - empty if not rated
Date Dropped
YYYY-MM-DD format - empty unless dropped
Notes
Your notes and quotes for the book, with page numbers - empty if none
Duration Minutes
Audiobook length in minutes - empty if not set
Date Started
YYYY-MM-DD format - empty if not set
Translators
Names separated by semicolons - empty if not set
Editors
Names separated by semicolons - empty if not set
Illustrators
Names separated by semicolons - empty if not set
Narrators
Names separated by semicolons - empty if not set
Ownership
owned, borrowed, wishlist, or not_owned
Return Date
YYYY-MM-DD format - only for borrowed books
从 Leaf 导出文件导入
恢复之前从应用导出的 Leaf 书库。
打开 Leaf → 设置 → 数据 → “从 Leaf CSV 导入”，然后点击“选择 CSV 文件”并选择导出文件。
导入的内容
- 书名、作者、ISBN、封面和页数
- 阅读状态（正在阅读、想读、已读完、已放弃）和你的评分
- 开始日期、完成日期和放弃日期（添加日期不会被保留）
- 有阅读进度的书籍的当前页码，以及格式、进度单位和有声书时长
- 你的笔记与摘录，连同页码一起恢复
- 译者等署名信息、拥有状态和归还日期
- 重复书籍会被自动检测并跳过
自行创建 CSV 文件
也可以从头创建 CSV 文件，从任意来源导入书籍，适用于从支持 CSV 导出的应用迁移的场景。
Column
Required
Notes
Title
Yes
Book title
Status
Yes
Reading · Want to Read · Read · Dropped (case-sensitive)
Author
—
Author name, empty if not set
ISBN
—
ISBN-10 or ISBN-13, empty if not set
Date Added
—
YYYY-MM-DD format
Date Finished
—
YYYY-MM-DD format, only for Read books
Current Page
—
Latest page reached, only for Reading and Dropped books
Cover URL
—
Book cover image URL, empty if not set
Page Count
—
Total pages, empty if unknown
Format
—
physical or ebook, empty if not set
Progress Unit
—
pages or percent, empty if not set
Cover Customized
—
true if the cover was set manually, empty otherwise