@framers/agentos-ext-deep-research

中文文档
0.2.6发布于 2026/11/11Apache-2.0TypeScriptCommonJS构建来源已验证近 30 天下载 2万

AgentOS的深度研究延伸——多源调查,学术搜索,内容刮取,汇总搜索,趋势发现.

中文使用文档
文档目录12 节
  1. 安装
  2. 使用量
  3. 配置
  4. 工具
  5. researchInvestigate
  6. researchAcademic
  7. researchScrape
  8. researchAggregate
  9. researchTrending
  10. deep_research
  11. 页:1
  12. 许可证

深入研究

这个包提供了代理调查,学术搜索,刮取,汇总搜索,趋势发现和迭代研究工具. 用这个 axios 用于搜索和内容 API, DuckDuckGo HTML 搜索,以及 OpenAI 兼容的聊天完成端点,用于查询分解和报告合成.

安装

npm install @framers/agentos-ext-deep-research

同伴依赖 : @framers/agentos 有范围 >=0.10.40。 。 。 .

使用量

import { AgentOS } from '@framers/agentos';

const agentos = await AgentOS.create({
  extensionManifest: {
    packs: [
      {
        package: '@framers/agentos-ext-deep-research',
        options: {
          serperApiKey: process.env.SERPER_API_KEY,
          braveApiKey: process.env.BRAVE_API_KEY,
          serpApiKey: process.env.SERPAPI_API_KEY,
          openaiApiKey: process.env.OPENAI_API_KEY,
          openrouterApiKey: process.env.OPENROUTER_API_KEY,
        },
      },
    ],
  },
});

配置

选项秘密编号环境变量需求默认
serperApiKeyserper.apiKeySERPER_API_KEY是, 显示空字符串
braveApiKeybrave.apiKeyBRAVE_API_KEY没有未设置
serpApiKeyserpapi.apiKeySERPAPI_API_KEY没有未设置
openaiApiKeyopenai.apiKeyOPENAI_API_KEY,则 OPENROUTER_API_KEY 在共享密钥链中没有共享密钥链, 然后空出字符串
openrouterApiKeyopenrouter.apiKeyOPENAI_API_KEY,则 OPENROUTER_API_KEY 在共享密钥链中没有共享密钥链, 然后空出字符串
primaryProvider无无没有openai
smallModel无无没有gpt-4o-mini
synthesisModel无无没有gpt-4o
secrets秘密地图无没有A. 背景情况 secrets空对象
无无DEBUG没有未设置

从选项中搜索密钥解析,然后是选中的秘密地图,然后是环境 . options.secrets 替换上下文 secrets。 LLM 密钥解析自 openaiApiKey, (中文(简体) ), openai.apiKey, (中文(简体) ), openrouterApiKey, (中文(简体) ), openrouter.apiKey, (中文(简体) ), OPENAI_API_KEY,则 OPENROUTER_API_KEY。 。 。 .

primaryProvider 选择 openai, (中文(简体) ), openrouter 或者说 ollama。一个 OpenRouter 选项或环境键也会选择 OpenRouter 的终点,当 openaiApiKey 缺席。 奥拉马终点是本地的. 无空 DEBUG 允许控制台进度记录,除非每个调用进度回调优先.

工具

工具它会做什么
researchInvestigate调查一个跨网络,学术,社会和新闻的有交叉参考的话题.
researchAcademic在arXiv,谷歌学者或语义学者上搜索学术论文.
researchScrape取自YouTube,维基百科,博客和通用网页的内容.
researchAggregate搜索Serper,Brave和SerpAPI并返回由引擎分组的结果.
researchTrending从Twitter,Reddit,YouTube或Hacker News中检索趋势.
deep_research分解一个查询,搜索并提取出源,分析漏洞并用引用来合成一个报告.

researchInvestigate

