KResearch：用Google Gemini API 免费生成深度研究报告

KResearch 是一个开源的浏览器应用，旨在通过人工智能帮助用户快速完成深度研究。它利用谷歌 Gemini API，自动化执行信息收集、分析和报告生成。用户只需输入研究主题，KResearch 会通过提问明确需求，制定研究策略，自动搜索网络信息，并生成结构化的 Markdown 报告。整个过程实时展示，适合学生、研究人员和产品经理等需要快速获取信息的用户。项目托管在 GitHub 上，代码公开，用户可自由部署和修改。

功能列表

• 主题澄清：通过 AI 提问，帮助用户明确研究方向和需求。
• 研究策略生成：根据主题自动生成清晰的研究计划。
• 自动化信息收集：通过谷歌搜索 API 自动获取相关网页和数据。
• 实时研究日志：展示每一步研究进展，保持过程透明。
• 报告生成：生成包含表格、公式和图表的 Markdown 报告。
• 支持多种模式：提供快速、平衡和深度研究模式，满足不同需求。
• 可配置迭代次数：用户可设置 1-500 次研究迭代，控制研究深度。
• 知识图谱输出：生成可视化的概念关系图，清晰展示信息结构。

使用帮助

安装流程

KResearch 是一个基于浏览器的开源工具，部署简单，无需复杂环境。以下是详细安装步骤：

1. 克隆代码库
   打开终端，运行以下命令克隆 KResearch 项目：

   git clone https://github.com/KuekHaoYang/KResearch.git
   

   进入项目目录：

   cd KResearch
   

2. 安装依赖
   使用 npm 或 pnpm 安装项目依赖：

   npm install
   

   或

   pnpm install
   

3. 设置 API 密钥
   KResearch 依赖谷歌 Gemini API，需要配置 API 密钥。
   • 创建 .env 文件，在项目根目录运行：

     echo 'API_KEY="your_gemini_api_key_here"' > .env
     

   • 或者，通过浏览器界面设置密钥。打开应用后，点击右下角“设置”按钮，在弹窗中输入 API 密钥。密钥会存储在浏览器本地，数据不会外泄。
   • 获取 Gemini API 密钥：访问谷歌云平台，创建项目并启用 Gemini API，生成密钥。
4. 启动开发服务器
   运行以下命令启动本地服务器：

   npm run dev
   

   终端会显示本地地址（通常是 http://localhost:5173）。在浏览器中打开此地址，应用即可运行。如果 API 密钥未配置，界面会显示警告。

使用流程

1. 输入研究主题
   打开 KResearch 网页，界面中央有一个大输入框。输入研究主题（如“人工智能在医疗中的应用”），支持中英文或混合语言输入。
2. 选择研究模式
   在界面左上角选择研究模式：
   • Ultra Fast：快速扫描，适合初步探索（约 1-2 分钟）。
   • Fast：中等速度，适合简单研究。
   • Balanced：平衡速度与深度，适合大多数场景。
   • Deep Dive：深度研究，耗时约 15 分钟，适合复杂课题。
     推荐先用 Ultra Fast 测试主题范围，确认后再用 Deep Dive 深入研究。
3. 设置迭代次数
   在输入框下方，设置最大研究迭代次数（1-500）。迭代次数越多，信息收集越全面，但耗时也越长。建议初次使用设为 10-20 次。
4. 澄清主题
   点击“下一步：澄清主题”按钮。AI 会提出 2-3 个问题，帮助明确研究范围。例如，输入“区块链技术”后，AI 可能询问：“您是想研究区块链的应用场景、技术原理，还是市场趋势？” 用户回答后，AI 会保存“澄清完成”状态。
5. 审查研究策略
   AI 生成研究策略后，界面会显示计划大纲（如“技术瓶颈 → 供应链 → 政策影响”）。用户可编辑策略，或选择“直接开始研究”或“审查首项行动并继续”。后者允许用户检查 AI 提出的第一个搜索查询。
6. 监控研究过程
   点击“执行行动并开始研究”后，界面右方会显示实时研究日志。日志记录每一步搜索和分析动作。如果某步骤耗时超过 1 分钟，界面会显示“仍在工作”提示。用户可随时点击“取消”中断研究。
7. 获取报告
   研究完成后，KResearch 生成 Markdown 报告，包含标题、表格、KaTeX 公式（如数学模型）和 Mermaid 图表（如概念关系图）。报告分两阶段生成：初稿和详细修订稿。用户可下载或复制报告，用于学术写作或工作汇报。

特色功能操作

• 实时日志：右方面板显示 AI 决策过程，如搜索关键词和提取的关键点。用户可随时检查 AI 的逻辑。
• 知识图谱：报告附带概念关系图，展示主题内实体（如人物、公司）间的联系，适合复杂课题分析。
• 多语言支持：输入框支持中英文混合输入，报告语言与输入一致，适合全球用户。
• 开源定制：用户可修改代码，调整 AI 行为或界面样式。GitHub 仓库提供详细文档，社区支持丰富。

注意事项

• 确保网络稳定，API 调用需要持续连接。
• API 密钥需妥善保存，避免泄露。
• 报告默认不包含引文。若需引用，需手动从日志中提取来源链接。

应用场景

1. 学术研究
   学生或学者可使用 KResearch 快速收集论文相关资料。例如，研究“量子计算发展”，KResearch 可生成包含技术进展、关键人物和最新论文的报告，节省手动搜索时间。
2. 市场分析
   产品经理可通过 Ultra Fast 模式快速了解市场趋势，再用 Deep Dive 模式深入分析竞争对手或行业数据。例如，研究“电动车电池技术”，可得到供应链和政策影响的详细报告。
3. 学习辅助
   学生可利用 KResearch 整理课程笔记或复习资料。例如，输入“机器学习基础”，KResearch 会生成包含算法原理和案例的结构化笔记。
4. 项目规划
   创业者可使用 KResearch 探索新领域的可行性。例如，研究“可持续能源解决方案”，可获得技术、市场和政策的综合分析。

QA

1. KResearch 需要付费吗？
   KResearch 是免费的开源工具，但需要用户自行获取谷歌 Gemini API 密钥。API 使用可能涉及费用，具体取决于谷歌的定价政策，建议访问 https://x.ai/api 查看详情。
2. 报告质量如何保证？
   KResearch 通过多轮迭代搜索和 AI 筛选确保信息准确性。用户可审查日志和来源链接，验证报告内容。Deep Dive 模式会提取更权威的网页数据。
3. 可以离线使用吗？
   目前 KResearch 依赖网络连接调用 Gemini API，无法离线运行。未来版本可能支持本地模型。
4. 如何处理复杂主题？
   建议使用 Deep Dive 模式，设置较高迭代次数（如 50 次）。在澄清阶段详细回答 AI 问题，确保研究方向精准。