stock-agent-v3

🚀 事件驱动的美股监控 + 决策提醒系统

📁 项目结构

stock-agent-v3/
├── 📁 src/                    # 源代码目录
│   ├── 📁 core/              # 核心模块
│   │   ├── server.py         # FastAPI服务器
│   │   ├── worker.py         # 事件消费者
│   │   └── poller.py         # 轮询监控
│   ├── 📁 analysis/          # 分析模块
│   │   ├── analysis.py       # AI分析、估值评分
│   │   └── llm_client.py     # OpenAI API客户端
│   ├── 📁 monitoring/        # 监控模块
│   │   ├── price_monitor.py  # 价格监控
│   │   └── news_monitor.py   # 新闻监控
│   ├── 📁 trading/           # 交易模块
│   │   ├── paper_trading.py  # 纸面交易
│   │   └── event_handlers.py # 事件处理
│   ├── 📁 notification/      # 通知模块
│   │   └── notifier.py       # 邮件和短信
│   ├── 📁 utils/             # 工具模块
│   │   ├── config.py         # 配置管理
│   │   └── utils.py          # 通用工具
│   └── models.py             # 数据模型
├── 📁 docker/                # Docker配置
├── 📁 data/                  # 数据文件
├── 📁 docs/                  # 详细文档
├── 📁 tests/                 # 测试文件
├── 📁 config/                # 配置文件
├── main.py                   # 主入口文件
└── requirements.txt           # 依赖包

🚀 快速开始

1. 环境准备

# 克隆项目
git clone <repository-url>
cd stock-agent-v3

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，填写必要的配置

2. 使用Docker启动

# 启动所有服务
cd docker
docker compose up -d --build

# 查看日志
docker compose logs -f

# 启动单个服务
docker compose up api -d      # 只启动API服务
docker compose up poller -d   # 只启动监控服务
docker compose up worker -d   # 只启动工作进程

3. 本地开发启动

# 启动API服务
python -m src.core.server

# 启动监控服务
python -m src.core.poller

# 启动工作进程
python -m src.core.worker

🔧 主要功能

• 📊 实时监控: 价格波动、新闻事件、市场脉搏
• 🤖 AI分析: GPT-5快速点评、情绪分析、深度研究
• 📈 智能选股: 估值评分、买入候选、情绪调节
• ⚠️ 风险控制: 自动止损止盈、持仓监控
• 📧 智能通知: 邮件、短信、即时提醒
• 📝 交易记录: 纸面回放、复盘分析

📡 API接口

• GET /health - 健康检查
• GET /holdings - 获取持仓信息
• POST /holdings/trade - 执行交易
• POST /holdings/set - 设置持仓快照
• POST /webhook/tradingview - TradingView Webhook

🔄 事件类型

• price_spike - 价格波动触发
• news - 新闻事件
• stop_loss - 止损触发
• take_profit - 止盈触发
• market_pulse - 市场脉搏
• weekly_digest - 周度汇总
• trade_email - 邮件交易指令

📊 配置说明

主要配置项在 .env 文件中：

# OpenAI配置
OPENAI_API_KEY=your_api_key
LLM_MODEL=gpt-5

# 监控配置
TICKERS=NVDA,MSFT,AAPL
MOVE_PCT_THRESHOLD=3.0
POLL_INTERVAL_SEC=300

# 风险控制
STOP_LOSS_PCT=0.07
TAKE_PROFIT_PCT=0.15

# 通知配置
SMTP_HOST=smtp.gmail.com
SMTP_USER=your_email
SMTP_PASS=your_password

🧪 测试

# 运行测试
cd tests
python -m pytest

# 运行特定测试
python -m pytest test_analysis.py

📚 详细文档

更多详细信息请查看 docs/ 目录。

🤝 贡献

欢迎提交 Issue 和 Pull Request！

�� 许可证

MIT License