mcpField
A
arxiv-reading

arxiv-reading

github.com/leo1oel生产力039 次安装14 周前更新
代码仓库

关于 arxiv-reading

arxiv-reading 是一项研究技能,可将 arXiv 论文转换为 Markdown,保留数学公式、表格和章节结构,便于阅读。它还说明如何获取所需图表,以及 HTML 转换不可用时的处理方式。

主要功能

  1. 01用 arxiv2md 转换 arXiv 论文
  2. 02保留 LaTeX 公式、表格和章节
  3. 03获取并查看所需图表资源
  4. 04提供旧论文的备用读取方式

适用场景

  1. 01无需从 PDF 开始阅读论文正文
  2. 02查看论文中的重要图表
  3. 03处理无法获取 arXiv HTML 的论文

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/leo1oel/leo-agent-skills --skill arxiv-reading

安装后在 Claude Code 中输入/arxiv-reading确认已加载。

详细介绍

arXiv 论文阅读

以清晰的 Markdown 阅读论文,不要阅读 PDF。 对于判断方面——从论文中提取什么内容以及如何权衡,请使用 research-taste 技能。

阅读前先转换

对于 arXiv 论文,使用 arxiv2md 转换为 Markdown。它会解析 arXiv 的结构化 HTML,并保留 LaTeX 格式的数学公式、真实表格和章节树:

uvx --from arxiv2markdown arxiv2md <id> -o paper.md

/abs/、/pdf/ 和 /html/ 这几种 URL 形式使用相同的 ID,因此 PDF 链接也可以使用;只需提取其中的 ID。

图表

arxiv2md 会保留文本、数学公式和表格,但不会下载图表。 每个图表在 Markdown 中都会显示为一行不起作用的文本,例如 Refer to caption: 2501.11120v1/x1.png——这是相对资源路径,不是 URL,也不是已保存的文件。

要实际查看图表,请将该路径与 https://arxiv.org/html/ 拼接,下载资源,然后使用 Read 工具打开(Read 会以视觉方式呈现图像):

curl -sL https://arxiv.org/html/2501.11120v1/x1.png -o fig1.png

然后用 Read 读取 fig1.png。 将论文读取操作导向 arxiv2md 的工具调用前钩子允许下载这些图像资源(.png、.jpg、.svg 等),同时仍会阻止直接获取 HTML/PDF 论文,因此请一次下载一个图表,而不是获取整个 HTML 页面。 只下载实际需要的图表——大多数论文只需阅读文本和几张关键图表即可。

备用方案

如果 arxiv2md 没有可用的 HTML(较早的论文尚未由 arXiv 渲染为 HTML),请按以下顺序处理:

  1. 使用 WebFetch 访问 https://ar5iv.org/abs/<id> 并提出具体问题;ar5iv 会从 LaTeX 源码为大多数较早的论文渲染 HTML。
  2. 仅将 PDF 作为最后手段,使用 Read 工具按页码范围读取,而不是盲目转储全文。通常只看摘要就足以判断是否值得继续阅读。

评论

支持 Markdown