From 2a4dbc5e119f99cb61ad828dc06bd859f2e0d1bb Mon Sep 17 00:00:00 2001 From: dw1161 Date: Sat, 21 Mar 2026 16:38:33 +0800 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=96=20public=20=E5=88=86=E6=94=AF?= =?UTF-8?q?=EF=BC=9AREADME=5FCN=20=E5=8E=BB=E9=99=A4=E7=A7=81=E6=9C=89?= =?UTF-8?q?=E4=BF=A1=E6=81=AF=EF=BC=8C=E9=80=9A=E7=94=A8=E5=8C=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README_CN.md | 156 ++++++++++++++++++++++++++++++--------------------- 1 file changed, 92 insertions(+), 64 deletions(-) diff --git a/README_CN.md b/README_CN.md index 78f64e4c..076a8153 100644 --- a/README_CN.md +++ b/README_CN.md @@ -1,10 +1,11 @@ -# TradingAgents 中文使用指南 +# TradingAgents 中文版 -> 基于 [TauricResearch/TradingAgents](https://github.com/TauricResearch/TradingAgents) 定制，添加中文输出支持。 - -## 项目简介 - -TradingAgents 是一个多 Agent LLM 交易分析框架，模拟真实交易公司的工作流程：多个专业 AI Agent 协同分析、辩论，最终给出交易建议。 +> 基于 [TauricResearch/TradingAgents](https://github.com/TauricResearch/TradingAgents) 定制，新增： +> - 🇨🇳 全部 Agent 输出改为简体中文 +> - 💬 支持注入自定义分析视角 +> - 🔄 Gemini API 自动重试（SSL 断连容错） +> - 📝 中文分析入口脚本 `run_analysis.py` +> - 🖥️ TUI 界面新增用户视角输入步骤 **⚠️ 声明：本项目仅供研究和学习使用，不构成任何投资建议。** @@ -36,51 +37,82 @@ TradingAgents 是一个多 Agent LLM 交易分析框架，模拟真实交易公 ## 快速开始 -### 1. 环境准备 +### 1. 克隆并安装 ```bash -cd ~/.openclaw/workspace/TradingAgents -source .venv/bin/activate +git clone https://github.com/dw1161/TradingAgents.git +cd TradingAgents + +# 创建虚拟环境（推荐 Python 3.11-3.13） +python3 -m venv .venv +source .venv/bin/activate # Windows: .venv\Scripts\activate + +# 安装依赖 +pip install -r requirements.txt ``` -### 2. 运行分析（命令行脚本） +### 2. 配置 API Key + +创建 `.env` 文件（已被 gitignore，不会上传）： ```bash -# 分析 NVDA（今日日期） -GOOGLE_API_KEY=你的Key python run_analysis.py NVDA - -# 分析 VOO -GOOGLE_API_KEY=你的Key python run_analysis.py VOO - -# 指定日期 -GOOGLE_API_KEY=你的Key python run_analysis.py NVDA 2026-03-20 +# 三选一，用哪个填哪个 +GOOGLE_API_KEY=你的Gemini_Key +ANTHROPIC_API_KEY=你的Claude_Key +OPENAI_API_KEY=你的OpenAI_Key ``` -结果自动保存到 `results/NVDA_日期.txt`，包含完整的多 Agent 分析报告。 +### 3. 运行分析 -### 3. 运行交互式 TUI 界面（推荐） +**TUI 交互界面（推荐，有实时进度展示）：** +```bash +python -m cli.main +``` + +**命令行脚本：** +```bash +# 基础用法 +python run_analysis.py NVDA 2026-03-20 + +# 注入自定义分析视角（核心功能） +python run_analysis.py NVDA 2026-03-20 "中东地缘冲突升级是当前美股主要风险，请重点评估" + +# 交互式输入视角 +python run_analysis.py NVDA +``` + +结果保存至 `results/NVDA_日期.txt`。 + +--- + +## 自定义分析视角（新功能） + +支持在分析开始前注入你的判断框架，**所有 Agent 都会优先考虑此视角**： ```bash -GOOGLE_API_KEY=你的Key python -m cli.main +# 地缘政治视角 +python run_analysis.py NVDA 2026-03-20 "中东伊朗局势升级正在推高油价并压制科技股估值" + +# 宏观政策视角 +python run_analysis.py NVDA 2026-03-20 "美联储降息预期升温，流动性改善利好成长股" + +# 产业趋势视角 +python run_analysis.py NVDA 2026-03-20 "AI算力需求超预期，数据中心扩张带来订单增量" ``` -会启动漂亮的终端界面，可以选择： -- 分析标的（任意股票代码） -- 使用哪些分析师 -- 使用哪个 LLM 模型 +TUI 界面（`cli.main`）在 Step 8 也支持输入视角。 --- ## 配置说明 -修改 `run_analysis.py` 顶部的 `config` 可调整行为： +修改 `run_analysis.py` 顶部调整行为： ```python -config["llm_provider"] = "google" # 模型提供商：google / anthropic / openai -config["deep_think_llm"] = "gemini-2.5-flash" # 深度推理用（研究员辩论/风控） -config["quick_think_llm"] = "gemini-2.5-flash" # 快速任务用（情绪/新闻分析） -config["max_debate_rounds"] = 1 # 多空辩论轮数（越多越慢越贵） -config["max_risk_discuss_rounds"] = 1 # 风控讨论轮数 +config["llm_provider"] = "google" # google / anthropic / openai +config["deep_think_llm"] = "gemini-2.5-flash" # 深度推理（研究员辩论/风控） +config["quick_think_llm"] = "gemini-2.5-flash" # 快速任务（情绪/新闻分析） +config["max_debate_rounds"] = 1 # 辩论轮数（越多越慢越贵） ``` ### 支持的模型提供商 @@ -93,50 +125,46 @@ config["max_risk_discuss_rounds"] = 1 # 风控讨论轮数 --- +## 日期参数说明 + +传入日期为**截止日期**，Agent 用该日期及之前的数据分析： +- 推荐传**昨天或前天**（今天数据不完整） +- 可传历史日期做回测验证 + +--- + ## 支持的标的 -| 标的 | 类型 | 支持情况 | -|------|------|---------| -| NVDA | 美股个股 | ✅ 完整支持（4 个分析师全部可用） | -| VOO | 美股 ETF | ✅ 支持（基本面分析师意义较小） | -| 其他美股 | - | ✅ 理论上支持 | -| Au99.99（黄金） | 国内 SGE | ⚠️ 需要自定义数据适配层 | +| 标的 | 支持情况 | +|------|---------| +| 美股个股（NVDA/AAPL 等） | ✅ 完整支持 | +| 美股 ETF（VOO/SPY 等） | ✅ 支持（基本面分析意义较小） | +| 国内 A 股 / 商品 | ⚠️ 需自定义数据适配层 | --- ## 已知问题 -1. **Gemini 偶发断连**：Google API 对长 prompt 偶尔返回 `Server disconnected`，脚本已内置 3 次自动重试。 -2. **Python 3.14 兼容警告**：`Pydantic V1 not compatible` 是警告非错误，不影响运行。 -3. **回测数据不可信**：框架在回测时可能存在前视偏差，历史回测结果仅供参考。 +1. **Gemini 偶发断连**：已在 LLM 客户端层加入指数退避自动重试（最多 5 次） +2. **Python 3.14 Pydantic 警告**：Warning 非 Error，不影响运行，忽略即可 +3. **回测前视偏差**：Agent 联网获取信息可能导致回测数据失真，历史结果仅供参考 --- -## 目录结构 +## 本版改动说明 -``` -TradingAgents/ -├── run_analysis.py # 中文分析入口脚本（定制） -├── .env # API Key 配置（已 gitignore） -├── results/ # 分析结果输出目录 -├── cli/ # TUI 交互界面 -├── tradingagents/ -│ ├── agents/ -│ │ ├── analysts/ # 4 个分析师（已汉化） -│ │ ├── researchers/ # 多空研究员（已汉化） -│ │ ├── managers/ # 研究主管 + 风控主管（已汉化） -│ │ ├── trader/ # 交易员（已汉化） -│ │ └── risk_mgmt/ # 风控辩手团队（已汉化） -│ ├── dataflows/ # 数据获取层（yfinance） -│ └── default_config.py # 默认配置 -└── README_CN.md # 本文件 -``` - ---- - -## Gitea 仓库 - -`http://192.168.1.94:4000/flyingjoe2010/TradingAgents` +| 文件 | 改动 | +|------|------| +| `tradingagents/agents/analysts/*.py` | 所有分析师 prompt 加中文输出指令 | +| `tradingagents/agents/researchers/*.py` | 多空研究员 prompt 加中文指令 | +| `tradingagents/agents/managers/*.py` | 研究主管/风控主管加中文指令 | +| `tradingagents/agents/trader/trader.py` | 交易员加中文指令 | +| `tradingagents/agents/risk_mgmt/*.py` | 风控辩手加中文指令 | +| `tradingagents/llm_clients/google_client.py` | 加入 SSL 断连自动重试 | +| `tradingagents/graph/propagation.py` | 支持 `user_context` 参数 | +| `tradingagents/graph/trading_graph.py` | `propagate()` 支持用户视角注入 | +| `cli/main.py` | TUI 新增 Step 8 用户视角输入 | +| `run_analysis.py` | 新增中文分析入口脚本 | ---