EquityCompass 是一个基于人工智能的股票分析平台，集成了多个先进的AI模型（DeepSeek、Qwen），为用户提供专业的股票基本面和技术面分析报告。平台采用现代化的Web界面，支持实时分析、报告管理、PDF导出等功能。
- 多AI模型支持: 集成DeepSeek、Qwen、Gemini三大AI模型
- 默认模型: Qwen Deep Research (研究型智能体)
- 深度思考功能: DeepSeek Reasoner支持多步推理，Qwen Deep Research支持深入研究
- 全网搜索功能: Qwen Max支持实时搜索最新市场信息和新闻
- 双分析模式: 基本面分析 + 技术面分析
- 实时分析: 支持单个股票和批量分析
- 异步处理: 后台任务处理，支持进度跟踪
- 深度思考: 支持多步推理，提供更深入的分析
- 模型: deepseek-reasoner
- 特点: 专业推理能力，适合复杂分析场景
- Token限制: 8000 tokens
- 深入研究: 研究型智能体，可拆解复杂问题，结合互联网搜索进行推理分析
- 全网搜索: 实时搜索最新市场信息、新闻和动态
- 多阶段分析: 反问确认 → 研究规划 → 网络搜索 → 报告生成
- 模型: qwen-deep-research
- 特点: 专业研究能力，提供最全面和深入的分析报告
- Token限制: 支持长文本分析
- 基础分析: 提供快速的基础分析功能
- 模型: gemini-2.0-flash
- 特点: 响应速度快，适合快速分析
- Token限制: 8000 tokens
- 报告存储: 自动保存所有分析报告
- 历史查看: 查看同一公司的历史分析报告
- 报告详情: 完整的报告内容展示
- 分页浏览: 支持大量报告的分页显示
- PDF导出: 单个报告导出为PDF，保持网页样式
- 批量导出: 多选报告批量导出为ZIP压缩包
- 中文支持: 完美支持中文显示和排版
- 每日限制: 普通用户每日10次分析限制
- 管理员权限: 管理员无限制使用
- 使用统计: 实时显示当日使用情况
- 内置股票池: 包含主流股票数据
- 自定义股票: 支持添加自定义股票
- 股票分类: 内置股票vs自定义股票区分
- 任务队列: 异步任务处理系统
- 状态跟踪: 实时任务状态更新
- 重试机制: 自动重试失败任务（最多5次）
- 手动重试: 支持手动重试失败任务
- 框架: Flask (Python)
- 数据库: SQLite + SQLAlchemy ORM
- AI集成:
- DeepSeek Reasoner (深度思考模型)
- 阿里云Qwen Deep Research (研究型智能体 + 全网搜索)
- Google Gemini (基础分析)
- PDF生成: Playwright + Markdown
- 异步处理: Python threading
- 日志系统: Python logging
- 模板引擎: Jinja2
- 样式框架: Bootstrap 5
- JavaScript: 原生JS + jQuery
- 响应式设计: 移动端友好
- 时区处理: 统一使用北京时间(UTC+8)
- 错误处理: 完善的异常处理机制
- 日志记录: 详细的LLM调用日志
- 模块化设计: 清晰的服务层架构
- Docker
- Docker Compose
- 克隆项目
git clone https://github.com/your-username/EquityCompass.git
cd EquityCompass- 配置环境变量
cp backend/env.example .env
# 编辑 .env 文件，配置必要的API密钥- 使用Docker Compose启动
docker compose up -d- 启动服务
docker compose up -d- 查看启动日志
docker compose logs -f equitycompass注意: 首次启动时会自动执行数据库初始化和股票数据导入，无需手动操作。
- 访问应用 打开浏览器访问: http://localhost:5002
# 启动服务
docker compose up -d
# 查看日志
docker compose logs -f
# 停止服务
docker compose down
# 重新构建镜像
docker compose build --no-cache
# 查看容器状态
docker compose ps- Python 3.9+
- pip
- Git
- 克隆项目
git clone https://github.com/your-username/EquityCompass.git
cd EquityCompass- 创建虚拟环境
cd backend
python -m venv venv
source venv/bin/activate # Linux/Mac
# 或
venv\Scripts\activate # Windows- 安装依赖
pip install -r requirements.txt- 初始化数据库
python app.py init-db- 导入股票数据
python scripts/import_stocks.py- 启动应用
python app.py- 访问应用 打开浏览器访问: http://localhost:5002
复制环境变量模板并配置：
cp env.example .env主要配置项：
FLASK_SECRET_KEY: Flask密钥GEMINI_API_KEY: Google Gemini API密钥QWEN_API_KEY: 阿里云Qwen API密钥QWEN_MODEL: Qwen模型名称 (默认: qwen-deep-research)QWEN_THINKING_STEPS: Qwen深度思考步数 (默认: 3)DEEPSEEK_API_KEY: DeepSeek API密钥DEEPSEEK_MODEL: DeepSeek模型名称 (默认: deepseek-reasoner)DEEPSEEK_THINKING_STEPS: DeepSeek深度思考步数 (默认: 3)
EquityCompass/
├── backend/ # 后端应用
│ ├── app/ # 应用核心
│ │ ├── models/ # 数据模型
│ │ ├── views/ # 视图控制器
│ │ ├── services/ # 业务服务
│ │ ├── templates/ # 前端模板
│ │ └── static/ # 静态资源
│ ├── data/ # 数据存储
│ │ ├── reports/ # 分析报告
│ │ ├── tasks/ # 任务数据
│ │ └── usage/ # 使用统计
│ ├── scripts/ # 脚本工具
│ ├── tests/ # 测试文件
│ └── requirements.txt # Python依赖
├── docs/ # 文档
├── configs/ # 配置文件
└── README.md # 项目说明
确保服务器已安装Docker和Docker Compose：
# 安装Docker
curl -fsSL https://get.docker.com | sh
# 安装Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose# 克隆项目
git clone https://github.com/your-username/EquityCompass.git
cd EquityCompass
# 配置环境变量
cp backend/env.example .env
nano .env # 编辑配置文件# 构建并启动
docker compose up -d --build
# 查看启动状态
docker compose ps
# 查看日志
docker compose logs -f# 进入容器执行初始化
docker exec -it equitycompass-app python scripts/init_db.py
docker exec -it equitycompass-app python scripts/import_stocks.py# 启动服务
docker compose up -d
# 停止服务
docker compose down
# 重启服务
docker compose restart
# 查看日志
docker compose logs -f equitycompass
# 进入容器
docker exec -it equitycompass-app bash
# 更新代码后重新构建
docker compose down
docker compose build --no-cache
docker compose up -d- 应用数据存储在Docker卷中：
equitycompass_data - 日志文件存储在Docker卷中：
equitycompass_logs - 数据库文件持久化在容器中
容器内置健康检查，可通过以下命令查看：
docker inspect equitycompass-app | grep Health -A 10- 遵循PEP 8 Python代码规范
- 使用类型提示
- 编写详细的文档字符串
- 保持代码模块化
运行全面测试：
python scripts/run_all_tests.py# 初始化数据库
python app.py init-db
# 填充初始数据
python app.py seed-db
# 重置数据库（危险操作）
python app.py reset-db- 选择股票和AI模型
- DeepSeek Reasoner: 深度思考，适合复杂分析
- Qwen Max: 深度思考 + 全网搜索，最全面的分析
- Google Gemini: 快速基础分析
- 选择分析类型（基本面/技术面）
- 提交分析请求
- 查看实时进度
- 获取分析报告
- 浏览所有分析报告
- 查看报告详情
- 查看历史报告
- 导出PDF报告
- 批量导出报告
- 查看所有任务状态
- 监控任务进度
- 重试失败任务
- 查看任务详情
- 用户认证和授权
- API密钥安全存储
- 输入验证和过滤
- 错误信息保护
- 日志安全记录
- 异步任务处理
- 数据库查询优化
- 静态资源缓存
- 分页加载
- 内存管理
- Fork 项目
- 创建功能分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 打开 Pull Request
- ✅ 升级 DeepSeek 模型至 deepseek-reasoner (支持深度思考)
- ✅ 升级 Qwen 模型至 qwen-max (支持深度思考 + 全网搜索)
- ✅ 实现 DeepSeek 深度思考功能 (多步推理)
- ✅ 实现 Qwen 深度思考功能 (多步推理)
- ✅ 实现 Qwen 全网搜索功能 (实时获取最新市场信息)
- ✅ 优化 Token 限制至 8000 (支持更详细的分析报告)
- ✅ 完善 AI 模型配置和参数管理
- ✅ 添加深度思考和全网搜索的测试脚本
- ✅ 完成核心分析功能
- ✅ 实现PDF导出功能
- ✅ 添加批量导出功能
- ✅ 优化UI/UX设计
- ✅ 完善异步任务系统
- ✅ 实现分页功能
- ✅ 修复时区问题
- ✅ 添加用户权限控制
- ✅ 完善日志系统
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情
- 项目维护者: [Your Name]
- 邮箱: [your.email@example.com]
- 项目链接: https://github.com/your-username/EquityCompass
感谢以下开源项目和服务：
- Flask - Web框架
- Bootstrap - UI框架
- Google Gemini - 基础AI分析
- 阿里云Qwen Max - 深度思考 + 全网搜索
- DeepSeek Reasoner - 深度思考推理
- Playwright - PDF生成
注意: 本平台生成的分析报告仅供参考，不构成投资建议。投资有风险，入市需谨慎。