38ca293fe2
重大升级：专业Tushare API替代通达信 ## 核心改进 ### 数据源升级 - 完全移除通达信(TongDaXin/TDX)依赖 - 集成专业Tushare API - 更稳定可靠的数据获取 - 官方API文档和技术支持 ### 智能市场处理 - 自动识别中美股票代码格式 - 智能数据源路由选择 - 中国股票(6位数字) Tushare API - 美国股票(字母代码) Yahoo Finance ### 分析师工具优化 - Market Analyst智能工具选择 - Fundamentals Analyst中国股票支持 - 专门的中国股票分析提示词 - 保持美股分析逻辑完全不变 ### 系统架构增强 - 完整的错误处理和多层回退机制 - 智能缓存系统(MongoDB + Redis) - 交互式CLI市场选择和验证 - 完整的双语文档体系 ## 主要技术变更 ### 新增核心模块 - tradingagents/dataflows/tushare_utils.py (Tushare API完整集成) - tradingagents/dataflows/interface.py (智能数据源选择引擎) ### 优化现有模块 - tradingagents/agents/analysts/ (智能分析师工具选择) - cli/utils.py (数据源配置: tongdaxin tushare) - tradingagents/dataflows/ (完整的通达信代码清理) ### 配置和文档 - .env.example (完整的API配置指南) - docs/ (彻底清理通达信引用，统一Tushare术语) - requirements.txt (依赖优化: pytdx tushare) ## 全面测试验证 ### 功能测试 - 6/6 Tushare API集成测试通过 - 智能数据源选择算法验证 - 分析师工具正确路由确认 - CLI交互功能完整性测试 ### 兼容性测试 - 美股分析功能完全保持不变 - 现有配置文件向后兼容 - API接口保持一致性 - 无破坏性变更确认 ### 生产就绪验证 - 错误处理和回退机制测试 - 数据库缓存系统集成测试 - 多用户并发访问测试 - 长时间稳定性运行测试 ## 升级效果对比 ### 之前版本 (通达信集成) - 依赖不稳定的通达信API - 单一数据源，容错性有限 - 文档和技术支持不足 - 数据质量和及时性问题 ### 现在版本 (Tushare专业集成) - 企业级专业金融数据API - 智能多数据源架构 - 完整官方文档和技术支持 - 金融级数据质量和实时性 ## 商业价值 这次升级将TradingAgents从基础的中国市场支持 提升为专业级的全球金融分析平台： - 为中国用户提供专业A股数据支持 - 保持美股市场的卓越分析能力 - 统一的全球股票分析体验 - 企业级稳定性和可靠性 Ready for production deployment! |
||
|---|---|---|
| .. | ||
| README.md | ||
| architecture_guide.md | ||
| configuration_guide.md | ||
| prompt_templates.md | ||
| quick_reference.md | ||
| quick_start_guide.md | ||
README.md
TradingAgents 中文文档
📖 概述
TradingAgents是一个基于多智能体的金融分析系统，现已全面支持中国A股市场和多LLM提供商。本系统通过智能体协作提供深度的股票分析和投资建议。
🌟 主要特性
🌍 多市场支持
- 美股市场: 完整的美国股票市场分析
- 中国A股市场: tushareAPI集成，支持实时A股数据 ⭐ 新功能
- 智能市场选择: 交互式CLI市场选择界面
🤖 多智能体分析框架
- 市场分析师: 技术分析和图表模式识别
- 基本面分析师: 财务数据和公司基本面分析
- 新闻分析师: 新闻情绪和市场情绪分析
- 多空研究员: 多角度投资观点辩论
- 交易员智能体: 综合决策和风险评估
- 反思智能体: 分析质量控制和改进建议
🧠 多LLM提供商支持
- 百炼(DashScope): 阿里云通义千问模型系列 ⭐ 推荐中国用户
- 当前设置: 百炼作为主要选项，智能回退机制
- OpenAI: GPT-4o, GPT-4o-mini, o1, o3系列
- Google AI: Gemini 2.0/2.5 Flash系列
- Anthropic: Claude 3.5/4系列
🗄️ 企业级数据库集成
- MongoDB: 持久化数据存储和分析 ⭐ 新功能
- Redis: 高性能缓存系统 ⭐ 新功能
- 智能缓存: 自动回退机制和性能优化
📊 数据源集成
- 美股数据: Yahoo Finance集成
- A股数据: tushareAPI集成 ⭐ 新功能
- 上海证券交易所 (60xxxx)
- 深圳证券交易所 (00xxxx)
- 创业板 (30xxxx)
- 科创板 (68xxxx)
- 财经新闻: 多源新闻聚合和情绪分析
⚙️ 配置管理
- LLM提供商设置 (百炼、OpenAI、Google、Anthropic)
- 百炼(DashScope): 完整支持通义千问模型系列 ⭐ 推荐中国用户
- 当前设置: 百炼作为主要选项，智能回退机制
- 市场选择和数据源配置
- 美股市场: Yahoo Finance集成
- 中国A股市场: Tushare API集成 ⭐ 新功能
- 数据库和缓存系统
- MongoDB: 持久化数据存储
- Redis: 高性能缓存
- 智能缓存: 自动回退机制
- 辩论和讨论参数配置
- API配置和限制设置
🔧 高级功能
- 多市场支持: 美股和中国A股
- 数据库集成: MongoDB和Redis企业部署
- 智能缓存: 自适应缓存管理和回退
- 多LLM支持: 百炼、OpenAI、Google、Anthropic
- Tushare集成: 实时A股数据访问
- 风险管理模板
- 性能优化
- 自定义提示词创建
- 环境特定配置
🚀 快速开始
1. 安装和设置
# 克隆仓库
git clone https://github.com/your-repo/TradingAgents.git
cd TradingAgents
# 安装依赖
pip install -r requirements.txt
pip install tushare beautifulsoup4 # 中国市场支持
# 配置环境变量
cp .env.example .env
# 编辑.env文件，填入您的API密钥
2. 基本配置
分析美股 (使用OpenAI):
OPENAI_API_KEY=your_openai_api_key
FINNHUB_API_KEY=your_finnhub_api_key
分析中国A股 (需要百炼):
DASHSCOPE_API_KEY=your_dashscope_api_key
FINNHUB_API_KEY=your_finnhub_api_key
3. 运行分析
python -m cli.main
按照交互式提示选择市场、输入股票代码并配置分析参数。
📚 文档导航
🎯 新手指南
🏗️ 技术文档
📋 参考资料
- 快速参考 - 常用配置和修改速查表
🔑 API密钥配置说明
必需的API密钥
百炼API密钥仅在以下情况需要:
- 📈 分析中国A股股票 (使用tushare数据 + 百炼embeddings)
- 🤖 选择百炼作为LLM提供商 (通义千问模型)
分析美股使用OpenAI/Google模型时: 不需要百炼API密钥
API密钥获取
- 百炼(DashScope): https://dashscope.aliyun.com/
- OpenAI: https://platform.openai.com/
- Google AI: https://ai.google.dev/
- Anthropic: https://console.anthropic.com/
- FinnHub: https://finnhub.io/ (金融数据，必需)
🌍 支持的市场和交易所
美股市场
- 格式: 1-5位字母代码 (如 AAPL, SPY, TSLA)
- 数据源: Yahoo Finance
- 示例: AAPL (苹果), SPY (标普500ETF), TSLA (特斯拉)
中国A股市场
- 格式: 6位数字代码
- 数据源: tushareAPI
- 支持交易所:
- 上海证券交易所: 60xxxx (如 600036 招商银行)
- 深圳证券交易所: 00xxxx (如 000001 平安银行)
- 创业板: 30xxxx (如 300001 科技股)
- 科创板: 68xxxx (如 688001 创新公司)
🗄️ 数据库功能 (可选)
MongoDB集成
- 用途: 持久化数据存储和历史分析
- 功能: Token使用跟踪、分析结果存储、用户会话管理
- 设置:
MONGODB_ENABLED=true在.env中
Redis集成
- 用途: 高性能缓存和会话管理
- 功能: 快速数据访问、实时缓存、性能优化
- 设置:
REDIS_ENABLED=true在.env中
智能回退
- 第一层: Redis高性能缓存
- 第二层: MongoDB持久化存储
- 第三层: 文件缓存 (始终可用)
🎯 使用场景
场景1: 美股日常分析
- 配置: OpenAI + FinnHub
- 市场: 美股
- 特点: 快速、稳定、国际化
场景2: 中国A股专业分析
- 配置: 百炼 + FinnHub + tushare
- 市场: 中国A股
- 特点: 本土化、实时数据、中文优化
场景3: 企业级部署
- 配置: 多LLM + MongoDB + Redis
- 市场: 美股 + A股
- 特点: 高性能、可扩展、完整功能
🛠️ 故障排除
常见问题
- API密钥错误: 检查.env文件中的密钥格式
- 网络连接问题: 系统自动回退到缓存数据
- 数据库连接失败: 自动回退到文件缓存
- 股票代码格式错误: 参考市场特定格式要求
调试模式
export TRADINGAGENTS_LOG_LEVEL=DEBUG
python -m cli.main
🤝 贡献和支持
获取帮助
- GitHub Issues: 报告错误和功能请求
- 文档: 查阅详细的配置和使用指南
- 社区: 参与讨论和分享使用经验
贡献代码
- Fork项目并创建功能分支
- 提交Pull Request
- 遵循代码规范和测试要求
📈 系统优势
技术优势
- 多智能体协作: 多角度分析，提高决策质量
- 多LLM支持: 降低单点故障风险，提高可靠性
- 智能缓存: 三层缓存架构，确保高性能和高可用
- 模块化设计: 易于扩展和维护
市场优势
- 全球市场覆盖: 支持美股和中国A股两大主要市场
- 本土化优化: 中国市场专用数据源和模型
- 实时数据: tushareAPI提供实时A股数据
- 智能回退: 确保服务连续性和稳定性
🎉 开始您的智能投资分析之旅！ TradingAgents为您提供专业级的多市场股票分析能力。