# AI对话式分析使用说明

## 功能概述

AI对话式分析是Blackdata股票终端的终极功能，通过自然语言与AI助手对话，实现智能选股、持仓诊断、策略建议等功能，无需记忆复杂操作步骤。

## 核心特性

### 1. 自然语言理解
不需要点击菜单或填写表单，直接用人话描述需求：
```
❌ 传统方式：进入"选股引擎" → 选择字段 → 设置条件 → 执行
✅ AI方式："帮我找近期突破且资金流入的科技股"
```

### 2. 上下文记忆
AI会记住对话历史，支持多轮连续对话：
```
用户：帮我选股
AI：[返回10只股票]
用户：分析第1只
AI：[分析第1只股票，无需再次指定代码]
```

### 3. 智能功能调用
AI自动识别意图并调用相应功能：
- 选股功能
- 持仓诊断
- 策略建议
- 个股分析
- 板块分析

### 4. 多模态回复
根据问题类型，返回不同格式的结果：
- 文字解释
- 数据表格
- 操作建议
- 风险提示

---

## 支持的问题类型

### 类型1：自然语言选股

**示例问题**：
```
✓ 帮我找近期突破的科技股
✓ 推荐一些超跌反弹的股票
✓ 有哪些量比大于2且上涨的股票
✓ 找5日涨幅超过10%的股票
✓ 成交额大于10亿的强势股
```

**AI如何处理**：
1. 识别为选股需求
2. 提取选股条件：
   - "近期突破" → 5日涨幅 > 5%
   - "科技股" → 板块筛选（简化处理）
   - "资金流入" → 量比 > 1.5
3. 调用选股引擎
4. 返回前10只股票

**回复示例**：
```
为您找到 25 只股票，以下是前10只：

1. 中芯国际（688981）
   现价：52.30元　涨跌：+3.25%　5日：+12.8%
   量比：2.85　成交额：45.6亿

2. 北方华创（002371）
   现价：285.60元　涨跌：+2.10%　5日：+9.3%
   量比：2.12　成交额：38.2亿

...

💡 您可以继续问我：
- 分析某只股票（如"分析第1只"）
- 回测这个策略
- 看看其他板块
```

---

### 类型2：持仓诊断对话

**示例问题**：
```
✓ 我的持仓有什么风险？
✓ 帮我看看持仓情况
✓ 诊断一下我的组合
✓ 有哪些股票在亏钱？
✓ 我应该止损吗？
```

**AI如何处理**：
1. 识别为持仓诊断需求
2. 读取当前持仓数据
3. 分析风险点：
   - 浮亏比例
   - 持仓集中度
   - 历史胜率
4. 给出诊断报告和建议

**回复示例**：
```
📊 持仓诊断报告

持仓数量：5 只
持仓市值：125,680.00 元
浮动盈亏：-3,250.00 元
历史胜率：58%

⚠️ 风险提示：
⚠️ 超过一半的持仓处于浮亏状态（3/5只）

📈 前5大持仓：
1. 贵州茅台　+5.20%　+6500元
2. 中芯国际　-8.50%　-4200元
3. 宁德时代　-3.20%　-2800元
4. 比亚迪　+2.10%　+1800元
5. 隆基绿能　-12.30%　-4550元

💡 建议：
- 考虑止损浮亏较大的股票（如隆基绿能）
- 增加持仓分散度
- 定期复盘，总结经验
```

---

### 类型3：策略建议

**示例问题**：
```
✓ 当前市场适合什么策略？
✓ 现在应该怎么操作？
✓ 给我一些投资建议
✓ 现在是买入还是观望的时机？
✓ 市场风格是什么？
```

**AI如何处理**：
1. 识别为策略建议需求
2. 获取板块轮动数据
3. 分析市场强弱
4. 给出操作建议

**回复示例**：
```
📋 当前市场策略建议

🔥 强势板块：
- 半导体　+8.5%
- 新能源　+6.2%
- 人工智能　+5.8%

📉 弱势板块：
- 地产　-3.2%
- 银行　-1.8%
- 煤炭　-1.5%

💡 策略建议：
- 市场情绪较好，适合进攻型策略
- 可关注强势板块的龙头股
- 设置好止盈点，及时落袋为安

🎯 具体操作：
- 可以问我"帮我找半导体的股票"
- 或"分析新能源板块"
```

---

### 类型4：个股分析

