zcbot/skills/literature/references/source-paper-server.md

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、出版社、版本或页码。