TradingAgents-CN 的 Tushare 数据源接入与使用全指南配置、统一接口、多周期数据与故障排查【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN本篇技术指南以 TradingAgents-CN基于多智能体 LLM 的中文金融交易框架中 Tushare 数据源的完整接入方案为主题系统讲解从 Token 配置、CLI/Web/API 三种使用方式到统一数据源管理器、多周期历史数据初始化、缓存与降级机制以及常见故障排查的完整链路。读完本文你将掌握在 TradingAgents-CN 中以 Tushare 为默认 A 股数据源进行数据初始化、行情查询、基本面分析与数据源切换的全部实操方法并能深入理解其底层源码实现原理。一、Tushare 接入概览与配置状态确认TradingAgents-CN 已将 Tushare 作为默认的中国股票数据源。完成配置后可通过以下状态信息确认接入是否成功 数据源状态: ✅ 正常 TUSHARE_TOKEN: ✅ 已配置 (56字符) 默认数据源: tushare 可用数据源: tushare, akshare, baostock, tdx(已弃用) API连接: ✅ 成功其中几个关键点需要特别说明TUSHARE_TOKEN 长度为 56 字符这是 Tushare 官方分配的 API 密钥配置时必须确保字符完整无缺。tdx通达信数据源已弃用从源码看data_source_manager.py 中明确注释了 TDX (通达信) 已移除、TDX 适配器已移除switch_china_data_source的映射表中也移除了tdx项。因此本文所有内容均以 Tushare、AKShare、BaoStock 三种可用数据源为准。Token 的读取优先级从 tushare.py 的_get_token_from_database与connect_sync实现可以确认系统优先从 MongoDB 数据库的激活配置system_configs集合中is_activeTrue的文档读取 Token其次才读取环境变量。这意味着在 Web 后台修改数据源配置后可以立即生效无需重启服务同时会过滤掉以your_开头的占位符 Token。环境变量层面的配置要求是.env文件中正确设置TUSHARE_TOKEN与DEFAULT_CHINA_DATA_SOURCEtushare。也可以通过调试命令快速验证# 检查配置 python -c import os print(TUSHARE_TOKEN:, 已设置 if os.getenv(TUSHARE_TOKEN) else 未设置) print(DEFAULT_CHINA_DATA_SOURCE:, os.getenv(DEFAULT_CHINA_DATA_SOURCE, tushare)) # 测试连接 python -c import tushare as ts import os ts.set_token(os.getenv(TUSHARE_TOKEN)) pro ts.pro_api() print(Tushare连接测试成功) 二、三种使用方式CLI、Web 与 API1. 命令行界面推荐# 启动CLI python -m cli.main # 选择分析中国股票 # 系统会自动使用Tushare数据源获取数据CLI 入口位于 cli/main.py适合快速交互式分析场景。2. Web 界面# 启动Web界面 python -m streamlit run web/app.py # 在浏览器中访问: http://localhost:8501 # 系统会自动使用Tushare数据源3. API 调用示例所有统一数据接口均在 tradingagents/dataflows/init.py 中导出可直接导入使用from tradingagents.dataflows import ( get_china_stock_data_unified, get_china_stock_info_unified ) # 获取平安银行历史数据 data get_china_stock_data_unified(000001, 2024-01-01, 2024-12-31) print(data) # 获取股票基本信息 info get_china_stock_info_unified(000001) print(info)从源码看interface.py 中的get_china_stock_data_unified会在获取数据前自动扩展日期范围它会读取MARKET_ANALYST_LOOKBACK_DAYS配置默认 30 天来向前回溯以覆盖周末和节假日导致的非交易日缺口确保返回的数据足够支撑技术指标计算get_china_stock_info_unified则返回包含股票代码、名称、所属地区、所属行业、上市市场、上市日期以及附加快照行情现价、涨跌幅、成交量的格式化文本可直接作为 LLM 的分析输入。三、为什么选择 Tushare与 TDX 的对比与旧数据源 TDX 对比特性TDX (旧)Tushare (新)数据质量⚠️ 个人接口✅ 专业API连接稳定性⚠️ 经常断线✅ 高可用数据完整性⚠️ 部分缺失✅ 完整准确更新频率⚠️ 延迟较大✅ 及时更新技术支持❌ 无官方支持✅ 专业支持需要说明的是该对比表中的结论来源于项目官方文档 TUSHARE_USAGE_GUIDE.md且 TDX 数据源在后续版本中已被彻底移除从源码层面不再支持。数据覆盖范围✅股票基础数据: 所有A股股票信息✅历史行情: 日线、周线、月线数据支持多周期同步✅财务数据: 三大财务报表✅实时数据: 最新价格和交易信息✅技术指标: 常用技术分析指标多周期数据支持日线数据(daily): 每个交易日的OHLCV数据周线数据(weekly): 每周的OHLCV数据月线数据(monthly): 每月的OHLCV数据所有周期数据统一存储在stock_daily_quotes集合多周期数据是 TradingAgents-CN 对 Tushare 接入的重要增强用于支撑多时间尺度短期、中期、长期的市场分析与交易信号验证。四、统一数据源管理器优先级、降级与缓存机制Tushare 并非孤立地工作而是运行在 TradingAgents-CN 的统一数据源管理框架内。理解这一框架有助于你更好地使用和调优。数据源优先级从 data_source_manager.py 的ChinaDataSource枚举与_get_default_source实现可以确认中国股票数据源按以下优先级排列MongoDB 数据库缓存最高优先级 Tushare AKShare BaoStock具体逻辑为若启用 MongoDB 缓存由use_app_cache_enabled()运行时设置控制MongoDB 缓存数据源作为最高优先级查询时优先命中本地缓存默认数据源从环境变量DEFAULT_CHINA_DATA_SOURCE读取默认值为akshare可切换为tushare系统会从数据库的system_configs集合中读取data_source_configs配置按priority字段降序排列过滤出启用的数据源若数据库配置读取失败则回退到默认顺序AKShare Tushare BaoStock并只保留实际可用的数据源。自动降级机制当主数据源获取失败或返回空数据时get_stock_dataframe、get_fundamentals_data、get_news_data等方法都会遍历available_sources列表自动降级到下一个可用数据源并将失败与降级过程记录到日志data_source、event_type: fundamentals_fetch_fallback等结构化字段。这保证了在 Tushare 接口异常时分析流程不会中断。双层缓存统一缓存管理器tradingagents.dataflows.cache自动缓存股票数据重复查询直接命中缓存缓存有效期 24 小时max_age_hours24确保数据新鲜度MongoDB 缓存适配器作为最高优先级数据源持久化存储行情与基本面数据供后续查询复用。技术指标自动计算值得一提的是_format_stock_data_response会在返回行情数据时自动计算并附上技术指标MA5/MA10/MA20/MA60、MACDDIF/DEA/柱、RSI6/RSI12/RSI24同花顺风格的中国式 SMA 算法与 RSI14国际标准、布林带BOLL等并给出金叉/死叉、超买/超卖、多头/空头排列等信号判断。这意味着通过get_china_stock_data_unified一次调用即可获得带技术指标的完整分析数据。五、常用功能示例1. 股票基本面分析# 分析平安银行 from tradingagents.dataflows import get_china_stock_fundamentals_tushare # 获取基本面分析 fundamentals get_china_stock_fundamentals_tushare(000001) print(fundamentals)从 interface.py 的get_china_stock_fundamentals_tushare实现看该方法会重定向到data_source_manager.get_fundamentals_data其降级链路为MongoDB → Tushare → AKShare → 生成分析即使所有数据源都失败也会退化为基于已知信息的自动分析保证 LLM 始终有输入可用。2. 股票搜索# 搜索银行股 from tradingagents.dataflows import search_china_stocks_tushare results search_china_stocks_tushare(银行) print(results)3. 多周期数据初始化Tushare 多周期历史数据的初始化通过 cli/tushare_init.py 完成这是首次部署时的关键步骤# 初始化多周期历史数据日线、周线、月线 python cli/tushare_init.py --full --multi-period # 指定历史数据范围例如1年 python cli/tushare_init.py --full --multi-period --historical-days 365 # 强制重新初始化 python cli/tushare_init.py --full --multi-period --force该 CLI 工具的完整参数如下参数默认值说明--full-运行完整初始化推荐首次使用--basic-only-仅初始化基础信息--historical-days365历史数据天数全历史初始化1990 年至今需 ≥3650 天生产环境推荐--historical-days 10000--multi-period-同步多周期数据日线、周线、月线--sync-items-指定同步类型逗号分隔可选basic_info,historical,weekly,monthly,financial,quotes,news--force-强制初始化覆盖已有数据--batch-size100批处理大小--check-only-仅检查数据库状态不执行同步--help-detail-显示详细帮助常用组合示例# 全历史多周期初始化推荐用于生产环境 python cli/tushare_init.py --full --multi-period --historical-days 10000 # 仅同步历史数据日线 python cli/tushare_init.py --full --sync-items historical # 仅同步财务数据和行情数据 python cli/tushare_init.py --full --sync-items financial,quotes # 仅更新周线和月线数据 python cli/tushare_init.py --full --sync-items weekly,monthly # 仅检查当前数据状态 python cli/tushare_init.py --check-only该工具的实现要点见 cli/tushare_init.py初始化时先检查数据库状态check_database_status统计stock_basic_info与market_quotes集合的条数、扩展字段full_symbol、market_info覆盖率若覆盖率低于 50% 会建议重新初始化--full模式下若数据库已有数据且未加--force工具会提示需要强制初始化初始化完成后会输出耗时、进度以及分周期数据统计日线/周线/月线条数、财务数据条数、行情条数、新闻条数并展示最多 3 个错误明细底层调用 app/worker/tushare_init_service.py 的run_full_initialization支持skip_if_exists、enable_multi_period、sync_items等参数控制。4. 查询多周期数据多周期数据统一存储在 MongoDB 的stock_daily_quotes集合中可按symbolperioddata_source组合查询from tradingagents.config.database_manager import get_mongodb_client client get_mongodb_client() db client.get_database(tradingagents) collection db.stock_daily_quotes # 查询日线数据 daily_data list(collection.find({ symbol: 000001, period: daily, data_source: tushare }).sort(trade_date, 1)) # 查询周线数据 weekly_data list(collection.find({ symbol: 000001, period: weekly, data_source: tushare }).sort(trade_date, 1)) # 查询月线数据 monthly_data list(collection.find({ symbol: 000001, period: monthly, data_source: tushare }).sort(trade_date, 1)) print(f日线: {len(daily_data)} 条) print(f周线: {len(weekly_data)} 条) print(f月线: {len(monthly_data)} 条)5. 数据源切换# 查看当前数据源 from tradingagents.dataflows import get_current_china_data_source current get_current_china_data_source() print(current) # 切换数据源如果需要 from tradingagents.dataflows import switch_china_data_source switch_china_data_source(tushare) # 确保使用Tushareswitch_china_data_source支持tushare、akshare、baostock三种取值tdx已移除切换前会校验目标数据源是否在available_sources中set_current_source方法不可用的数据源会被拒绝。切换是进程内即时生效的适合在会话中动态调整。六、性能优化建议1. 利用缓存系统自动缓存数据重复查询会更快缓存有效期 24 小时确保数据新鲜度建议优先使用统一接口get_china_stock_data_unified()其内部会先走缓存再走网络请求。2. 批量查询# 批量获取多只股票信息 stocks [000001, 000002, 600036, 600519] for stock in stocks: info get_china_stock_info_unified(stock) print(f{stock}: {info.split(股票名称: )[1].split(\n)[0]})3. 合理使用APITushare 有调用频率限制取决于账号积分等级建议间隔 0.1 秒进行连续调用避免触发限频充分利用缓存减少 API 调用次数大规模历史数据同步时使用cli/tushare_init.py --batch-size控制批处理大小默认 100。七、故障排除常见问题Token无效错误: 无效的token 解决: 检查.env文件中的TUSHARE_TOKEN是否正确补充由于 Token 读取优先级是数据库优先若在 Web 后台或 MongoDB 的system_configs中配置了错误的 Token也会导致此错误。请同时检查数据库配置与.env两处。API调用超限错误: 调用频率超限 解决: 等待一分钟后重试或升级Tushare账号网络连接问题错误: 连接超时 解决: 检查网络连接重试操作调试建议从 tushare.py 的connect_sync实现看系统会对数据库 Token 与环境变量 Token 分步打日志从数据库读取 Token、读取 .env 中的 Token连接测试超时时间为 10 秒若持续超时可检查网络代理设置所有数据获取路径都会输出结构化日志含data_source、symbol、event_type、耗时等字段可通过日志定位是哪个数据源、哪一步失败运行 tests/test_tushare_integration.py 可验证 Tushare 提供器、适配器与统一接口三层功能是否正常覆盖股票列表、股票信息、日线数据、搜索与基本面数据的获取。八、高级功能自定义数据源策略与数据质量监控1. 自定义数据源策略from tradingagents.dataflows.data_source_manager import get_data_source_manager manager get_data_source_manager() # 查看所有可用数据源 print(可用数据源:, [s.value for s in manager.available_sources]) # 设置备用数据源策略 # 主: Tushare - 备用1: AKShare - 备用2: BaoStockget_data_source_manager()返回全局单例见 data_source_manager.py 的get_data_source_manager函数你还可以通过manager.set_current_source()在代码中动态切换当前数据源或通过数据库data_source_configs中每个数据源的enabled、priority、market_categories字段精细控制各市场A 股/美股/港股的数据源优先级。2. 数据质量监控# 获取数据时检查质量 data get_china_stock_data_unified(000001, 2024-01-01, 2024-12-31) if ❌ in data: print(数据获取失败请检查网络或API配置) else: print(数据获取成功质量良好)统一接口在数据获取失败时返回以❌开头的错误文本在成功时返回格式化的数据报告这是最简单的质量自检方式生产环境中建议结合日志中的event_typefetch_success/fetch_fallback/fetch_exception构建监控指标。九、最佳实践总结1. 环境配置确保.env文件中正确设置TUSHARE_TOKEN设置DEFAULT_CHINA_DATA_SOURCEtushare定期检查 Token 有效性Tushare 账号积分等级会影响调用频率上限首次部署务必运行python cli/tushare_init.py --full --multi-period --historical-days 10000完成全历史多周期数据初始化。2. 代码使用优先使用统一接口get_china_stock_data_unified()、get_china_stock_info_unified()而非直接调用单个数据源的底层方法——统一接口天然具备缓存、降级和技术指标计算能力充分利用缓存机制减少重复 API 调用合理控制 API 调用频率批量操作时加入 0.1 秒间隔。3. 错误处理总是检查返回结果是否包含❌错误标记实现适当的重试机制Tushare 限频时等待后重试记录错误日志便于调试结构化日志字段symbol、data_source、event_type。4. 验证与测试运行python tests/test_tushare_integration.py验证 Tushare 提供器、适配器与统一接口的完整功能使用python cli/tushare_init.py --check-only快速检查数据库数据状态与扩展字段覆盖率。更新日期: 2025-09-30版本: v1.1 - 新增多周期数据支持日线、周线、月线【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
TradingAgents-CN 的 Tushare 数据源接入与使用全指南：配置、统一接口、多周期数据与故障排查
TradingAgents-CN 的 Tushare 数据源接入与使用全指南配置、统一接口、多周期数据与故障排查【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN本篇技术指南以 TradingAgents-CN基于多智能体 LLM 的中文金融交易框架中 Tushare 数据源的完整接入方案为主题系统讲解从 Token 配置、CLI/Web/API 三种使用方式到统一数据源管理器、多周期历史数据初始化、缓存与降级机制以及常见故障排查的完整链路。读完本文你将掌握在 TradingAgents-CN 中以 Tushare 为默认 A 股数据源进行数据初始化、行情查询、基本面分析与数据源切换的全部实操方法并能深入理解其底层源码实现原理。一、Tushare 接入概览与配置状态确认TradingAgents-CN 已将 Tushare 作为默认的中国股票数据源。完成配置后可通过以下状态信息确认接入是否成功 数据源状态: ✅ 正常 TUSHARE_TOKEN: ✅ 已配置 (56字符) 默认数据源: tushare 可用数据源: tushare, akshare, baostock, tdx(已弃用) API连接: ✅ 成功其中几个关键点需要特别说明TUSHARE_TOKEN 长度为 56 字符这是 Tushare 官方分配的 API 密钥配置时必须确保字符完整无缺。tdx通达信数据源已弃用从源码看data_source_manager.py 中明确注释了 TDX (通达信) 已移除、TDX 适配器已移除switch_china_data_source的映射表中也移除了tdx项。因此本文所有内容均以 Tushare、AKShare、BaoStock 三种可用数据源为准。Token 的读取优先级从 tushare.py 的_get_token_from_database与connect_sync实现可以确认系统优先从 MongoDB 数据库的激活配置system_configs集合中is_activeTrue的文档读取 Token其次才读取环境变量。这意味着在 Web 后台修改数据源配置后可以立即生效无需重启服务同时会过滤掉以your_开头的占位符 Token。环境变量层面的配置要求是.env文件中正确设置TUSHARE_TOKEN与DEFAULT_CHINA_DATA_SOURCEtushare。也可以通过调试命令快速验证# 检查配置 python -c import os print(TUSHARE_TOKEN:, 已设置 if os.getenv(TUSHARE_TOKEN) else 未设置) print(DEFAULT_CHINA_DATA_SOURCE:, os.getenv(DEFAULT_CHINA_DATA_SOURCE, tushare)) # 测试连接 python -c import tushare as ts import os ts.set_token(os.getenv(TUSHARE_TOKEN)) pro ts.pro_api() print(Tushare连接测试成功) 二、三种使用方式CLI、Web 与 API1. 命令行界面推荐# 启动CLI python -m cli.main # 选择分析中国股票 # 系统会自动使用Tushare数据源获取数据CLI 入口位于 cli/main.py适合快速交互式分析场景。2. Web 界面# 启动Web界面 python -m streamlit run web/app.py # 在浏览器中访问: http://localhost:8501 # 系统会自动使用Tushare数据源3. API 调用示例所有统一数据接口均在 tradingagents/dataflows/init.py 中导出可直接导入使用from tradingagents.dataflows import ( get_china_stock_data_unified, get_china_stock_info_unified ) # 获取平安银行历史数据 data get_china_stock_data_unified(000001, 2024-01-01, 2024-12-31) print(data) # 获取股票基本信息 info get_china_stock_info_unified(000001) print(info)从源码看interface.py 中的get_china_stock_data_unified会在获取数据前自动扩展日期范围它会读取MARKET_ANALYST_LOOKBACK_DAYS配置默认 30 天来向前回溯以覆盖周末和节假日导致的非交易日缺口确保返回的数据足够支撑技术指标计算get_china_stock_info_unified则返回包含股票代码、名称、所属地区、所属行业、上市市场、上市日期以及附加快照行情现价、涨跌幅、成交量的格式化文本可直接作为 LLM 的分析输入。三、为什么选择 Tushare与 TDX 的对比与旧数据源 TDX 对比特性TDX (旧)Tushare (新)数据质量⚠️ 个人接口✅ 专业API连接稳定性⚠️ 经常断线✅ 高可用数据完整性⚠️ 部分缺失✅ 完整准确更新频率⚠️ 延迟较大✅ 及时更新技术支持❌ 无官方支持✅ 专业支持需要说明的是该对比表中的结论来源于项目官方文档 TUSHARE_USAGE_GUIDE.md且 TDX 数据源在后续版本中已被彻底移除从源码层面不再支持。数据覆盖范围✅股票基础数据: 所有A股股票信息✅历史行情: 日线、周线、月线数据支持多周期同步✅财务数据: 三大财务报表✅实时数据: 最新价格和交易信息✅技术指标: 常用技术分析指标多周期数据支持日线数据(daily): 每个交易日的OHLCV数据周线数据(weekly): 每周的OHLCV数据月线数据(monthly): 每月的OHLCV数据所有周期数据统一存储在stock_daily_quotes集合多周期数据是 TradingAgents-CN 对 Tushare 接入的重要增强用于支撑多时间尺度短期、中期、长期的市场分析与交易信号验证。四、统一数据源管理器优先级、降级与缓存机制Tushare 并非孤立地工作而是运行在 TradingAgents-CN 的统一数据源管理框架内。理解这一框架有助于你更好地使用和调优。数据源优先级从 data_source_manager.py 的ChinaDataSource枚举与_get_default_source实现可以确认中国股票数据源按以下优先级排列MongoDB 数据库缓存最高优先级 Tushare AKShare BaoStock具体逻辑为若启用 MongoDB 缓存由use_app_cache_enabled()运行时设置控制MongoDB 缓存数据源作为最高优先级查询时优先命中本地缓存默认数据源从环境变量DEFAULT_CHINA_DATA_SOURCE读取默认值为akshare可切换为tushare系统会从数据库的system_configs集合中读取data_source_configs配置按priority字段降序排列过滤出启用的数据源若数据库配置读取失败则回退到默认顺序AKShare Tushare BaoStock并只保留实际可用的数据源。自动降级机制当主数据源获取失败或返回空数据时get_stock_dataframe、get_fundamentals_data、get_news_data等方法都会遍历available_sources列表自动降级到下一个可用数据源并将失败与降级过程记录到日志data_source、event_type: fundamentals_fetch_fallback等结构化字段。这保证了在 Tushare 接口异常时分析流程不会中断。双层缓存统一缓存管理器tradingagents.dataflows.cache自动缓存股票数据重复查询直接命中缓存缓存有效期 24 小时max_age_hours24确保数据新鲜度MongoDB 缓存适配器作为最高优先级数据源持久化存储行情与基本面数据供后续查询复用。技术指标自动计算值得一提的是_format_stock_data_response会在返回行情数据时自动计算并附上技术指标MA5/MA10/MA20/MA60、MACDDIF/DEA/柱、RSI6/RSI12/RSI24同花顺风格的中国式 SMA 算法与 RSI14国际标准、布林带BOLL等并给出金叉/死叉、超买/超卖、多头/空头排列等信号判断。这意味着通过get_china_stock_data_unified一次调用即可获得带技术指标的完整分析数据。五、常用功能示例1. 股票基本面分析# 分析平安银行 from tradingagents.dataflows import get_china_stock_fundamentals_tushare # 获取基本面分析 fundamentals get_china_stock_fundamentals_tushare(000001) print(fundamentals)从 interface.py 的get_china_stock_fundamentals_tushare实现看该方法会重定向到data_source_manager.get_fundamentals_data其降级链路为MongoDB → Tushare → AKShare → 生成分析即使所有数据源都失败也会退化为基于已知信息的自动分析保证 LLM 始终有输入可用。2. 股票搜索# 搜索银行股 from tradingagents.dataflows import search_china_stocks_tushare results search_china_stocks_tushare(银行) print(results)3. 多周期数据初始化Tushare 多周期历史数据的初始化通过 cli/tushare_init.py 完成这是首次部署时的关键步骤# 初始化多周期历史数据日线、周线、月线 python cli/tushare_init.py --full --multi-period # 指定历史数据范围例如1年 python cli/tushare_init.py --full --multi-period --historical-days 365 # 强制重新初始化 python cli/tushare_init.py --full --multi-period --force该 CLI 工具的完整参数如下参数默认值说明--full-运行完整初始化推荐首次使用--basic-only-仅初始化基础信息--historical-days365历史数据天数全历史初始化1990 年至今需 ≥3650 天生产环境推荐--historical-days 10000--multi-period-同步多周期数据日线、周线、月线--sync-items-指定同步类型逗号分隔可选basic_info,historical,weekly,monthly,financial,quotes,news--force-强制初始化覆盖已有数据--batch-size100批处理大小--check-only-仅检查数据库状态不执行同步--help-detail-显示详细帮助常用组合示例# 全历史多周期初始化推荐用于生产环境 python cli/tushare_init.py --full --multi-period --historical-days 10000 # 仅同步历史数据日线 python cli/tushare_init.py --full --sync-items historical # 仅同步财务数据和行情数据 python cli/tushare_init.py --full --sync-items financial,quotes # 仅更新周线和月线数据 python cli/tushare_init.py --full --sync-items weekly,monthly # 仅检查当前数据状态 python cli/tushare_init.py --check-only该工具的实现要点见 cli/tushare_init.py初始化时先检查数据库状态check_database_status统计stock_basic_info与market_quotes集合的条数、扩展字段full_symbol、market_info覆盖率若覆盖率低于 50% 会建议重新初始化--full模式下若数据库已有数据且未加--force工具会提示需要强制初始化初始化完成后会输出耗时、进度以及分周期数据统计日线/周线/月线条数、财务数据条数、行情条数、新闻条数并展示最多 3 个错误明细底层调用 app/worker/tushare_init_service.py 的run_full_initialization支持skip_if_exists、enable_multi_period、sync_items等参数控制。4. 查询多周期数据多周期数据统一存储在 MongoDB 的stock_daily_quotes集合中可按symbolperioddata_source组合查询from tradingagents.config.database_manager import get_mongodb_client client get_mongodb_client() db client.get_database(tradingagents) collection db.stock_daily_quotes # 查询日线数据 daily_data list(collection.find({ symbol: 000001, period: daily, data_source: tushare }).sort(trade_date, 1)) # 查询周线数据 weekly_data list(collection.find({ symbol: 000001, period: weekly, data_source: tushare }).sort(trade_date, 1)) # 查询月线数据 monthly_data list(collection.find({ symbol: 000001, period: monthly, data_source: tushare }).sort(trade_date, 1)) print(f日线: {len(daily_data)} 条) print(f周线: {len(weekly_data)} 条) print(f月线: {len(monthly_data)} 条)5. 数据源切换# 查看当前数据源 from tradingagents.dataflows import get_current_china_data_source current get_current_china_data_source() print(current) # 切换数据源如果需要 from tradingagents.dataflows import switch_china_data_source switch_china_data_source(tushare) # 确保使用Tushareswitch_china_data_source支持tushare、akshare、baostock三种取值tdx已移除切换前会校验目标数据源是否在available_sources中set_current_source方法不可用的数据源会被拒绝。切换是进程内即时生效的适合在会话中动态调整。六、性能优化建议1. 利用缓存系统自动缓存数据重复查询会更快缓存有效期 24 小时确保数据新鲜度建议优先使用统一接口get_china_stock_data_unified()其内部会先走缓存再走网络请求。2. 批量查询# 批量获取多只股票信息 stocks [000001, 000002, 600036, 600519] for stock in stocks: info get_china_stock_info_unified(stock) print(f{stock}: {info.split(股票名称: )[1].split(\n)[0]})3. 合理使用APITushare 有调用频率限制取决于账号积分等级建议间隔 0.1 秒进行连续调用避免触发限频充分利用缓存减少 API 调用次数大规模历史数据同步时使用cli/tushare_init.py --batch-size控制批处理大小默认 100。七、故障排除常见问题Token无效错误: 无效的token 解决: 检查.env文件中的TUSHARE_TOKEN是否正确补充由于 Token 读取优先级是数据库优先若在 Web 后台或 MongoDB 的system_configs中配置了错误的 Token也会导致此错误。请同时检查数据库配置与.env两处。API调用超限错误: 调用频率超限 解决: 等待一分钟后重试或升级Tushare账号网络连接问题错误: 连接超时 解决: 检查网络连接重试操作调试建议从 tushare.py 的connect_sync实现看系统会对数据库 Token 与环境变量 Token 分步打日志从数据库读取 Token、读取 .env 中的 Token连接测试超时时间为 10 秒若持续超时可检查网络代理设置所有数据获取路径都会输出结构化日志含data_source、symbol、event_type、耗时等字段可通过日志定位是哪个数据源、哪一步失败运行 tests/test_tushare_integration.py 可验证 Tushare 提供器、适配器与统一接口三层功能是否正常覆盖股票列表、股票信息、日线数据、搜索与基本面数据的获取。八、高级功能自定义数据源策略与数据质量监控1. 自定义数据源策略from tradingagents.dataflows.data_source_manager import get_data_source_manager manager get_data_source_manager() # 查看所有可用数据源 print(可用数据源:, [s.value for s in manager.available_sources]) # 设置备用数据源策略 # 主: Tushare - 备用1: AKShare - 备用2: BaoStockget_data_source_manager()返回全局单例见 data_source_manager.py 的get_data_source_manager函数你还可以通过manager.set_current_source()在代码中动态切换当前数据源或通过数据库data_source_configs中每个数据源的enabled、priority、market_categories字段精细控制各市场A 股/美股/港股的数据源优先级。2. 数据质量监控# 获取数据时检查质量 data get_china_stock_data_unified(000001, 2024-01-01, 2024-12-31) if ❌ in data: print(数据获取失败请检查网络或API配置) else: print(数据获取成功质量良好)统一接口在数据获取失败时返回以❌开头的错误文本在成功时返回格式化的数据报告这是最简单的质量自检方式生产环境中建议结合日志中的event_typefetch_success/fetch_fallback/fetch_exception构建监控指标。九、最佳实践总结1. 环境配置确保.env文件中正确设置TUSHARE_TOKEN设置DEFAULT_CHINA_DATA_SOURCEtushare定期检查 Token 有效性Tushare 账号积分等级会影响调用频率上限首次部署务必运行python cli/tushare_init.py --full --multi-period --historical-days 10000完成全历史多周期数据初始化。2. 代码使用优先使用统一接口get_china_stock_data_unified()、get_china_stock_info_unified()而非直接调用单个数据源的底层方法——统一接口天然具备缓存、降级和技术指标计算能力充分利用缓存机制减少重复 API 调用合理控制 API 调用频率批量操作时加入 0.1 秒间隔。3. 错误处理总是检查返回结果是否包含❌错误标记实现适当的重试机制Tushare 限频时等待后重试记录错误日志便于调试结构化日志字段symbol、data_source、event_type。4. 验证与测试运行python tests/test_tushare_integration.py验证 Tushare 提供器、适配器与统一接口的完整功能使用python cli/tushare_init.py --check-only快速检查数据库数据状态与扩展字段覆盖率。更新日期: 2025-09-30版本: v1.1 - 新增多周期数据支持日线、周线、月线【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
核心原理与实战指南)
