TradingAgents-CN 文档中心使用指南docs 全目录导航与 v1.0.1 版本能力速览【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CNTradingAgents-CN 的docs/目录是整个中文增强版多智能体金融交易框架的官方文档中心本文以 docs/README.md 为主体梳理 v1.0.1 版本的核心更新、完整文档地图与推荐阅读路径。读完本文后你可以快速定位到配置管理、LLM 接入、数据同步、Docker 部署、发布升级等主题对应的文档位置并理解 v1.0.1 在配置体验、页面刷新、单股同步与上游能力吸收四方面的具体改进从而高效上手和排查该框架的日常使用问题。一、文档中心定位与版本基线docs/README.md 明确声明文档中心适用于v1.0.1版本覆盖配置管理、模型目录、大模型配置、股票详情、单股同步、日志排查、部署升级等核心内容。仓库根目录的 VERSION 文件当前内容即为v1.0.1与文档声明保持一致说明当前仓库快照与该文档中心是配套的。从 v1.0.1 发布说明 看本版本定位是配置管理与数据同步体验增强版本是v1.0.0-preview之后的首个稳定维护版本发布日期为 2026-04-14。二、v1.0.1 版本亮点文档原文要点 发布说明佐证docs/README.md 的版本亮点小节列出了八项更新以下逐项结合发布说明与仓库实现给出对应关系亮点具体说明佐证配置管理优化新增厂家和模型按最新添加顺序置顶显示v1.0.1 发布说明聚合厂家增强新增AiHubMix聚合 LLM 厂家支持聚合渠道初始化app/scripts/init_providers.py、app/services/config_service.py中均可检索到 aihubmix 相关实现模型选择统一排序配置页、下拉框、分析页模型顺序一致发布说明详细更新清单页面切换修复股票详情、报告详情切换时自动刷新正确内容发布说明前端页面切换修复单股同步增强返回主链路、回退链路、错误原因和落库状态发布说明中/api/stock-sync/single相关条目AKShare 兜底增强单股实时行情支持多级备份接口回退stock_bid_ask_em→stock_zh_a_spot→stock_zh_a_spot_em→stock_zh_a_hist发布说明AKShare 实时行情兜底增强上游能力持续吸收同步 LLM clients、共享模型目录、provider 规范化和数据库迁移增强上游同步策略、人工上游吸收清单文档与升级说明补充新增 v1.0.1 发布说明、使用手册和升级指南v1.0.1 使用手册、升级指南上游能力吸收的技术落地发布说明中列出的上游同步能力在当前仓库中可以从源码结构得到印证llm_clients抽象层tradingagents/llm_clients/目录下存在factory.py、model_catalog.py、provider_keys.py、validators.py、openai_client.py等模块对应provider 规范键统一为 canonical key与共享模型目录接入主链路的说法图初始化收口tradingagents/graph/trading_graph.py是主链路初始化文件发布说明称其主要 provider 初始化路径已收口到llm_clients数据库命名调整MongoDB 默认库名调整为tradingagentscn在app/core/config.py、app/core/config_bridge.py及 数据库版本隔离文档 中均可检索到该字符串且tests/test_mongo_db_naming.py提供了对应测试。canonical provider 键包括qwen、glm、openai、google、deepseek、openrouter、ollama、qianfan、custom_openai这一命名约束在 多提供商配置 相关文档与tradingagents/llm_clients/provider_keys.py中保持一致。三、文档结构全景按主题组织的完整导航docs/README.md 将文档划分为十余个板块。以下按文档原文的板块逐一列出并对链接统一转换为仓库根目录相对路径同时标注各板块中当前仓库实际存在的核心文档便于按需深入。3.1 概览文档入门第一站项目概述项目的基本介绍和目标快速开始快速上手指南安装指南详细的安装说明。该目录另含 开源免责声明适合在二次分发项目前阅读。3.2 架构文档索引中列出的架构板块包括系统架构、容器化架构、数据库架构、智能体架构、数据流架构、图结构设计、配置优化指南等主题。需要说明的是从当前仓库目录结构看docs/architecture/下的文档已按版本与主题重新组织实际现存的核心架构文档包括API 架构升级数据源重构说明 与 数据源单位对比报告模块结构子目录docs/architecture/data-source/、docs/architecture/database/、docs/architecture/dataflows/分别存放数据源、数据库与数据流专题文档。阅读建议先读数据库与数据流子目录理解 MongoDB Redis 存储与数据管道再读 数据源重构说明 理解 A 股数据源的分层与兜底设计。3.3 智能体文档索引指向的智能体板块分析师团队、研究员团队、交易员、风险管理、管理层对应框架的核心多智能体设计。从当前仓库目录结构看docs/agents/已按版本归档docs/agents/v0.1.13/子目录智能体相关设计文档随版本演进存放于该目录阅读时可结合 系统架构文档 与tradingagents/包下的智能体源码互相印证。3.4 数据处理文档数据源集成支持的数据源和 API含 A 股支持Tushare 数据接口集成A 股数据源详解索引中写作china_stock-api-integration.md当前仓库实际文件名为 tushare-integration.md数据处理流程数据获取和处理缓存机制数据缓存策略。docs/data/下另有 通达信 API 集成与 v1.0.1 单股同步的多级兜底链路AKShare 多接口 历史日线直接相关是排查行情获取问题的配套阅读材料。3.5 核心功能文档索引中核心功能板块对应的现存文档智能新闻分析模块设计AI 驱动的新闻过滤与质量评估新闻质量分析报告新闻质量评估与相关性分析新闻分析师工具修复报告工具调用修复记录Docker 容器化部署一键部署完整环境。docs/features/下还包含aggregator/聚合、config-wizard/配置向导、data-sync/数据同步、model-settings/模型设置、paper-trading/模拟交易、progress-tracking/进度跟踪、reporting/报告、stock-detail/股票详情、usage-statistics/用量统计等子目录分别对应各功能模块的设计与修复文档可按需进入。3.6 配置与部署文档实操密度最高的板块配置说明配置文件详解LLM 配置大语言模型配置Docker 配置Docker 环境配置指南DeepSeek 配置、阿里百炼配置、Google AI 配置三大厂商的专项配置Token 追踪指南Token 使用监控数据目录配置数据存储路径配置Web 界面配置Web 管理界面使用指南索引写作../web/README.md以仓库根为起点即 web/README.md。docs/configuration/下另有大量深度配置文档如 API Key 优先级、缓存配置、配置矩阵、统一配置、自定义 OpenAI Endpoint、代理配置 等是排障与二次开发时的主要参考。3.7 LLM 集成专区索引中唯一成体系的专区LLM 文档目录大语言模型集成完整文档LLM 集成指南新 LLM 提供商接入指导LLM 测试验证指南LLM 功能测试指南千帆模型接入百度千帆专项接入指南。该专区还有 模型目录管理、模型目录快速上手、模型过滤、模型定价指南 等文档与 v1.0.1 的模型目录管理页和聚合渠道初始化亮点直接对应是使用AiHubMix、OpenRouter等聚合厂家时的首选入口。3.8 开发指南与维护策略上游同步策略人工选择性同步上游的流程与原则人工上游吸收清单每次吸收上游能力时的核对清单。维护策略的核心原则在发布说明中表述得非常清楚优先吸收核心能力、底层抽象和明确缺陷修复不强行追求与上游完全一致以稳定性、收益和可维护性为优先同时保留本项目的中文增强、Web 配置管理、MongoDB 配置体系和多市场本地化能力。这对理解 TradingAgents-CN 与上游 TradingAgents 项目的关系至关重要。开发侧文档集中在docs/development/如 代码结构说明、分支管理、开发工作流、新增数据源指南 等索引中的dev-setup.md、extending.md等条目在当前目录中未以同名文件存在以目录实际内容为准。3.9 版本发布与升级发布文档最完整的板块完整更新日志所有版本更新记录v1.0.1 发布说明本版本的详细说明v0.1.12 发布说明 与 v0.1.11 发布说明智能新闻分析、多 LLM 提供商集成的历史版本说明版本对比各版本功能对比升级指南版本升级操作指南。3.10 使用指南、API、示例与常见问题v1.0.1 使用手册配置管理、同步与排障的完整指南与本版本亮点一一对应A股分析指南、配置管理指南、Docker 部署指南、报告导出指南、DeepSeek 使用指南、新闻分析系统使用指南Web 界面指南 与 投资分析指南FAQ常见问题解答基础示例 与 高级示例。索引中API 参考板块列出的core-api.md、agents-api.md、data-api.md在当前docs/api/目录下未以同名文件存在该目录现存 批量分析限制说明接口级细节可结合app/routers/下的路由源码与 Web 界面配置文档 阅读。四、v1.0.1 关键变更的落地细节4.1 配置排序与模型管理按发布说明v1.0.1 实现了新增厂家/模型按最新添加顺序置顶的统一行为模型目录管理页、大模型配置页、大模型选择下拉列表、分析页模型选择列表四处顺序一致且后端接口/api/config/llm按最新配置优先返回。实现上依赖大模型配置表新增的created_at/updated_at时间字段兼容性方面历史数据即使没有时间字段也会按原始追加顺序倒序返回用户无需手动迁移即可享受新排序。4.2 单股同步与 AKShare 多级兜底/api/stock-sync/single接口的返回结果升级为明细结构明确展示主链路数据源、回退链路数据源、主错误原因、回退错误原因、是否已写入market_quotes集合前端同步提示也从简单成功提示升级为结果明细弹窗。AKShare 单股实时行情的降级链路按发布说明为四级stock_bid_ask_em盘口接口stock_zh_a_spot新浪快照stock_zh_a_spot_em东财快照stock_zh_a_hist历史日线最后一级兜底。主接口异常时系统自动尝试备份接口使运维人员可以更快判断失败原因是网络问题、限流问题还是落库问题。4.3 升级路径与注意事项从v1.0.0-preview升级到v1.0.1的推荐步骤来自发布说明备份当前.env、数据库和自定义配置拉取最新代码重启后端与前端服务打开配置管理检查厂家、模型显示顺序打开任意股票详情页执行一次同步数据验证同步提示和行情落库。已知注意事项AKShare 主接口被远端断开时会自动走备份接口但仍建议保留 Tushare 作为辅助数据源Tushare 账户存在频率限制时避免在 1 分钟内重复触发单股同步历史旧数据若本身缺失实时行情记录仍需至少成功执行一次同步才能写入market_quotes。五、文档健康度提示与推荐阅读路线5.1 索引链接的时效性从当前仓库目录结构看docs/README.md 中部分早期条目指向的文件已随版本演进迁移或改名例如数据源详解由china_stock-api-integration.md变为 tushare-integration.md、API 参考板块的三份文档未同名存在、docs/architecture/与docs/agents/已按版本子目录归档。使用本文给出的板块导航时建议以仓库目录实际文件为准各板块的现行文档位置已在第三节中逐一标注。5.2 推荐阅读路线新用户使用项目概述 → 快速开始 → 安装指南 → v1.0.1 使用手册 → Web 界面指南LLM 配置用户LLM 文档目录 → LLM 配置 → 厂商专项DeepSeek / 阿里百炼 / Google AI→ 模型目录管理运维与排障Token 追踪指南 → 缓存机制 → FAQ → v1.0.1 发布说明 的已知注意事项章节维护者与贡献者上游同步策略 → 人工上游吸收清单 → 代码结构 → 完整更新日志。六、小结docs/README.md 作为文档中心的总入口以 v1.0.1 为基线组织了概览、架构、智能体、数据、功能、配置、LLM、开发、发布、API、使用指南、示例与 FAQ 共十余个板块。结合 v1.0.1 发布说明 与仓库中的tradingagents/llm_clients/、app/配置服务、docs/maintenance/维护文档等实现证据可以看出v1.0.1 的改动围绕配置体验一致性、页面状态正确性、同步可观测性、上游能力可控吸收四条主线展开文档体系与各板块源码、脚本、测试形成了可互相印证的闭环。按本文给出的板块导航与阅读路线可以快速从任意使用场景跳转到位避免在庞大的docs/目录中迷失。【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考