179 lines
4.0 KiB
Markdown
179 lines
4.0 KiB
Markdown
# Stock Buddy 港股AI交易系统
|
||
|
||
一套完整的港股交易分析系统，支持持仓管理、自动舆情分析、实时交易信号。
|
||
|
||
## 功能特性
|
||
|
||
- 📊 **持仓管理** - 记录持仓股票，自动计算盈亏
|
||
- 🤖 **AI舆情分析** - 每日自动分析持仓股票舆情（支持Agent调用）
|
||
- 📈 **策略信号** - v7策略：三维度评分 + 大盘过滤 + 盈利保护
|
||
- 🔍 **手动分析** - 输入任意股票代码，即时生成分析报告
|
||
- ⏰ **定时任务** - 每日9:00自动运行分析
|
||
- 🌐 **Web界面** - 现代化UI，支持移动端
|
||
|
||
## 技术栈
|
||
|
||
- **后端**: FastAPI + SQLite + APScheduler
|
||
- **前端**: 原生HTML/CSS/JS
|
||
- **数据源**: yfinance（自动切东方财富备用）
|
||
- **LLM**: 预留Agent接口（测试阶段用规则引擎）
|
||
|
||
## 快速启动
|
||
|
||
```bash
|
||
cd stock-buddy
|
||
./start.sh
|
||
```
|
||
|
||
访问:
|
||
- 前端: http://localhost:8000/app
|
||
- API文档: http://localhost:8000/docs
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
stock-buddy/
|
||
├── backend/ # FastAPI后端
|
||
│ ├── main.py # 主入口
|
||
│ ├── database.py # 数据库模型
|
||
│ ├── models.py # Pydantic模型
|
||
│ ├── services/ # 业务服务
|
||
│ │ ├── stock_service.py
|
||
│ │ ├── sentiment_service.py
|
||
│ │ ├── strategy_service.py
|
||
│ │ └── llm_service.py
|
||
│ └── requirements.txt
|
||
├── frontend/ # 前端界面
|
||
│ ├── index.html
|
||
│ ├── style.css
|
||
│ └── app.js
|
||
├── data/ # 数据存储
|
||
│ ├── stocks.db # SQLite数据库
|
||
│ └── cache/ # 股票数据缓存
|
||
├── start.sh # 启动脚本
|
||
└── README.md
|
||
```
|
||
|
||
## 使用指南
|
||
|
||
### 1. 添加持仓
|
||
|
||
进入"持仓管理"页面，点击"添加持仓"，输入:
|
||
- 股票名称（如：中芯国际）
|
||
- 股票代码（如：0981.HK）
|
||
- 持仓数量
|
||
- 成本价
|
||
- 选择策略（A/B/C）
|
||
|
||
### 2. 查看分析
|
||
|
||
在"总览"页面查看:
|
||
- 实时市值和盈亏
|
||
- 买入/卖出信号
|
||
- 持仓列表
|
||
|
||
### 3. 手动分析新股票
|
||
|
||
进入"股票分析"页面:
|
||
1. 输入股票名称或代码
|
||
2. 点击"分析"
|
||
3. 查看综合评分、技术信号、舆情分析
|
||
|
||
### 4. 每日自动分析
|
||
|
||
系统每天9:00自动:
|
||
1. 更新持仓股票数据
|
||
2. 生成舆情分析
|
||
3. 计算交易信号
|
||
4. 保存分析结果
|
||
|
||
也可手动点击"运行分析"触发。
|
||
|
||
## 策略说明
|
||
|
||
### v7策略架构
|
||
|
||
```
|
||
三维度评分
|
||
├── 技术面 (60%): RSI + MACD + 均线系统
|
||
├── 基本面 (30%): 营收/利润/PE快照
|
||
└── 舆情面 (10%): LLM情绪分析
|
||
|
||
买入条件:
|
||
- 综合评分 ≥ 1.5
|
||
- 成交量连续2日放量
|
||
- 恒生指数 > MA20（大盘过滤）
|
||
|
||
止损策略:
|
||
- A: 固定12%
|
||
- B: ATR × 2.5 动态
|
||
- C: 混合自适应（按波动率自动选择）
|
||
|
||
盈利保护:
|
||
- >30%: 保本止损
|
||
- >50%: 锁定10%利润
|
||
- >100%: 宽追踪止损
|
||
```
|
||
|
||
## API接口
|
||
|
||
### 持仓管理
|
||
|
||
```
|
||
GET /api/positions # 获取所有持仓
|
||
POST /api/positions # 添加持仓
|
||
PUT /api/positions/{id} # 更新持仓
|
||
DELETE /api/positions/{id} # 删除持仓
|
||
```
|
||
|
||
### 股票分析
|
||
|
||
```
|
||
POST /api/analyze # 分析股票
|
||
Body: {"stock_name": "中芯国际", "ticker": "0981.HK"}
|
||
```
|
||
|
||
### 实时行情
|
||
|
||
```
|
||
GET /api/quote/{ticker} # 获取实时行情
|
||
```
|
||
|
||
### 任务管理
|
||
|
||
```
|
||
POST /api/tasks/daily-analysis # 手动触发每日分析
|
||
```
|
||
|
||
## LLM舆情接入
|
||
|
||
当前使用规则引擎模拟LLM分析，如需接入真实LLM:
|
||
|
||
1. 修改 `backend/services/llm_service.py`
|
||
2. 替换 `analyze_sentiment()` 方法为真实API调用
|
||
3. 支持通过Agent生成分析（已预留接口）
|
||
|
||
```python
|
||
# 调用Agent生成舆情
|
||
from llm_sentiment_agent import generate_prompt
|
||
|
||
prompt = generate_prompt("中芯国际", "2024-06-01", "2024-06-30")
|
||
# 发送给Agent，获取JSON结果
|
||
```
|
||
|
||
## 开发计划
|
||
|
||
- [x] 基础持仓管理
|
||
- [x] 股票数据服务
|
||
- [x] v7策略回测
|
||
- [x] Web界面
|
||
- [x] 定时任务
|
||
- [ ] 真实LLM接入
|
||
- [ ] 邮件/微信推送
|
||
- [ ] 历史回测报告
|
||
- [ ] 多用户支持
|
||
|
||
## 许可证
|
||
|
||
MIT
|