# paper_server 来源

`paper_server` 以 OpenAlex 元数据为基础，并按记录实际可用性提供摘要、PDF 或 XML。当前语料以英文为主，也包含中文记录。

## 调用

使用宿主侧 typed tools，凭据不会进入 sandbox：

- `paper_search(keyword="", publication_type="", year=None, year_gte=None, year_lte=None, doi="", first_author="", publication_name="", has_pdf=None, is_oa=None, limit=10)`：搜索题录并返回摘要和全文可用状态。能确定来源类型时用 `publication_type` 做服务端过滤，例如 `book`、`book-chapter`、`article`。
- `paper_get(id_or_doi)`：按内部 ID 或 DOI 获取完整记录。
- `paper_fetch(id_or_doi, format)`：把记录实际提供的 `pdf` 或 `xml` 保存到任务的 `papers/` 目录。

工具由平台自动使用 `PAPER_SERVER_API_KEY` 和可选的 `PAPER_SERVER_URL`；未配置时本轮不会注册这些工具。只通过这些工具访问，由它们处理认证、URL、响应裁剪和下载路径。

## 查询与全文

- 将中文概念转换为常用专业英文术语，并按需补中文、缩写、全称或同义词。
- `publication_type` 使用 paper_server/OpenAlex 的来源原始值；例如统一类型 `book_chapter` 在这里对应 `book-chapter`。能前置确定类型时服务端过滤，跨类型发现或类型不确定时再按来源返回的 `type` 筛选候选。
- 相关性初筛使用题名和摘要；精确数据、章节、图表或页码必须读取正文。
- 结构化段落和参考文献优先 XML；版式、页码、公式和图表优先 PDF。只获取记录实际提供的格式。

## 失败

- 认证失败需要管理员检查 `PAPER_SERVER_API_KEY`。
- DOI 未命中、格式缺失或服务器文件不存在时，改查其他候选或使用现有摘要，并降低证据等级。
- 只引用返回记录中的真实字段，不补写缺失的 ISBN、出版社、版本或页码。
