Hyperresearch claims命令完全指南跨来源提取与查询结构化声明【免费下载链接】hyperresearchAgent-driven research knowledge base. Agents collect, search, and synthesize web research into a persistent, searchable wiki.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperresearchHyperresearch 是一个开源的深度研究知识库它让 AI Agent 自动抓取网络来源、沉淀为可持久搜索的研究笔记库并产出有证据背书的报告。其中claims 命令族正是它「结构化提取 跨来源查询」的核心把每个来源支持的**声明claim**存成可查询的数据库条目让哪些来源支持某个观点变成一条命令的事。本文带你完整走通 claims 的 5 个子命令ingest、list、search、matrix、targets。为什么需要 claims 命令从读网页到查声明普通的深度研究工具是一次性的报告生成完读过的内容就丢了。Hyperresearch 的思路是把抓取过的每个来源都沉淀进知识库Markdown 笔记 SQLite 索引而 claims 命令进一步把来源内容拆成结构化声明claim一句可证伪的论断比如异步 IO 显著提升网络型负载的吞吐量quoted_support来源中的原文引用最关键字段引用核查直接依赖它numbers具体数字、百分比、阈值数字一致性检查的数据源stance / stance_target该声明支持还是反驳某个立场、针对什么论点evidence_type / confidence证据类型与置信度在 16 步研究流水线中抓取 Agent 每读一个来源就会把这类声明写入临时 JSON 文件research/runs/vault_tag/temp/claims-note-id.json。但这些文件散落各处、无法聚合——claims 命令把它们持久化进数据库claims 表 全文索引从此声明可以被搜索、按来源分组、跨研究轮次对比。5 个子命令一览子命令一句话说明常用选项ingest把 claims JSON 文件摄入数据库幂等重复运行不重复入库--tag、-jlist列出已入库声明可按来源/研究轮次过滤--note、--tag、-nsearch全声明全文搜索回答哪个来源支持 X-n、-jmatrix一键生成文献综述矩阵每个来源一行--tag、-otargets按立场目标分组跨来源做元分析--min-sources 五个子命令都支持--json或-j输出机器可读结果方便接脚本或管道。第一步用 ingest 一键导入结构化声明claims 文件由流水线的抓取 Agent 自动生成第 2 步宽度扫描与第 13 步补抓都会写你通常只需一条命令把它们收进数据库# 摄入指定研究轮次的声明并给数据打上 vault_tag hyperresearch claims ingest --tag my-topic -j不传--tag时它会自动扫描所有研究轮次工作区research/runs/*/temp/和旧版扁平目录research/temp/下的claims-*.json文件。新手须知文件名必须形如claims-笔记id.json且该笔记要先存在于知识库中否则提示先hyperresearch sync幂等设计每条声明以「笔记 id 内容哈希」去重重复摄入是空操作放心重跑内置安全上限单文件 8MB、单字段 2 万字符一个畸形文件不会拖垮整批导入找不到文件时会打印提示用--tag指定轮次或直接把文件路径传给命令一条声明长什么样下面是单个声明的最小结构由抓取 Agent 按契约写入无需手写{ claim: 异步 IO 在网络型负载下显著提升吞吐, quoted_support: 来源原文引用最多两句, numbers: [10x], evidence_type: empirical, stance: supports, stance_target: async-performance, confidence: high }第二步跨来源查询——search 与 list用 search 回答哪个来源支持 Xhyperresearch claims search 吞吐量提升搜索基于 SQLite 全文索引覆盖claim 正文 quoted_support 原文按相关度排序。每条结果会显示来源笔记 id、声明内容截断到 120 字符以及原文引用160 字符一眼看清谁在支持什么。用 list 按来源精确浏览hyperresearch claims list --note python-async-patterns -n 50 hyperresearch claims list --tag my-topic--note只看某个来源提取的声明--tag只看某一研究轮次的数据——适合撰写报告时核对我到底从这篇文献里拿到了哪些证据。第三步用 matrix 一键生成文献综述矩阵hyperresearch claims matrix --tag my-topic -o matrix.md这是 claims 表最直观的产出为每个有声明的来源生成一行包含层级、类型、发表载体、被引次数、质量分、声明数实证/量化各多少并自动挑出该来源信号最强的一条关键发现优先实证、带数字、高置信度的声明。行按质量分从高到低排序被撤稿的来源会醒目标注RETRACTED。输出就是标准 Markdown 表格-o参数直接落盘——这正是论文写作场景下的文献综述附录把数周的人工整理表格变成一条命令。第四步用 targets 做跨来源元分析hyperresearch claims targets --tag my-topic --min-sources 3它把所有声明按stance_target立场目标分组只保留被 ≥N 个不同来源讨论过的目标默认 2并输出讨论该目标的来源数与声明数立场分布比如 3 个来源支持、1 个来源反驳每条声明的带来源归属的数字值——现成的对比表格底料方便你标出离群值对多个来源就同一问题给出不同结论的场景综述、争论类选题targets 直接给出分歧全景。它在流水线中的位置一条线索串起来claims 命令不是孤立功能而是整个研究流水线的数据底座环节与 claims 的关系第 2 步 宽度扫描抓取 Agent 提取声明并写入临时 JSON步骤结尾执行claims ingest --tag vault_tag -j见 hyperresearch-2-width-sweep.md第 3 步 矛盾图谱 / 第 9 步 证据摘要可直接消费 claims 表不必反复解析 JSON 文件第 14.5 步 引用核查用quoted_support与数字字段做机械化核查报告数字必须能追溯到声明常见问题问为什么重复 ingest 显示 already present / skipped这是幂等设计在起作用已存在的声明不会重复入库跳过即正常可以放心重跑。问ingest 报 note not in vault 怎么办文件名中的笔记 id 还没进知识库。先运行hyperresearch sync同步笔记再重新摄入。问ingest 提示找不到 claims 文件说明该轮次没有抓取 Agent 产出的声明文件。确认研究运行到第 2 步宽度扫描之后或显式把 JSON 文件路径传给claims ingest 路径...。关键文件索引想深入了解实现细节可以从这些文件入手命令入口src/hyperresearch/cli/claims_cmd.py核心持久化与聚合逻辑摄入、搜索、矩阵、分组src/hyperresearch/core/claims.pyclaims 表的设计蓝图docs/roadmap-2.0/phase-2-source-ranking.md离线测试用例幂等性、FTS 搜索、CLI 调用tests/test_core/test_claims_and_embed.py掌握了 claims 命令族你就不再是读完就忘的研究者每个来源的声明都被结构化留存可搜索、可对比、可核查——下一次研究开局就已经比上一次更聪明。【免费下载链接】hyperresearchAgent-driven research knowledge base. Agents collect, search, and synthesize web research into a persistent, searchable wiki.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperresearch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考