参数类型需求说明
query字符串对研究查询或调查专题
sources字符串阵列, enum : web, (中文(简体) ), academic, (中文(简体) ), social, (中文(简体) ), news没有要搜索的源( 默认值 : web, (中文(简体) ), academic, (中文(简体) ), news(中文(简体) )
maxResults编号没有每个源的最大结果( 默认) 10(中文(简体) )

researchAcademic

参数类型需求说明
query字符串对学术搜索查询(关键词、纸张标题、作者名称)
source字符串, enum : arxiv, (中文(简体) ), scholar, (中文(简体) ), semantic没有要搜索的学术来源( 默认 ): arxiv(中文(简体) )
maxResults编号没有返回的最大纸张数量( 默认) 10(中文(简体) )

researchScrape

参数类型需求说明
url字符串对要从中刮取内容的 URL
type字符串, enum : youtube, (中文(简体) ), wikipedia, (中文(简体) ), blog, (中文(简体) ), generic没有平台特定提取的内容类型( 默认 : generic(中文(简体) )

researchAggregate

参数类型需求说明
query字符串对搜索查询
engines字符串阵列, enum : serper, (中文(简体) ), brave, (中文(简体) ), serpapi没有要查询的搜索引擎( 默认 ): serper(中文(简体) )
maxResults编号没有每个引擎的最大结果( 默认) 10(中文(简体) )

researchTrending

参数类型需求说明
platform字符串, enum : twitter, (中文(简体) ), reddit, (中文(简体) ), youtube, (中文(简体) ), hackernews没有发现趋势的平台( 默认 ): hackernews(中文(简体) )
category字符串没有分类或子编辑以过滤趋势( 可选)

deep_research

参数类型需求说明
query字符串对研究问题或待调查的专题
depth字符串, enum : quick, (中文(简体) ), moderate, (中文(简体) ), deep; 默认 : moderate没有研究深度:快速(30000 女士们, 10 搜索),中度(120000 女士们, 20 搜索),深度(540000 女士们, 50 搜索)
maxIterations最小整数 1最大值 10没有最大搜索- 提取- 分析重迭
sources字符串阵列, enum : web, (中文(简体) ), academic, (中文(简体) ), news, (中文(简体) ), social没有要搜索的源类型
focusAreas字符串数组没有需要重点关注的具体方面

页:1

名单要求 serper.apiKey,但工厂不拒绝 丢失的钥匙。 没有它, deep_research 使用 DuckDuckGo HTML 搜索。 有了它,引擎使用聚合搜索;空的提供者结果不会触发 DuckDuckGo. 勇者与 SerpAPI 在键缺失时被跳过 。 调查和汇总搜索跳过失败的源或引擎.

服务辅助工具需要激活. deep_research 声明 capability:web_search 并验证 query 至少已经 3 字符键。 内容 sources 输入会传递到搜索方法,但不会过滤搜索。 没有 LLM 密钥,引擎会搜索原始查询;当它收集内容并保留 LLM 预算时,它的No-op 合成返回一个空摘要. 已配置的 LLM 调用将研究提示和源证据发送到选定的端点.

YouTube 刮取返回 oEmbed 元数据,而不是记录誊本. 维基百科刮取使用英语摘要终点. 调查交叉引用匹配共享标题词. 趋势 category 影响 Reddit; 其他提供者忽略它 .

服务 HTTP 请求使用 a 30000 ms 超时; 通用刮取和引擎页面提取使用 15000 m. 将文本切换到 10000 字符键。 引擎跟踪搜索、提取、 LLM 和过时预算,默认重复限制为 1 页:1 quick, (中文(简体) ), 3 页:1 moderate 财务报告和审定财务报表 6 页:1 deep。这些检查不会取消飞行中搜索或LLM请求.

Firecrawl支持存在于引擎中,但包工厂并没有将Firecrawl设置传递给它.

许可证

阿帕奇 - 2.0

版本与发布记录

@framers/agentos-ext-deep-research 共发布 8 个版本,首次发布于 2026/05/02;过去 12 个月发布了 8 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.6latest2026/11/114 天前
0.2.52026/11/0115 天前
0.2.42026/10/2125 天前
0.2.32026/10/121 个月前
0.2.22026/10/111 个月前
0.2.12026/10/081 个月前

关于 @framers/agentos-ext-deep-research 的常见问题

@framers/agentos-ext-deep-research 是什么?

AgentOS的深度研究延伸——多源调查,学术搜索,内容刮取,汇总搜索,趋势发现.

如何安装 @framers/agentos-ext-deep-research?

在项目目录运行 npm install @framers/agentos-ext-deep-research,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@framers/agentos(>=0.10.40)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@framers/agentos-ext-deep-research 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@framers/agentos-ext-deep-research 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@framers/agentos-ext-deep-research 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@framers/agentos-ext-deep-research 可以商用吗?

@framers/agentos-ext-deep-research 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@framers/agentos-ext-deep-research 的下载量有多少?

根据 npm 官方下载统计,@framers/agentos-ext-deep-research 在 2026/10/16 – 2026/11/14 这 30 天内被下载 20,407 次,日均约 680 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@framers/agentos-ext-deep-research 还在维护吗?

最新版本 0.2.6 发布于 2026/11/11(4 天前);至今共发布 8 个版本,其中过去 12 个月发布了 8 个;首次发布于 2026/05/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。