如何在本地管理 PDF 和 EPUB 笔记
在本地管理 PDF 和 EPUB 笔记，最稳妥的方式是把“原始文档、阅读位置、标注、长笔记和搜索索引”分开保存，但让它们通过稳定的文档身份和位置重新连接。文件夹只负责归类，真正决定以后能否找回内容的是位置、结构和导出能力。
用自己的资料检查一次完整往返
先选一份 PDF、一篇网页和一个短视频，围绕同一个问题写一篇笔记。不要一次导入整个资料库；先检查下面三件事：
- 重新打开笔记，确认文字和插入的内容仍可阅读。
- 从笔记中的来源入口返回原文，核对页码、段落或视频范围。
- 搜索一个记得的关键词，确认能找到笔记或来源中的实际内容。
同步成功和有备份是两件事。把需要长期保存的内容导出到另一个位置，检查文件能否重新打开，再安排后续备份。完整的跨资料笔记流程展示了这些内容如何放在一起。
先分清五种数据
一个长期可用的阅读资料库至少包含：
- **原始文档：**PDF、EPUB 以及图片、字体等资源。
- **阅读状态：**当前页、章节位置、书签和阅读进度。
- **原文标注：**高亮、下划线、引用和短批注，并保留来源位置。
- **独立笔记：**可以跨文档组织观点的 Markdown 或结构化笔记。
- **搜索索引：**由正文和标注生成，可以丢弃后重建，不应成为唯一数据源。
把这些内容全写回 PDF 或 EPUB，看似“只有一个文件”，却容易受到格式能力和应用兼容性的限制。把它们完全拆散，又会失去从笔记返回原文的路径。更实用的做法是：原文件保持独立，标注和笔记由资料库管理，并保存足以重新定位的地址。
PDF 和 EPUB 的位置不是同一种东西
PDF 页面固定，位置通常可以用页码和页内坐标表达。EPUB 会随字号、窗口宽度和设备重新排版，因此“第 83 页”不是稳定地址，更适合使用章节和正文位置。
这会直接影响笔记系统：
- PDF 笔记应该能回到具体页面和选区。
- EPUB 笔记应该跟随内容位置，而不是某次排版产生的页码。
- 修改或替换原文件后，两种位置都需要重新检查。
- 仅保存截图可以保留外观，却失去可搜索文字和可迁移的结构。
一个同时管理 PDF 与 EPUB 的工具，必须尊重两种格式的定位差异，不能只把它们当成一摞通用附件。
三种常见笔记方式
| 方式 | 优点 | 适合保存 | 主要问题 |
|---|---|---|---|
| 直接写进 PDF 批注 | 文件跟着走，很多阅读器能显示 | 高亮、短评论、校对痕迹 | EPUB 不适用，跨文档整理较弱 |
| 应用内结构化标注 | 可搜索、筛选、复习并返回原文 | 高亮、引用、链接、卡片 | 需要可靠导出和备份策略 |
| 独立 Markdown 笔记 | 开放、容易编辑和组合 | 长期观点、提纲、跨资料综合 | 必须另外保存返回来源的位置 |
它们不是互斥选择。短标注适合贴在原文上，较长的分析适合独立笔记；关键是两者之间有稳定链接。
一个可持续的本地工作流
1. 先建立文档入口，不急着设计复杂分类
把现有 PDF 和 EPUB 导入同一个资料库。第一次可以按原文件夹批量导入并保留目录结构，再用少量标签表达跨目录主题。
文件夹适合稳定归属，例如课程、客户或项目；标签适合交叉分类，例如“待读”“方法论”或“引用候选”。不要一开始建立几十层目录，搜索和链接比完美分类更重要。
2. 阅读时保存最小但足够的上下文
一条有用标注至少应知道：
- 来自哪份文档。
- 对应哪段原文。
- 位于 PDF 页面、EPUB 章节位置或视频时间点的哪里。
- 属于高亮、引用、链接、长笔记还是卡片。
- 何时创建或修改。
不要把所有想法都塞进页边短批注。对一句话的即时反应可以留在原文；需要比较多份资料的内容，最好写进独立 Markdown 笔记，再链接回证据位置。
3. 让标注进入搜索
资料变多以后，最常记得的往往不是文件名，而是自己写过的一句话。全文搜索应该同时覆盖正文、高亮、引用、链接和笔记，并保留命中来源。
在 DoCube 中，全库搜索覆盖 PDF、EPUB、HTML、Markdown、MinerU、视频字幕和多类标注。结果可以返回具体页面、章节、内容块或时间点，而不是只打开文档封面。
4. 用位置链接连接长笔记和原文
复制当前阅读位置的 docube:// 地址，把它贴进 Markdown 或其他支持链接的笔记工具。这样长笔记可以保持开放文本结构，同时仍然能够一键回到原文。
位置链接不包含原文件。把笔记复制到另一台设备时，还要确保目标文档已经导入或同步过去。
5. 把同步和备份分开理解
本地优先不等于只保留一份副本：
- 本地资料库是主要工作副本。
- iCloud 可以在 Mac、iPhone 和 iPad 之间同步改动。
- 同步会传播修改和删除，因此不能代替独立备份。
- 定期导出重要原文、译文和笔记，并保留可恢复的历史副本。
删除文档前还要检查标注、卡片和其他笔记是否仍然引用它。
DoCube 如何处理这些内容
DoCube 把文档复制到设备上的资料库，标注独立于原始 PDF 保存，不会直接写回原文件。PDF、EPUB、网页、Markdown、MinerU 和视频可以一起组织、搜索和链接。
建议的最小路径是：
- 导入一个小文件夹，确认标题、封面和正文解析正常。
- 为扫描 PDF 完成本地 OCR。
- 在 PDF 或 EPUB 中创建几条高亮、引用和 Markdown 标注。
- 建立一篇独立 Markdown 笔记，粘贴几个具体位置链接。
- 用全库搜索输入自己写过的词，确认能返回原文。
- 打开 iCloud 同步前，先确认本地资料和导出路径符合预期。
免费版最多可以建立 5 个文档，足以用真实资料验证这条链路，再决定是否迁移完整资料库。
选择本地笔记工具时的检查表
- 能否同时读取 PDF 和 EPUB，而不是只把它们当附件？
- 扫描 PDF 是否可以在本地 OCR？
- 标注能否搜索，并返回准确位置？
- EPUB 改字号后，链接还能否回到同一段内容？
- 长笔记是否使用开放或可导出的格式？
- 能否导出原文件、译文和独立副本？
- 同步是否可选，数据主要存在哪里？
- 删除一个文档时，会同时删除哪些关联数据？
- 搜索索引损坏后，能否由原文和笔记重建？
常见问题
标注应该直接写回 PDF 吗？
如果需要把带批注 PDF 交给其他阅读器，这是合理选择。若目标是跨 PDF、EPUB 和视频统一搜索、链接和复习，应用内结构化标注更灵活，但必须有明确的导出和备份路径。
EPUB 笔记为什么不能只保存页码？
EPUB 通常会随字号、窗口和设备重新分页。页码是一次排版的结果，不是稳定内容地址；应保存章节和正文位置。
local-first 是否意味着不能使用 iCloud？
不是。local-first 的重点是设备上有完整可用的主要副本，核心阅读和管理不依赖服务端账号持续在线。iCloud 可以作为用户控制的同步通道，但同步不等于备份。
换工具时最重要的导出是什么？
至少保留原始 PDF/EPUB、可读的笔记文本、标注原文与位置，以及必要的图片资源。只有应用内部数据库、没有可读导出，会增加长期迁移成本。
下一步可以阅读如何把笔记链接回 PDF 和 EPUB 的具体位置，把“资料在本地”进一步变成“以后还能准确回到原文”。