Hyperresearch：让Claude Code产出可核验的深度研究报告
给Claude Code用的深度研究工具，把网页证据沉淀进可搜索vault并逐条核验引用。
GitHub jordan-gibbs/hyperresearch 更新 2026-09-12 分支 main 星标 2.6K 分叉 258
Python 深度研究 Claude Code SQLite MCP Markdown知识库

🧭 决策指南

为什么现在热： 无法从材料判断

适合，如果你

  • 你已有Claude Code和Python 3.11–3.13，需要输出带引用核验的研究报告。
    README 的“Install”和“Requirements”章节要求Python 3.11+与Claude Code；“Why it wins”说明cite-checker会核验每条引用。
  • 你的问题需要同时检索OpenAlex、Crossref、CORE、DOAB、ClinicalTrials.gov、SEC EDGAR和FRED。
    README 的“Why it wins”章节明确列出hpr scholar search支持的八个学术源和DOI、标题去重。
  • 你要把多次研究积累到Markdown加SQLite vault，并在任务中断后继续。
    README 的“Why it wins”和“Runs: resumable, budgeted, verified”章节说明来源进入持久vault，run resume可恢复到准确步骤。
  • 你需要从30分钟快速路径扩展到25K–80K字、300–450来源的dissertation运行。
    README 的“Why it wins”章节给出5步fast path、25K–80K字和300–450来源的范围。

不适合，如果你

  • 你的运行环境是Python 3.14，且不能切换到Python 3.11–3.13。
    README 的Install提示写明“3.14 not yet supported”。
  • 你不使用Claude Code，也不打算通过MCP、Web UI等方式接入vault。
    README 的Requirements要求Claude Code；“Use the vault outside Claude Code”只列出MCP和本地Web UI两种外部使用方式。
  • 你要求DeepResearch-Bench成绩已有第三方确认。
    README正文明确写着“Third party validation is pending”。
  • 你的任务只需要一次短答案，不需要16步pipeline、250+来源或cite-check。
    README的pipeline包含16步；“Why it wins”描述250+来源和逐条引用核验。

前置条件

  • Python 3.11+；README特别说明Python 3.14尚未支持。
  • Claude Code。
  • 项目安装命令为：pip install hyperresearch && hyperresearch install。
  • 可选MCP依赖：pip install hyperresearch[mcp]。
  • run init --budget 50可设置估算API等价开销上限；README未说明具体模型或供应商。

第一步命令（README 原文）

pip install hyperresearch && hyperresearch install

要注意

  • 全局安装会让每个Claude Code会话增加约15行系统提醒；项目级安装可避免影响无关会话。
    README的Install章节对hyperresearch install --global明确说明了约15行system reminder的代价。
  • run init --budget超出预算会阻止运行，不会让开销静默增长。
    README的Runs章节说明预算越界会阻塞run。
  • 闭源论文会优先经Unpaywall、Europe PMC和CORE寻找合法全文，替换行为会写入note、frontmatter和CLI输出。
    README的Why it wins章节说明了付费论文的全文替换与披露位置。
  • 本地Web UI使用stdlib HTTP server监听8080，无构建步骤和JavaScript依赖。
    README的Use the vault outside Claude Code章节明确给出端口8080及运行方式。

替代方案

  • Hyperresearch MCP：你主要使用Claude Desktop或Cursor，而不是Claude Code命令入口时，可让这些客户端通过stdio访问同一个vault。
    Use the vault outside Claude Code
  • Hyperresearch local web UI：你只需要浏览笔记、标签、搜索和交互式链接图时，可用hyperresearch serve --open，而不必接入Claude Code。
    Use the vault outside Claude Code

材料未说明

  • README未提供实际使用的LLM模型名称、API供应商、单次运行真实成本或延迟。
  • README未给出250+来源声明对应的公开可复现实验记录；仅说明DeepResearch-Bench第三方验证待完成。
  • README未说明支持的操作系统、最低硬件配置和大规模SQLite vault的容量上限。
  • README未说明Web提供商、Authenticated crawling和browser lane所需的账号、密钥及具体支持范围。
  • README未说明研究数据、API密钥和本地vault的加密、访问控制或远程同步方案。
  • README未给出Python包的详细依赖锁定信息、测试覆盖率或10次最近提交的具体内容。

💡 深度解析

6
适合 我同时维护多个 Claude Code 项目，只希望在一个 Python 3.13 研究目录启用 Hyperresearch，避免给其他会话增加系统提醒；应该采用哪种安装方式？
适合读者： 维护多个 Claude Code 项目、只想在一个研究项目中启用 Hyperresearch 的 Python 3.11–3.13 开发者

