# AI 分析

**页面路径**：`/ai`（须在系统设置 → 导航显示 中开启「AI 分析」）

**相关文件**：`ai_client.py`、`ai_worker.py`、`ai_messages.py`、`templates/ai_messages.html`

---

## 功能概述

| 能力 | 说明 |
|------|------|
| 开仓分析 | 手动/关键位开仓成交后后台分析 |
| 平仓分析 | 写入 `trade_logs` 平仓记录后分析 |
| 日终报告 | 每日定时汇总当日交易与持仓 |
| 消息存档 | 全部写入 `ai_messages` 表，页面可浏览 |
| 微信推送 | 可选：分析成功后推送到企业微信 |

---

## 配置项（系统设置 → AI 分析）

| 设置键 | 说明 | 默认 |
|--------|------|------|
| `ai_enabled` | 总开关 | 关 |
| `ai_provider` | `ollama` / `openai` | ollama |
| `ai_ollama_base_url` | Ollama 地址 | `http://127.0.0.1:11434` |
| `ai_ollama_model` | Ollama 模型 | `qwen2.5:7b` |
| `ai_openai_base_url` | OpenAI 兼容 API | `https://api.openai.com/v1` |
| `ai_openai_api_key` | API Key | 空 |
| `ai_openai_model` | 模型名 | `gpt-4o-mini` |
| `ai_daily_report_enabled` | 日终报告开关 | 开 |
| `ai_daily_report_hour` | 报告时刻（时） | 15 |
| `ai_daily_report_minute` | 报告时刻（分） | 5 |

---

## 触发时机

### 1. 开仓分析（`kind=open`）

- **触发**：下单监控手动开仓 **成交** 且填写止损 → `notify_manual_open_filled()` 调度。
- **标题**：`{品种名} 开仓`
- **Payload**：symbol、direction、entry、stop_loss、take_profit、lots、capital

### 2. 关键位开仓（`kind=key_open`）

- **触发**：箱体/收敛突破自动单成交 → `notify_key_breakout_open()` 调度。
- **标题**：`{品种名} 关键位开仓`
- **Payload**：monitor_type、trade_mode、break_side、entry、stop_loss、take_profit、lots

### 3. 平仓分析（`kind=close`）

- **触发**：`trade_logs` 新增平仓 → `notify_trade_log_close()` 调度。
- **标题**：`{品种名} 平仓`
- **Payload**：source、result、pnl_net、entry、close_price、lots

### 4. 日终报告（`kind=daily_report`）

- **触发**：后台 `ai_worker` 每分钟检查；到达设定时刻且当日未生成过。
- **标题**：`{YYYY-MM-DD} 日终持仓与交易报告`
- **Payload**：当日成交汇总、胜负次数、净盈亏、active 持仓列表

> 开仓/平仓的 AI 分析 **默认不推微信**（仅写入页面）；日终报告与可在设置中开启的推送见下文。

---

## 分析逻辑

**System Prompt**（固定）：

```
你是国内期货交易复盘助手。根据提供的结构化交易数据，
用简洁中文给出 3～6 条要点：风险、纪律、改进建议。
不要编造未提供的数据；金额单位为元。
```

**User Prompt**：

```
事件类型：{event_kind}

数据：
{JSON payload}
```

**接口**：

- Ollama：`POST {base}/api/chat`
- OpenAI 兼容：`POST {base}/chat/completions`，temperature=0.4

失败时内容前加 `⚠`，仍写入 `ai_messages`。

---

## 微信推送

| 类型 | 条件 | 模板 |
|------|------|------|
| 事件分析 | AI 调用成功 **且** 调度时传入 `send_wechat_fn` | 见 [WECHAT.md §12](./WECHAT.md#12-ai-分析) |
| 日终报告 | `ai_daily_report_enabled=1` 且 AI 成功 | `🤖 {date} 日终持仓与交易报告\n\n{content[:1800]}` |

**说明**：

- 当前实现中，开仓/平仓触发的 `schedule_ai_event_analysis()` **未绑定** `send_wechat_fn`，故 **仅存档到 /ai 页面**。
- 日终报告在 `maybe_run_daily_ai_report()` 中会推微信（成功时）。
- 正文截断为 **1800 字符**，避免超长。

---

## 下单逻辑

AI **不参与下单**，仅事后分析。无 `assert_can_open` 或 CTP 交互。

---

## 风控规则

AI 模块无独立风控。其输入数据来自已发生的交易事件，不改变账户冻结、保证金等状态。

---

## 后台任务

- 线程名：`ai-worker`
- 启动延迟 30 秒后，每 **60 秒** 检查是否该跑日终报告
- 与 `background_task`（计划/关键位）独立运行

---

## 数据存储

表 `ai_messages`：

| 字段 | 说明 |
|------|------|
| kind | open / key_open / close / daily_report |
| title | 标题 |
| content | AI 回复正文 |
| meta | JSON payload |
| created_at | 创建时间 |

页面 `/ai` 按时间倒序展示；上方含使用说明卡片。

---

## 相关文档

- [WECHAT.md §12](./WECHAT.md#12-ai-分析) — 推送模板
- [ORDER_MONITOR.md](./ORDER_MONITOR.md) — 手动开仓触发 AI
- [KEY_MONITORS.md](./KEY_MONITORS.md) — 关键位开仓触发 AI
- [SETTINGS.md](./SETTINGS.md) — 配置入口