Files

T

brunoandClaude d364268ca4 fix: Register Claude × DeepSeek collaboration routes in main.py

Fixed missing route registration that prevented the /api/collab/* endpoints from being available.
The claude_deepseek_collab module was imported and implemented but not registered in the FastAPI app,
causing 404 errors on all endpoints including health check, recommend, and batch-recommend.

Changes:
- Updated backend/app/routes/__init__.py to export claude_deepseek_collab module
- Updated backend/main.py to import and register the claude_deepseek_collab router
- All endpoints now properly accessible and working with real Alpha Vantage data

Verified endpoints:
✅ /api/collab/health - System health check
✅ /api/collab/recommend - Single stock/forex analysis with Claude + DeepSeek
✅ /api/collab/batch-recommend - Batch analysis for multiple assets
✅ /api/collab/analyze/{symbol} - Technical signal analysis only

Real data sources verified:
✅ AAPL: $275.25 (Alpha Vantage)
✅ EURUSD=X: 1.16 (ExchangeRate API)

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>

2025-11-12 14:55:38 +01:00

6.2 KiB

Raw Permalink Blame History

快速开始指南

🚀 30 秒快速启动

# 1. 克隆项目
git clone <repo-url>
cd stock

# 2. 配置 API Key
export OPENROUTER_API_KEY="your-key"

# 3. 启动系统
docker-compose up -d

# 4. 等待 Ollama 加载模型 (首次 30-120 分钟)
docker-compose logs -f ollama

# 5. 打开前端
# 浏览器访问：http://localhost:8090

📊 核心概念速览

三层协作架构

用户输入 (如：AAPL)
    ↓
📊 数据层 (Yahoo Finance)
    ├─ 获取当前价格
    ├─ 计算 MA, RSI, MACD
    └─ 返回技术指标
    ↓
🤖 策略层 (DeepSeek + Ollama)
    ├─ 分析技术指标
    ├─ 评估交易信号
    └─ 返回 BUY/SELL/HOLD
    ↓
💡 建议层 (Claude 4.5)
    ├─ 理解 DeepSeek 信号
    ├─ 生成投资建议
    └─ 添加风险提示
    ↓
📱 前端展示 (Vue3)
    └─ 可视化展示结果

📋 系统状态检查

# 检查所有服务
curl http://localhost:8001/api/collab/health

# 输出示例：
# {
#   "status": "operational",
#   "components": {
#     "ollama": "available",
#     "deepseek": "available",
#     "claude": "available",
#     "yahoo_finance": "available"
#   }
# }

🔗 API 端点速查

端点	方法	功能
`/api/collab/recommend`	POST	获取完整推荐
`/api/collab/analyze/{symbol}`	GET	仅获取 DeepSeek 信号
`/api/collab/market-snapshot`	GET	市场快照
`/api/collab/health`	GET	系统健康检查

📱 前端使用

使用 Vue 组件

<template>
  <ClaudeDeepSeekRecommendation />
</template>

<script setup>
import ClaudeDeepSeekRecommendation from '@/components/ClaudeDeepSeekRecommendation.vue'
</script>

直接调用 API

// 获取推荐
const response = await fetch('/api/collab/recommend', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ symbol: 'AAPL' })
})

const result = await response.json()

// DeepSeek 信号
console.log(result.deepseek_signal)

// Claude 建议
console.log(result.investment_advice)

🎯 常见用途

1. 单个股票分析

curl -X POST http://localhost:8001/api/collab/recommend \
  -H "Content-Type: application/json" \
  -d '{"symbol": "AAPL"}'

2. 批量分析

curl -X POST http://localhost:8001/api/collab/batch-recommend \
  -H "Content-Type: application/json" \
  -d '{"symbols": ["AAPL", "MSFT", "NVDA"]}'

3. 获取市场快照

curl http://localhost:8001/api/collab/market-snapshot

4. 仅获取技术信号

curl http://localhost:8001/api/collab/analyze/AAPL

⚙️ 配置调整

修改 Ollama 模型

编辑 docker-compose.yml，找到 ollama 服务：

ollama:
  # ...
  entrypoint: |
    /bin/bash -c "
    /bin/ollama serve &
    OLLAMA_PID=$!;
    sleep 10;
    # 修改这行
    /bin/ollama pull deepseek-coder:33b;  # 默认
    # /bin/ollama pull deepseek-coder:7b;   # 轻量版本
    wait $OLLAMA_PID;
    "

启用 GPU 加速

在 docker-compose.yml 中修改 ollama 服务：

ollama:
  runtime: nvidia
  environment:
    CUDA_VISIBLE_DEVICES: "0"  # 选择 GPU 编号

修改 API 端口

在 docker-compose.yml 中修改端口映射：

backend:
  ports:
    - "8002:8000"  # 改为 8002
frontend:
  ports:
    - "3000:80"    # 改为 3000

🛠️ 故障排查

Q: 系统启动很慢？

A: 首次启动需要下载 DeepSeek 33B 模型（~33GB，取决于网络速度）。可以用 7B 轻量版本加快启动。

Q: 推荐返回 "Ollama 不可用"？

A: 检查 Ollama 容器：

docker-compose logs ollama
docker-compose exec ollama ollama list

Q: Claude API 错误？

A: 检查 API Key：

docker-compose exec backend env | grep OPENROUTER

Q: 容器占用 CPU 过高？

A: 这是正常的（尤其是 Ollama 在推理时）。如需限制资源，参考部署指南。

📚 深入学习

🎓 项目结构

stock/
├── backend/                    # 后端 (FastAPI)
│   ├── data/
│   │   └── datasource_yahoo.py    # 数据源
│   ├── strategy/
│   │   └── deepseek_engine.py     # 策略引擎
│   ├── advisor/
│   │   └── claude_investment_advisor.py  # 建议生成
│   ├── routes/
│   │   └── claude_deepseek_collab.py    # API 路由
│   ├── utils/
│   │   └── prompt_orchestrator.py       # Prompt 编排
│   └── main.py                 # 应用入口
├── frontend/                   # 前端 (Vue3)
│   └── src/components/
│       └── ClaudeDeepSeekRecommendation.vue  # 推荐组件
├── docker-compose.yml         # 容器编排
├── CLAUDE_DEEPSEEK_ARCHITECTURE.md  # 架构文档
├── DEPLOYMENT_GUIDE.md        # 部署指南
└── QUICKSTART_GUIDE.md        # 本文件

💡 核心特性

✅ 本地 AI：DeepSeek 在本地 Ollama 运行，数据不上传云端 ✅ 双 AI 协作：DeepSeek 做量化分析，Claude 生成自然语言建议 ✅ 多市场支持：美股、港股、黄金、外汇等 ✅ 技术指标完整：MA, RSI, MACD 自动计算 ✅ 多风格推荐：激进/平衡/保守三档策略 ✅ 智能缓存：Redis 缓存常见查询，提高响应速度 ✅ 完整风险提示：每个建议都配备风险分析 ✅ 实时更新：支持流式数据更新

📞 需要帮助？

查看日志：docker-compose logs -f
进入容器调试：docker-compose exec backend bash
查看 API 文档：http://localhost:8001/docs
阅读源代码注释

🚦 下一步

✅ 系统已启动
📊 访问前端 (http://localhost:8090)
🔍 输入股票代码获取推荐
📖 查看完整文档了解更多功能
🛠️ 根据需要自定义配置

Happy Trading! 🚀

祝你使用愉快！如有任何问题，欢迎提交 Issue 或查阅完整文档。

6.2 KiB Raw Permalink Blame History Unescape Escape