TradingAgents-CN：多智能体股票分析新手指南-平芜编程栈

TradingAgents-CN：多智能体股票分析新手指南

【免费下载链接】TradingAgents-CN基于多智能体LLM的中文金融交易框架 - TradingAgents中文增强版项目地址: https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN

TradingAgents-CN 是一个多智能体股票分析平台：输入股票代码，分析师、研究员、交易员、风控等多个 AI 智能体分工、辩论并评审，最后交付一份经过风控把关的分析报告。适合想入门 AI 股票研究、又不想从零写代码的新手和量化爱好者。

项目定位

一句话定义：它用多个大模型智能体（Agent，指会独立干活、互相配合的 AI 角色）复刻真实投研团队的分工，对 A 股、港股、美股标的做全流程股票分析。面向没写过代码、也想用 AI 做研究的人。

🤖 覆盖 A 股、港股、美股行情与历史数据，数据源多层降级，单源失效自动切换
📊 大模型可选 OpenAI、DeepSeek、通义千问等，配置全在 Web 页面完成
📤 报告可导出 Markdown、Word、PDF，界面与文档都是中文
🐳 Docker 一键部署、免安装绿色版都有，不写代码也能跑起来

部署方式速览

方式	适用人群	上手难度
Docker 一键部署（推荐）	装过 Docker、想尽快跑起来的人	★
本地源码安装	想二次开发、加数据源、调流程的开发者	★★★
绿色版	没有 Python、Docker 环境的 Windows 用户	★

推荐走 Docker，两条命令：

git clone https://gitcode.com/GitHub_Trending/tr/TradingAgents-CN cd TradingAgents-CN && docker-compose up -d

看到什么算成功：浏览器打开 http://localhost:3000 出现 Web 管理页，http://localhost:8000 的 API 能正常响应；页面里已备好模型、数据源与分析设置的入口。

其余两条路径：

本地源码：建虚拟环境装好依赖，再按 docs/QUICK_START.md 依次启动后端、前端与 worker。成功信号：出现和 Docker 版一样的 Web 页面，logs 目录里能看到每个智能体的执行日志（需自备 Python 3.10+、MongoDB、Redis）。
绿色版：把压缩包解压到不含中文的目录，双击启动程序。成功信号：浏览器自动打开本地 Web 页面，直接进分析配置页。

工作原理

一条完整链路：系统先拉取行情、社媒、新闻、基本面四类数据，分析师给出初判，研究员分看涨、看跌两派辩论，交易员把结论转成交易提案，风控按三种偏好评审，最后经理整合所有信息给出最终决策。

环节	角色	产出
数据输入	行情 / 社媒 / 新闻 / 基本面数据源	各分析师的结构化输入
多维分析	市场、新闻、基本面等分析师	技术指标、消息情绪、财务三份报告
多空辩论	看涨、看跌两名研究员	双方论点与辩论记录
交易提案	交易员	买入 / 卖出指令
风控评审	激进 / 中性 / 保守三档风控	不同风险偏好下的评审意见
最终决策	经理	整合后的最终决策

左边是四类数据源，中间是看涨/看跌辩论与交易员，右边是风控团队和经理产出最终决策。

跟着做一次

以 Web 界面为例，一次分析分四步走完：

输入标的与配置：选市场、填股票代码和分析日期，再勾选要参与的分析师团队与研究深度。
多维分析：市场、新闻、基本面三位分析师各交一份报告，分别讲技术指标、消息面情绪、财务数据。
多空辩论：两名研究员各领看涨、看跌立场多轮交锋，页面并排展示双方依据与辩论过程。
决策与风控：交易员把辩论结果落成买入或卖出提案，风控按激进、中性、保守三档给出评审意见。

配置要点

类型	常用数据源	用途
实时 / 历史行情	Tushare、AkShare、BaoStock	价格、成交量、技术指标
基本面	财报与估值指标	PE、PB 等财务分析
新闻与情绪	Finnhub 等新闻源、社交媒体	新闻过滤与情绪分析

三条配置建议：

先给一个大模型配好 API 密钥，DeepSeek、通义千问、OpenAI 三选一；这是跑起分析的前置条件。
发起分析前先完成股票数据同步，否则结论会建立在残缺数据上。
先用免费数据源把全流程跑通，再按需加付费源；源优先级与缓存时长按使用频率调整。

问题速查

问题	现象	原因	修复
端口冲突	启动报端口已被占用，页面打不开	本机 3000 或 8000 被别的程序占了	`netstat -tuln \\| grep 3000`找到进程并结束，或把 docker-compose.yml 映射改成 3001:3000 后重启，页面即可打开
数据库连接失败	后端启动报错、页面加载失败	MongoDB / Redis 容器没就绪，或连接串对不上	用`docker-compose ps`确认容器都运行，再核对 .env 里的连接串
依赖安装慢	pip 下载极慢或超时	默认走海外源，访问不稳定	换清华源安装：`pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple`
分析数据缺失	报告里行情或财务数据是空的	该股历史数据还没同步进本地库	先跑数据同步功能，同步完成后再发起分析

进阶方向

想接私有或第三方数据源，先看 examples/crawlers/ 里的抓取示例。想改分析提示词或智能体行为，入口在 tradingagents/agents/，分析师、研究员、交易员、风控四个角色各在自己的子目录里。完整教程与测试股票示例见 docs/QUICK_START.md，生产部署细节翻 docs/deployment/ 下的文档。