tradusai/QUICK_START.md
2025-12-02 22:54:03 +08:00

251 lines
4.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🚀 Tradus AI 快速开始指南
## 📋 目录
- [系统启动](#系统启动)
- [手动运行分析](#手动运行分析)
- [查看结果](#查看结果)
- [日志监控](#日志监控)
- [系统管理](#系统管理)
---
## 🎯 系统启动
### 方式一:使用脚本(推荐)
```bash
# 启动完整系统(数据采集 + 自动信号生成)
./start_system.sh
# 停止系统
./stop_system.sh
```
### 方式二:使用 Docker Compose
```bash
# 启动完整系统
docker compose --profile scheduler up -d
# 仅启动数据采集(不生成信号)
docker compose up -d
# 停止系统
docker compose --profile scheduler down
```
---
## 🔍 手动运行分析
### 运行一次完整的量化+LLM分析
```bash
# 使用脚本(推荐)
./run_signal.sh
# 或直接运行
docker compose exec scheduler python /app/scripts/generate_trading_signal.py
```
**系统会自动**
- ✅ 执行量化分析
- ✅ 调用 DeepSeek LLM 分析(如果通过 Gate
- ✅ 聚合两种分析结果
- ✅ 保存到 `output/latest_signal.json`
- ✅ 如果是 BUY/SELL 信号,发送钉钉通知
---
## 📊 查看结果
### 查看最新信号
```bash
# 使用脚本(格式化显示)
./view_signal.sh
# 或查看完整 JSON
cat output/latest_signal.json | python -m json.tool
```
### 信号包含内容
- **最终信号**: BUY / SELL / HOLD
- **置信度**: 0-100%
- **共识状态**: QUANT_LLM_AGREE / LLM_LEADING / QUANT_ONLY
- **量化分析**: 趋势、动量、订单流得分
- **LLM 分析**: 深度推理、交易计划、风险评估
- **价格建议**: 入场/止损/止盈
---
## 📋 日志监控
### 查看实时日志
```bash
# 使用脚本
./view_logs.sh scheduler
# 或直接查看
docker compose logs -f scheduler --tail 50
```
### 查看特定日志
```bash
# 查看数据采集日志
docker compose logs -f ingestion
# 查看 Redis 日志
docker compose logs -f redis
# 查看所有服务
docker compose logs -f
```
---
## 🎛️ 系统管理
### 检查服务状态
```bash
docker compose ps
```
### 重启服务
```bash
# 重启 scheduler
docker compose restart scheduler
# 重启所有服务
docker compose restart
```
### 重新构建
```bash
# 重新构建 scheduler应用代码更改
docker compose build scheduler
docker compose --profile scheduler up -d
```
### 完全清理并重启
```bash
# 停止并删除所有容器和卷
docker compose --profile scheduler down -v
# 重新启动
./start_system.sh
```
---
## ⚙️ 配置调整
### LLM Gate 阈值
编辑 `config/settings.py`:
```python
LLM_MIN_COMPOSITE_SCORE: float = 15.0 # 降低到 5.0 可看到更多 LLM 分析
```
### 信号生成频率
编辑 `docker-compose.yml`:
```yaml
environment:
- SIGNAL_INTERVAL_MINUTES=5 # 修改为想要的分钟数
```
### 钉钉配置
编辑 `docker-compose.yml`:
```yaml
environment:
- DINGTALK_WEBHOOK=你的webhook地址
- DINGTALK_SECRET=你的密钥
```
---
## 🔔 钉钉通知规则
-**BUY 信号**: 自动发送简洁通知
-**SELL 信号**: 自动发送简洁通知
-**HOLD 信号**: 不发送(减少噪音)
**通知内容**
- 信号类型和置信度
- 当前价格
- 交易计划(入场/止损/止盈)
- 风险回报比
- 简短原因
---
## 📞 常见问题
### Q: 如何强制 LLM 分析每次都运行?
A: 降低 Gate 阈值到 5.0 或更低:
```bash
# 临时降低阈值,然后重启
docker compose restart scheduler
```
### Q: 如何查看 DeepSeek 调用情况?
A: 查看日志中的 LLM 相关信息:
```bash
docker compose logs scheduler | grep -E "LLM|Deepseek"
```
### Q: 信号文件在哪里?
A: `output/latest_signal.json`
---
## 🎯 典型工作流
```bash
# 1. 启动系统
./start_system.sh
# 2. 监控日志(新终端窗口)
./view_logs.sh scheduler
# 3. 手动运行分析(可选)
./run_signal.sh
# 4. 查看结果
./view_signal.sh
# 5. 停止系统(工作完成后)
./stop_system.sh
```
---
## 📚 更多文档
- `DINGTALK_SETUP.md` - 钉钉配置详细指南
- `NOTIFICATION_SUMMARY.md` - 通知功能实现总结
- `README.md` - 完整系统文档
---
**系统版本**: 1.0.0
**最后更新**: 2025-12-01