deep-research

# Gemini 深度研究技能 运行自主研究任务，进行规划、搜索、阅读并将信息综合成全面的报告。 ## 何时使用此技能 在以下情况使用此技能： - 执行市场分析 - 进行竞争格局分析 - 创建文献综述 - 进行技术研究 - 执行尽职调查 - 需要详细的、带引用的研究报告 ## 要求 - Python 3.8+ - httpx: `pip install -r requirements.txt` - GEMINI_API_KEY 环境变量 ## 设置 1. 从 [Google AI Studio](https://aistudio.google.com/) 获取 Gemini API 密钥 2. 设置环境变量： bash export GEMINI_API_KEY=your-api-key-here 或者在技能目录中创建一个 `.env` 文件。 ## 使用方法 ### 启动研究任务 bash python3 scripts/research.py --query "Research the history of Kubernetes" ### 使用结构化输出格式 bash python3 scripts/research.py --query "Compare Python web frameworks" --format "1. Executive Summaryn2. Comparison Tablen3. Recommendations" ### 实时流式传输进度 bash python3 scripts/research.py --query "Analyze EV battery market" --stream ### 启动后不等待 bash python3 scripts/research.py --query "Research topic" --no-wait ### 检查正在进行的研究状态 bash python3 scripts/research.py --status ### 等待完成 bash python3 scripts/research.py --wait ### 从之前的研究继续 bash python3 scripts/research.py --query "Elaborate on point 2" --continue ### 列出最近的研究 bash python3 scripts/research.py --list ## 输出格式 - **默认**：人类可读的 Markdown 报告 - **JSON** (`--json`)：用于程序化使用的结构化数据 - **Raw** (`--raw`)：未经处理的 API 响应 ## 成本与时间 | 指标 | 数值 | |--------|-------| | 时间 | 每个任务 2-10 分钟 | | 成本 | 每个任务 $2-5 (视复杂程度而定) | | Token 使用量 | ~250k-900k 输入, ~60k-80k 输出 | ## 最佳用例 - 市场分析和竞争格局分析 - 技术文献综述 - 尽职调查研究 - 历史研究和时间线 - 比较分析（框架、产品、技术） ## 工作流 1. 用户请求研究 → 运行 `--query "..."` 2. 通知用户预计时间（2-10 分钟） 3. 使用 `--stream` 监控或使用 `--status` 轮询 4. 返回格式化结果 5. 使用 `--continue` 进行后续提问 ## 退出代码 - **0**: S