适合，应该采用 README 给出的项目级安装，而不是全局安装。

  • README 的标准流程是在目标目录执行 pip install hyperresearch && hyperresearch install，随后在 Claude Code 中使用 /hyperresearch。
  • 项目要求 Python 3.11–3.13，Python 3.14 尚未支持；你的 Python 3.13 约束符合要求。
  • README 明确说明 hyperresearch install --global 会让命令出现在所有 Claude Code 会话中，并给每个会话增加约 15 行系统提醒。
  • 项目级安装则保持无关的 Claude Code 会话干净，更符合只隔离启用一个研究项目的要求。
  • README Install: “cd your-project / pip install hyperresearch && hyperresearch install”
  • README Requirements: “Python 3.11–3.13. (3.14 not yet supported.)”
  • README Install: “`hyperresearch install --global` ... at the cost of ~15 lines in every session's system reminder.”
  • README Install: “Per-project install ... keeps unrelated CC sessions clean.”
cd your-project
pip install hyperresearch && hyperresearch install
材料未说明：README 未说明项目级安装是否会影响该目录中已有的 Claude Code Skill 或系统提示。；README 未说明不同 Python 虚拟环境之间的 vault 默认路径是否完全隔离。
适合 我主要在 Cursor 中工作，希望继续使用本地 Markdown 和 SQLite 研究资料，并通过 MCP 搜索、读取和更新这些笔记；Hyperresearch 是否满足这个部署约束？
适合读者： 在 Cursor 中使用 MCP、希望复用团队本地研究资料而不迁移到云端知识库的开发者

适合，README 明确提供面向 Cursor 的 MCP 入口，并把知识库存储在本地 Markdown 加 SQLite 中。

  • 安装 hyperresearch[mcp] 后，hyperresearch mcp 通过 stdio 提供 MCP 服务，Cursor 等 MCP 客户端可以使用同一个 vault。
  • MCP 暴露 13 个工具，包括 search_notes、read_note、get_backlinks、check_source、create_note 和 update_note，不只是只读搜索。
  • 本地 Web UI 使用标准库 HTTP 服务器，不需要构建步骤或 JavaScript 依赖，也可浏览标签、搜索和链接图。
  • 但项目洞察指出默认本地服务和 vault 的访问控制、团队权限隔离与敏感资料治理需要部署者自行评估。
  • README: “An MCP server. `pip install hyperresearch[mcp]`, then `hyperresearch mcp` speaks stdio, so Claude Desktop, Cursor, or anything else that speaks MCP can work the same vault.”
  • README: “Thirteen tools: `search_notes` ... `update_note`”
  • README: “No build step and no JavaScript dependencies.”
  • 项目洞察：MCP 和本地 Web UI 的访问控制、团队协作与权限隔离需要部署者自行评估
pip install hyperresearch[mcp]
材料未说明：README 未说明 MCP 服务是否提供认证、加密传输或多用户权限模型。；README 未说明多个 Cursor 实例同时修改同一 vault 时的冲突处理方式。
适合 我需要提交一份可审计的政策报告，关键要求是每个引用句都能回溯到来源，并能发现撤稿和无法追溯的数字；Hyperresearch 是否比普通研究型聊天工具更合适？
适合读者： 需要提交可审计政策报告、特别关注引用句支持、撤稿和数字证据的合规或战略分析师

适合，尤其适合把引用和研究过程作为发布门禁，而不是只生成一份带参考文献的文本。

  • README 说 cite-checker 会核验每个引用来源是否真正支持对应句子，虚构引文和未披露撤稿会在门禁阶段阻断发布。
  • 发布前验证包含 quote-integrity、retracted-citations、numeric-consistency，以及逐引用 binding audit，直接对应你的审计要求。
  • 来源、笔记、链接和运行 manifest 持久化到 vault，能够检查原始材料和研究过程，而不只查看最终报告。
  • 但这不是形式化事实证明：项目洞察指出模型仍可能误读来源、过度因果推断，网页访问失败时也可能只能使用摘要或替代版本。
  • README: “Every citation is verified before the report ships.”
  • README: “quote-integrity ... retracted-citations ... numeric-consistency”
  • README: “plus the cite-check step's per-citation binding audit.”
  • 项目洞察：系统不能保证事实绝对正确，无法获取原文时可能使用摘要、替代版本或不完整证据
hyperresearch run verify <tag> -j
材料未说明：README 未说明 cite-checker 对来源质量、研究设计或因果推断的自动判定精度。；README 未说明审计记录是否具备适合监管或法律举证的不可篡改性。
视情况 我已经使用 Python 3.13 和 Claude Code，需要完成一篇 25K–80K 字、整合 300–450 个来源的论文；Hyperresearch 能否作为主要研究流水线？
适合读者： 使用 Python 3.13 和 Claude Code 撰写 25K–80K 字论文、需要整合 300–450 个来源的研究生或学者

视情况，适合承担检索、证据整理和初稿生成，但不适合作为论文质量的唯一保证。

  • README 明确支持 opt-in dissertation runs，可跨章节生成 25K–80K 字并处理 300–450 个来源。
  • 16 步流程包含问题分解、矛盾分析、综合写作、四类批评、引用核验和发布前检查，适合长篇研究的过程管理。
  • 研究结果会保存到 Markdown 加 SQLite 的可搜索 vault，运行还带 manifest，可在崩溃后从中断步骤恢复。
  • 但 README 也说明系统不能保证事实绝对正确，开放获取替代版本可能与正式出版版本存在差异；论文的方法、统计和学术伦理仍不由工具验证。
  • README: “Opt-in dissertation runs write 25K–80K words across chapters, from 300–450 sources.”
  • README: “A tier-adaptive 16-step pipeline”
  • README: “Every source lands in a searchable markdown-plus-SQLite vault”
  • README: “Crashed runs resume”
  • 项目洞察：引用验证不能完全判断研究设计质量、统计方法正确性或学术论证是否符合学科规范
