# 🚀 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