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

paper_server 来源

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

调用

通过 run_python 使用 helper：

from skills.literature.paper import search, get_paper, fetch_pdf, fetch_xml

• search(keyword="", year=None, year_gte=None, year_lte=None, doi="", first_author="", publication_name="", has_pdf=None, is_oa=None, limit=10)：搜索题录并返回摘要和全文可用状态。
• get_paper(id_or_doi)：按内部 ID 或 DOI 获取完整记录。
• fetch_xml(id_or_doi, working_dir) / fetch_pdf(id_or_doi, working_dir)：把可用全文保存到任务的 papers/ 目录。

helper 自动使用 PAPER_SERVER_API_KEY 和可选的 PAPER_SERVER_URL。只通过 helper 访问，由它处理认证、URL 和下载路径。

查询与全文

• 将中文概念转换为常用专业英文术语，并按需补中文、缩写、全称或同义词。
• 用 DOI、题名、作者、出版物、年份和来源返回的 type 筛选候选。
• 相关性初筛使用题名和摘要；精确数据、章节、图表或页码必须读取正文。
• 结构化段落和参考文献优先 XML；版式、页码、公式和图表优先 PDF。只获取记录实际提供的格式。

失败

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