tradusai/USAGE.md

# 🚀 快速使用指南

## 📋 前置条件

确保 Docker 服务正在运行：
```bash
docker compose ps
```

如果服务未运行，先启动：
```bash
docker compose up -d
```

---

## 🎯 运行交易信号分析

### 方式 1: 完整 AI 分析（推荐测试）
每次都调用 Deepseek AI 进行深度分析：

```bash
./run_signal.sh
```

**特点**:
- ✅ 每次运行都会调用 Deepseek AI
- ✅ 获得量化 + AI 双重分析
- ⚠️ 每次调用成本约 ¥0.005 元

---

### 方式 2: 智能门控模式（推荐生产）
只在高质量信号时调用 AI，节省 95% 成本：

```bash
./run_signal_smart.sh
```

**特点**:
- ✅ 自动判断是否需要 AI 分析
- ✅ 节省 API 调用成本
- ✅ 每天最多调用 5 次
- ✅ 只在关键时刻使用 AI

**何时调用 AI**:
- 综合得分 ≥ 20.0
- 共识度 ≥ 0.75
- 数据充足（≥50 根 K 线）
- 属于高价值场景（趋势回调/真假突破等）

---

## 📊 查看结果

### 查看最新信号
```bash
./view_signal.sh
```

**输出示例**:
```
════════════════════════════════════════════════════════════════
                   📊 最新交易信号
════════════════════════════════════════════════════════════════

🎯 最终信号: HOLD
📈 置信度: 33%
🤝 共识: CONSENSUS_HOLD
📊 当前价格: $90,662.10

────────────────────────────────────────────────────────────────
🔢 量化信号: HOLD (置信度: 25%)
   综合得分: -2.6
   趋势:   23.1 | 动量:    5.0
   订单流:  -47.6 | 突破:    0.0

────────────────────────────────────────────────────────────────
🤖 AI 信号: HOLD (置信度: 40%)
   推理: 当前价格处于上涨后的回调阶段，RSI显示中性偏强...
   关键因素: RSI中性区域, MACD死叉收窄, 成交量萎缩

────────────────────────────────────────────────────────────────
💡 建议: 量化和AI分析均建议观望,等待更好的机会
════════════════════════════════════════════════════════════════
```

### 查看实时数据
```bash
./view_data.sh
```

**输出示例**:
```
════════════════════════════════════════════════════════════════
                   📡 实时数据监控
════════════════════════════════════════════════════════════════

📊 当前 BTC 价格：
  $ 90,662.10  (最新)
  $ 90,680.00  (5分钟最高)
  $ 90,640.00  (5分钟最低)
  成交量: 45.23 BTC

─────────────────────────────────────────────────────────────────

📈 数据流状态：
  kline:5m       : 10,007 条消息
  kline:15m      :  3,500 条消息
  kline:1h       :  1,200 条消息
  trade          : 50,000 条消息
  depth:20       : 80,000 条消息

─────────────────────────────────────────────────────────────────

🚀 服务状态：
  tradus-redis: Up
  tradus-ingestion: Up
════════════════════════════════════════════════════════════════
```

---

## 📁 查看完整 JSON 结果

```bash
docker compose exec ingestion cat /app/output/latest_signal.json | python3 -m json.tool
```

---

## ⚙️ 高级用法

### 使用 Makefile 快捷命令

```bash
# 查看所有可用命令
make help

# 查看日志
make logs

# 查看系统监控
make monitor

# 进入 Redis CLI
make redis-cli

# 重启服务
make restart
```

### 手动运行分析

```bash
# 进入容器
docker compose exec ingestion bash

# 设置 API Key
export OPENAI_API_KEY='sk-9f6b56f08796435d988cf202e37f6ee3'
export OPENAI_BASE_URL='https://api.deepseek.com'

# 运行市场分析
python scripts/run_analysis.py

# 运行信号生成
python scripts/generate_trading_signal.py
```

---

## 🔧 定时自动运行（可选）

### 使用 cron 定时任务

每 30 分钟运行一次（智能门控模式）：

```bash
# 编辑 crontab
crontab -e

# 添加以下行：
*/30 * * * * cd /Users/aaron/source_code/tradus-ai/realtime-ingestion && ./run_signal_smart.sh >> logs/signal.log 2>&1
```

每小时运行一次（完整 AI 分析）：

```bash
0 * * * * cd /Users/aaron/source_code/tradus-ai/realtime-ingestion && ./run_signal.sh >> logs/signal.log 2>&1
```

### 使用 watch 命令持续监控

```bash
# 每 5 分钟运行一次
watch -n 300 ./run_signal_smart.sh
```

---

## 📌 常见问题

### Q: 如何切换 LLM 服务商？

**使用 Claude**:
```bash
export ANTHROPIC_API_KEY='your-claude-key'
# 然后修改 scripts/generate_trading_signal.py 中的
# LLMDecisionMaker(provider='claude')
```

**使用 OpenAI GPT**:
```bash
export OPENAI_API_KEY='your-openai-key'
unset OPENAI_BASE_URL  # 删除 Deepseek 的 base_url
```

### Q: 如何调整门控参数？

编辑 `.env` 文件：
```bash
LLM_GATE_ENABLED=true
LLM_MIN_CONSENSUS=0.75      # 共识度阈值
LLM_MIN_COMPOSITE_SCORE=40  # 综合得分阈值
LLM_MAX_CALLS_PER_DAY=5     # 每天最多调用次数
```

### Q: 数据不足怎么办？

系统会自动从 Binance API 获取历史数据。如果仍然提示数据不足，请等待：
- 5分钟图: 需要约 17 小时积累 200 根 K 线
- 或让系统持续运行，会自动补全历史数据

---

## 🎓 下一步

1. **了解信号含义**: 查看生成的 JSON 结果，理解各个字段
2. **调整参数**: 根据自己的交易风格调整门控阈值
3. **集成通知**: 添加 Telegram/钉钉通知高质量信号
4. **回测验证**: 使用历史数据验证信号准确性

---

## 📞 获取帮助

查看日志：
```bash
make logs
```

查看系统状态：
```bash
docker compose ps
```

查看 Redis 数据：
```bash
make redis-cli
```