开放式深度研究 Web 界面

基于原始 Deep Research CLI 项目构建的现代化、交互式 Web 界面。这款 Web 应用程序利用 Next.js 和 shadcn/ui，将命令行研究助手转变为直观且视觉上吸引人的体验。

概述

开放式深度研究 Web 界面是一款由 AI 驱动的研究助手，它使用 Next.js 和 shadcn/ui 将原始的 CLI 工具转换为现代 Web 界面。您可以在 anotherwrapper.com/open-deep-research 上使用自己的 API 密钥试用，也可以自行部署。

该系统结合了搜索引擎（通过 FireCrawl）、网页抓取以及语言模型（通过 OpenAI），能够对任何主题进行深入研究。其主要功能包括：

• 智能研究流程：

  • 通过递归地深入探索主题来执行迭代式研究
  • 利用 LLM 根据研究目标生成有针对性的搜索查询
  • 创建后续问题以更好地理解研究需求
  • 并行处理多个搜索和结果以提高效率
  • 可配置的深度和广度参数，用于控制研究范围

• 研究输出：

  • 生成包含发现与来源的详细 Markdown 报告
  • 实时跟踪研究步骤的进度
  • 内置 Markdown 查看器用于查看结果
  • 可下载的研究报告

• 现代化界面：

  • 用于调整研究参数的交互式控件
  • 对正在进行的研究进度提供可视化反馈
  • 仅限 HTTP 的 Cookie 存储用于保存 API 密钥

该系统保留了原始 CLI 的核心研究能力，同时提供了一个直观的可视化界面，用于控制和监控研究过程。

赞助商

本项目由 AnotherWrapper 荣誉赞助。

快速开始

前提条件

• Node.js v14 或更高版本
• OpenAI 和 FireCrawl 的 API 密钥

安装

1. 克隆并安装

   git clone https://github.com/fdarkaou/open-deep-research.git
   cd open-deep-research
   npm install
   

2. 配置环境

   创建 .env.local 文件，并添加以下内容：

   OPENAI_API_KEY=your-openai-api-key
   FIRECRAWL_KEY=your-firecrawl-api-key
   NEXT_PUBLIC_ENABLE_API_KEYS=false  # 设置为 false 以禁用 API 密钥对话框
   

3. 运行应用

   npm run dev
   

   访问 http://localhost:3000

API 密钥管理

默认情况下（NEXT_PUBLIC_ENABLE_API_KEYS=true），应用程序会显示一个 API 密钥输入对话框，允许用户直接在浏览器中使用自己的 API 密钥试用研究助手。密钥会被安全地存储在仅限 HTTP 的 Cookie 中，绝不会暴露给客户端 JavaScript。

对于您自己的部署，可以通过将 NEXT_PUBLIC_ENABLE_API_KEYS 设置为 false 来禁用此对话框，并改而在您的 .env.local 文件中直接配置 API 密钥。

许可证

MIT 许可证。您可以根据自己的意愿自由使用和修改代码，用于您自己的项目。

致谢

• 原始 CLI： dzhng/deep-research
• 赞助商： AnotherWrapper
• 工具： Next.js、shadcn/ui、anotherwrapper、Vercel AI SDK

祝您研究愉快！

Open Deep Research 快速上手指南

Open Deep Research 是一个基于 Next.js 和 shadcn/ui 构建的现代化 Web 界面，将原本命令行的深度研究工具转化为直观的可视化应用。它结合搜索引擎（FireCrawl）、网页抓取和大语言模型（OpenAI），能够针对任意主题进行迭代式深度研究并生成详细报告。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• Node.js: 版本 v14 或更高（推荐使用 v18+ LTS 版本）
• API 密钥:
  • OpenAI API Key
  • FireCrawl API Key
• 包管理器: npm, yarn 或 pnpm

国内开发者提示：如果访问 GitHub 或 npm 源较慢，建议配置国内镜像加速：

• 设置 npm 淘宝镜像：npm config set registry https://registry.npmmirror.com
• 使用 git clone 时若遇网络问题，可尝试使用 Gitee 镜像或代理加速。

安装步骤

1. 克隆项目并安装依赖

打开终端，执行以下命令获取源码并安装依赖：

git clone https://github.com/fdarkaou/open-deep-research.git
cd open-deep-research
npm install

2. 配置环境变量

在项目根目录下创建 .env.local 文件，并填入您的 API 密钥：

OPENAI_API_KEY=your-openai-api-key
FIRECRAWL_KEY=your-firecrawl-api-key
NEXT_PUBLIC_ENABLE_API_KEYS=false

说明：

• 将 your-openai-api-key 和 your-firecrawl-api-key 替换为实际密钥。
• NEXT_PUBLIC_ENABLE_API_KEYS=false 表示禁用前端输入框，直接使用配置文件中的密钥（适合本地部署）。若设为 true，则启动后会在网页弹窗中输入密钥。

基本使用

启动应用

运行开发服务器：

npm run dev

访问界面

打开浏览器访问：

http://localhost:3000

开始研究

1. 如果启用了 API 密钥输入功能（NEXT_PUBLIC_ENABLE_API_KEYS=true），在页面弹窗中输入您的 OpenAI 和 FireCrawl 密钥。
2. 在主界面输入您想要研究的主题（例如："2024 年人工智能在医疗领域的最新进展"）。
3. 调整研究深度和广度参数（可选）。
4. 点击开始，系统将自动执行多轮搜索、分析和总结。
5. 实时查看研究进度，完成后即可在线预览或下载 Markdown 格式的研究报表。