AI 期货分析系统是基于**DeepSeek 大模型**和**量化分析算法**的智能期货决策辅助系统，为期货投资者提供：

- 📊 **多维度市场分析**（技术面、资金面、政策面）
- 🤖 **AI 智能研判**（趋势判断、胜率评估、风险预警）
- ⚡ **全自动数据更新**（每日 3 次自动复盘）
- 🛡️ **专业风控管理**（止损建议、仓位管理、换月预警）

### 1.2 核心能力

| 能力维度 | 具体功能 | 技术实现 |
|---------|---------|---------|
| **趋势分析** | ADX 趋势强度、双均线过滤、多周期共振 | TrendFilter 类 |
| **风控管理** | ATR 动态仓位、技术位止损、盈亏比控制 | RiskManager 类 |
| **资金监控** | 持仓量分析、量价背离、资金流向 | FundFlowMonitor 类 |
| **压力支撑** | 关键价位识别、智能止损位、目标位测算 | SupportResistance 类 |
| **换月预警** | 交割日检测、流动性保护、自动减仓 | RolloverDetector 类 |
| **AI 研判** | DeepSeek 大模型、多维度融合、决策透明 | DeepseekAgent 类 |

---

## 2. 功能架构

### 2.1 系统架构图

```
┌─────────────────────────────────────────────────────────────┐
│                      用户界面层 (UI)                         │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │ 多品种面板   │  │ 品种详情页   │  │ 分析卡片     │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                      业务逻辑层                              │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │ generate_card│  │ deepseek_agent│  │ risk_manager│      │
│  │ (卡片生成)   │  │ (AI 分析)      │  │ (风控计算)  │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                      数据计算层                              │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │ fetch_market │  │ fund_flow    │  │ trend_filter│      │
│  │ (市场数据)   │  │ (资金分析)    │  │ (趋势计算)  │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                      数据源层                                │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐      │
│  │ 天勤 TQSDK    │  │ 新闻 API      │  │ 数据库      │      │
│  │ (行情数据)   │  │ (政策新闻)    │  │ (SQLite)    │      │
│  └──────────────┘  └──────────────┘  └──────────────┘      │
└─────────────────────────────────────────────────────────────┘
```

### 2.2 数据流向

```
API 获取 (天勤 TQSDK)
    │
    ├─→ K 线数据 (open/high/low/close/volume/close_oi)
    │
    ▼
数据清洗与计算
    │
    ├─→ 技术指标 (MACD/RSI/布林带/KDJ)
    ├─→ 趋势分析 (ADX/双均线/多周期)
    ├─→ 资金分析 (持仓量/量价关系)
    └─→ 压力支撑 (枢轴点/近期高低点)
    │
    ▼
AI 综合研判 (DeepSeek)
    │
    ├─→ 多维度数据融合
    ├─→ 趋势过滤应用
    └─→ 交易建议生成
    │
    ▼
数据库存储 (SQLite)
    │
    ▼
前端展示 (Web 界面)
```

---

## 3. 业务逻辑

### 3.1 胜率计算逻辑

胜率是**综合评分**，由三个维度加权计算：

```
胜率 = 价格分位评分 × 权重 + 量价强度评分 × 权重 + 趋势强度评分 × 权重
```

**震荡市（ADX<20）权重分配**：
- 价格分位：25%（降低，避免逆势抄底）
- 量价分析：60%（提高，震荡市更重要）
- 趋势强度：15%

**趋势市（ADX≥20）权重分配**：
- 价格分位：30-60%（随 ADX 递减）
- 量价分析：40%
- 趋势调整：根据方向±(ADX-20)×0.5%

**价格分位评分标准**：
- <20%（极低）：90 分
- <40%（相对低）：75 分
- 40-60%（中性）：55 分
- >60%（相对高）：40 分
- >80%（极高）：25 分

### 3.2 方向判断逻辑

方向（做多/做空/观望）由**多因素投票**决定：

1. **资金面信号**（1 票）
   - 胜率>60% → 做多
   - 胜率<40% → 做空
   - 40-60% → 观望

