# 美股手动分析脚本使用说明

## 📜 脚本列表

| 脚本 | 说明 | 推荐度 |
|------|------|--------|
| `scripts/stock.sh` | 快捷分析脚本（推荐） | ⭐⭐⭐ |
| `scripts/analyze_stock_simple.py` | Python 简化版 | ⭐⭐ |
| `scripts/analyze_stock.py` | Python 完整版 | ⭐ |

## 🚀 快速开始

### 方式 1: 使用快捷脚本（推荐）

```bash
# 分析单只股票
./scripts/stock.sh AAPL

# 分析多只股票
./scripts/stock.sh AAPL TSLA NVDA

# 分析配置的所有股票
./scripts/stock.sh
```

### 方式 2: 使用 Python 脚本

```bash
# 简化版
cd backend
python3 ../scripts/analyze_stock_simple.py AAPL
python3 ../scripts/analyze_stock_simple.py AAPL TSLA NVDA

# 完整版
python3 ../scripts/analyze_stock.py AAPL
python3 ../scripts/analyze_stock.py AAPL TSLA NVDA
```

## 📋 输出示例

```
============================================================
📊 分析 AAPL
============================================================
价格: $178.50 (+1.25%)
K线: ['1d', '1h']

🤖 LLM分析中...

状态: 震荡上涨，MACD 金叉形成

🎯 发现 1 个信号:

  🟢 做多 [A⭐⭐⭐] 85%
  入场: $178.50
  止损: $172.80
  止盈: $205.28
  理由: 突破 MA20 阻力，RSI=58 进入强势区...

✅ 完成
```

## ⚙️ 配置说明

在 `.env` 文件中配置默认股票列表：

```bash
# 美股智能体配置
STOCK_SYMBOLS=AAPL,TSLA,NVDA,MSFT,GOOGL
```

## 📝 完整版功能

完整版脚本 (`analyze_stock.py`) 提供更多详细信息：

- ✅ 当前行情详情
- ✅ K 线数据统计
- ✅ 新闻情绪分析
- ✅ 关键支撑/阻力位
- ✅ 详细信号列表
- ✅ 风险提示
- ✅ 通知预览

## 🔧 依赖要求

确保已安装 yfinance：

```bash
cd backend
pip install yfinance
```

## 💡 提示

1. **首次使用**：建议先运行一次 `./scripts/stock.sh` 测试
2. **分析频率**：不要频繁分析，避免 API 限流
3. **最佳时间**：在美股交易时间内分析效果最佳
4. **股票代码**：使用美股代码，如 AAPL, TSLA, NVDA 等

## 📊 支持的股票

任何美股代码都可以分析，常见示例：

- 科技股: AAPL, MSFT, GOOGL, META, AMZN, NVDA, TSLA
- 金融股: JPM, BAC, GS, MS
- 医疗股: JNJ, PFE, UNH, ABT
- 消费股: NKE, KO, MCD, SBUX

## ⚠️ 注意事项

1. 数据来源：YFinance（Yahoo Finance）
2. 数据延迟：约 15 分钟
3. API 限制：过于频繁的请求可能被限流
4. 市场时间：美股交易时间分析效果最佳

## 🆘 故障排除

### 错误：ModuleNotFoundError: No module named 'yfinance'

```bash
cd backend
pip install yfinance
```

### 错误：无法获取行情

- 检查股票代码是否正确
- 检查网络连接
- 稍后重试

### 错误：LLM 分析失败

- 检查 API 密钥配置
- 检查 DeepSeek/Zhipu API 是否可用