cd your-project
pip install hyperresearch && hyperresearch install
材料未说明：README 未说明生成的章节是否符合目标期刊、学校或学位论文模板。；README 未给出 dissertation 模式的实际运行时长、API 成本或不同模型配置下的质量差异。
适合 我使用 Claude Code 做多轮网页研究，预算不能超过估算的 API 等价成本，而且运行可能因网络或进程问题中断；Hyperresearch 能否阻止预算失控并从原步骤继续？
适合读者： 需要控制 Claude Code 研究成本、并经常遭遇网络中断或进程崩溃的独立研究者

适合，它把预算上限、隔离运行和按步骤恢复直接做进运行机制。

  • run init --budget 50 会设置估算 API 等价支出上限，超过上限时阻止运行，而不是让成本继续膨胀。
  • 每次运行拥有独立 workspace 和 manifest，并记录步骤、花费和来源产出，因此并发运行不会互相碰撞。
  • hyperresearch run resume -j 会显示精确的下一步及继续所需的 Skill 调用；README 明确说崩溃运行可从停止步骤恢复。
  • 预算只是阻断机制，不保证任务在上限内完成；项目洞察还指出多 Agent、补缺抓取和审查会带来较高模型调用和网络请求量。
  • README: “`run init --budget 50` caps estimated API-equivalent spend”
  • README: “Each run owns an isolated workspace ... and a manifest”
  • README: “`run resume` picks up at the exact step where it died.”
  • 项目洞察：完整流程会产生大量模型调用、网络请求和本地存储需求
hyperresearch run status -j
材料未说明：README 未说明预算估算与实际供应商账单之间的误差范围。；README 未说明网络请求失败、部分步骤重试或重复调用是否会增加已计入的 spend。
适合 我需要把论文、书籍、临床试验、SEC EDGAR 文件和 FRED 数据放进同一份研究清单；Hyperresearch 是否能减少我维护多个检索入口和去重流程的工作？
适合读者： 需要同时检索 OpenAlex、Crossref、CORE、DOAB、ClinicalTrials.gov、SEC EDGAR 和 FRED 的政策或金融研究分析师

适合，因为它正面覆盖了多类型学术与专业数据源的统一检索和去重。

  • README 的 hpr scholar search 通过一个客户端层访问 OpenAlex、Crossref、CORE、DOAB、ClinicalTrials.gov、SEC EDGAR 和 FRED。
  • 返回结果会按 DOI 和标题去重，并给论文、书籍、试验和申报文件加标签，使流水线知道来源类型。
  • 研究来源随后进入可搜索 vault，后续会话可以优先复用已有材料，而不是重新抓取。
  • 但它仍依赖外部服务的 API 可用性、速率限制和元数据质量；README 没有承诺每个数据源的完整覆盖，也没有说明复杂授权数据库的接入方式。
  • README: “Eight scholarly sources, one query”
  • README: “returns a single list deduplicated by DOI and title”
  • README: “Nothing is thrown away”
  • 项目洞察：外部数据源的 API 可用性、速率限制和元数据质量可能影响检索结果
pip install hyperresearch[mcp]
材料未说明：README 未列出各数据源具体支持的字段、分页限制和失败重试策略。；README 未说明 SEC EDGAR 或 FRED 查询是否覆盖所有高级过滤和时间序列操作。

✨ 核心亮点

  • 单次运行可覆盖250+来源，并支持25K–80K字论文级输出
  • cite-checker逐条核验引用，撤稿和虚假引文会阻止发布
  • OpenAlex等八个学术源由hpr scholar search统一检索去重
  • Markdown加SQLite持久化vault，崩溃后可用run resume续跑

🔧 工程化

  • Claude Code调用16步pipeline，生成带完整来源溯源的对抗审计报告
  • hpr scholar search统一查询OpenAlex、Crossref、CORE等八个学术源
  • vault以Markdown和SQLite保存来源，下一次会话可复用既有研究
  • 四个critic并行攻击草稿，tool-locked patcher只能执行外科式编辑

⚠️ 风险

  • 项目要求Python 3.11–3.13与Claude Code，Python 3.14尚未支持
  • DeepResearch-Bench领先说法来自内部基准，第三方验证仍待完成
  • premier配置目标250+来源，run init --budget仅限制估算API等价开销
  • 全量16步包含四轮critic、gap-fetch和cite-check，短问答可能不划算

👥 适合谁？

  • 需要Claude Code完成可追溯文献综述、调查报告或论文研究的开发者
  • 需要跨论文、书籍、临床试验和SEC文件检索的研究团队
  • 希望用MCP接入Claude Desktop或Cursor共享研究vault的用户
  • 需要30分钟快速路径或25K–80K字dissertation模式的个人研究者