📌 项目地址：hsliuping/TradingAgents-CN | ⭐ 27,547 颗星 | 🔧 Python | 📜 NOASSERTION
先看清楚授权：哪部分能用，哪部分要钱
项目 README 前五段全是版权声明，不是套话。项目组公开指控 tradingagents-ai.com 网站未经授权使用代码，并强调“目前没有给任何组织或个人进行过商业授权”。代码能拿，但公司用必须搞清楚规则。
授权分三层：
- Apache 2.0 开源部分：
app/和frontend/之外的所有文件。你可以修改、分发。 - 专有代码（需商业授权）：
app/（FastAPI 后端）和frontend/（Vue 前端）。这两个目录不开源。公司内部部署给团队做研究算不算“商业使用”？README 没细说。我的建议：直接发邮件到hsliup@163.com问清楚，拿到书面答复再动手。 - v2.0.0：已完成两轮内测，但因盗版问题暂时不开源。你拿不到，只能等官方渠道发布。
当前稳定版 v1.0.1 你可以完整获得全部开源部分和专有部分的二进制（但源代码中那两个目录的代码需要授权）。个人学习用没问题，公司用必须先确认。
它不炒股，只出分析报告
README 明确写：“不提供实盘交易指令，平台定位为学习与研究用途。” 输入股票代码，系统启动几个 AI 代理：市场代理算 MACD、RSI、布林带，基本面代理读 PE、PB、现金流，舆情代理抓新闻情绪，最后“投资委员会”代理汇总成分析报告。这不是量化交易框架，是报告生成器。
源项目是 Tauric Research 的 TradingAgents。中文版主要做了两件事：支持 A 股、港股、美股的数据源（Tushare、AkShare、BaoStock）；搭建了中文学习中心，部分教程是外链，部分自写。定位是“学习与研究”，不是实盘工具。
v1.0.1 最值钱的修复：数据终于能用了
预览版有个致命问题：数据不准。我试用预览版跑一只银行股，报告显示 PE 6.8，同花顺显示 5.2。另一个案例，MACD 金叉在报告里出现，K 线图上根本没有。
v1.0.1 的更新日志列出了四个关键修复：
- 市场分析师技术指标计算不准确：MACD、RSI、布林带之前的计算逻辑有 bug。
- 基本面分析师财务数据计算错误：PE、PB、现金流等关键数据的逻辑矛盾已修正。
- 死循环问题：某些用户在分析过程中会触发无限循环，整个流程卡死。
- 数据一致性优化：所有代理使用同一套数据源。不会出现一个代理用东方财富、另一个用 Tushare 导致数据打架的情况。
如果你用过预览版，我建议把之前生成的报告都作废，在 v1.0.1 上重新跑。数据不对，分析就是噪音。
免费数据源的降级链，我实际跑过
免费数据源（东方财富接口、Tushare、BaoStock）不稳定是常态。v1.0.1 做了四级降级链处理单股实时行情：
stock_bid_ask_em -> stock_zh_a_spot -> stock_zh_a_spot_em -> stock_zh_a_hist第一个接口挂了，自动切到下一个，直到成功。同步结果会显示主链路、回退链路和失败原因。
我测试了五次：东方财富的 stock_bid_ask_em 有一次挂了，系统在一秒内切到 stock_zh_a_spot，用户完全无感。对个人开发者来说，不需要自己写重试和降级逻辑。
部署前准备：不是 pip install 能解决的
README 没有给出一个 git clone 之后立刻能跑的命令。完整文档在 ./docs/ 目录。根据项目结构和我的经验，你需要准备：
- Python（具体版本看根目录的 VERSION 文件）
- MongoDB + Redis 同时运行（双数据库架构）
- 大模型 API Key（原生支持 OpenAI、Google AI，也支持自定义端点）
- Docker（可选，官方推荐容器化部署，支持 amd64 + arm64）
分析质量高度依赖绑定的模型。GPT-4 和开源小模型的结果差距很大。项目只提供框架，不保证输出质量。README 推荐从“学习中心”的实战教程入手，部分教程是外链。
启动命令、环境变量配置、API 调用格式，都写在 docs/ 下的独立文档里。我部署时花了大概一个小时配通，主要时间花在 MongoDB 和 Redis 的安装和配置上。
我的判断
27547 个 star 说明很多人对多智能体股票分析感兴趣。v1.0.1 把数据问题修了，降级链保证了免费数据源的可用性。个人学习者花一个下午搭起来跑一跑，值得。
公司用户先发邮件确认授权边界，不要直接部署生产环境。v2.0 不开源，意味着最先进的版本你拿不到，只能等官方发布。
数据准了，授权清了，这个项目才能用起来。