**示例问题**：
```
✓ 分析一下贵州茅台
✓ 600519怎么样？
✓ 帮我看看中芯国际
✓ 这只股票能买吗？（需要先提到股票）
✓ 分析第1只（在选股结果后）
```

**AI如何处理**：
1. 识别为个股分析需求
2. 提取股票代码
3. 调用AI诊断功能
4. 返回综合评分和建议

**回复示例**：
```
📊 贵州茅台（600519）AI诊断

综合评分：78分
预测方向：看多
置信度：72%

📈 各维度评分：
- 技术面：82分
- 资金面：75分
- 基本面：85分
- 动量：68分
- 情绪面：70分
- 估值：65分

💬 该股技术面强势，均线多头排列，MACD金叉...

💡 完整分析请在「AI分析 → 个股诊断」页面查看
```

---

### 类型5：板块分析

**示例问题**：
```
✓ 半导体板块怎么样？
✓ 分析一下新能源板块
✓ 医药板块现在能买吗？
✓ 科技股还能涨吗？
```

**AI如何处理**：
1. 识别为板块分析需求
2. 提取板块名称
3. 调用板块生命周期分析
4. 返回阶段判断和龙头股

**回复示例**：
```
📊 半导体 板块分析

生命周期：加速期
板块持续上涨且加速，成交活跃，主升浪阶段

📈 近期表现：
- 5日涨幅：+8.50%
- 20日涨幅：+23.70%
- 成交额变化：+45.20%

🏆 龙头股：
1. 中芯国际　+28.60%
2. 北方华创　+25.30%
3. 韦尔股份　+22.80%

💡 您可以继续问：
- 帮我找半导体板块的股票
- 半导体龙头股有哪些
```

---

### 类型6：闲聊与问候

**示例问题**：
```
✓ 你好
✓ 你是谁？
✓ 你能做什么？
✓ 谢谢
✓ 再见
```

**AI回复**：
友好的问候和功能介绍。

---

## 使用技巧

### 技巧1：渐进式提问

不要一次性问太复杂的问题，可以分步提问：

```
❌ 不好的提问：
"帮我找5日涨幅大于10%且量比大于2且RSI小于80的科技股，然后回测这个策略，再给我策略建议"

✅ 好的提问：
用户：帮我找5日涨幅大于10%的科技股
AI：[返回结果]
用户：量比也要大于2
AI：[筛选后返回]
用户：回测一下这个策略
AI：[回测结果]
```

---

### 技巧2：利用上下文

AI会记住对话历史，善用这个特性：

```
用户：帮我选股
AI：[返回10只股票]

用户：分析第1只
AI：[分析第1只股票]

用户：这只股票风险大吗？
AI：[针对该股票回答风险]

用户：给我推荐其他的
AI：[推荐选股结果中的其他股票]
```

---

### 技巧3：明确需求

问题越明确，回答越精准：

```
❌ 模糊："有什么好股票？"
✅ 明确："帮我找近5日涨幅超过10%且量比大于2的股票"

❌ 模糊："市场怎么样？"
✅ 明确："当前半导体板块处于什么阶段？"

❌ 模糊："我该买什么？"
✅ 明确："根据我的持仓情况，推荐一些分散风险的股票"
```

---

### 技巧4：组合使用功能

将多个功能串联起来：

```
流程示例：

1. 用户：当前市场适合什么策略？
   AI：[分析市场，建议关注半导体]

2. 用户：帮我找半导体板块的股票
   AI：[返回10只股票]

3. 用户：分析第1只
   AI：[详细分析]

4. 用户：回测这个选股策略
   AI：[回测结果]

5. 用户：我的持仓有什么风险？
   AI：[诊断持仓]
```

---

## 快速开始

### 步骤1：配置大模型（必需）

在 `backend/.env` 中配置：

```env
LLM_API_KEY=sk-xxxxx
LLM_BASE_URL=https://api.openai.com/v1
LLM_MODEL=gpt-3.5-turbo
```

**支持的大模型**：
- OpenAI（GPT-3.5/GPT-4）
- 国内大模型（通义千问、文心一言、讯飞星火等，通过兼容接口）
- 本地部署模型（Ollama、LM Studio等）

---

### 步骤2：启动服务

```bash
cd backend
python main.py
```

---

### 步骤3：开始对话

1. 打开浏览器访问 `http://127.0.0.1:8000`
2. 进入"AI分析" → "AI对话助手"
3. 在输入框输入问题，按回车发送

