arxiv

用途

该技能用于从 arXiv 搜索、下载并总结学术论文。当用户说出“search arxiv”“download paper”“fetch arxiv”“arxiv search”“get paper”等指令时触发。

主要能力

• 按主题关键词或 arXiv 论文 ID 检索论文。
• 默认返回最多 10 条搜索结果（MAX_RESULTS = 10）。
• 支持参数覆盖：
  • - max: N：调整返回结果数量，例如 - max: 20。
  • - dir: PATH：自定义 PDF 保存目录，例如 - dir: literature/。
  • - download：列出结果后下载第一条结果的 PDF。
  • - download: all：下载所有结果的 PDF。
• 搜索结果以表格展示：编号、arXiv ID、标题、作者、日期、分类。
• 对指定论文 ID 获取详细信息：标题、全部作者、分类、完整摘要、发布日期、PDF URL、摘要页 URL。
• 下载 PDF 并校验文件大小（须大于 10 KB，过小则视为错误页面并拒绝）。
• 连续下载之间等待 1 秒以避免限流；遇到 HTTP 429 时等待 5 秒后重试一次。
• 不覆盖已存在的同名 PDF，跳过并报告“already exists”。
• 若项目存在 research-wiki/ 目录，则将本次返回的论文写入研究 wiki。

使用方式

基本调用形式为 /arxiv 后接查询主题或 arXiv 论文 ID，例如：

• /arxiv "attention mechanism" - max: 20：返回最多 20 条结果。
• /arxiv "2301.07041" - download：按 ID 下载指定论文。
• /arxiv "query" - dir: literature/：将 PDF 保存到自定义目录。
• /arxiv "query" - download: all：下载所有结果的 PDF。

若参数匹配 arXiv ID 格式（YYMM.NNNNN 或 category/NNNNNNN），则跳过搜索直接获取详情。

搜索时优先使用 arxiv_fetch.py 脚本（按既定解析链查找），若无法解析则回退到内联 Python 代码调用 arXiv API。下载时同样优先使用脚本，回退方案为直接通过 Python 下载 PDF。

PDF 默认保存目录为当前项目目录下的 papers/（PAPER_DIR），目录不存在时自动创建。

适用场景

• 需要快速检索 arXiv 上的学术论文并查看元数据与摘要。
• 需要按 ID 获取单篇论文的完整信息用于引用或复现。
• 需要批量下载论文 PDF 到本地目录。
• 需要将检索到的论文自动归档到项目的研究 wiki 中。

限制

• 默认最多返回 10 条结果，需通过 - max 参数调整。
• 下载的 PDF 若小于 10 KB 会被视为错误并删除。
• 连续下载需等待 1 秒，可能影响批量下载速度。
• 若 arXiv API 不可达，会明确报告错误，并建议改用 /research-lit 的 - sources: web 作为回退。
• 研究 wiki 写入依赖 research_wiki.py 脚本；若脚本缺失会发出警告并跳过写入，可通过安装脚本刷新仓库、设置 ARIS_REPO 或手动复制脚本修复。
• 关于收费、价格、平台支持范围等信息，资料中暂未提供。