2. **技术面信号**（1 票）
   - MACD 金叉/多头排列 → 做多
   - MACD 死叉/空头排列 → 做空
   - RSI 超买且做多 → 修正为观望
   - RSI 超卖且做空 → 修正为观望

3. **价格位置信号**（1 票）
   - 价格分位<30% → 做多
   - 价格分位>70% → 做空
   - 30-70% → 观望

4. **政策面信号**（1 票）
   - 利好 → 做多
   - 利空 → 做空
   - 中性 → 观望

**最终方向**：得票最多的方向

**趋势过滤**：ADX<20（无趋势）时，强制改为「观望」

### 3.3 周期判断逻辑

周期（短线/中线/长线）由**多周期一致性**决定：

```Python
if 所有周期方向一致且不为观望:
    cycle = 「短线」  # 各周期共振，适合短线操作
else:
    cycle = 「中线」  # 周期分歧，中线布局

if 极强趋势（ADX>40 且所有周期同向）:
    cycle = 「长线」  # 强势趋势，长线持有
```
## 4. 数据指标说明

### 4.1 核心指标

#### 资金胜率 (fund_probability)

| 范围 | 含义 | 建议 |
|------|------|------|
| 80-100% | 极高胜率 | 高置信度交易机会 |
| 60-80% | 中高胜率 | 较好的交易机会 |
| 40-60% | 中性 | 观望或轻仓试探 |
| 20-40% | 较低胜率 | 谨慎或回避 |
| 0-20% | 低胜率 | 不建议交易 |

**计算公式**：
```
震荡市: 价格分位×25% + 量价强度×60% + 趋势×15%
趋势市: 价格分位×(0.3-0.6) + 量价强度×40% + 趋势调整
```

#### ADX 趋势强度

| ADX 值 | 趋势状态 | 交易策略 |
|-------|---------|---------|
| >40 | 强趋势 | 顺势交易，禁止逆势 |
| 25-40 | 中等趋势 | 顺势为主 |
| 20-25 | 弱趋势 | 谨慎参与 |
| <20 | 无趋势/震荡 | 高抛低吸或观望 |

#### 持仓量信号

| 信号类型 | 持仓变化 | 价格变化 | 含义 |
|---------|---------|---------|------|
| 增仓上涨 | ↑ >5% | ↑ | 多头主力积极建仓 |
| 减仓上涨 | ↓ >5% | ↑ | 资金离场，上涨动能减弱 |
| 增仓下跌 | ↑ >5% | ↓ | 空头主力积极建仓 |
| 减仓下跌 | ↓ >5% | ↓ | 资金离场，下跌动能减弱 |
| 持仓平稳 | -5%~+5% | - | 多空双方观望 |

### 4.2 技术指标详解

#### MACD (指数平滑异同平均线)

**金叉/死叉判断**：
- 金叉：DIF 上穿 DEA → 买入信号
- 死叉：DIF 下穿 DEA → 卖出信号

**多头排列**：
- MACD 柱状图>0 且持续扩大
- DIF>DEA>0

#### RSI (相对强弱指标)

| RSI 值 | 状态 | 操作建议 |
|-------|------|---------|
| >70 | 超买 | 警惕回调，考虑减仓 |
| 50-70 | 偏强 | 多头占优 |
| 30-50 | 偏弱 | 空头占优 |
| <30 | 超卖 | 警惕反弹，考虑建仓 |

#### 布林带 (Bollinger Bands)

| 位置 | 含义 | 策略 |
|------|------|------|
| 触及上轨 | 相对高位 | 警惕回落 |
| 中轨附近 | 均衡位置 | 观望或轻仓 |
| 触及下轨 | 相对低位 | 警惕反弹 |

#### KDJ (随机指标)

| 信号 | 条件 | 操作 |
|------|------|------|
| 金叉 | K 上穿 D | 买入信号 |
| 死叉 | K 下穿 D | 卖出信号 |
| 超买 | K,D,J>80 | 警惕回调 |
| 超卖 | K,D,J<20 | 警惕反弹 |

