TradingAgents/CLAUDE.md

3.3 KiB
Raw Blame History

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

语言规则

  • 用中文回答用户的问题

项目概述

TradingAgents 是一个基于 LangGraph 的多智能体 LLM 金融交易框架,模拟真实交易公司的运作模式。通过部署专业化的 LLM 智能体(基本面分析师、情绪分析师、技术分析师、交易员、风险管理团队)协作评估市场状况并做出交易决策。

常用命令

# 激活环境
source env312/bin/activate

# SEPA筛选 + TradingAgents 完整流程
python sepa_v5.py

# 单股分析
python run_ningde.py   # 宁德时代 (300750.SZ)
python run_312.py      # 贵州茅台

# CLI 交互模式
python -m cli.main

核心架构

工作流程

SEPA筛选 (定量) → 分析师团队 → 研究员辩论 → 交易员 → 风险管理辩论 → 组合经理

关键组件 (tradingagents/)

目录 职责
agents/ LLM智能体实现 (分析师、研究员、交易员、风控)
dataflows/ 数据源集成 (yfinance, alpha_vantage, china_data)
graph/ LangGraph 工作流编排
llm_clients/ 多Provider LLM支持 (OpenAI, Anthropic, Google)

数据流向

数据源 → dataflows/interface.py (路由) → 各智能体工具调用

A股特定配置

  • 数据源: yfinance (akshare财务API已损坏)
  • 股票代码格式: 300750.SZ (深圳), 603259.SS (上海), 688256.SS (科创板)
  • API: MiniMax (Anthropic兼容), Base URL: https://api.minimaxi.com/anthropic

关键文件

文件 用途
tradingagents/graph/trading_graph.py 主协调器 TradingAgentsGraph
tradingagents/graph/setup.py LangGraph 节点/边配置
dataflows/interface.py 数据供应商路由
sepa_v5.py SEPA筛选流程
default_config.py 默认配置

配置

默认配置在 tradingagents/default_config.py,运行时可覆盖:

  • llm_provider: LLM提供商
  • deep_think_llm / quick_think_llm: 模型选择
  • data_vendors: 数据源路由
  • max_debate_rounds: 辩论轮数

设计上下文 (Web Dashboard)

核心功能

  • 股票筛选面板: 输入股票代码运行SEPA筛选展示筛选结果表格
  • 分析监控台: 实时显示TradingAgents多智能体分析进度分析师→研究员→交易员→风控
  • 历史报告查看: 展示历史分析报告,支持搜索、筛选、导出
  • 批量管理: 批量提交股票分析任务,查看队列状态

界面风格

  • 风格: 数据可视化优先 - 图表驱动,实时更新
  • 参考: Grafana监控面板、彭博终端、币安交易界面
  • 主题: 深色主题为主,大量使用图表展示数据

设计原则

  1. 实时性优先 - 所有状态变化即时反映,图表数据自动刷新
  2. 数据可视化 - 数字指标用图表展示,不用纯文本堆砌
  3. 清晰的状态层级 - 当前任务 > 队列任务 > 历史记录
  4. 批量效率 - 支持多任务同时提交、统一管理
  5. 专业金融感 - 深色主题、K线/折线图、数据表格

设计系统

Always read DESIGN.md before making any visual or UI decisions. All font choices, colors, spacing, and aesthetic direction are defined there. Do not deviate without explicit user approval.