Hyperresearch 安全边界设计CAPTCHA 和 2FA 为什么永远交给人处理的完整解读【免费下载链接】hyperresearchAgent-driven research knowledge base. Agents collect, search, and synthesize web research into a persistent, searchable wiki.项目地址: https://gitcode.com/GitHub_Trending/hy/hyperresearchHyperresearch 是一个 Agent 驱动的深度研究工具AI 智能体自主收集、搜索并综合网页资料沉淀为可持久检索的研究知识库。当 Agent 一次读取 250 个网页来源时如何保证它不越界本文带你完整解读 Hyperresearch 安全边界设计——升级队列、浏览器泳道与硬边界三层机制以及 CAPTCHA 和 2FA 为什么永远交给人处理。一、为什么研究智能体需要明确的安全边界研究智能体的核心循环是抓取 → 阅读 → 综合。Hyperresearch 在单次完整运行中会读取 250 个来源官方基准测试中它取得了 DeepResearch-Bench 榜单的综合领先成绩来源读得越多撞上登录墙、机器人检测墙、验证码的概率就越高。更关键的是README 里有一句直白的定义The web is hostile input网络是敌对输入——Agent 读几百个自己没选过的页面其中任何一个都可能包含写给 Agent 看、而不是写给你看的文字。因此安全边界必须同时回答两个问题遇到打不开的页面来源就直接丢了吗️遇到只有人类该做的事Agent 会不会自作主张Hyperresearch 对这两个问题的答案分别落在下面三层设计里。二、升级队列被拦截的页面不再静默丢失早期版本中无头爬虫碰到登录墙或机器人墙时URL 会被直接丢弃——在博士论文级别的研究量300–450 个来源下一次运行就会静默丢失几十个来源。现在的做法是结果分类而非失败即弃被拦截的 URL 会进入一个持久化的升级队列escalation queue记录拦截原因login_wall/bot_block/captcha/fetch_failed等、效用分数和来源出处。队列的核心代码见 escalation.py每个条目有清晰的生命周期queued → in_progress → fetched | needs_human | abandoned两个值得新手理解的设计细节SQLite 原子认领队列存在知识库的 SQLite 库中而不是 JSON 文件并行的抓取浪潮可以安全地并发入队claim操作保证两个消费者永远抢不到同一条目效用门槛配置项 ChromeSettings 定义了escalation_utility_threshold默认 8.0和max_items_per_run默认 25——低价值的被拦 URL 直接放弃因为浏览器泳道是串行的、昂贵的工作通道只留给真正值得的来源。三、浏览器泳道让 Agent 驱动你真实的 Chrome队列里的条目由专门的hyperresearch-browser-fetcher智能体排空——它通过 Claude-in-Chrome 驱动你本人日常使用的 Chrome 浏览器而不是另一套需要重新登录的爬虫浏览器逐个标签页地打开、等待、提取正文。这个设计本身就体现了安全边界的思路只读不写优先读取而非点击绝不退出登录、绝不改变账号状态、绝不离开被认领条目的域名串行限速一次只开一个标签页人为节奏human-paced访问而不是高速轰炸不存储凭据会话就留在你自己浏览器的 Profile 里Hyperresearch 一个字节都不保存不绕过付费墙泳道只读取你自己的订阅能看到的内容不存在付费墙规避。完整的架构决策与非目标声明写在设计文档 phase-4-chrome-lane.md 里。四、硬边界CAPTCHA / 2FA / 登录永远不自动解决这是整个安全边界设计的承重墙项目文档的原话是No automated CAPTCHA solving and no bot-detection defeat…… This is a hard scope boundary, not a deferred feature.不自动解验证码、不击败机器人检测。这是硬性范围边界不是以后再做的功能。Agent 提示词里同样写死了这条红线见 hooks.py 中的 browser-fetcher 定义You NEVER attempt to solve, bypass, or automate CAPTCHAs, 2FA prompts, or login forms.Agent 碰到验证的瞬间就停下执行一条命令把条目标记为needs_human然后处理下一个hyperresearch escalation human id --detail solve CAPTCHA on example.com -j对应的 CLI 实现是 escalation_cmd.py 中的human子命令其帮助文本直接写着Mark an item as needing the human (CAPTCHA / 2FA / login). NEVER solve these automatically.为什么不做自动解题三个原因原因说明 权责归属验证码和 2FA 本质上是账号所有者的身份证明机器代答在语义上就站不住⚖️ 合规风险自动绕过机器人检测会触碰网站的服务条款人完成挑战让整条链路保持干净 用户控制每次敏感交互都留下人类知情同意的痕迹Agent 只是跑腿不做决定五、人性化细节一次批量打断而不是每个 URL 打断一次把问题交给人不等于把人当验证码打手。Hyperresearch 特意设计了**合并提示consolidated prompt**模式编排器在步骤的自然暂停点检查needs_human条目把所有待办合并成一条消息3 个来源需要你[站点 A解验证码]、[站点 B登录]、[站点 C2FA]。在 Chrome 里完成挑战然后回复 done或 skip非交互运行下它会把blocked_on记为human-challenges其余所有工作照常继续等你完成挑战后run resume再补齐这几条来源。设计文档 phase-4-chrome-lane.md 里对这一点的总结很精辟The human does human things in their own browser for ten seconds; the pipeline gets the source.人在自己的浏览器里花十秒钟做人类该做的事流水线拿到来源——一次运行只被打断一次。六、安全边界的其余防线除了 CAPTCHA/2FA 这条主线安全边界还有几层配套垃圾页拦截base.py 的looks_like_junk在保存前就识别 Cloudflare 拦截页、reCAPTCHA、checking your browser 等信号让验证码页面永远不会被当成研究来源写进知识库不可信围栏所有抓取的网页正文在note show和search输出中都被包进untrusted-source围栏标注这是数据不是指令——页面里就算写着忽略你之前的指令Agent 也只会把它当内容读发报告前验证引用逐句核对、撤稿源拦截、引文完整性检查让Agent 读了什么和报告写了什么之间始终有审计线。七、如何上手体验只需一条命令即可安装要求 Python 3.11–3.13pip install hyperresearch hyperresearch install之后在 Claude Code 中用/hyperresearch 你的研究问题启动。当运行碰到登录墙或验证码时用hyperresearch escalation list -j查看队列在步骤暂停点你会收到那条合并好的需要你出手的消息。推荐阅读的源码与文档升级队列核心逻辑escalation.py升级队列 CLIclaim / human / retry / abandonescalation_cmd.py浏览器泳道 Agent 提示词与硬边界原文hooks.pyChrome 泳道完整设计文档phase-4-chrome-lane.md宽度扫描中的人机交接话术hyperresearch-2-width-sweep.md✅一句话总结Hyperresearch 的安全边界不是Agent 不够聪明所以不敢让它做而是明确地把证明你是人这件事划定为人类专属职责——Agent 负责 99% 的跑腿工作最后 10 秒钟的人味儿永远留给你。【免费下载链接】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），仅供参考