TradingAgents-CN

# TradingAgents 中文增强版 --- ## ⚠️ 重要版权声明与授权说明 ### 🚨 版权侵权警告 **我们注意到 `tradingagents-ai.com` 网站未经授权使用了我们的专有代码，并声称是他们公司的产品。** **⚠️ 重要提醒**： - ❌ **我们项目组目前没有给任何组织或个人进行过商业授权** - ❌ **该网站未经授权使用我们的代码，属于侵权行为** - ⚠️ **请大家注意识别，避免上当受骗** **✅ 官方唯一渠道**： - 📦 GitHub 仓库：https://github.com/hsliuping/TradingAgents-CN - 📧 官方邮箱：[email protected] - 📱 微信公众号：TradingAgents-CN 如发现任何未经授权的商业使用，请通过上述渠道联系我们。 ### 📋 版本授权说明 #### v1.1.0（已开源） - ✅ **个人使用**：完全开源，可自由使用 - ❌ **商业使用**：**必须获得商业授权**，未经授权禁止商业使用 - 📧 **授权联系**：[[email protected]](mailto:[email protected]) #### v2.0（即将开源） - 🔄 **开发状态**：已开发完成，稳定运行中 - 🔓 **开源计划**：**v2.0 将完整开源**（Apache 2.0 + 商业使用限制条款） - 📢 **开源时间**：v3.0 正式发布后，v2.0 开源 - ⚠️ **商业使用**：开源后商业使用仍需获得授权 #### v3.0（即将发布） - 🎉 **开发状态**：开发完成，内测启动中 - ✨ **新功能**：AI 工作流设计器、复盘研究、持仓研究、Skill 系统、智能助手等 - 🚀 **版本定位**：最新版本，包含全部专业功能 - 📧 **内测申请**：[[email protected]](mailto:[email protected]) ### 📄 许可证详情 本项目采用**混合许可证**模式： - 🔓 **开源部分**（Apache 2.0）：除 `app/` 和 `frontend/` 外的所有文件 - 🔒 **专有部分**（需商业授权）：`app/`（FastAPI后端）和 `frontend/`（Vue前端）目录 详细说明请查看：[版权声明](./COPYRIGHT.md) | [许可证文件](./LICENSE) ### 🤝 贡献者招募 我们正在寻找核心贡献者！贡献代码可获得 Pro 版授权和收入分成： - 合并 1 个 PR → Pro 版 3 个月授权 - 合并 3 个 PR → Pro 版 1 年授权 - 核心贡献者 → 永久授权 + 收入分成 详见：[贡献指南](./docs/development/CONTRIBUTING.md) ### ⚖️ 免责声明 > **本工具仅提供数据分析，不构成任何投资建议。** > 投资有风险，决策需谨慎。分析结果由 AI 生成，仅供参考，用户需自行判断并承担投资风险。 > 本平台不提供实盘交易指令，定位为学习与研究用途。 ### 🗺️ 项目路线图 我们坚持**逐步开源**策略，旧版本会在新版本稳定后逐步开源： | 版本 | 状态 | 说明 | |------|------|------| | v1.0 | ✅ 已开源 | 基础功能，吸引社区参与 | | v2.0 | 🔓 即将开源 | 完整功能，建立用户习惯 | | v3.0 | 🚀 即将发布 | 最新版本，专业功能 | **开源承诺**：旧版本会逐步免费开源，使用最新版本的用户始终能获得最新的功能和优先支持。 **长期方向**： - 持续完善 AI 多智能体分析能力 - 探索策略回测、知识图谱等专业方向 - 建设开源社区，欢迎贡献者参与 --- > > 🎓 **学习中心**: AI基础 | 提示词工程 | 模型选择 | 多智能体分析原理 | 风险与局限 | 源项目与论文 | 实战教程（部分为外链） | 常见问题 > 🎯 **核心功能**: 原生OpenAI支持 | Google AI全面集成 | 自定义端点配置 | 智能模型选择 | 多LLM提供商支持 | 模型选择持久化 | Docker容器化部署 | 专业报告导出 | 完整A股支持 | 中文本地化 面向中文用户的**多智能体与大模型股票分析学习平台**。帮助你系统化学习如何使用多智能体交易框架与 AI 大模型进行合规的股票研究与策略实验，不提供实盘交易指令，平台定位为学习与研究用途。 ## 🙏 致敬源项目 感谢 [Tauric Research](https://github.com/TauricResearch) 团队创造的革命性多智能体交易框架 [TradingAgents](https://github.com/TauricResearch/TradingAgents)！ **🎯 我们的定位与使命**: 专注学习与研究，提供中文化学习中心与工具，合规友好，支持 A股/港股/美股 的分析与教学，推动 AI 金融技术在中文社区的普及与正确使用。 ## 🎉 v1.1.0 版本说明 - 火山方舟集成与开发体验增强 > 🚀 **当前推荐版本**: `v1.1.0` 已正式可用，在 v1.0.1 基础上，重点集成火山方舟模型服务、增强推理模型支持、统一开发启动脚本，并完善项目文档体系。 ### ✨ 核心特性 #### 🏗️ **全新技术架构** - **后端升级**: 从 Streamlit 迁移到 FastAPI，提供更强大的 RESTful API - **前端重构**: 采用 Vue 3 + Element Plus，打造现代化的单页应用 - **数据库优化**: MongoDB + Redis 双数据库架构，性能提升 10 倍 - **容器化部署**: 完整的 Docker 多架构支持（amd64 + arm64） #### 🚀 **v1.1.0 重点增强** - **火山方舟集成**: 新增火山方舟（VolcEngine Ark）Provider，支持编程版模型硬编码配置与密码兼容 - **推理模型优化**: `reasoning_effort` 全链路传递，推理模型超时保护优化 - **数据模型扩展**: 添加 `reasoning_effort` / `test_model` 字段，支持火山方舟模型过滤 - **统一启动脚本**: 新增 `start_dev.ps1`，支持 v1.0/v2.0/v2.1/v3.0 多版本开发环境一键启动 - **连接修复**: MongoDB 连接字符串自动构建，Tushare 写 tk.csv 权限错误修复 - **文档体系完善**: 更新版权声明与授权说明、贡献者指南（贡献换授权机制）、项目发展战略规划 #### 🎯 **企业级功能** - **用户权限管理**: 完整的用户认证、角色管理、操作日志系统 - **配置管理中心**: 可视化的大模型配置、数据源管理、系统设置 - **缓存管理系统**: 智能缓存策略，支持 MongoDB/Redis/文件多级缓存 - **实时通知系统**: SSE+WebSocket 双通道推送，实时跟踪分析进度和系统状态 - **批量分析功能**: 支持多只股票同时分析，提升工作效率 - **智能股票筛选**: 基于多维度指标的股票筛选和排序系统 - **自选股管理**: 个人自选股收藏、分组管理和跟踪功能 - **个股详情页**: 完整的个股信息展示和历史分析记录 - **模拟交易系统**: 虚拟交易环境，验证投资策略效果 #### 🤖 **智能分析增强** - **动态供应商管理**: 支持动态添加和配置 LLM 供应商 - **模型能力管理**: 智能模型选择，根据任务自动匹配最佳模型 - **多数据源同步**: 统一的数据源管理，支持 Tushare、AkShare、BaoStock - **报告导出功能**: 支持 Markdown/Word/PDF 多格式专业报告导出 #### 🔧 **重大Bug修复** - **技术指标计算修复**: 彻底解决市场分析师技术指标计算不准确问题 - **基本面数据修复**: 修复基本面分析师PE、PB等关键财务数据计算错误 - **死循环问题修复**: 解决部分用户在分析过程中触发的无限循环问题 - **数据一致性优化**: 确保所有分析师使用统一、准确的数据源 #### 🐳 **Docker 多架构支持** - **跨平台部署**: 支持 x86_64 和 ARM64 架构（Apple Silicon、树莓派、AWS Graviton） - **GitHub Actions**: 自动化构建和发布 Docker 镜像 - **一键部署**: 完整的 Docker Compose 配置，5 分钟快速启动 ### 📊 技术栈升级 | 组件 | v0.1.x | v1.1.0 | |------|--------|----------------| | **后端框架** | Streamlit | FastAPI + Uvicorn | | **前端框架** | Streamlit | Vue 3 + Vite + Element Plus | | **数据库** | 可选 MongoDB | MongoDB + Redis | | **API 架构** | 单体应用 | RESTful API + WebSocket | | **部署方式** | 本地/Docker | Docker 多架构 + GitHub Actions | #### 📥 安装部署 **两种部署方式，任选其一**： | 部署方式 | 适用场景 | 难度 | 文档链接 | |---------|---------|------|---------| | 🐳 **Docker版** | 生产环境、跨平台 | ⭐⭐ 中等 | [Docker 部署指南](https://mp.weixin.qq.com/s/JkA0cOu8xJnoY_3LC5oXNw) | | 💻 **本地代码版** | 开发者、定制需求 | ⭐⭐⭐ 较难 | [本地安装指南](https://mp.weixin.qq.com/s/cqUGf-sAzcBV19gdI4sYfA) | ⚠️ **重要提醒**：在分析股票之前，请按相关文档要求，将股票数据同步完成，否则分析结果将会出现数据错误。 #### 📚 使用指南 在使用前，建议先阅读详细的使用指南： - **[v1.1.0 发布说明](./docs/releases/v1.1.0-release-notes.md)** - **[v1.1.0 使用手册](./docs/guides/v1.1.0-user-manual.md)** - **[v1.1.0 升级指南](./docs/releases/upgrade-guide.md)** - **[完整更新日志](./docs/releases/CHANGELOG.md)** - **[0、📘 TradingAgents-CN v1.0.0-preview 快速入门视频](https://www.bilibili.com/video/BV1i2CeBwEP7/?vd_source=5d790a5b8d2f46d2c10fd4e770be1594)** - **[1、📘 TradingAgents-CN v1.0.0-preview 使用指南](https://mp.weixin.qq.com/s/ppsYiBncynxlsfKFG8uEbw)** - **[2、📘 使用 Docker Compose 部署TradingAgents-CN v1.0.0-preview（完全版）](https://mp.weixin.qq.com/s/JkA0cOu8xJnoY_3LC5oXNw)** - **[3、📘 从 Docker Hub 更新 TradingAgents‑CN 镜像](https://mp.weixin.qq.com/s/WKYhW8J80Watpg8K6E_dSQ)** - **[4、📘 TradingAgents-CN v1.0.0-preview绿色版安装和升级指南](https://mp.weixin.qq.com/s/eoo_HeIGxaQZVT76LBbRJQ)** - **[5、📘 TradingAgents-CN v1.0.0-preview绿色版端口配置说明](https://mp.weixin.qq.com/s/o5QdNuh2-iKkIHzJXCj7vQ)** - **[6、📘 TradingAgents v1.0.0-preview 源码版安装手册（修订版）](https://mp.weixin.qq.com/s/cqUGf-sAzcBV19gdI4sYfA)** - **[7、📘 TradingAgents v1.0.0-preview 源码安装视频教程](https://www.bilibili.com/video/BV1FxCtBHEte/?vd_source=5d790a5b8d2f46d2c10fd4e770be1594)** 使用指南包含： - ✅ 完整的功能介绍和操作演示 - ✅ 详细的配置说明和最佳实践 - ✅ 常见问题解答和故障排除 - ✅ 实际使用案例和效果展示 ### 数据库运维补充 - 数据库版本隔离、共享库保护、迁移脚本与 provider 规范化说明： - [数据库版本隔离与 Provider 规范化](./docs/deployment/database/DB_VERSION_ISOLATION_AND_PROVIDER_NORMALIZATION.md) ### 上游吸收补充 - 当前项目采用人工选择性吸收上游更新： - [上游同步策略](./docs/maintenance/upstream-sync.md) - [人工上游吸收清单](./docs/maintenance/manual-upstream-absorption-checklist.md) - `v1.1.0` 已明确同步到当前版本的上游能力包括： - `llm_clients` 抽象层主链路 - 共享模型目录与轻量校验 - provider canonical key 规范化 - `trading_graph.py` 主要 provider 初始化路径收口 - `fundamentals_analyst.py` 中 qwen fresh llm 重建逻辑 - 图层参数透传、工厂别名兼容、风控引用修复 - provider 默认 URL / 环境变量映射统一 - MongoDB 默认库名、版本隔离命名与迁移脚本增强 #### 关注公众号 1. **关注公众号**: 微信搜索 **"TradingAgents-CN"** 并关注 2. 公众号每天推送项目最新进展和使用教程 - **微信公众号**: TradingAgents-CN（推荐） ## 🆚 中文增强特色 **相比原版新增**: 智能新闻分析 | 多层次新闻过滤 | 新闻质量评估 | 统一新闻工具 | 多LLM提供商集成 | 模型选择持久化 | 快速切换按钮 | | 实时进度显示 | 智能会话管理 | 中文界面 | A股数据 | 国产LLM | Docker部署 | 专业报告导出 | 统一日志管理 | Web配置界面 | 成本优化 ## 🤝 贡献指南 我们欢迎各种形式的贡献： ### 贡献类型 - 🐛 **Bug修复** - 发现并修复问题 - ✨ **新功能** - 添加新的功能特性 - 📚 **文档改进** - 完善文档和教程 - 🌐 **本地化** - 翻译和本地化工作 - 🎨 **代码优化** - 性能优化和代码重构 ### 贡献流程 1. Fork 本仓库 2. 创建特性分支 (`git checkout -b feature/AmazingFeature`) 3. 提交更改 (`git commit -m 'Add some AmazingFeature'`) 4. 推送到分支 (`git push origin feature/AmazingFeature`) 5. 创建 Pull Request ### 📋 查看贡献者 查看所有贡献者和详细贡献内容：**[🤝 贡献者名单](CONTRIBUTORS.md)** ## 📄 许可证详情 本项目采用**混合许可证**模式，详见 [LICENSE](LICENSE) 文件： ### 🔓 开源部分（Apache 2.0） - **适用范围**：除 `app/` 和 `frontend/` 外的所有文件 - **权限**：商业使用 ✅ | 修改分发 ✅ | 私人使用 ✅ | 专利使用 ✅ - **条件**：保留版权声明 ❗ | 包含许可证副本 ❗ ### 🔒 专有部分（需商业授权） - **适用范围**：`app/`（FastAPI后端）和 `frontend/`（Vue前端）目录 - **商业使用**：需要单独许可协议 - **联系授权**：[[email protected]](mailto:[email protected]) ### 📋 许可证选择建议 - **个人学习/研究**：可自由使用全部功能 - **商业应用**：请联系获取专有组件授权 - **定制开发**：欢迎咨询商业合作方案 ### 📚 相关文档 - [版权声明](./COPYRIGHT.md) - 详细的版权信息和使用条款 - [主许可证](./LICENSE) - Apache 2.0 许可证 - [后端专有许可证](./app/LICENSE) - 后端专有组件许可证 - [前端专有许可证](./frontend/LICENSE) - 前端专有组件许可证 ## 🙏 致谢与感恩 ### 🌟 向源项目开发者致敬 我们向 [Tauric Research](https://github.com/TauricResearch) 团队表达最深的敬意和感谢： - **🎯 愿景领导者**: 感谢您们在AI金融领域的前瞻性思考和创新实践 - **💎 珍贵源码**: 感谢您们开源的每一行代码，它们凝聚着无数的智慧和心血 - **🏗️ 架构大师**: 感谢您们设计了如此优雅、可扩展的多智能体框架 - **💡 技术先驱**: 感谢您们将前沿AI技术与金融实务完美结合 - **🔄 持续贡献**: 感谢您们持续的维护、更新和改进工作 ### 🤝 社区贡献者致谢 感谢所有为TradingAgents-CN项目做出贡献的开发者和用户！ 详细的贡献者名单和贡献内容请查看：**[📋 贡献者名单](CONTRIBUTORS.md)** 包括但不限于： - 🐳 **Docker容器化** - 部署方案优化 - 📄 **报告导出功能** - 多格式输出支持 - 🐛 **Bug修复** - 系统稳定性提升 - 🔧 **代码优化** - 用户体验改进 - 📝 **文档完善** - 使用指南和教程 - 🌍 **社区建设** - 问题反馈和推广 - **🌍 开源贡献**: 感谢您们选择Apache 2.0协议，给予开发者最大的自由 - **📚 知识分享**: 感谢您们提供的详细文档和最佳实践指导 **特别感谢**：[TradingAgents](https://github.com/TauricResearch/TradingAgents) 项目为我们提供了坚实的技术基础。虽然Apache 2.0协议赋予了我们使用源码的权利，但我们深知每一行代码的珍贵价值，将永远铭记并感谢您们的无私贡献。 ### 🇨🇳 推广使命的初心 创建这个中文增强版本，我们怀着以下初心： - **🌉 技术传播**: 让优秀的TradingAgents技术在中国得到更广泛的应用 - **🎓 教育普及**: 为中国的AI金融教育提供更好的工具和资源 - **🤝 文化桥梁**: 在中西方技术社区之间搭建交流合作的桥梁 - **🚀 创新推动**: 推动中国金融科技领域的AI技术创新和应用 ### 🌍 开源社区 感谢所有为本项目贡献代码、文档、建议和反馈的开发者和用户。正是因为有了大家的支持，我们才能更好地服务中文用户社区。 ### 🤝 合作共赢 我们承诺： - **尊重原创**: 始终尊重源项目的知识产权和开源协议 - **反馈贡献**: 将有价值的改进和创新反馈给源项目和开源社区 - **持续改进**: 不断完善中文增强版本，提供更好的用户体验 - **开放合作**: 欢迎与源项目团队和全球开发者进行技术交流与合作 ## 🙏 感谢赞助 感谢字节火山引擎赞助本项目！
【专属活动优惠】19元Tokens包！享字节自研豆包模型+满血版开源 SOTA模型，覆盖文本、VLM、图像生成，全模态一站配齐：Seed-2.1、Seedream-5.0、GLM-5.2、DeepSeek、Qwen等。不止编程、更能解决 Agent 复杂长程任务 → 注册即领2500万Tokens，立即前往
👉 点击链接抢购 ## 📈 版本历史 - **v1.1.0** (2026-07-24): 🚀 火山方舟集成、reasoning_effort 推理优化、统一启动脚本、文档体系完善 ✨ **当前版本** - **v1.0.1** (2026-04-14): 🔧 配置管理优化、AiHubMix 聚合厂家、单股同步增强与上游能力吸收 - **v1.0.0-preview** (2025-10-10): 🏗️ FastAPI + Vue 3 新架构预览版 - **v0.1.13** (2025-08-02): 🤖 原生OpenAI支持与Google AI生态系统全面集成 - **v0.1.12** (2025-07-29): 🧠 智能新闻分析模块与项目结构优化 - **v0.1.11** (2025-07-27): 🤖 多LLM提供商集成与模型选择持久化 - **v0.1.10** (2025-07-18): 🚀 Web界面实时进度显示与智能会话管理 - **v0.1.9** (2025-07-16): 🎯 CLI用户体验重大优化与统一日志管理 - **v0.1.8** (2025-07-15): 🎨 Web界面全面优化与用户体验提升 - **v0.1.7** (2025-07-13): 🐳 容器化部署与专业报告导出 - **v0.1.6** (2025-07-11): 🔧 阿里百炼修复与数据源升级 - **v0.1.5** (2025-07-08): 📊 添加Deepseek模型支持 - **v0.1.4** (2025-07-05): 🏗️ 架构优化与配置管理重构 - **v0.1.3** (2025-06-28): 🇨🇳 A股市场完整支持 - **v0.1.2** (2025-06-15): 🌐 Web界面和配置管理 - **v0.1.1** (2025-06-01): 🧠 国产LLM集成 📋 **详细更新日志**: [CHANGELOG.md](./docs/releases/CHANGELOG.md) ## 📞 联系方式 - **GitHub Issues**: [提交问题和建议](https://github.com/hsliuping/TradingAgents-CN/issues) - **邮箱**: [email protected] - 项目ＱＱ群：1091917201 - 项目微信公众号：TradingAgents-CN - **原项目**: [TauricResearch/TradingAgents](https://github.com/TauricResearch/TradingAgents) - **文档**: [完整文档目录](docs/) ## ⚠️ 风险提示 **重要声明**: 本框架仅用于研究和教育目的，不构成投资建议。 - 📊 交易表现可能因多种因素而异 - 🤖 AI模型的预测存在不确定性 - 💰 投资有风险，决策需谨慎 - 👨‍💼 建议咨询专业财务顾问 ---