标注

在 PDF、网页、EPUB 上划线、加旁注，全部汇总到一处，可导出，可被 agent 读取。

这一页讲标注的机制——存在哪、怎么锚定、有什么边界。想知道界面在哪，看 Highlights 高亮汇总。

支持哪些格式

格式	高亮	旁注	便签
PDF	✅	✅	✅
网页（.html / .mhtml）	✅	✅	——
EPUB	✅	✅	——

Markdown、图片、音频、视频不支持标注。这是有意的取舍：这些格式的锚点模型和文本选区完全不同，硬套一套模型会把数据结构扭曲掉。

标注的种类

Markup（文本锚定）——附着在一段选中文字上，四种样式：

样式
Highlight	高亮
Underline	下划线
Strikethrough	删除线
Squiggly	波浪线

六种颜色：黄 · 橙 · 绿 · 青 · 粉 · 品红。颜色的含义完全由你定义——Scholardo 不预设「黄色=重要，红色=存疑」这类语义，用的是常见 PDF 工具的标准荧光色。

Sticky Note（便签）——PDF 专有，钉在页面上任意位置的自由便签，不依附于任何文字。适合写「这个图的纵轴单位不对」这类不针对某句话的评论。

每条 markup 标注都可以附一段 旁注（margin note）——你对这段文字的想法。

存在哪里

标注不写进原文件。它们存在项目里的独立文件：

<项目>/.scholardo/annotations/<sha 前缀>/<sha>.json

其中 sha 是文件内容的哈希，不是文件路径。这个设计带来两个直接好处：

• 重命名 / 移动文件，标注不丢——认的是内容不是路径
• 原文件保持干净——你可以把那个 PDF 原样发给别人，不会附带你的批注

反过来：内容变了，标注就找不到家了

如果你重新下载了一版排版不同的 PDF，内容 SHA 变了，旧标注就锚不上新文件。它们不会被删除，会作为孤儿标注保留在 Highlights 里，只是失去了跳回原文的能力。

已有的 PDF 内嵌批注

如果你的 PDF 里已经有别的工具做的批注（Preview、Adobe、Zotero），Scholardo 首次打开时会把它们导入成自己的标注，之后正常显示和管理。这些标注标记为 external 来源，与你在 Scholardo 里新建的（native）区分开。

网页与 EPUB 的锚点

网页和 EPUB 没有 PDF 那样的页面坐标系，标注靠文本选择器锚定：记录选中文字本身、前后若干字符的上下文、以及在文档中的位置。重新打开时按这几个线索重新定位。

EPUB 的锚点精度

EPUB 目前用文本选择器锚定，没有实现 CFI（EPUB 标准的规范定位符）。对绝大多数阅读场景够用；如果同一本书你有多个来源版本，跨版本定位可能不准。

许可证边界

操作	试用 / 有效许可证	许可证过期后
查看已有标注	✅	✅
导出标注	✅	✅
新建 / 修改 / 删除标注	✅	❌

过期后你的标注完全不受影响——照常显示、可读、可导出。只是不能再新建。

导出

在 Highlights 里导出，Markdown 或 CSV，复制到剪贴板或存成文件，可以只导出选中的若干条。

也可以选一批高亮直接生成一条笔记，进入你的 Notes。

Agent 只读

Agent 有三个标注工具，全部只读：

工具	作用
list_annotations	列出某个文档（按 contentSha）的全部标注
get_annotation	按 ID 取一条
search_annotations	按文本或标签搜索

没有写工具，这是刻意的。 Agent 可以基于你的划线来总结、对比、找关联——「把我在这五篇里划的关于催化机理的部分整理一下」是可行的——但它不能替你划线，也不能改你划的。标记这件事保留在你手里。

Hypothesis 同步

用 Hypothesis 在公开网页上做的标注可以同步进来，见 Highlights → Hypothesis 同步。目前是单向的（Hypothesis → Scholardo）。

多设备的注意事项

标注文件没有并发保护

标注 sidecar 是普通 JSON 文件。如果你把项目放在 iCloud / Dropbox 之类的同步盘上，并且在两台设备上同时打开同一个文件做标注，后写入的一方会覆盖先写入的一方，中间的改动会丢。

日常单机使用不受影响。跨设备时的稳妥做法是：一台设备上关掉项目，再在另一台上打开。

相关

• Highlights 高亮汇总——界面在哪、怎么筛选和导出
• 预览窗通则——各类预览窗的标注差异