# godeepresearch

**Repository Path**: xiaoa7/godeepresearch

## Basic Information

- **Project Name**: godeepresearch
- **Description**: go语言版的一个深度研究工具。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-17
- **Last Updated**: 2026-05-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GoDeepResearch

基于 Go 语言开发的 Deep Research（深度研究）CLI 工具，利用 AI Agent 技术自动联网搜索、分析整理并生成研究报告。

## 解决的痛点

1. **人工资料收集效率低** - 传统研究需要手动搜索筛选大量网页，耗时耗力
2. **信息来源单一** - 个人研究易受信息茧房限制，难以覆盖多角度/正反观点
3. **深度分析能力不足** - 缺乏专业分析框架，难以提炼深层洞察和识别信息缺口
4. **研究质量无保障** - 缺乏系统验收机制，信息不完整时难以自动补充
5. **报告撰写耗时** - 资料整理后还需结构化撰写，引用标注繁琐
6. **技术门槛高** - 现有 Deep Research 工具对国内用户访问不便

## 核心特性

- **Go 语言开发**：高并发、快速部署
- **豆包 LLM**：国内模型、速度快、成本低
- **自主规划**：智能拆解研究任务（5-10个搜索，覆盖5种类型）
- **联网搜索**：自动获取最新资料（SearchXNG）
- **信息萃取** ⭐：把搜索结果拆解成结构化条目（事实/数据/案例/观点）
- **智能分析**：深度洞察要求「论点+证据+推理」三要素
- **质量审核**：硬指标检查（事实≥8/数据≥3/案例≥1），不满足就补充搜索
- **结构化报告**：≥4000字硬性要求，每个论点都有证据支撑
- **JSON 输出**：支持结构化数据输出

## 快速开始

### 1. 构建项目

```bash
go build -o godeepresearch .
```

### 2. 创建配置文件

```bash
cp example/godeepresearch.yaml ~/.godeepresearch.yaml
# 编辑配置文件，填入你的 API Key
```

### 3. 运行研究

```bash
# 基本使用
./godeepresearch "人工智能在医疗领域的应用前景"

# 保存到文件
./godeepresearch --output report.md "研究课题"

# JSON 格式输出
./godeepresearch --json "研究课题"

# 指定配置文件
./godeepresearch --config myconfig.yaml "研究课题"
```

## 命令行选项

```
--config string   配置文件路径 (默认: ~/.godeepresearch.yaml 或 ./godeepresearch.yaml)
--topic string    研究课题
--output string   输出文件路径
--json            输出 JSON 格式
```

## 配置文件

示例配置见 `example/godeepresearch.yaml`：

```yaml
llm:
  base_url: "https://ark.cn-beijing.volces.com/api/coding/v3"
  api_key: "ark-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx-xxxx"
  model: "doubao-seed-code"
search:
  endpoint: "http://your-searchxng-endpoint:8080"
```

## 系统架构

```
CLI 入口 → 配置管理 → Agent 核心层 → 输出层
                     ↓
        ┌─────────────────────┐
        │ Planning Agent      │ → 生成研究计划
        └──────────┬──────────┘
                   ↓
        ┌─────────────────────┐
        │   Executor          │ → 任务调度
        └──────────┬──────────┘
         ┌─────────┼─────────┐
         ↓         ↓         ↓
      Search   Analyze   Report
      Agent    Agent     Agent
```

## 项目结构

```
godeepresearch/
├── main.go           # CLI 入口
├── go.mod/go.sum     # Go 模块
├── config/           # 配置管理
│   └── config.go
├── llm/              # 豆包 LLM 客户端
│   └── doubao.go
├── search/           # SearchXNG 搜索客户端
│   └── searchxng.go
├── agent/            # Agent 核心逻辑
│   └── agent.go
├── prompt/           # Prompts 模板
│   └── prompts.go
├── example/          # 示例配置
│   └── godeepresearch.yaml
├── docs/             # 项目文档
└── README.md
```

## 版本历史

### V1.3 - 详实报告+信息萃取 (2026-05-22) ⭐ 最新
- ✅ 新增 Extract 阶段 - 结构化信息萃取（事实/数据/案例/观点）
- ✅ PlanningPrompt 增强 - 5-10个搜索任务，覆盖5种类型
- ✅ AnalyzePrompt 增强 - 洞察要求「论点+证据+推理」
- ✅ ReportPrompt 升级 - ≥4000字硬性要求，每个论点都有证据
- ✅ ReviewPrompt 改进 - 硬指标验收（事实≥8/数据≥3/案例≥1）
- ✅ agent.go 流程更新 - 串联搜索→萃取→分析→报告

### V1.2 - 深度+闭环 (2026-05-17)
- ✅ Prompt 全面重写 - 从信息搬运升级为价值创造
- ✅ Review-Adjust 闭环 - 验收-调整迭代循环
- ✅ 质量审核四维度 - 完整性/可信度/矛盾处理/深度
- ✅ 配置扩展 - research.max_iterations

### V1.1 - 功能完善 (2026-05-16)
- ✅ Analyze Agent - 智能分析搜索结果
- ✅ 更好的进度显示和日志输出
- ✅ 引用来源追踪
- ✅ JSON 格式输出支持
- ✅ 错误处理和重试机制

### V1.0 - MVP 基础版本 (2026-05-16)
- ✅ 项目骨架搭建
- ✅ 配置管理
- ✅ 豆包 LLM 集成
- ✅ SearchXNG 搜索集成
- ✅ 基础报告生成
- ✅ CLI 接口

## 常用开发命令

```bash
# 构建
go build -o godeepresearch .

# 运行
./godeepresearch "研究课题"

# 格式化代码
go fmt ./...
```

## 项目文档

详细文档见 `docs/` 目录：
- `docs/需求确认.md` - 需求文档
- `docs/架构设计.md` - 技术方案
- `docs/迭代拆分.md` - 迭代计划
- `docs/项目研发进度.md` - 研发进度