**第一次对话建议**：
```
你好，请介绍一下你的功能
```

AI会详细介绍可以做什么。

---

## 实战案例

### 案例1：从零开始选股

**对话记录**：

```
用户：你好

AI：👋 你好！我是Blackdata AI助手。

我可以帮你：
• 自然语言选股
• 诊断持仓风险
• 给出策略建议
• 分析个股和板块

有什么可以帮你的吗？

---

用户：当前市场适合什么策略？

AI：📋 当前市场策略建议

🔥 强势板块：
- 半导体　+8.5%
- 新能源　+6.2%
- 人工智能　+5.8%

...

💡 策略建议：
- 市场情绪较好，适合进攻型策略
- 可关注强势板块的龙头股

---

用户：帮我找半导体板块涨幅超过5%的股票

AI：为您找到 18 只股票，以下是前10只：

1. 中芯国际（688981）
   现价：52.30元　涨跌：+3.25%　5日：+12.8%
   ...

---

用户：分析第1只

AI：📊 中芯国际（688981）AI诊断

综合评分：82分
预测方向：看多
置信度：75%
...

---

用户：谢谢

AI：不客气！有其他问题随时问我 😊
```

---

### 案例2：持仓诊断与优化

**对话记录**：

```
用户：我的持仓有什么问题？

AI：📊 持仓诊断报告

持仓数量：5 只
浮动盈亏：-3,250.00 元

⚠️ 风险提示：
⚠️ 超过一半的持仓处于浮亏状态（3/5只）

📈 前5大持仓：
1. 贵州茅台　+5.20%
2. 中芯国际　-8.50%
3. 隆基绿能　-12.30%
...

💡 建议：
- 考虑止损浮亏较大的股票

---

用户：隆基绿能为什么跌这么多？

AI：[分析隆基绿能]

---

用户：我应该止损吗？

AI：根据您的持仓情况：

隆基绿能浮亏-12.30%，建议：
1. 如果跌破-15%，坚决止损
2. 检查基本面是否恶化
3. 设置止损线，严格执行

注意：这不构成投资建议，请根据自己的风险承受能力决策。
```

---

## API 接口

### POST /api/chat
发送消息

**请求体**：
```json
{
  "session_id": "session_123456",
  "message": "帮我找近期突破的科技股"
}
```

**响应**：
```json
{
  "ok": true,
  "type": "select_stocks",
  "text": "为您找到 25 只股票...",
  "data": [...]
}
```

### DELETE /api/chat/{session_id}
清空会话

### GET /api/chat/{session_id}/history
获取会话历史

---

## 注意事项

1. **大模型依赖**：
   - 必须配置 LLM_API_KEY
   - 未配置时会提示降级使用其他功能

2. **API费用**：
   - 每次对话会调用大模型API
   - 建议使用便宜的模型（如GPT-3.5-turbo）
   - 控制对话长度以节省费用

3. **数据隐私**：
   - 对话内容会发送到大模型服务商
   - 不要在对话中透露敏感信息（密码、账号等）

4. **准确性**：
   - AI回答基于当前数据，但不保证100%准确
   - 投资决策请结合自己的判断
   - 不构成投资建议

5. **会话管理**：
   - 会话保存在内存中，重启后清空
   - 对话历史保留最近20轮
   - 可手动清空会话重新开始

---

## 后续优化

- [ ] 语音输入/输出
- [ ] 更多Function Calling（如直接下单、设置预警）
- [ ] 会话持久化（保存到数据库）
- [ ] 多用户支持
- [ ] 对话导出（PDF报告）
- [ ] 实时行情推送（"茅台涨了多少"）
- [ ] 图表生成（直接生成K线图）
- [ ] 策略自动执行

---

## 总结

AI对话式分析是Blackdata股票终端的**终极形态**，将所有功能融合到自然语言交互中，让投资分析像聊天一样简单。

**核心价值**：
- **零门槛**：不需要学习操作步骤
- **高效率**：一句话完成复杂操作
- **智能化**：AI自动识别意图并调用功能
- **个性化**：记住对话历史，越用越懂你

**适合人群**：
- 所有投资者（新手尤其友好）
- 喜欢自然交互的用户
- 希望快速获取信息的用户

**开始使用**：
配置好大模型 → 进入"AI对话助手" → 开始聊天 → 享受智能投资体验！