📖 public 分支：README_CN 去除私有信息，通用化
This commit is contained in:
dw1161
parent
39abd4878c
commit
2a4dbc5e11
156
README_CN.md
156
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` | 新增中文分析入口脚本 |
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue