SuperAPI AI 工具集

read-arxiv-paper

写作与研究

查看项目

更新于 10-15 20:11

技能介绍

用途:作为学术论文研究助手,把 arXiv 论文转成 Obsidian vault 中的结构化解读笔记,风格类似 AlphaXiv blog,有图有文而非摘要翻译。

环境要求:Python 3 与 pymupdf(pip install pymupdf);环境变量 OBSIDIAN_VAULT 指向 vault 路径。所有下载、提取、写入操作须直接在 $OBSIDIAN_VAULT 下进行,禁止使用 /tmp 等临时目录。

目录结构:assets/pdfs 存 PDF,assets/png/{arxiv_id}/ 存图片,papers/notes/ 存以 arXiv ID 命名的笔记,papers/index/ 存 .base 索引,knowledge/Summary/ 存综述。

工作流程:Step 0 先查 papers/notes/{ARXIV_ID}.md 是否已存在,存在则跳过;Step 1 用 curl -sL "https://arxiv.org/pdf/$ARXIV_ID.pdf" -o "$OBSIDIAN_VAULT/assets/pdfs/$ARXIV_ID.pdf" 下载;Step 2 从 HTML 或 PDF 提取全文,必须读完全文并列出所有 Figure/Table 编号标题后才动笔;Step 3 按模板生成笔记,文件名用 arXiv ID;Step 4 图片优先用在线链接 https://arxiv.org/html/{ARXIV_ID}v1/x{N}.png,仅在 HTML 版不存在或 404 时下载到本地,必要时用 pymupdf 从 PDF 提取;Step 5 全部笔记写完后统一执行 paper-index skill 更新索引。

笔记模板含 frontmatter(title、title_zh、authors、year、arxiv、pdf、tags、tldr、date_added)及研究动机、核心方法、实验与结果、消融、个人思考、通俗讲解、相关论文等章节。tags 不能含空格,用连字符或下划线。公式行内用单美元、行间用双美元,禁止用反引号包裹。质量要求:动机至少 300 字、方法至少 500 字、整篇至少 1500 字,只引用 2-4 张关键图且每图配中文说明。

限制:需自行配置 Python 环境与 OBSIDIAN_VAULT;依赖 arXiv HTML 版可用性;未提供收费、平台支持等信息。