跳到主要内容

Folder

Folder 是 L-Reader 组织本地文件的基本单位——一个 Folder 就是磁盘上的一个文件夹，它既存放书库（图书与阅读材料）也存放知识文件（Folder 里的 .md 文件，详见 知识库）。

跨设备同步​

Folder 是数据同步的最小单位。需要跨设备阅读时，只要把这个文件夹同步到其他设备，用 L-Reader 打开同一个文件夹，所有阅读记录和知识库内容就能无缝衔接。

为什么用 Folder​

  • 隔离 — 工作资料、休闲阅读、学习材料可放在不同 Folder 互不干扰
  • 可移植 — Folder 元数据保存在目录下的 .l-feed/ 隐藏文件夹，拷贝文件夹即带走全部数据。
    • 推荐的同步方案：
      • iCloud / OneDrive / Dropbox 等云盘 — 把 Folder 放进云盘目录，由云盘负责文件级实时同步
      • Git 仓库 — 适合开发者，可追溯每次阅读进度与笔记的变化

打开与切换​

  • 菜单 文件 → 打开文件夹…（Cmd/Ctrl+O）选择文件夹作为当前 Folder
  • 启动时可直接选择最近打开过的 Folder
  • 首次启动会引导你打开第一个文件夹作为初始 Folder

Folder 结构​

你的 Folder/
├── .l-feed/
│   └── <user-id>/
│       └── manifest.json     Folder 标识与元信息
├── 你的电子书.epub
├── 笔记.md
└── ...

manifest.json 字段：

字段说明
versionmanifest 版本，目前为 1
project_idFolder 唯一 ID（UUID），同步主键
nameFolder 名称（默认取文件夹名）
created_at / updated_at创建 / 最后更新时间
books[]Folder 内图书清单：book_id + file_relative_path

这些文件体积很小，可放心纳入版本控制或云盘同步。

注意

请勿手动删除或修改 .l-feed/ 目录，否则该 Folder 的历史划线与生词可能丢失。