### 4.3 风控指标

#### ATR (真实波动幅度)

**止损位计算**：
```
做多止损 = 入场价 - ATR × 倍数(通常 2 倍)
做空止损 = 入场价 + ATR × 倍数(通常 2 倍)
```

**仓位计算**：
```
建议手数 = 账户资金 × 风险比例 / (ATR × 合约乘数)
```

#### 盈亏比

```
盈亏比 = (目标价 - 入场价) / (入场价 - 止损价)

要求: 盈亏比 >= 1.5
```

**示例**：
- 入场价：3500
- 止损价：3450（50 点）
- 目标价：3600（100 点）
- 盈亏比：100/50 = 2.0 ✅

---

## 5. 界面展示说明

### 5.1 多品种分析面板

**展示字段**：

| 字段 | 说明 | 示例 |
|------|------|------|
| **品种名称** | 期货品种 | 沥青(BU) |
| **当前价格** | 最新价格 | 3500 |
| **趋势方向** | AI 建议方向 | 观望/做多/做空 |
| **胜率** | 综合胜率 | 75% |
| **趋势强度** | ADX 评分 | 强势多头(85) |
| **周期** | 建议周期 | 短线/中线 |
| **换月预警** | 距离交割天数 | ⚠️ 12 天 |
| **主力资金** | 资金流向 | 增仓上涨 |

**颜色标识**：
- 🟢 看多/强烈看多
- 🔴 看空/强烈看空
- ⚪ 观望/中性

### 5.2 品种详情页

**模块 1: 市场概况**
- 当前价格、涨跌幅
- 价格分位（近一年）
- 波动率（ATR 比率）

**模块 2: 技术指标**
- MACD 信号（金叉/死叉/多头排列）
- RSI 值（超买/超卖/中性）
- 布林带位置（上轨/中轨/下轨）
- KDJ 信号（金叉/死叉）

**模块 3: 趋势分析**
- ADX 趋势强度
- 多周期方向（5min/30min/1hour/1day）
- 多周期一致性说明

**模块 4: 压力支撑**
- 最近支撑位（距离）
- 最近阻力位（距离）
- 智能止损位建议
- 目标位测算

**模块 5: 主力资金**
- 持仓量变化（百分比）
- 价格变化（5 日）
- 资金信号解读
- 综合评分

**模块 6: AI 交易建议**
- 方向：做多/做空/观望
- 周期：短线/中线/长线
- 入场价、止损价、目标价
- 信心等级：高/中/低
- 详细理由说明

**模块 7: 风控建议**
- 建议手数
- 每手保证金
- 最大仓位限制
- 单日最大亏损限制
- 风险回报比

**模块 8: 相关新闻**
- 最新政策新闻列表
- 新闻情绪（积极/中性/消极）
- 新闻摘要

### 5.3 分析卡片文本

**格式示例**：
```
┌─────────────────────────────────────┐
│ 📊 沥青(BU) 分析卡片                  │
├─────────────────────────────────────┤
│ 当前价格: 3500                       │
│ 趋势方向: 观望 | 周期: 短线           │
│ 资金胜率: 75%                        │
├─────────────────────────────────────┤
│ 🎯 交易建议                           │
│ • 方向: 观望                         │
│ • 入场: 3450                         │
│ • 止损: 3400 (2 倍 ATR)                │
│ • 目标: 3600 (盈亏比 2.0)             │
│ • 信心: 中                           │
├─────────────────────────────────────┤
│ 📈 技术指标                           │
│ • MACD: 多头排列                     │
│ • RSI: 60(中性)                      │
│ • 布林带: 中轨区域                   │
├─────────────────────────────────────┤
│ 💰 主力资金                           │
│ • 持仓大增 10%                       │
│ • 价格上升 5%                        │
│ • 多头主力积极建仓                    │
├─────────────────────────────────────┤
│ ⚠️ 风险提示                           │
│ • 换月期预警: 距离交割 12 天            │
│ • 多周期分歧: 仅日线看多              │
└─────────────────────────────────────┘
```