TradingAgents-CN v1.0.1 使用手册配置管理、单股同步与上游同步实战指南【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN本文是 TradingAgents-CNv1.0.1版本的完整使用手册。v1.0.1是一个面向日常使用的稳定维护版本重点改进了配置管理体验厂家/模型自动置顶、聚合 LLM 厂家 AiHubMix、修复了报告与股票详情页切换时的数据残留问题并大幅增强了单股同步的兜底链路与失败排查能力。读完本文你将掌握如何正确启动与访问系统、如何完成厂家—模型目录—大模型—数据源的全链路配置、如何用同步结果明细弹窗快速定位 AKShare/Tushare 同步失败的根因以及本项目人工选择性吸收上游的维护机制。1. 产品简介TradingAgents-CN 是一个面向股票分析与管理场景的中文系统v1.0.1版本覆盖了以下核心能力模块配置管理厂家管理、模型目录、大模型配置的统一 Web 管理体系股票详情单只股票的综合信息展示行情、基本信息、新闻舆情、财务数据、历史分析记录报告分析查看多智能体 LLM 生成的模块化分析报告自选股与筛选维护自选列表基于数据库与多维度条件筛选股票数据同步AKShare / Tushare 驱动的单股与批量行情、历史、财务、基础数据同步大模型配置绑定厂家与模型、设置默认模型、配置 Token/温度/超时/价格v1.0.1相比此前版本重点增强了以下体验新增厂家和模型后自动置顶显示新增聚合 LLM 厂家AiHubMix支持通过统一 OpenAI 兼容接口接入多家模型切换报告和股票时页面会自动刷新正确内容不再残留旧页面数据单股同步失败时可直接看到具体原因主链路/回退链路/落库状态AKShare 单股实时行情支持备份接口兜底降低单股同步失败率继续吸收上游项目核心能力同时保留本地中文增强与 Web 管理体系适用版本v1.0.1适用对象日常使用 Web 界面的个人用户、管理员和运维人员。更完整的版本变更细节可参考 v1.0.1 发布说明 与 更新日志。2. 启动与访问2.1 启动服务按部署方式启动后端与前端服务常见入口包括python -m app.main或使用项目中的启动脚本python scripts/startup/start_backend.py python scripts/startup/start_web.py从源码结构看scripts/startup 目录提供了完整的启动脚本族start_api.py、start_backend.py、start_frontend.py、start_production.py等以及 Windows 的.bat/ PowerShell 和 Linux 的.sh版本可以按部署环境选择对应入口。2.2 访问系统前端页面默认访问地址通常为http://localhost:3000或部署后的实际地址后端 API 默认访问地址通常为http://localhost:3001如果你的环境使用 Docker 或反向代理请以实际部署地址为准仓库根目录的 docker-compose.yml 与 docker/nginx.conf 提供了容器化与反向代理的参考配置。3. 首次使用建议首次进入系统后建议按以下顺序完成配置检查系统是否能正常登录进入配置管理配置厂家信息导入或维护模型目录配置大模型配置数据源打开一只股票执行一次同步测试这套流程覆盖了登录 → 配置 → 验证的完整闭环先保证模型链路可用再验证数据链路可用最后再执行分析可以最大程度避免后续分析任务因配置缺失而失败。4. 配置管理配置管理是v1.0.1的重点改进区域Web 端的配置最终由 app/routers/config.py 与 app/services/config_service.py 支撑并落库到 MongoDB 配置体系中。4.1 厂家管理在配置管理 - 厂家管理中可以新增厂家编辑厂家信息删除不再使用的厂家检查厂家启用状态v1.0.1新增内容支持新增聚合 LLM 厂家AiHubMix支持聚合渠道厂家初始化能力可批量生成302.AI、AiHubMix、OpenRouter、One API、New API等配置建议维护的厂家字段包括字段说明厂家标识provider key系统内部使用的规范键如aihubmix、qwen、deepseek等厂家显示名称Web 界面展示的名称API Key调用该厂家接口的密钥Base URL该厂家 API 的入口地址启用状态是否允许该厂家参与模型调用从 tradingagents/llm_clients/provider_keys.py 的源码可以看到厂家标识会被归一化为canonical key例如dashscope、alibaba、阿里百炼都会被归一化为qwenzhipu、智谱会被归一化为glm。这正是v1.0.1中provider 规范键统一的落地实现它保证了不同来源的厂家命名不会引发调用分歧。同时该文件还维护了各厂家的默认环境变量映射如AIHUBMIX_API_KEY、DASHSCOPE_API_KEY、OPENAI_API_KEY、DEEPSEEK_API_KEY、ZHIPU_API_KEY等与默认 Base URL如aihubmix→https://aihubmix.com/v1可作为厂家配置的参考值。4.2 模型目录管理在配置管理 - 模型目录中可以为指定厂家添加模型目录编辑模型目录内容删除模型目录v1.0.1新行为新增的厂家会自动排到列表最上面模型目录选择时会优先显示最近新增的厂家这一行为的后端基础是大模型配置补齐了created_at/updated_at时间字段/api/config/llm按最新配置优先返回前端排序与接口返回顺序保持一致。4.3 大模型配置在配置管理 - 大模型配置中可以新增模型配置绑定厂家与模型设置默认模型配置 Token、温度、超时和价格信息启用或禁用模型v1.0.1新行为新增模型后会自动显示在最上方模型选择框中的候选模型也会优先显示最新添加的模型分析页面使用的模型下拉顺序与配置页面保持一致在运行层面配置好的大模型会通过 tradingagents/llm_clients 抽象层统一接入主链路factory.py负责按 provider 创建客户端model_catalog.py提供共享模型目录校验openai_client.py实现 OpenAI 兼容协议调用validators.py提供轻量校验。从 tradingagents/graph/trading_graph.py 的源码结构看trading_graph.py的主要 provider 初始化路径已进一步收口到llm_clients这意味着你在 Web 端配置的模型会直接影响分析主链路。4.4 配置建议常用厂家保持启用状态不再使用的模型建议禁用而不是直接删除便于日后回退配置完成后建议刷新一次页面确认排序与状态正常如果你使用聚合平台建议优先配置AiHubMix这类 OpenAI 兼容聚合厂家再补充对应模型目录——聚合厂家通常一次接入即可访问多家上游模型能显著降低 Key 与 URL 的维护成本5. 股票详情页使用股票详情页用于查看单只股票的综合信息。5.1 常见内容行情信息由market_quotes集合提供实时快照基本信息由stock_basic_info集合提供新闻与舆情财务数据历史分析记录5.2 v1.0.1 改进从一只股票切换到另一只股票时页面会重新加载对应数据不会再停留在上一个股票的旧内容如果你通过自选股、筛选结果或列表页跳转到股票详情页面应自动刷新为新股票内容。这一修复对应发布说明中的股票详情页切换股票时重置旧状态并重新加载与详情页状态重置逻辑优化。6. 报告详情页使用报告详情页用于查看已完成的多智能体分析报告。6.1 常见操作查看报告摘要查看模块化分析内容回看历史报告6.2 v1.0.1 改进在不同报告之间切换时页面会自动重新拉取对应内容不会再停留在上一份报告的数据该修复对应发布说明中的报告详情页监听路由参数变化并自动刷新解决了高频切换报告时旧内容残留的问题。7. 单股同步操作单股同步是v1.0.1重点增强的使用环节其后端入口为 app/routers/stock_sync.py 中的POST /api/stock-sync/single。7.1 操作入口进入任意股票详情页后点击同步数据即可执行单股同步。7.2 可同步内容实时行情sync_realtime历史行情sync_historical默认开启财务数据sync_financial默认开启基础信息sync_basic默认关闭从 app/routers/stock_sync.py 的请求模型可以看到单股同步还支持data_sourcetushare/akshare默认tushare与days历史数据天数范围 13650默认 30两个关键参数。一个值得注意的实现细节是单股实时行情同步会自动切换到 AKShare——即使请求指定了tushare后端也会先切换为akshare以规避 Tushare 接口限制当 AKShare 主链路失败时再回退到 Tushare 全量同步仅同步实时行情场景。7.3 同步结果说明v1.0.1中同步完成后会弹出结果明细而不是只显示同步成功或同步失败。你会看到以下信息实时行情是否成功历史数据是否成功财务数据是否成功基础数据是否成功实际尝试过哪些数据源attempted_sources主链路错误原因primary_error回退链路错误原因fallback_error是否已写入market_quotesmarket_quote_available对应源码app/routers/stock_sync.py中realtime_sync返回结构包含data_source_used、attempted_sources、primary_error、fallback_error、market_quote_available、market_quote_snapshot等字段且同步汇总日志会以前缀完整打印上述上下文可直接用于问题排查。此外历史数据同步成功后后端会调用_sync_latest_to_market_quotesapp/routers/stock_sync.py将stock_daily_quotes中的最新数据同步到market_quotes并带有一个智能判断如果market_quotes中已有更新或相同交易日的数据则不覆盖避免用历史数据覆盖实时数据。8. 数据源与故障排查8.1 AKShare 实时行情策略v1.0.1中AKShare 单股实时行情采用以下顺序自动尝试实现在 tradingagents/dataflows/providers/china/akshare.pystock_bid_ask_em—— 主接口东方财富买卖五档快照stock_zh_a_spot—— 备份接口 1新浪全市场快照stock_zh_a_spot_em—— 备份接口 2东方财富全市场快照stock_zh_a_hist—— 最终兜底历史日线含义如下前 3 个属于实时或快照接口第 4 个属于历史日线兜底即使实时接口全部不可用也能用最新一根日线给出可用的行情结构该策略由 tradingagents/dataflows/providers/china/akshare.py 的get_stock_quotes实现优先调用stock_bid_ask_em若返回空或抛出异常则自动转入备份接口链路每一级失败都会记录 warning 日志方便追踪实际生效的数据源。同时在 app/worker/akshare_sync_service.py 中单只股票的同步会直接走get_stock_quotes单股接口而不是批量快照接口配合多级兜底提升单股成功率。8.2 常见失败原因情况 1AKShare 连接被远端断开常见表现日志出现RemoteDisconnected同步提示里显示主链路失败建议检查网络环境检查是否有代理、VPN 或网络拦截重试一次同步系统会自动尝试备份接口情况 2Tushare 被限流常见表现日志或提示中出现每分钟最多访问该接口 1 次建议间隔 1 分钟以上再重试避免短时间连续点击同步情况 3未写入 market_quotes常见表现同步后/api/stocks/{code}/quote仍查不到数据建议查看同步结果弹窗中的market_quote_available检查实时链路是否全部失败必要时先同步历史数据再补实时数据历史数据同步成功后会触发_sync_latest_to_market_quotes自动回填market_quotes重要提示HTTP200只代表接口调用成功不代表行情已经写入数据库。判定是否落库必须以同步结果弹窗中的实时结果和market_quotes写入状态为准。9. 推荐使用流程适合日常管理员的推荐流程如下登录系统打开配置管理检查厂家、模型目录和大模型配置确认新增项是否已置顶打开目标股票详情页执行一次单股同步查看同步明细弹窗确认行情是否已写入再执行分析或查看报告这套流程的关键在于第 4 步和第 8 步置顶排序用于验证配置管理是否生效行情落库验证用于确保数据链路真正打通两者都通过后再进入分析环节可避免配置看似成功、分析却无数据的隐性故障。10. 上游同步说明v1.0.1不只是本地修复版本也包含人工选择性同步上游项目的持续演进成果。10.1 什么是上游同步这里的上游指原项目TauricResearch/TradingAgents。当前项目没有采用整仓自动跟随而是按模块人工评估、选择性吸收上游更新。完整策略见 docs/maintenance/upstream-sync.md逐项吸收记录见 docs/maintenance/manual-upstream-absorption-checklist.md。10.2 当前同步原则优先吸收核心能力和底层抽象优先吸收明确的缺陷修复和稳定性改进不强行追求与上游完全一致保留本项目的中文增强、Web 配置管理和数据库配置体系10.3 v1.0.1 中与上游同步相关的能力llm_clients抽象层接入主链路统一主要 LLM 调用入口见 tradingagents/llm_clients 目录共享模型目录接入 CLI 与轻量校验链路provider 规范键统一为 canonical key减少不同实现之间的命名分歧见 tradingagents/llm_clients/provider_keys.pytrading_graph.py的主要 provider 初始化路径进一步收口到llm_clientsfundamentals_analyst.py中与 qwen 相关的 fresh llm 重建逻辑适配新路径图层参数透传能力同步到当前实现工厂别名兼容和风控引用修复同步到当前实现provider 命名兼容、默认 URL / 环境变量映射和依赖补齐同步到当前实现provider 别名归一化工具和 model catalog 共享校验逻辑接入当前版本MongoDB 默认库名tradingagentscn、按版本 / 实例隔离命名能力与迁移脚本同步到当前版本开发环境共享库保护和相关运维文档同步到当前版本当前 canonical provider 键集合包括qwen、glm、openai、google、deepseek、openrouter、ollama、qianfan、custom_openai另在v1.0.1中纳入aihubmix聚合厂家规范键与中文别名如阿里百炼→qwen、智谱→glm的归一化映射可在 tradingagents/llm_clients/provider_keys.py 中直接查阅。10.4 相关文档上游同步策略人工上游吸收清单11. 常见问题Q1为什么新增厂家没有显示在最上面请刷新配置管理 - 模型目录页面。在v1.0.1中新增厂家默认按最新顺序置顶显示。Q2为什么新增模型没有显示在最上面请确认当前运行版本为v1.0.1并刷新大模型配置页面。如果后端未重启接口可能还在返回旧顺序/api/config/llm的置顶排序依赖后端新增的created_at/updated_at时间字段。Q3为什么点击另一个股票后还是旧页面v1.0.1已修复这个问题。如果仍出现请清空前端缓存并刷新页面确认部署代码已更新。Q4为什么同步接口返回 200但还是没有行情HTTP200只表示接口调用成功不代表行情已经写入数据库。请以同步结果弹窗中的实时结果和market_quotes写入状态为准重点看market_quote_available字段。Q5AKShare 失败后怎么办系统会自动尝试备份接口stock_zh_a_spot→stock_zh_a_spot_em→stock_zh_a_hist。如果全部失败再考虑检查网络、等待限流恢复或改用其他数据源。12. 运维建议每次升级后先验证配置管理页面排序至少抽查一只股票的同步链路关注后端日志中的数据源切换与错误摘要单股同步汇总日志以前缀输出可直接定位主链路/回退链路错误对 Tushare 用户避免在一分钟内重复触发同类接口在吸收上游更新前先参考上游同步策略和人工吸收清单做评估13. 相关文档v1.0.1 发布说明更新日志升级指南上游同步策略人工上游吸收清单如需深入源码级验证本文提到的实现可重点阅读app/routers/stock_sync.py —— 单股/批量同步 API、同步结果明细结构、market_quotes回填逻辑app/worker/akshare_sync_service.py —— AKShare 同步服务实时行情单股优化、批量快照与逐个回退、历史/财务/基础数据同步tradingagents/dataflows/providers/china/akshare.py ——stock_bid_ask_em多级兜底链路tradingagents/llm_clients/provider_keys.py —— provider 规范键、别名归一化、默认 URL 与环境变量映射tradingagents/llm_clients/factory.py —— LLM 客户端工厂与主链路接入scripts/startup —— 后端/前端启动脚本族【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
