Articlefeed

ArticleFeed — 快速上手

ArticleFeed 是一套运行在 Claude Code 里的学术论文阅读系统，帮你做三件事：找论文、读论文、追踪进度。

它是怎么工作的

整个系统由两部分组成：

- Python 脚本：搜索论文、查询引用数和作者信息、批量重命名 PDF。数据来源是 Semantic Scholar——由艾伦人工智能研究所（AI2）维护的免费学术搜索引擎，收录超过 2 亿篇论文，覆盖人文社科和理工科，无需登录
- Claude Code 技能（skill）：你输入 /feed、/read 等命令，Claude 就会执行对应的流程——更新搜索词、精读分析、写笔记、存文件

两者配合形成一个循环：

Claude 会记住你的研究背景（存在 memory/MEMORY.md），每次 /feed 都基于你已读的论文动态调整推荐方向。笔记按日期归档，和 PDF 放在一起，存入你指定的数据目录。

包含什么

目录结构说明

脚本文件和笔记/PDF 放在不同的文件夹里：

配置步骤

第零步：安装依赖

Claude Code（若尚未安装）：参考 官方文档。

poppler（PDF 工具库，提供 pdftotext）：

Python 仅使用标准库，无需额外安装。

第一步：运行安装脚本

打开终端，进入 ArticleFeed 目录，运行安装脚本：

脚本会自动完成：
- 在 .claude/ 下创建 commands 软链接，指向根目录的 commands/（Claude Code 通过此链接识别技能命令）
- 创建 memory/ 软链接，指向 Claude 的记忆目录（可直接在项目里浏览和编辑）
- 复制权限配置（写文件、建文件夹、下载 PDF 等操作不再弹出确认）
- 从 template/ 复制 config.json、search_config.json、interest_profile.json 初始文件（不覆盖已有文件）

之后对 commands/ 和 memory/ 的任何修改都会实时生效，无需重复操作。

第二步：填写路径
编辑安装脚本生成的 config.json，填入你的研究数据文件夹路径（PDF 放这里，笔记自动存入其中的 notes/ 子目录）：

如何获取路径：

- Mac：在 Finder 中找到目标文件夹，右键 → 按住 Option 键 → 点击「拷贝"xxx"的路径名」，粘贴即可。或者直接把文件夹拖入终端窗口，会自动显示路径。
- Windows：在文件资源管理器中打开目标文件夹，点击地址栏，复制显示的路径。或按住 Shift 右键文件夹 → 「复制为路径」。
- Linux：在终端中进入目标文件夹，运行 pwd 即可。

路径格式示例：

不填 API key 也能正常使用，Semantic Scholar 免费层无需注册。有 key 时速率限制更宽松，搜索更快；没有 key 时遇到限速会自动重试，不影响结果。

如需申请：https://www.semanticscholar.org/product/api

第三步：运行 /setup，让 Claude 帮你完成剩余配置
在 ArticleFeed 目录打开 Claude Code：

输入 /setup，Claude 会通过对话了解你的研究方向，自动生成：
- memory/MEMORY.md（研究背景）
- search_config.json（初始搜索词）
- data_dir/notes/reading_list.md（阅读列表，含适合你领域的分类）

不需要手动编辑这些文件。

日常使用

文件夹结构（运行后）

使用注意：自然语言指令的漂移问题

ArticleFeed 的命令（/read、/feed 等）是用自然语言写的 .md 文件，由 Claude 解释执行。这和代码有本质区别：

具体表现：命令文件里写"各作者：机构、职级、h-index（如可查）"，对 Claude 来说是建议性字段，不是硬约束。同一条命令在有上下文参照（刚看过格式正确的上一篇笔记）和没有参照（新对话冷启动）时，产出质量会不一样。

应对方式：命令文件里需要用"必须"、"不可"、"至少 N…