// 01 TradingAgents‑CN 是什么
一、项目概览：什么是TradingAgents‑CN？
TradingAgents‑CN是由 hsliuping 维护的开源项目，是 TradingAgents 的中文增强版本。该项目基于多智能体（Multi‑Agent）LLM 交易框架，整合了 A 股、港股市场数据，提供了中文文档、Web 界面、Docker 部署、报告导出等功能，帮助用户部署一套专业化智能交易系统。
核心特点：
借助多个专业角色智能体协作（分析、决策、风险控制）
完整中文交互界面，适应国内投资者习惯
完善的本地部署方式，适应中国市场环境
二、技术架构与智能体协作机制
2.1 模型角色分工
框架参考 TradingAgents 原理，将智能体分为：
基本面分析员：评估公司财务；
情绪分析员：分析情绪波动；
新闻分析员：分析宏观和政策事件；
技术分析员：图表和指标；
Bull/Bear 研究员：正反两派市场观点；
交易执行员与风控团队：评估并执行交易。
2.2 多智能体协同流程
交易决策流程为：各分析员调研 → 研究员辩论 → 交易员制定方案 → 风控审核 → 投资执行。这种角色协作方式模仿真实投研流程，更具可解释性与稳健性。
2.3 本地部署与 Web 界面
TradingAgents‑CN 提供：
Docker + Docker Compose 一键部署；
Web UI 支持中文操作和部署进度提示；
CLI 工具提供日志分离和阶段时间估计。
三、版本功能与更新动态
3.1 最新版本特性（v0.1.9）
CLI 重构：进度提示与日志清晰区分
支持 A 股、港股成熟接入策略和容错机制
启用 DeepSeek V3 节点优化本地模型调用
报告导出支持 Word/PDF/Markdown 格式
3.2 v0.1.8 特性补充
Web 界面优化、布局更新、A 股示例丰富
数据路由结构优化，解决港股/美股数据识别Bug
3.3 v0.1.7 特性补充
容器化部署方案上线
引入统一日志配置、模型路由与系统稳定性提升
项目持续活跃，社区 Bug 报告与功能需求频繁更新。
四、使用流程：从安装到实战
4.1 安装部署
使用容器方式部署即可快速启动 Web 界面。
4.2 数据接入
支持 Tushare, AkShare, Wind 等国内主流金融数据源，自动检测并切换最佳工具。
用户仅需配置 .env 文件中的 API KEY，即可开始分析。
4.3 运行分析流程
启动主服务：
main.py在 Web UI 中选择目标市场 / 股票池
系统阶段性输出步骤与时间估算
分析完毕后导出诊断报告
4.4 查看与导出报告
报告支持导出为 Word、PDF、Markdown 格式，便于研究与归档。
五、应用场景与用户价值
5.1 智能投研工具
支持个人投资者或量化团队形成模拟投研流程，进行多角度分析和长期策略回测。
5.2 教育科研辅助
可用于高校金融定量课程，让学生通过代码实现投研流程，加深模型理解。
5.3 AI 智能代理实验平台
提供多智能体协作框架，可用于探索 LLM 在金融、决策系统中的应用潜力。
5.4 本地安全部署
在国内网络环境中运行，无需担心 API 调用限制及安全合规问题。
