数据导出结果示例:藏书 CSV、阅读记录和笔记档案怎么看
解压后先看目录,再区分书目汇总和逐次阅读明细。
读书迹 App 可以导出书籍 CSV、阅读记录 CSV、笔记 Markdown 压缩包和生词 CSV,也可以把这些内容合成完整档案 ZIP。书籍表格是一行一本书,阅读记录是一行一次已结束的阅读,笔记按关联书籍分文件夹。下面用演示数据说明文件结构与字段含义,不展示真实用户信息。
手机从「数据导出」进入,电脑网页版从「设置 → 数据导入导出」进入。导出后保存文件,先检查内容再作为备份留存。
完整档案解压后是什么样
books.csv
reading-sessions.csv
vocab.csv
notes/
示例小说 A/
book.json
示例笔记ID-2026-09-18.md
无关联书籍/
示例笔记ID-2026-09-20.md
完整档案的三个 CSV 位于压缩包根目录,笔记位于 notes/。只有存在笔记的书才会在笔记目录中出现,不是每本藏书都生成一个文件夹。同名书可能在文件夹名后追加标识,文件名中的非法字符会被替换。
单独导出笔记时,ZIP 内最外层是 notes-YYYY-MM-DD/,下面仍按书籍分组;不要把这一层与完整档案里的 notes/ 混淆。
书籍 CSV:一行一本书
书籍表格使用以下中文表头,按添加时间倒序输出:
书名,作者,译者,出版社,ISBN,定价,册数,页数,字数,评分,阅读状态,阅读时长,阅读天数,阅读次数,购入价,购买时间,购买来源,存放位置,书架,分类,阅读日期,备注,简介,添加时间,更新时间
以下只截取部分列作阅读示例,不是完整导出行:
| 书名 | 定价 | 购入价 | 评分 | 阅读状态 | 阅读时长 | 阅读天数 | 阅读次数 | 存放位置 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
| 示例小说 A | 49.80 | 32.00 | 4.5 | 已读 | 1 小时 20 分钟 | 2 | 1 | 书房 A 柜第 2 层 | 文学/小说 |
- 金额单位是元:
49.80表示 49 元 8 角;未设置金额时可能输出0.00。 - 阅读时长是汇总:将这本书的阅读记录时长相加,再四舍五入为分钟,不是逐条流水。
- 阅读天数是不同阅读日期的数量:同一天读多次不会增加多个阅读天数。
- 阅读次数是读毕次数:计时开始次数不等于这列的次数。
- 阅读日期列列出读毕日期:按日期倒序,以逗号分隔;含逗号的 CSV 单元格会用双引号包裹。
- 分类用
/分隔:表示多个分类,不表示层级。页数、字数等无有效数值时可能留空。
阅读记录 CSV:一行一次已结束的阅读
书名,作者,ISBN,开始时间,结束时间,时长(分钟),阅读日期,读到页码,是否读毕,来源,备注
示例小说 A,示例作者甲,,2026-09-18 20:00,2026-09-18 20:35,35,2026-09-18,120,,计时,晚间阅读
开始时间和结束时间统一按北京时间(UTC+8)输出为 YYYY-MM-DD HH:mm。阅读日期是记录归属的自然日,不能仅凭开始时间重新推算,跨日或补录时尤其需要保留这一列。
只有已结束的记录进入导出,正在计时的记录不在其中。计时记录的分钟数会四舍五入,正时长不足一分钟时输出 1;手动标记的记录没有计时时长,时长列留空,不表示「读了 0 分钟」。读毕记录在「是否读毕」列写「是」,其他记录留空。
笔记 Markdown 和 book.json
每条未删除笔记写成一个 .md 文件,内容保留笔记正文,不额外增加标题或日期前言。文件名包含笔记标识和创建日期,没有关联书籍的笔记放在「无关联书籍」目录。
有书籍关联的目录还带 book.json,保存该书的标识、书名、作者、封面链接、ISBN、评分和部分书目、购买信息。需要注意:其中 price 和 purchasePrice 是内部金额的分值,例如 4980 表示 49.80 元,与书籍 CSV 的元单位不同。
封面记录的是 URL,不代表压缩包下载并保存了封面图片;笔记正文中的远程图片链接也不代表已打包对应图片文件。检查长期备份时,应分别确认这些链接中的资源是否需要另行保存。
生词 CSV
默认中文表头为「类型、字/词、读音、释义、收藏时间」。字和词本身来自生词本,读音与释义在导出时查询补充;未查到时相应列可能为空,原来的字或词仍保留。不同界面语言下,生词表头和类型文案可能不同。
这些文件能否完整恢复账号
书籍 CSV 可以作为表格导入来源,但完整档案 ZIP 不是一键恢复包。阅读记录 CSV、笔记目录和生词 CSV 不会通过书籍表格导入自动恢复。
重新导入书籍时需要选择目标书架;书架列不会自动还原各行原书架,私人标签也不会由表格自动重建。书籍 CSV 中的累计阅读时长、读毕日期可以按导入规则处理,但逐次阅读明细不能由汇总表完整恢复。具体字段规则见Excel 导入字段示例。
保存前核对
- 确认压缩包能解压、CSV 能正常显示中文。
- 随机检查书名、ISBN、金额和阅读记录时间。
- 检查有无关联书籍的笔记目录,以及其中的 Markdown 正文。
- 按导出日期分别保留档案,不覆盖唯一的旧备份。
CSV 使用 UTF-8 BOM,含逗号、引号或换行的字段按 CSV 规则转义。用 Excel 打开时,ISBN 列仍建议按文本导入,避免软件自动转换数字。