📌 项目地址：jordan-gibbs/hyperresearch | ⭐ 2,433 颗星 | 🔧 Python | 📜 未标注
榜单成绩先放一边
jordan-gibbs/hyperresearch，2433 star，Python。README 自称在 DeepResearch-Bench RACE 榜单领先，但同一页也写明：这是作者拿分层试点对榜单快照做的推算，第三方验证没做。这个成绩先打个问号，下面不围绕它展开。
项目本体：把 Claude Code 变成深度研究代理。一个 prompt 进去，16 步流水线，出来一份经过对抗审计、带完整来源溯源的报告。所有读过的来源进一个持久化可搜索的知识库。
四道闸
AI 研究报告有几个常见失败模式：引用是编的、来源看着多其实是一家、付费墙论文只读了摘要就当读过。这个项目逐条用机制去堵。
第一道，引用逐条验证。 一个”怀疑论” cite-checker 在报告产出前审计每条引用，检查来源是否真的支撑它所在的那句话。捏造的引文、没标注的撤稿，直接硬拦截。不是在提示词里写”请确保引用准确”，是流程上有独立的检查步骤。
第二道，转载不算共识。 独立性审计会聚类衍生副本——五家媒体转载同一篇新闻稿，按一个来源算权重。”搜索结果看起来很多”和”证据真的独立充分”是两回事，这层大多数工具根本不碰。
第三道，付费墙论文尽量拿全文。 常规做法里，闭源论文进知识库时只有 1500 字符的摘要，报告却把它当读过的引用。Hyperresearch 会向 Unpaywall、Europe PMC 和 CORE 请求合法的开放获取版本，存全文；即使出版商屏蔽抓取，也尝试从这几个渠道拿到副本。每次替换都在笔记、frontmatter 和 CLI 输出里披露。说清楚：这不是绕付费墙，没有 OA 版本就读不到全文，只是不假装读过。
第四道，修改权限被锁死。 四个批评者并行攻击草稿，之后一个 tool-locked patcher 修问题。这个 patcher 只能做外科手术式的小编辑，结构上无法重写整份报告。批评和修改分离，防止越改越面目全非——这个设计我觉得是全项目最值得抄的部分。
持久知识库
每次运行读到的所有来源进一个 markdown + SQLite 的 vault，可搜索。下次研究先查库里已有的，再决定要不要抓新的。用得越久，重复抓取消耗越少，来源变成可复用资产。
崩溃恢复也有：每次运行带 manifest，run resume 从断掉的那一步继续。跑到第 14 步挂了不用从头来。
学术搜索与规模
hpr scholar search 一次查询打八个学术源：OpenAlex、Crossref、CORE、DOAB、ClinicalTrials.gov、SEC EDGAR、FRED（README 列了七个机构名，自称八个来源），按 DOI 和标题去重后返回单一列表。论文、书、临床试验、SEC 文件混在一起返回，各带标签。人文社科是特意覆盖的。
规模分两头。默认路径单次运行目标 250+ 来源：premier 配置下仅宽度扫描就瞄准 100–130 个，引文追踪和缺口填补让实际入库量翻倍以上。bounded 查询自动走 5 步快速路径，约 30 分钟出结果。另一头是 opt-in 的 dissertation 模式：写 2.5 万到 8 万字、分章的报告，基于 300–450 个来源。
安装
cd your-project
pip install hyperresearch && hyperresearch install
装完在 Claude Code 里输 /hyperresearch 加研究问题。
Python 要 3.11–3.13，3.14 暂不支持。降级路径：
pyenv install 3.13
# 或
uv venv -p 3.13
# 或
py -3.13 -m venv .venv
我的判断
这个项目的价值不在榜单名次，在于它列出了 AI 研究报告的具体失败模式，然后每条配一个流程机制。cite-checker、独立性审计、OA 替换披露、patcher 权限锁定——每条都对应一个真实存在的坑。
两个限制要想清楚。一是强绑定 Claude Code，不用 Claude Code 就没法用，它不是独立的研究 CLI。二是”paywalled papers get read, not skimmed”有前提：得存在合法 OA 版本，没有的论文它照样只拿得到摘要。
2400+ star 的新项目，迭代快，具体命令参数以仓库为准。