claude强化功能

功能拓展/AI对话式分析使用说明.md

@@ -0,0 +1,597 @@
+# 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对话助手" → 开始聊天 → 享受智能投资体验！