融合大模型问答、联网深度检索、本地知识库与行业资讯聚合的智能行业信息分析助手
| 依赖 | 版本要求 | 说明 |
|---|---|---|
| Docker | 20.0+ | 运行所有基础服务（PostgreSQL、Redis、Milvus、Elasticsearch） |
| Python | 3.10+ | 后端服务 |
| Node.js | 18+ | 前端构建 |
cd Industry-DeepResearch-Assistant方式 A: 使用启动脚本（推荐）
# 在项目根目录执行
chmod +x start-services.sh
./start-services.sh start方式 B: 使用 Docker Compose
# 在项目根目录执行
docker compose up -d验证服务状态：
# 方式 A
./start-services.sh status
# 方式 B
docker compose ps
# 应该看到以下服务运行中:
# - industry_postgres (PostgreSQL)
# - industry_redis (Redis)
# - industry_milvus (Milvus)
# - industry_elasticsearch (Elasticsearch)
# - industry_minio (MinIO)
# - industry_etcd (etcd)服务访问地址：
- PostgreSQL:
localhost:5432(用户名:postgres, 密码:postgres123) - Redis:
localhost:6379 - Milvus:
localhost:19530 - Elasticsearch:
localhost:1200 - MinIO Console:
localhost:9001(admin/minioadmin)
cd backend
# 复制示例配置文件
cp .env.example .env
# 编辑 .env 文件，填入你的 API Key必填的 API Key（其他配置已预配置好）：
# 阿里云百炼 (LLM & Embedding) - 必填
DASHSCOPE_API_KEY=your-dashscope-api-key
# 搜索服务 - 必填
BOCHA_API_KEY=your-bocha-api-key
# PostgreSQL 配置（已在 Docker 中配置，通常无需修改）
POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres123
POSTGRES_DB=industry_assistant
# JWT 密钥（生产环境建议修改）
JWT_SECRET_KEY=your-super-secret-key-change-in-production注意：
- PostgreSQL、Redis、Milvus 的配置已在 Docker Compose 中设置好
.env.example文件中的默认值与 Docker 配置匹配- 如果使用 Docker，数据库相关配置通常无需修改
- 生产环境务必修改
JWT_SECRET_KEY为随机密钥
cd backend
# 创建虚拟环境 (推荐)
conda create -n deepresearch python=3.10
conda activate deepresearch
# 安装依赖
pip install -r requirements.txt
# 启动后端服务
python app/app_main.py后端默认运行在 http://localhost:8000
cd frontend
# 安装依赖
npm install --legacy-peer-deps
# 开发模式启动
npm run dev前端默认运行在 http://localhost:5173/login
| 变量名 | 说明 | 申请地址 |
|---|---|---|
DASHSCOPE_API_KEY |
阿里云百炼 (LLM & Embedding) | https://bailian.console.aliyun.com/ |
BOCHA_API_KEY |
博查搜索 API | https://open.bochaai.com/ |
POSTGRES_* |
PostgreSQL 连接配置 | - |
REDIS_HOST/PORT |
Redis 连接配置 | - |
MILVUS_HOST/PORT |
Milvus 向量数据库配置 | - |
JWT_SECRET_KEY |
JWT 认证密钥 (自定义字符串) | - |
| 变量名 | 说明 | 申请地址 |
|---|---|---|
DOCMIND_ACCESS_KEY_ID |
阿里云 DocMind 文档解析 | https://help.aliyun.com/zh/ram/user-guide/create-an-accesskey-pair |
DOCMIND_ACCESS_KEY_SECRET |
阿里云 DocMind Secret | 同上 |
BID_APP_KEY |
招投标信息 API | https://market.aliyun.com/detail/cmapi00063550?spm=5176.730005.result.20.3188414aM3Wls9&innerSource=search_%E6%8B%9B%E6%8A%95%E6%A0%87#sku=yuncode5755000002 |
BID_APP_SECRET |
招投标 API Secret | 同上 |
BID_APP_CODE |
招投标 API Code | 同上 |
JUHE_STOCK_API_KEY |
聚合数据 - 股票行情 | https://www.juhe.cn/docs/api/id/21 |
OPENROUTER_API_KEY |
OpenRouter (多模型网关) | https://openrouter.ai/ |
如果你想使用本地安装的 PostgreSQL 而不是 Docker：
-
安装 PostgreSQL
# macOS brew install postgresql@15 brew services start postgresql@15 -
创建数据库和用户
# 连接 PostgreSQL psql postgres # 创建用户 CREATE USER postgres WITH PASSWORD 'postgres123'; # 创建数据库 CREATE DATABASE industry_assistant OWNER postgres; # 退出 \q
-
修改 Docker Compose 配置
# 编辑 docker-compose.yml，注释掉 postgres 服务 # 或者使用 backend/docker-compose-base.yml（只包含 Redis 和 Milvus） cd backend docker compose -f docker-compose-base.yml up -d
-
确保
.env配置正确POSTGRES_HOST=localhost POSTGRES_PORT=5432 POSTGRES_USER=postgres POSTGRES_PASSWORD=postgres123 POSTGRES_DB=industry_assistant
首次启动时，后端会自动创建数据库表。如果遇到问题，可手动执行：
-- 连接数据库
-- Docker: docker exec -it industry_postgres psql -U postgres -d industry_assistant
-- 本地: psql -U postgres -d industry_assistant
-- 确保 research_checkpoints 表有完整的列
ALTER TABLE research_checkpoints ADD COLUMN IF NOT EXISTS ui_state_json JSONB;
ALTER TABLE research_checkpoints ADD COLUMN IF NOT EXISTS final_report TEXT;# 启动所有服务
./start-services.sh start
# 查看服务状态
./start-services.sh status
# 查看日志
./start-services.sh logs # 所有服务
./start-services.sh logs postgres # 特定服务
# 重启服务
./start-services.sh restart
# 停止服务
./start-services.sh stop
# 清理数据（危险操作！）
./start-services.sh clean# 启动
docker compose up -d
# 查看状态
docker compose ps
# 查看日志
docker compose logs -f
docker compose logs -f postgres # 特定服务
# 停止
docker compose down
# 停止并删除数据卷（危险操作！）
docker compose down -vcd backend
curl -X POST "http://localhost:8000/documents/upload" \
-H "Content-Type: multipart/form-data" \
-F "file=@./test/test_doc.pdf"# 使用启动脚本查看状态
./start-services.sh status
# 查看具体服务日志
./start-services.sh logs postgres # 查看 PostgreSQL 日志
./start-services.sh logs # 查看所有服务日志
# 重启所有容器
./start-services.sh restart
# 或使用 Docker Compose
docker compose down
docker compose up -d常见原因：
-
Docker 服务未启动
./start-services.sh status # 检查服务状态 ./start-services.sh start # 启动服务
-
.env文件配置错误# 确保配置与 Docker 一致 POSTGRES_USER=postgres POSTGRES_PASSWORD=postgres123 POSTGRES_DB=industry_assistant -
端口被占用（如已安装本地 PostgreSQL）
# 停止本地 PostgreSQL（如果有） brew services stop postgresql # 或者修改 docker-compose.yml 中的端口映射
# 使用 legacy-peer-deps 解决依赖冲突
npm install --legacy-peer-deps
# 或清除缓存后重试
rm -rf node_modules package-lock.json
npm install --legacy-peer-deps执行数据库迁移：
ALTER TABLE research_checkpoints ADD COLUMN IF NOT EXISTS ui_state_json JSONB;
ALTER TABLE research_checkpoints ADD COLUMN IF NOT EXISTS final_report TEXT;然后重启后端服务。
Industry-DeepResearch-Assistant/
├── backend/
│ ├── app/
│ │ ├── api/ # API 路由
│ │ ├── core/ # 核心配置
│ │ ├── models/ # 数据模型
│ │ ├── service/ # 业务逻辑
│ │ └── app_main.py # 入口文件
│ ├── docker-compose-base.yml
│ ├── requirements.txt
│ └── .env
├── frontend/
│ ├── src/
│ │ ├── api/ # API 调用
│ │ ├── components/ # 组件
│ │ ├── pages/ # 页面
│ │ └── store/ # 状态管理
│ └── package.json
└── READMED.md
启动后端后访问：http://localhost:8000/docs