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

6.7 KiB
Raw Blame History

🚀 快速使用指南

📋 前置条件

确保 Docker 服务正在运行:

docker compose ps

如果服务未运行,先启动:

docker compose up -d

🎯 运行交易信号分析

方式 1: 完整 AI 分析(推荐测试)

每次都调用 Deepseek AI 进行深度分析:

./run_signal.sh

特点:

  • 每次运行都会调用 Deepseek AI
  • 获得量化 + AI 双重分析
  • ⚠️ 每次调用成本约 ¥0.005 元

方式 2: 智能门控模式(推荐生产)

只在高质量信号时调用 AI节省 95% 成本:

./run_signal_smart.sh

特点:

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

何时调用 AI:

  • 综合得分 ≥ 20.0
  • 共识度 ≥ 0.75
  • 数据充足≥50 根 K 线)
  • 属于高价值场景(趋势回调/真假突破等)

📊 查看结果

查看最新信号

./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分析均建议观望,等待更好的机会
════════════════════════════════════════════════════════════════

查看实时数据

./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 结果

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

⚙️ 高级用法

使用 Makefile 快捷命令

# 查看所有可用命令
make help

# 查看日志
make logs

# 查看系统监控
make monitor

# 进入 Redis CLI
make redis-cli

# 重启服务
make restart

手动运行分析

# 进入容器
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 分钟运行一次(智能门控模式):

# 编辑 crontab
crontab -e

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

每小时运行一次(完整 AI 分析):

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

使用 watch 命令持续监控

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

📌 常见问题

Q: 如何切换 LLM 服务商?

使用 Claude:

export ANTHROPIC_API_KEY='your-claude-key'
# 然后修改 scripts/generate_trading_signal.py 中的
# LLMDecisionMaker(provider='claude')

使用 OpenAI GPT:

export OPENAI_API_KEY='your-openai-key'
unset OPENAI_BASE_URL  # 删除 Deepseek 的 base_url

Q: 如何调整门控参数?

编辑 .env 文件:

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. 回测验证: 使用历史数据验证信号准确性

📞 获取帮助

查看日志:

make logs

查看系统状态:

docker compose ps

查看 Redis 数据:

make redis-cli