Sources → Docs：文献与文档
Docs 是你读的东西住的地方：论文 PDF、Word 文稿、幻灯片、网页存档、EPUB、图片，甚至数据文件和代码。对应项目里的 sources/docs/ 目录。
把文件放进来
四种方式，任选：
| 方式 | 操作 |
|---|---|
| 拖拽 | 直接把文件从 Finder 拖到列表上 |
底部 + | 「From File…」选本地文件 |
| 从网页 | 「From Web…」输入网址，Scholardo 会抓取正文并存为 Markdown |
| 从内置浏览器 | 浏览时点工具栏的保存按钮，见内置浏览器 |
导入时如果检测到重复文件，会弹窗让你确认是跳过还是保留两份。
也可以让 AI 去找
+ 菜单里还有「Search papers via MCP…」——让 agent 按主题去检索论文元数据，找到后直接下载全文进 Docs。这条路径背后是 OpenAlex 与 Unpaywall。
阅读状态与阅读队列
每一行右侧有一个状态圆点，点击可以标记：
| 状态 | 含义 |
|---|---|
| ○ To Read | 待读 |
| ◐ Currently Reading | 在读 |
| ✓ Read | 已读 |
标记过 待读 或 在读 的文件会额外汇总到列表顶部的「Reading Queue」分区，可折叠。这样无论文件被归到哪个分组，你的当前战线始终在最上面一眼可见。
agent 也能往队列里塞
Agent 可以通过 MCP 工具 queue_add 把一篇文献加入你的阅读队列。它读到一篇相关论文，可以直接排进你的待读列表。
排序与筛选
右上角的排序图标打开菜单：
排序方式：Created（导入时间）· Modified（修改时间）· Name · Size · Kind（按类型分组）· Topic（按主题 AI 分组）
类型筛选：All · Documents · Code · Data
标签筛选：如果你在 Finder 里给文件打过彩色标签，这里会自动列出所有标签及数量，可以按标签筛。
按主题分组
选择排序方式里的「Topic」会触发一次 AI 分类：Scholardo 把任务交给你当前的 agent，由它读取文献元数据并归纳出主题分组，结果写回项目。分类完成后列表按主题分节展示。
分组头部有「重新生成」和「退出主题分组」两个动作。重新生成会替换掉现有主题（会先弹窗确认）。
需要配置 AI
主题分组要求你至少配好一个可用的 agent 或 AI API。没配的话会提示你先去设置里配置。
文件分组
右键任意文件 →「New Group…」可以把它归入一个自建分组。分组在列表里显示为可折叠的区块，带文件计数。
- Remove from Group：移出分组，文件回到主列表
- Disband Group…：解散分组，组内文件全部回到主列表（文件不会被删除）
分组信息存在项目的 .scholardo/ 目录里，会随 git 同步——多台机器打开同一个项目，分组是一致的。
搜索
子 tab 行的放大镜打开列表内搜索，按文件名过滤当前列表。搜索内容按项目记住，即使你收起侧栏再展开也还在。
要搜文献内容而不是文件名，用语义检索。
打开后看到什么
点一行，文件在中间栏打开。窗口类型按扩展名决定：
| 文件类型 | 打开为 |
|---|---|
.pdf | PDF 阅读器，可高亮、可加便签、缩略图页面网格 |
.docx .doc | Word 文档渲染 |
.pptx .ppt | 幻灯片预览 |
.epub | EPUB 阅读器，可高亮 |
.html .mhtml | 内置网页渲染，可高亮 |
.md | Markdown 编辑器 + 实时预览 |
.csv .xlsx .tsv .xls | 表格网格编辑器 |
| 图片 / 音频 / 视频 | 对应预览器，音视频可播放 |
| 其他 | 代码编辑器 |
各窗口的共同操作（缩放、页内查找、发送选中内容给 AI）见预览窗通则。PDF / 网页 / EPUB 的高亮怎么用，见 标注。
其他行内操作
右键一行：
- Rename 重命名
- Add to References 为这篇文档生成一条参考文献条目，写进
sources/refs/ - Move to Trash… 移到废纸篓（真的移到系统废纸篓，可恢复）
多选（Cmd / Shift 点击）后打开，会得到一个聚合预览标签页。