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对话助手" → 开始聊天 → 享受智能投资体验！

功能拓展/事件驱动策略使用说明.md

@@ -0,0 +1,504 @@
+# 事件驱动策略使用说明
+
+## 功能概述
+
+事件驱动策略是一种基于公司或行业重大事件进行投资决策的量化策略。通过统计分析历史事件对股价的影响，找出规律并应用于实战。
+
+**核心理念**：重大事件往往改变市场预期，带来股价波动，提前布局或及时应对可获取超额收益。
+
+---
+
+## 五大事件类型
+
+### 1. 财报发布（Earnings）
+
+**事件说明**：
+上市公司定期发布财报（季报、半年报、年报），业绩是否符合预期直接影响股价。
+
+**事件分类**：
+- **业绩超预期**（Positive）：实际业绩好于市场预期
+- **业绩不及预期**（Negative）：实际业绩低于市场预期
+- **业绩符合预期**（Neutral）：实际业绩与预期一致
+
+**统计分析**：
+系统统计历史上所有财报事件，分析：
+- 财报前N天的股价表现
+- 财报后N天的股价表现
+- 后续胜率（上涨概率）
+
+**典型规律**：
+
+| 业绩类型 | 财报前表现 | 财报后表现 | 胜率 |
+|----------|------------|------------|------|
+| 超预期 | 可能提前上涨 | 继续上涨 | 70%+ |
+| 不及预期 | 可能高位 | 大幅下跌 | 30%- |
+| 符合预期 | 平稳 | 小幅波动 | 50% |
+
+**投资策略**：
+
+**策略1：财报发布后介入**
+```
+条件：
+- 业绩超预期
+- 财报发布后1-3天内
+- 股价尚未大涨（涨幅 < 10%）
+
+操作：
+- 买入
+- 止盈：+15%
+- 止损：-5%
+- 持仓周期：5-10天
+
+历史胜率：68%
+平均收益：+8.5%
+```
+
+**策略2：财报前规避**
+```
+如果持有股票，财报发布前：
+- 业绩确定性高 → 继续持有
+- 业绩不确定 → 减仓或清仓
+- 避免赌业绩
+```
+
+---
+
+### 2. 高管增减持（Insider Trading）
+
+**事件说明**：
+公司高管、大股东增持或减持公司股票，往往透露内部信息。
+
+**信号解读**：
+
+**增持（Positive）**：
+- **含义**：高管看好公司未来
+- **信号强度**：⭐⭐⭐⭐
+- **投资价值**：跟随买入
+
+**减持（Negative）**：
+- **含义**：高管套现离场
+- **信号强度**：⭐⭐⭐
+- **投资价值**：警惕，考虑卖出
+
+**关键指标**：
+
+1. **增持金额**
+   - < 1000万：一般信号
+   - 1000万 - 5000万：强信号
+   - > 5000万：极强信号
+
+2. **增持主体**
+   - 董事长/总经理：信号最强
+   - 高管团队集体增持：信号极强
+   - 普通股东：信号较弱
+
+3. **增持时机**
+   - 股价低位增持：强看好
+   - 股价高位增持：一般
+   - 连续增持：信号持续
+
+**投资策略**：
+
+**策略1：跟随增持**
+```
+筛选条件：
+- 高管增持金额 > 1000万
+- 增持时股价处于相对低位（60日分位 < 30%）
+- 公司基本面良好
+
+操作：
+- 增持公告后1-3天内买入
+- 持仓周期：1-3个月
+- 止损：-10%
+
+历史胜率：65%
+平均收益：+12.3%
+```
+
+**策略2：规避减持**
+```
+警惕信号：
+- 高管大比例减持（> 持股10%）
+- 多位高管同时减持
+- 减持后继续公告减持计划
+
+操作：
+- 如有持仓，考虑卖出
+- 避免新进入
+```
+
+---
+
+### 3. 限售解禁（Share Unlock）
+
+**事件说明**：
+限售股份到期解禁，可以流通交易，通常带来抛压。
+
+**影响分析**：
+
+**解禁规模**：
+- **小规模**（< 5%流通股）：影响较小
+- **中规模**（5-20%）：有一定抛压
+- **大规模**（> 20%）：抛压明显
+
+**解禁对象**：
+- **创投/PE**：减持意愿强
+- **产业资本**：减持意愿一般
+- **核心高管**：减持意愿弱
+
+**历史规律**：
+
+```
+统计结果（近90天，30个解禁事件）：
+- 平均影响：-3.8%
+- 下跌比例：72%
+- 最大跌幅：-15.6%
+```
+
+**投资策略**：
+
+**策略1：解禁前规避**
+```
+条件：
+- 解禁规模 > 10%流通股
+- 解禁对象为创投/PE
+- 股价处于高位
+
+操作：
+- 解禁前10天减仓或清仓
+- 等待解禁后企稳再考虑
+```
+
+**策略2：解禁后抄底**
+```
+条件：
+- 解禁后股价大跌（> 15%）
+- 公司基本面良好
+- 估值合理
+
+操作：
+- 解禁后20-30天，股价企稳时介入
+- 长期持有
+```
+
+---
+
+### 4. 行业政策（Policy）
+
+**事件说明**：
+国家或地方政府发布影响特定行业的政策，如补贴、扶持、监管、限制等。
+
+**政策类型**：
+
+| 类型 | 说明 | 影响 | 示例 |
+|------|------|------|------|
+| **补贴（Subsidy）** | 财政补贴 | 利好 | 新能源汽车补贴 |
+| **扶持（Support）** | 产业支持 | 利好 | 芯片产业扶持政策 |
+| **监管（Regulation）** | 行业规范 | 利空/中性 | 教培行业"双减" |
+| **限制（Restriction）** | 行业限制 | 利空 | 地产调控 |
+
+**政策事件库**（示例）：
+
+```
+1. 新能源汽车补贴延续（2023.6）
+   - 板块：新能源
+   - 类型：补贴
+   - 影响：利好
+   - 涉及股票：比亚迪、宁德时代等
+
+2. 芯片产业扶持政策出台（2023.8）
+   - 板块：半导体
+   - 类型：扶持
+   - 影响：利好
+   - 涉及股票：中芯国际、北方华创等
+
+3. 光伏补贴退坡（2023.9）
+   - 板块：光伏
+   - 类型：补贴退坡
+   - 影响：利空
+   - 涉及股票：隆基绿能、通威股份等
+```
+
+**投资策略**：
+
+**策略1：政策利好提前布局**
+```
+流程：
+1. 关注政策动向（两会、部委文件）
+2. 政策预期阶段买入
+3. 政策正式发布前后卖出
+
+案例：
+"碳中和"政策预期（2020.9）
+→ 布局新能源板块
+→ 政策正式发布后（2020.12）板块暴涨
+→ 提前布局获利30%+
+```
+
+**策略2：政策利空规避**
+```
+原则：
+- 监管政策出台前，如有传闻，先减仓
+- 政策落地后，如超预期利空，坚决清仓
+- 等待政策冲击消化后再观察
+
+案例：
+教培行业"双减"政策（2021.7）
+→ 政策传闻阶段减仓
+→ 政策正式落地，板块暴跌
+→ 成功规避风险
+```
+
+---
+
+### 5. 其他事件
+
+**分红派息（Dividend）**：
+- 高分红股票吸引长期资金
+- 分红前后有"填权"行情
+
+**股权激励**：
+- 激励计划公告往往利好
+- 解锁条件设定的业绩目标是参考
+
+**重大合同**：
+- 大额订单、重大项目中标
+- 短期利好，关注持续性
+
+**并购重组**：
+- 停牌前有异动
+- 复牌后分化（成功或失败）
+
+---
+
+## 事件驱动选股
+
+**功能说明**：
+根据多个事件条件组合选股，找到同时符合多个利好事件的股票。
+
+**选股逻辑**：
+```
+事件评分 = 事件数量 × 事件强度
+```
+
+**示例配置**：
+
+**配置1：稳健型**
+```
+事件类型：
+✓ 业绩超预期
+✓ 高管增持
+✓ 分红派息
+
+时间范围：30天
+
+筛选结果：
+同时具备以上事件的股票，基本面和管理层信心都很强
+```
+
+**配置2：激进型**
+```
+事件类型：
+✓ 业绩超预期
+✓ 高管增持
+
+时间范围：7天
+
+筛选结果：
+近期多重利好叠加的股票，短期爆发力强
+```
+
+**使用步骤**：
+1. 进入"事件驱动" → "事件选股"
+2. 勾选事件类型（可多选）
+3. 选择时间范围
+4. 点击"开始选股"
+5. 查看选股结果
+
+---
+
+## 实战案例
+
+### 案例1：财报超预期+高管增持（双重利好）
+
+**股票**：某科技股（代码隐藏）
+
+**事件**：
+```
+2023.10.25：发布三季报，业绩超预期30%
+2023.10.28：董事长增持2000万元
+```
+
+**操作**：
+```
+2023.10.29：买入
+买入理由：
+- 业绩超预期，基本面改善
+- 高管增持，内部看好
+- 双重利好叠加
+
+持仓周期：30天
+卖出日期：2023.11.28
+收益率：+18.5%
+```
+
+**复盘**：
+事件驱动策略成功，双重利好推动股价上涨。
+
+---
+
+### 案例2：限售解禁规避（成功避险）
+
+**股票**：某消费股
+
+**事件**：
+```
+2023.9.15：公告10天后解禁，规模占流通股25%
+```
+
+**操作**：
+```
+2023.9.16：卖出全部持仓
+卖出理由：
+- 解禁规模大（25%）
+- 解禁对象为创投机构（减持意愿强）
+- 规避抛压
+
+实际走势：
+解禁后10天，股价下跌12%
+成功规避风险
+```
+
+---
+
+### 案例3：政策利好提前布局
+
+**板块**：人工智能
+
+**事件**：
+```
+2023.7：多个部委密集调研AI企业
+2023.8.10：AI产业发展规划预期升温
+```
+
+**操作**：
+```
+2023.8.12：提前布局AI板块龙头
+买入理由：
+- 政策预期强烈
+- 产业趋势向好
+- 估值合理
+
+2023.8.25：政策正式发布
+板块当日平均涨幅：+8%
+持仓30天收益：+25%
+```
+
+---
+
+## API 接口
+
+### POST /api/events/seed
+生成示例事件数据
+
+### GET /api/events/earnings/pattern
+财报发布前后统计规律
+
+**参数**：
+- `days_before`：财报前N天（1-10）
+- `days_after`：财报后N天（5-30）
+
+### GET /api/events/insider
+高管增减持跟踪
+
+**参数**：
+- `code`：股票代码（可选）
+- `days`：统计天数（30-365）
+
+### GET /api/events/unlock
+限售解禁影响分析
+
+**参数**：
+- `days`：统计天数（30-180）
+
+### GET /api/events/policy
+行业政策事件
+
+**参数**：
+- `sector`：板块名称（可选）
+- `days`：统计天数（30-365）
+
+### POST /api/events/selector
+事件驱动选股
+
+**请求体**：
+```json
+{
+  "event_types": ["earnings_positive", "insider_increase"],
+  "days": 30
+}
+```
+
+---
+
+## 注意事项
+
+1. **数据来源**：
+   - 当前版本使用模拟数据演示
+   - 实际生产需要接入东方财富、巨潮资讯等数据源
+
+2. **事件滞后性**：
+   - 公告发布到系统采集有延迟
+   - 建议盘后统一采集
+
+3. **历史规律不代表未来**：
+   - 统计规律是概率，不是确定性
+   - 需结合基本面和技术面综合判断
+
+4. **事件真实性**：
+   - 警惕虚假信息
+   - 以官方公告为准
+
+5. **风险控制**：
+   - 事件驱动策略也有失败概率
+   - 必须设置止损
+   - 控制单票仓位
+
+---
+
+## 后续优化
+
+- [ ] 接入真实事件数据源
+- [ ] 增加更多事件类型（股权激励、重大合同等）
+- [ ] 事件情绪分析（市场反应强度）
+- [ ] 事件关联分析（产业链联动）
+- [ ] 事件预警推送
+- [ ] 事件驱动策略自动回测
+- [ ] 事件日历（未来事件预告）
+- [ ] 事件影响持续时间分析
+
+---
+
+## 总结
+
+事件驱动策略是一种**基于基本面信息的量化策略**，通过统计历史规律，捕捉事件带来的投资机会。
+
+**核心优势**：
+- ✅ 有明确的事件触发点
+- ✅ 历史规律可统计验证
+- ✅ 逻辑清晰，易于执行
+- ✅ 可与技术分析结合
+
+**适合人群**：
+- 基本面投资者
+- 中长期投资者
+- 追求确定性的投资者
+
+**使用建议**：
+1. 先统计历史规律，验证有效性
+2. 结合基本面和技术面综合判断
+3. 设置止损，控制风险
+4. 跟踪事件后的股价表现，持续优化策略
+
+**开始使用**：
+进入"事件驱动" → 点击"生成示例数据" → 查看各类事件分析 → 尝试事件选股！

功能拓展/持仓归因分析深化使用说明.md

@@ -0,0 +1,526 @@
+# 持仓归因分析深化使用说明
+
+## 功能概述
+
+持仓归因分析深化模块帮助投资者深入理解盈亏来源，通过多维度分析找出投资中的优势和不足，从而改进投资策略。
+
+## 五大核心分析
+
+### 1. 选股能力 vs 择时能力
+
+**功能说明**：
+分解投资收益的两大来源，判断是"选对了股票"还是"买卖点把握好"。
+
+**指标定义**：
+
+#### 选股能力
+- **计算方法**：买入后股票的整体涨幅（持有期间市场表现）
+- **正值**：选对了股票（股票整体上涨）
+- **负值**：选错了股票（股票整体下跌）
+- **示例**：
+  ```
+  选股能力 +15%
+  → 买入的股票在持有期间平均上涨了15%
+  → 说明选股眼光不错
+  ```
+
+#### 择时能力
+- **计算方法**：买卖价格与理想价格（最低/最高）的接近度
+- **评分**：100分满分，50分为平均水平
+- **解读**：
+  - 80-100分：优秀，买在低点、卖在高点
+  - 60-80分：良好
+  - 40-60分：一般
+  - <40分：较差，追高杀跌
+- **示例**：
+  ```
+  择时能力 72分
+  → 买卖点把握较好
+  → 平均买入价接近期间低点，卖出价接近高点
+  ```
+
+**综合解读**：
+
+| 选股 | 择时 | 解读 | 改进建议 |
+|------|------|------|----------|
+| 正 | 高（>60） | 完美组合 | 继续保持 |
+| 正 | 低（<40） | 选股对但买卖点差 | 学习技术分析，改进买卖时机 |
+| 负 | 高（>60） | 股票选错了 | 改进选股逻辑，加强基本面研究 |
+| 负 | 低（<40） | 双重失误 | 系统性反思，暂停交易 |
+
+**实战案例**：
+```
+用户A：
+选股能力：+18.5%
+择时能力：45分
+
+分析：
+- 选股很好，买入的股票都大涨
+- 但买卖点把握一般，可能追高或过早卖出
+
+建议：
+- 保持选股策略
+- 学习等待回调买入
+- 设置合理的止盈点（如趋势未破不卖）
+```
+
+---
+
+### 2. 持仓时长分析
+
+**功能说明**：
+按持仓周期统计胜率和收益，找出最适合自己的持仓周期。
+
+**周期分类**：
+
+| 周期 | 定义 | 特点 |
+|------|------|------|
+| **短线** | ≤5天 | 快进快出，需要盯盘 |
+| **中线** | 6-30天 | 波段操作，适合上班族 |
+| **长线** | >30天 | 价值投资，考验耐心 |
+
+**分析维度**：
+- 交易次数
+- 胜率
+- 平均收益
+- 平均持仓天数
+- 总盈亏
+
+**使用场景**：
+
+#### 场景1：短线高手
+```
+短线（≤5天）：
+- 交易次数：50次
+- 胜率：68%
+- 平均收益：+3.2%
+
+中线（6-30天）：
+- 交易次数：10次
+- 胜率：40%
+- 平均收益：-1.5%
+
+结论：擅长短线，建议专注短线交易
+```
+
+#### 场景2：长线为王
+```
+短线（≤5天）：
+- 胜率：45%
+- 平均收益：+0.8%
+
+长线（>30天）：
+- 胜率：75%
+- 平均收益：+15.6%
+
+结论：长线胜率和收益都更高，建议降低交易频率
+```
+
+**策略建议**：
+系统会自动推荐表现最好的持仓周期：
+```
+"建议重点关注中线（6-30天），该周期胜率和收益表现最佳"
+```
+
+---
+
+### 3. 买入理由有效性验证
+
+**功能说明**：
+统计每个买入理由的胜率和收益，验证哪些理由是有效的。
+
+**理由示例**：
+- 技术突破
+- 基本面改善
+- 板块轮动
+- 超跌反弹
+- 消息驱动
+- 跟风买入
+
+**有效性判断**：
+- **有效**：胜率 > 50%
+- **无效**：胜率 ≤ 50%
+
+**实战案例**：
+
+```
+理由统计：
+
+1. 突破买入
+   - 次数：15次
+   - 胜率：73%  ✓ 有效
+   - 平均收益：+6.8%
+   - 总盈亏：+10200元
+
+2. 超跌反弹
+   - 次数：8次
+   - 胜率：62%  ✓ 有效
+   - 平均收益：+4.2%
+   - 总盈亏：+3360元
+
+3. 跟风买入
+   - 次数：12次
+   - 胜率：33%  ✗ 无效
+   - 平均收益：-2.5%
+   - 总盈亏：-3000元
+
+结论：
+- "突破买入"和"超跌反弹"是有效策略，应继续使用
+- "跟风买入"胜率低，应避免
+```
+
+**改进方向**：
+1. **放大有效理由**：增加"突破买入"的频率和仓位
+2. **避免无效理由**：彻底放弃"跟风买入"
+3. **优化理由**：将"跟风"改为"等待回调确认"
+
+---
+
+### 4. 情绪标签相关性分析
+
+**功能说明**：
+分析不同情绪状态下的交易表现，识别情绪对收益的影响。
+
+**情绪标签**：
+- **理性**：冷静分析后的决策
+- **贪婪**：追涨、加仓冲动
+- **恐惧**：恐慌性卖出
+- **纪律**：严格执行计划
+- **冲动**：未经思考的操作
+
+**实战案例**：
+
+```
+情绪统计：
+
+1. 理性
+   - 次数：20次
+   - 胜率：70%
+   - 平均收益：+5.8%
+   - 总盈亏：+11600元
+
+2. 纪律
+   - 次数：15次
+   - 胜率：67%
+   - 平均收益：+4.9%
+   - 总盈亏：+7350元
+
+3. 贪婪
+   - 次数：10次
+   - 胜率：30%
+   - 平均收益：-3.2%
+   - 总盈亏：-3200元
+
+4. 恐惧
+   - 次数：5次
+   - 胜率：20%
+   - 平均收益：-5.6%
+   - 总盈亏：-2800元
+```
+
+**情绪建议示例**：
+```
+最佳情绪状态：理性（胜率70%，平均收益5.8%）
+最差情绪状态：恐惧（胜率20%，平均收益-5.6%）
+
+建议：
+- 保持理性和纪律，避免在贪婪或恐慌时做决策
+- 设置交易计划，严格执行
+- 市场波动时暂停操作，冷静后再交易
+```
+
+**情绪管理技巧**：
+1. **交易前**：写下买入理由和预期目标
+2. **持仓中**：避免频繁看盘
+3. **出现冲动**：等待24小时再决策
+4. **大跌时**：先离开电脑，避免恐慌性卖出
+
+---
+
+### 5. 对标指数超额收益拆解
+
+**功能说明**：
+对比组合收益与沪深300指数，判断是否跑赢大盘。
+
+**指标定义**：
+
+| 指标 | 说明 |
+|------|------|
+| 组合收益 | 你的投资组合收益率 |
+| 沪深300收益 | 同期大盘收益率 |
+| **超额收益** | 组合收益 - 沪深300收益 |
+
+**超额收益解读**：
+
+| 超额收益 | 解读 | 来源分析 |
+|----------|------|----------|
+| > +5% | 显著跑赢大盘 | 选股和择时能力强 |
+| 0 ~ +5% | 小幅跑赢 | 选股能力较好 |
+| -5% ~ 0 | 小幅跑输 | 与大盘持平，可优化 |
+| < -5% | 显著跑输 | 选股或择时失误 |
+
+**实战案例**：
+
+```
+案例1：显著跑赢
+组合收益：+28.5%
+沪深300：+15.2%
+超额收益：+13.3%
+
+来源：选股能力贡献
+解读：组合表现优于大盘，说明选股和择时能力较好
+
+建议：继续保持当前策略
+```
+
+```
+案例2：显著跑输
+组合收益：-8.3%
+沪深300：+5.6%
+超额收益：-13.9%
+
+来源：选股/择时失误
+解读：组合表现明显弱于大盘，建议反思选股逻辑和买卖时机
+
+改进建议：
+1. 检查选股逻辑（是否追高、板块选择）
+2. 检查择时（是否频繁交易、追涨杀跌）
+3. 考虑指数基金作为底仓
+```
+
+```
+案例3：熊市中少亏
+组合收益：-3.2%
+沪深300：-12.5%
+超额收益：+9.3%
+
+来源：风险控制能力
+解读：熊市中跑赢大盘，说明风控做得好
+
+建议：继续保持防守策略，等待市场转暖
+```
+
+---
+
+## 完整使用流程
+
+### 步骤1：准备数据
+
+**前置条件**：
+- 至少有5笔已平仓交易
+- 交易记录包含：买入日期、卖出日期、买入理由、情绪标签
+
+**数据录入**：
+进入"组合交易" → "交易日志"，录入交易记录
+
+**必填字段**：
+- 代码、价格、数量、方向（买/卖）
+- 日期
+
+**建议填写**：
+- 买入理由（如"技术突破""超跌反弹"）
+- 情绪标签（如"理性""贪婪""恐惧"）
+
+---
+
+### 步骤2：执行分析
+
+1. 进入"组合交易" → "盈亏归因"
+2. 点击"刷新分析"
+3. 等待3-5秒
+4. 查看五大维度分析结果
+
+---
+
+### 步骤3：解读结果
+
+#### 优先查看：
+
+1. **超额收益**
+   - 是否跑赢沪深300？
+   - 如果跑输，重点看选股和择时
+
+2. **持仓时长**
+   - 哪个周期胜率最高？
+   - 调整交易频率
+
+3. **买入理由**
+   - 哪些理由有效？
+   - 放弃无效理由
+
+4. **情绪标签**
+   - 哪种情绪下表现最好？
+   - 避免情绪化交易
+
+---
+
+### 步骤4：制定改进计划
+
+**改进模板**：
+
+```
+当前问题：
+- 超额收益 -8%，跑输大盘
+- 短线胜率只有35%
+- "跟风买入"理由胜率30%
+- "贪婪"情绪下亏损严重
+
+改进计划：
+1. 选股：加强基本面研究，避免追高
+2. 周期：从短线转为中线（6-30天）
+3. 理由：放弃"跟风"，只做"突破"和"反弹"
+4. 情绪：设置交易计划，严格执行，避免冲动
+5. 目标：3个月后超额收益转正
+```
+
+---
+
+## API 接口
+
+### GET /api/portfolio/attribution
+持仓归因分析
+
+**响应**：
+```json
+{
+  "ok": true,
+  "stock_vs_timing": {
+    "ok": true,
+    "stock_ability": 15.3,
+    "timing_ability": 72.5
+  },
+  "hold_period": {
+    "ok": true,
+    "short_term": {
+      "count": 20,
+      "win_rate": 65.0,
+      "avg_return": 3.8,
+      "avg_days": 3.2,
+      "total_pnl": 7600
+    },
+    "mid_term": {...},
+    "long_term": {...},
+    "recommendation": "建议重点关注中线（6-30天）"
+  },
+  "reason_validity": {
+    "ok": true,
+    "by_reason": [
+      {
+        "reason": "突破买入",
+        "count": 15,
+        "win_rate": 73.3,
+        "avg_return": 6.8,
+        "total_pnl": 10200,
+        "effectiveness": "有效"
+      }
+    ]
+  },
+  "emotion_correlation": {
+    "ok": true,
+    "by_emotion": [...],
+    "advice": "最佳情绪状态：理性..."
+  },
+  "excess_return": {
+    "ok": true,
+    "portfolio_return": 28.5,
+    "index_return": 15.2,
+    "excess_return": 13.3,
+    "source": "选股能力贡献",
+    "interpretation": "组合表现优于大盘...",
+    "period": "2023-01-01 ~ 2024-01-15"
+  }
+}
+```
+
+---
+
+## 实战案例
+
+### 案例1：从跑输到跑赢
+
+**初始状态**：
+```
+超额收益：-10.5%
+短线胜率：38%
+主要理由：跟风买入（胜率28%）
+主要情绪：贪婪（胜率25%）
+```
+
+**改进措施**：
+1. 改为中线持仓（20天左右）
+2. 只做"突破"和"超跌反弹"
+3. 每次交易前写计划，标注"理性"
+4. 设置止损止盈，严格执行
+
+**3个月后**：
+```
+超额收益：+8.2%
+中线胜率：68%
+主要理由：突破买入（胜率70%）
+主要情绪：理性（胜率72%）
+```
+
+---
+
+### 案例2：找到自己的节奏
+
+**初始困惑**：
+不知道短线好还是长线好
+
+**数据分析**：
+```
+短线（≤5天）：
+- 胜率：48%
+- 平均收益：+1.2%
+
+中线（6-30天）：
+- 胜率：71%
+- 平均收益：+8.5%
+
+长线（>30天）：
+- 胜率：80%
+- 平均收益：+18.3%
+```
+
+**结论**：
+适合长线持有，越拿越赚
+
+**新策略**：
+- 减少交易频率
+- 选择优质股票长期持有
+- 目标持仓周期：60天以上
+
+---
+
+## 注意事项
+
+1. **数据质量**：
+   - 至少需要5笔已平仓交易
+   - 买入理由和情绪标签要真实填写
+
+2. **分析周期**：
+   - 建议每月分析一次
+   - 数据积累越多，分析越准确
+
+3. **避免过度解读**：
+   - 样本量小时结论可能不可靠
+   - 至少20笔交易后再做重大调整
+
+4. **结合市场环境**：
+   - 牛市和熊市的策略不同
+   - 分析时考虑大盘走势
+
+5. **持续改进**：
+   - 归因分析是诊断工具，不是灵丹妙药
+   - 需要根据分析结果调整策略，并持续跟踪
+
+---
+
+## 后续优化
+
+- [ ] 增加月度/季度对比
+- [ ] 支持自定义理由和情绪标签
+- [ ] 增加行业归因分析
+- [ ] 支持多个基准指数对比
+- [ ] 生成PDF归因报告
+- [ ] 历史归因数据对比（本月 vs 上月）

功能拓展/智能选股增强使用说明.md

@@ -0,0 +1,501 @@
+# 智能选股增强功能使用说明
+
+## 功能概述
+
+智能选股增强模块提供了可视化的多条件选股器，支持策略保存、历史回测、结果对比等功能，帮助投资者快速筛选符合条件的股票。
+
+## 核心功能
+
+### 1. 可视化选股器
+
+**功能说明**：
+通过拖拽式界面组合多个选股条件，无需编写代码即可完成复杂选股。
+
+**支持的条件字段**：
+
+| 字段 | 说明 | 示例条件 |
+|------|------|----------|
+| **价格类** |
+| 现价 | 最新收盘价 | > 10元 |
+| 涨跌幅 | 当日涨跌幅 | > 3% |
+| 5日涨幅 | 近5日累计涨幅 | > 10% |
+| 20日涨幅 | 近20日累计涨幅 | > 20% |
+| 60日涨幅 | 近60日累计涨幅 | < -15%（超跌）|
+| **技术指标** |
+| MA5/10/20/60 | 各周期均线 | MA5 > MA20 |
+| RSI | 相对强弱指标 | < 30（超卖）|
+| 60日分位 | 价格在60日区间的位置 | < 0.2（低位）|
+| 均线多头 | MA5>MA10>MA20 | = true |
+| MACD金叉 | MACD快线上穿慢线 | = true |
+| **量能类** |
+| 量比 | 当日量/近期均量 | > 2（放量）|
+| 成交额 | 日成交金额 | > 5亿 |
+| 连涨天数 | 连续上涨天数 | >= 3 |
+
+**支持的操作符**：
+- `>` 大于
+- `>=` 大于等于
+- `<` 小于
+- `<=` 小于等于
+
+**组合逻辑**：
+- **AND（全部满足）**：所有条件都满足才入选
+- **OR（任一满足）**：满足任意一个条件即入选
+
+**使用步骤**：
+1. 进入"选股引擎" → "智能选股器"
+2. 点击"➕ 添加条件"
+3. 选择字段、操作符、设置数值
+4. 继续添加条件（可添加多个）
+5. 选择组合逻辑（AND/OR）
+6. 点击"🔍 执行选股"
+
+**示例1：强势突破选股**
+```
+策略名称：强势突破
+逻辑：AND（全部满足）
+条件：
+1. 5日涨幅 > 10%
+2. 量比 > 2
+3. RSI < 80
+4. 成交额 > 5亿
+
+结果：筛选出短期强势且放量的股票
+```
+
+**示例2：超跌反弹选股**
+```
+策略名称：超跌反弹
+逻辑：AND
+条件：
+1. 20日涨幅 < -15%（超跌）
+2. RSI < 30（超卖）
+3. 当日涨幅 > 2%（企稳反弹）
+4. 成交额 > 3亿（有资金关注）
+
+结果：筛选出超跌后开始反弹的股票
+```
+
+---
+
+### 2. 预设策略
+
+**功能说明**：
+系统内置4个常用选股策略，可一键加载使用。
+
+#### 策略1：动量突破
+**理念**：捕捉短期强势股
+**条件**：
+- 5日涨幅 > 10%
+- 量比 > 2
+- RSI < 80
+
+**适用市场**：强势市、上涨趋势
+**风险**：追高风险，需设置止损
+
+#### 策略2：价值洼地
+**理念**：寻找低位价值股
+**条件**：
+- 60日分位 < 30%（低位）
+- 当日涨幅 > 0（企稳）
+- 成交额 > 5亿（流动性好）
+
+**适用市场**：震荡市、底部区域
+**风险**：可能继续下跌，需耐心等待
+
+#### 策略3：成长加速
+**理念**：寻找持续上涨的成长股
+**条件**：
+- 20日涨幅 > 15%
+- 均线多头 = true
+- 连涨天数 >= 2
+
+**适用市场**：牛市、趋势明确
+**风险**：涨幅过大可能回调
+
+#### 策略4：反转抄底
+**理念**：超跌后的技术反转
+**条件**：
+- 20日跌幅 < -15%
+- RSI < 30
+- 当日涨幅 > 2%
+
+**适用市场**：超跌反弹
+**风险**：可能是下跌中继，需严格止损
+
+**使用方法**：
+1. 点击"加载预设"
+2. 输入序号（1-4）
+3. 系统自动填充条件
+4. 可在预设基础上修改
+
+---
+
+### 3. 策略保存与分享
+
+**功能说明**：
+将配置好的选股策略保存到数据库，方便后续重复使用。
+
+**使用步骤**：
+1. 配置好选股条件
+2. 点击"保存策略"
+3. 输入策略描述（可选）
+4. 保存成功后获得策略ID
+
+**策略管理**：
+```
+GET /api/selector/strategies  # 获取保存的策略列表
+GET /api/selector/strategies/{id}  # 获取策略详情
+DELETE /api/selector/strategies/{id}  # 删除策略
+```
+
+**分享方式**：
+- 导出策略JSON
+- 分享策略ID
+- 复制策略配置
+
+---
+
+### 4. 选股结果回测
+
+**功能说明**：
+对选股策略进行历史回测，验证策略的有效性。
+
+**回测逻辑**：
+1. 逐日执行选股（回测期内每个交易日）
+2. 记录选中的股票
+3. 计算这些股票5日后的平均收益
+4. 统计胜率、最大收益等指标
+
+**回测指标**：
+
+| 指标 | 说明 | 优秀值 |
+|------|------|--------|
+| 平均收益 | 5日平均收益率 | > 5% |
+| 平均胜率 | 上涨股票占比 | > 60% |
+| 最佳日 | 表现最好的一天 | 参考 |
+| 最差日 | 表现最差的一天 | 避免大幅亏损 |
+
+**使用步骤**：
+1. 配置好选股条件
+2. 点击"回测验证"
+3. 输入回测天数（20-250天）
+4. 等待回测完成（约10-30秒）
+5. 查看回测结果
+
+**结果解读**：
+```
+回测结果（60天）
+- 平均收益：6.5%  ✓ 策略有效
+- 平均胜率：68%   ✓ 胜率较高
+- 最佳日：+12.3%
+- 最差日：-3.2%   ✓ 回撤可控
+
+结论：该策略在过去60天表现良好，可考虑实盘应用
+```
+
+**注意事项**：
+- 回测基于历史数据，不代表未来表现
+- 回测期应覆盖不同市场环境（牛市、熊市、震荡市）
+- 过度优化可能导致过拟合
+
+---
+
+### 5. 选股结果对比
+
+**功能说明**：
+对比今日和昨日的选股结果，识别新入选、退出、持续入选的股票。
+
+**使用场景**：
+- 发现新的投资机会（新入选）
+- 警惕风险（持续入选但开始下跌）
+- 分析策略稳定性
+
+**对比维度**：
+
+| 类型 | 说明 | 操作建议 |
+|------|------|----------|
+| **新入选** | 今日新符合条件 | 重点关注，可能是新机会 |
+| **退出** | 昨日入选，今日不符合 | 检查原因，考虑止盈/止损 |
+| **持续入选** | 连续多日符合条件 | 趋势延续，可继续持有 |
+
+**使用步骤**：
+1. 先在"智能选股器"配置策略
+2. 进入"选股结果对比"
+3. 点击"执行对比"
+4. 查看新入选、退出、持续入选的股票
+
+**实战应用**：
+```
+情况1：新入选10只，退出5只
+→ 市场活跃，有新热点
+→ 关注新入选股票
+
+情况2：新入选0只，退出15只
+→ 策略信号减弱
+→ 市场可能转向，谨慎操作
+
+情况3：持续入选30只
+→ 策略稳定
+→ 趋势延续，可放心持有
+```
+
+---
+
+## 完整使用流程
+
+### 场景1：新手快速上手
+
+**步骤**：
+1. 打开"智能选股器"
+2. 点击"加载预设" → 选择"动量突破"
+3. 点击"🔍 执行选股"
+4. 查看选股结果
+5. 点击"回测验证"，输入60天
+6. 确认策略有效后，点击"保存策略"
+
+**耗时**：5分钟
+
+---
+
+### 场景2：自定义策略开发
+
+**步骤**：
+1. 分析需求：我想找"低位企稳+放量"的股票
+2. 添加条件：
+   - 60日分位 < 0.3（低位）
+   - 当日涨幅 > 1%（企稳）
+   - 量比 > 1.5（放量）
+   - 成交额 > 3亿（流动性）
+3. 选择逻辑：AND
+4. 执行选股，查看结果
+5. 回测验证（60天）
+6. 根据回测结果调整条件
+7. 满意后保存策略
+
+**耗时**：15-30分钟
+
+---
+
+### 场景3：策略日常维护
+
+**每日流程**：
+1. 早盘前（9:00-9:25）
+   - 进入"选股结果对比"
+   - 查看新入选股票
+   - 关注退出股票（可能需要止盈/止损）
+
+2. 盘中（10:30-14:30）
+   - 观察新入选股票的表现
+   - 结合盘面验证策略
+
+3. 收盘后（15:30-16:00）
+   - 执行选股，记录结果
+   - 每周回测一次，验证策略有效性
+
+**耗时**：每日10分钟
+
+---
+
+## API 接口
+
+### POST /api/selector/run
+执行选股
+
+**请求体**：
+```json
+{
+  "strategy": {
+    "name": "强势突破",
+    "description": "短期强势+放量",
+    "logic": "and",
+    "conditions": [
+      {"field": "ret5", "operator": ">", "value": 10},
+      {"field": "vol_ratio", "operator": ">", "value": 2},
+      {"field": "rsi14", "operator": "<", "value": 80}
+    ]
+  },
+  "date": "2024-01-15"  // 可选，null表示最新
+}
+```
+
+**响应**：
+```json
+{
+  "ok": true,
+  "date": "2024-01-15",
+  "strategy": "强势突破",
+  "count": 25,
+  "results": [
+    {
+      "code": "600519",
+      "name": "贵州茅台",
+      "close": 1680.5,
+      "pct": 3.2,
+      "ret5": 12.5,
+      "ret20": 18.3,
+      "vol_ratio": 2.8,
+      "rsi14": 68.5,
+      "amount": 35.6
+    }
+  ]
+}
+```
+
+### POST /api/selector/backtest
+策略回测
+
+**请求体**：同上
+**参数**：`days`（回测天数，20-250）
+
+**响应**：
+```json
+{
+  "ok": true,
+  "strategy": "强势突破",
+  "days": 60,
+  "summary": {
+    "total_days": 42,
+    "avg_return": 6.5,
+    "avg_win_rate": 68.2,
+    "best_day": {...},
+    "worst_day": {...}
+  },
+  "daily": [
+    {
+      "date": "2023-12-01",
+      "count": 18,
+      "avg_return": 5.3,
+      "win_rate": 72.2,
+      "max_return": 15.6,
+      "min_return": -3.2
+    }
+  ]
+}
+```
+
+### POST /api/selector/compare
+对比选股结果
+
+**请求体**：
+```json
+{
+  "strategy": {...},
+  "date1": "2024-01-14",
+  "date2": "2024-01-15"
+}
+```
+
+### POST /api/selector/strategies
+保存策略
+
+**请求体**：
+```json
+{
+  "name": "我的策略",
+  "description": "策略描述",
+  "strategy": {...}
+}
+```
+
+### GET /api/selector/strategies
+获取保存的策略列表
+
+### GET /api/selector/strategies/{id}
+获取策略详情
+
+---
+
+## 高级技巧
+
+### 技巧1：多策略组合
+
+不要只依赖单一策略，建议配置3-5个不同风格的策略：
+
+```
+策略1：动量突破（激进）
+策略2：价值洼地（稳健）
+策略3：反转抄底（逆向）
+```
+
+每日执行3个策略，取交集或并集。
+
+---
+
+### 技巧2：动态调整阈值
+
+根据市场环境调整条件阈值：
+
+```
+牛市：
+- 5日涨幅 > 15%（更激进）
+- 量比 > 3
+
+震荡市：
+- 5日涨幅 > 8%（适中）
+- 量比 > 2
+
+熊市：
+- 5日涨幅 > 5%（保守）
+- 量比 > 1.5
+```
+
+---
+
+### 技巧3：结合板块分析
+
+选股后，查看"板块分析" → "强弱趋势"：
+- 优先选择强势板块的股票
+- 避开弱势板块
+
+---
+
+### 技巧4：设置后验条件
+
+选股后人工复核：
+- 查看K线形态
+- 检查基本面
+- 避开ST、*ST
+- 避开涨停板（无法买入）
+
+---
+
+## 注意事项
+
+1. **数据依赖**：
+   - 需要先在"数据中台"入库 `stock_metrics` 表
+   - 数据越完整，选股越准确
+
+2. **回测陷阱**：
+   - 历史表现不代表未来
+   - 过度优化导致过拟合
+   - 样本外测试很重要
+
+3. **实盘差异**：
+   - 回测基于收盘价，实盘有滑点
+   - 涨停板无法买入
+   - 流动性限制
+
+4. **风险控制**：
+   - 选股只是第一步
+   - 仍需设置止损止盈
+   - 控制仓位
+
+5. **策略失效**：
+   - 市场环境变化
+   - 策略被广泛使用后失效
+   - 定期回测验证
+
+---
+
+## 后续优化
+
+- [ ] 拖拽式可视化界面
+- [ ] 更多技术指标（KDJ、布林带）
+- [ ] 基本面指标（PE、ROE、营收增速）
+- [ ] 策略分享社区
+- [ ] 实时预警推送
+- [ ] 选股结果排序（按某个指标）
+- [ ] 导出选股结果
+- [ ] 批量回测多个策略
+</contents>

功能拓展/板块轮动分析使用说明.md

@@ -0,0 +1,403 @@
+# 板块轮动分析使用说明
+
+## 功能概述
+
+板块轮动分析模块帮助投资者识别市场热点板块、追踪资金流向、判断板块所处生命周期，从而把握板块轮动机会。
+
+## 五大核心功能
+
+### 1. 板块强弱趋势
+
+**功能说明**：
+展示近期（5日/10日/20日）各板块涨跌幅排名和趋势曲线。
+
+**使用场景**：
+- 快速识别强势板块和弱势板块
+- 观察板块强弱变化趋势
+- 对比不同周期的板块表现
+
+**操作步骤**：
+1. 进入"板块分析" → "强弱趋势"
+2. 切换时间周期（5日/10日/20日）
+3. 查看前15个板块的涨跌幅曲线
+
+**指标说明**：
+- **5日收益**：近5个交易日累计涨跌幅
+- **10日收益**：近10个交易日累计涨跌幅
+- **20日收益**：近20个交易日累计涨跌幅（复利计算）
+- **平均成交额**：日均成交金额
+- **波动率**：价格波动的标准差
+
+**使用技巧**：
+- 持续上涨的板块可能处于主升浪
+- 涨幅回落的板块可能进入调整期
+- 成交额放大的板块往往有资金关注
+
+---
+
+### 2. 资金流向分析
+
+**功能说明**：
+通过桑基图直观展示板块间资金流动，识别资金从哪里流出、流向哪里。
+
+**使用场景**：
+- 追踪市场热钱流向
+- 发现资金流入的新热点
+- 警惕资金流出的板块
+
+**操作步骤**：
+1. 进入"板块分析" → "资金流向"
+2. 选择统计周期（1日/3日/5日/10日）
+3. 查看桑基图和资金流入/流出排行
+
+**图表解读**：
+- **左侧**：资金净流出的板块
+- **中间**：资金池（转换枢纽）
+- **右侧**：资金净流入的板块
+- **线条粗细**：代表资金流动量
+
+**投资策略**：
+```
+顺势策略：跟随资金流入的板块
+逆向策略：关注资金流出但基本面良好的板块（可能超跌）
+```
+
+**示例**：
+```
+观察到：
+- 资金从"地产""银行"流出
+- 资金流入"半导体""新能源"
+
+解读：
+市场风格从传统周期股切换到科技成长股
+可考虑配置流入板块的龙头股
+```
+
+---
+
+### 3. 板块生命周期
+
+**功能说明**：
+判断板块当前处于哪个阶段，辅助买卖决策。
+
+**生命周期阶段**：
+
+| 阶段 | 特征 | 策略 |
+|------|------|------|
+| **启动期** | 刚开始上涨，资金流入加速 | 积极介入，低位布局 |
+| **加速期** | 持续上涨且加速，成交活跃 | 持有为主，主升浪 |
+| **衰退期** | 涨幅收窄或开始回调 | 逐步减仓，注意风险 |
+| **下跌期** | 持续下跌 | 避免介入，等待企稳 |
+| **震荡期** | 横盘整理，方向不明 | 观望，等待方向明确 |
+
+**判断依据**：
+1. **涨跌幅趋势**：
+   - 20日涨幅 > 0 且加速 → 启动期/加速期
+   - 20日涨幅 > 0 但减速 → 衰退期
+   - 20日跌幅 > 5% → 下跌期
+
+2. **成交额变化**：
+   - 近5日成交额 / 近20日成交额 > 1.2 → 资金流入
+   - < 0.8 → 资金流出
+
+3. **动量指标**：
+   - 5日涨幅 - 10日涨幅 > 0 → 加速
+   - < 0 → 减速
+
+**操作步骤**：
+1. 进入"板块分析" → "生命周期"
+2. 输入板块名称（如"半导体""新能源""医药"）
+3. 点击"分析"
+4. 查看生命周期阶段和建议
+
+**使用示例**：
+```
+板块：半导体
+阶段：加速期
+5日涨幅：+8.5%
+20日涨幅：+23.7%
+成交额变化：+45.2%
+
+解读：
+板块处于主升浪，持续上涨且加速，成交额放大明显。
+建议：持有为主，可适当加仓龙头股。
+风险：注意短期涨幅过大，设好止盈位。
+```
+
+---
+
+### 4. 龙头股识别
+
+**功能说明**：
+自动识别板块内的龙头股票（涨幅领先 + 成交额靠前）。
+
+**识别标准**：
+1. 近20日涨幅居前
+2. 日均成交额 > 5亿（流动性好）
+3. 名称包含板块关键词（简化匹配）
+
+**操作步骤**：
+1. 进入"板块分析" → "龙头股"
+2. 输入板块名称
+3. 点击"查询"
+4. 查看龙头股排名
+
+**指标说明**：
+- **现价**：最新收盘价
+- **涨跌幅**：当日涨跌幅
+- **5日涨幅**：短期表现
+- **20日涨幅**：中期表现
+- **成交额**：日均成交金额（流动性指标）
+- **量比**：当日成交量 / 近20日均量
+
+**投资策略**：
+```
+强者恒强：优先配置排名前3的龙头股
+分散持仓：龙头 + 二线股组合，平衡收益和风险
+轮动操作：龙头股涨幅过大时，切换到涨幅较小的潜力股
+```
+
+**注意事项**：
+- 当前基于名称关键词匹配，可能不完全准确
+- 实际应用建议建立股票-板块映射表
+- 龙头股不等于买入信号，需结合技术面和估值
+
+---
+
+### 5. 板块联动性分析
+
+**功能说明**：
+通过相关系数热力图，分析板块之间的联动关系。
+
+**使用场景**：
+- 发现高度相关的板块对
+- 分散投资时避免同涨同跌的板块
+- 识别产业链上下游关联
+
+**相关系数解读**：
+
+| 相关系数 | 含义 | 投资启示 |
+|----------|------|----------|
+| 0.9 - 1.0 | 极强正相关 | 几乎同涨同跌，分散效果差 |
+| 0.7 - 0.9 | 强正相关 | 联动性强，可能有产业链关系 |
+| 0.3 - 0.7 | 中度正相关 | 有一定联动性 |
+| -0.3 - 0.3 | 弱相关 | 独立性较强，分散效果好 |
+| -0.7 - -0.3 | 中度负相关 | 此消彼长 |
+| < -0.7 | 强负相关 | 跷跷板效应 |
+
+**操作步骤**：
+1. 进入"板块分析" → "联动性"
+2. 查看热力图（红色=正相关，绿色=负相关）
+3. 查看高度相关板块对列表
+
+**投资应用**：
+
+**案例1：分散投资**
+```
+如果持有"半导体"板块，
+查询发现"半导体"与"新能源"相关系数 0.85（强相关），
+则不宜同时重仓这两个板块，
+应选择相关系数 < 0.5 的板块进行分散。
+```
+
+**案例2：产业链联动**
+```
+发现"新能源汽车"与"锂电池"相关系数 0.92，
+说明产业链联动性强，
+当新能源汽车板块启动时，锂电池板块往往也会上涨。
+```
+
+**案例3：风格轮动**
+```
+发现"科技成长"与"银行地产"相关系数 -0.6（负相关），
+说明市场风格在两者间切换，
+当科技股回调时，可关注银行地产的反弹机会。
+```
+
+---
+
+## API 接口
+
+### GET /api/sector/trend
+板块强弱趋势
+
+**参数**：
+- `days`：统计天数（5-60），默认 20
+- `top_n`：返回数量（<=30），默认 15
+
+**响应**：
+```json
+{
+  "ok": true,
+  "date": "2024-01-15",
+  "days": 20,
+  "sectors": [
+    {
+      "name": "半导体",
+      "returns": {
+        "5d": 8.5,
+        "10d": 15.3,
+        "20d": 23.7
+      },
+      "avg_amount": 3520.5,
+      "volatility": 2.8,
+      "dates": [...],
+      "pcts": [...]
+    }
+  ]
+}
+```
+
+### GET /api/sector/flow
+资金流向分析
+
+**参数**：
+- `days`：统计天数（1-20），默认 5
+
+**响应**：
+```json
+{
+  "ok": true,
+  "days": 5,
+  "total_inflow": 235.8,
+  "total_outflow": 198.3,
+  "top_inflow": [["半导体", 85.6], ...],
+  "top_outflow": [["地产", 62.3], ...],
+  "sankey": {
+    "nodes": [...],
+    "links": [...]
+  }
+}
+```
+
+### GET /api/sector/lifecycle
+板块生命周期
+
+**参数**：
+- `name`：板块名称（必填）
+- `days`：分析天数（20-120），默认 60
+
+**响应**：
+```json
+{
+  "ok": true,
+  "sector": "半导体",
+  "phase": "加速期",
+  "description": "板块持续上涨且加速，成交活跃，主升浪阶段",
+  "metrics": {
+    "return_5d": 8.5,
+    "return_10d": 15.3,
+    "return_20d": 23.7,
+    "momentum": -6.8,
+    "amount_change": 45.2
+  }
+}
+```
+
+### GET /api/sector/leaders
+龙头股识别
+
+**参数**：
+- `name`：板块名称（必填）
+- `days`：统计天数（5-60），默认 20
+- `limit`：返回数量（<=30），默认 10
+
+### GET /api/sector/correlation
+板块联动性分析
+
+**参数**：
+- `days`：计算天数（20-120），默认 60
+- `top_n`：分析板块数（<=30），默认 20
+
+### GET /api/sector/summary
+板块轮动摘要
+
+**响应**：
+```json
+{
+  "ok": true,
+  "strongest_sectors": [...],
+  "weakest_sectors": [...],
+  "fund_flow": {...}
+}
+```
+
+---
+
+## 实战策略
+
+### 策略1：板块轮动捕捉法
+
+**步骤**：
+1. 每日查看"强弱趋势"，识别近5日涨幅前5的板块
+2. 进入"生命周期"，确认板块处于启动期或加速期
+3. 查看"龙头股"，选择涨幅和成交额靠前的2-3只
+4. 观察"资金流向"，确认有资金持续流入
+5. 买入并设置止盈（如+15%）和止损（如-5%）
+
+**适用市场**：
+强势市场、板块轮动明显时
+
+---
+
+### 策略2：衰退期预警法
+
+**步骤**：
+1. 持仓板块每周检查一次生命周期
+2. 若进入"衰退期"，逐步减仓50%
+3. 若5日涨幅转负，清仓离场
+4. 资金切换到处于"启动期"的新板块
+
+**适用场景**：
+板块行情见顶，及时止盈
+
+---
+
+### 策略3：联动对冲法
+
+**步骤**：
+1. 查看"联动性"，找出强负相关的板块对
+2. 同时配置两个板块，降低组合波动
+3. 如：科技（60%） + 银行（40%）
+4. 当一个板块回调时，另一个可能上涨
+
+**适用场景**：
+震荡市、追求稳健收益
+
+---
+
+## 注意事项
+
+1. **数据依赖**：
+   - 需要先在"数据中台"入库板块和资金流数据
+   - 建议每日收盘后执行一次入库
+
+2. **板块分类**：
+   - 当前使用 AkShare 的板块分类
+   - 不同数据源的板块分类可能不同
+
+3. **龙头股识别**：
+   - 目前基于名称关键词匹配
+   - 实际生产环境建议建立股票-板块映射表
+
+4. **相关性稳定性**：
+   - 相关系数会随市场环境变化
+   - 建议定期（如每月）重新计算
+
+5. **风险提示**：
+   - 板块轮动分析是辅助工具，不构成投资建议
+   - 需结合基本面、技术面综合判断
+   - 设置止损，控制风险
+
+---
+
+## 后续优化
+
+- [ ] 建立股票-板块映射表（精确匹配）
+- [ ] 增加行业指数对比
+- [ ] 板块轮动历史回测
+- [ ] 主力资金流向追踪
+- [ ] 板块估值分析（PE/PB）
+- [ ] 政策事件对板块影响分析
+- [ ] 板块强弱评分模型
+</contents>

功能拓展/盘中异动雷达使用说明.md

@@ -0,0 +1,135 @@
+# 盘中异动雷达功能说明
+
+## 功能概述
+
+盘中异动雷达是Blackdata股票终端的实时监控模块，能够在交易时间内自动检测市场异动并推送提醒。
+
+## 监控类型
+
+### 1. 快速拉升（surge）
+- **触发条件**：股价涨幅 ≥ 3%
+- **检测频率**：每60秒
+- **数据源**：实时涨幅榜前50
+
+### 2. 放量突破（volume_break）
+- **触发条件**：
+  - 量比 ≥ 3
+  - 价格上涨
+  - 突破关键位（60日分位 ≥ 95% 或突破MA20）
+- **检测频率**：每60秒
+- **数据源**：stock_metrics 表
+
+### 3. 涨停打开/炸板（limit_open）
+- **触发条件**：涨幅在 9.5% ~ 9.99% 之间
+- **检测频率**：每60秒
+- **用途**：捕捉涨停板打开的买入/卖出时机
+
+### 4. 连板股追踪（consecutive）
+- **触发条件**：连续2个及以上交易日涨停
+- **检测频率**：每60秒
+- **数据源**：历史日线数据
+
+### 5. 大单异动（big_order）
+- **状态**：功能保留，需要接入付费逐笔数据源
+- **触发条件**：单笔成交金额 ≥ 100万元
+
+## 使用方法
+
+### 自动监控（推荐）
+系统会在交易时间（周一至周五 9:30-11:30, 13:00-15:00）每60秒自动扫描，检测到异动后：
+1. 自动写入 `intraday_events` 表
+2. 自动推送到配置的通知渠道（邮件/微信）
+
+### 手动操作
+在前端"异动雷达"页面：
+- **立即扫描**：手动触发一次全市场扫描
+- **推送异动**：将未推送的异动事件立即推送
+- **查看统计**：查看今日各类异动的数量和最活跃股票
+
+## API 接口
+
+### GET /api/radar/status
+检查雷达状态（是否交易时间）
+
+### POST /api/radar/scan
+手动触发异动扫描
+- **返回**：扫描结果，包含检测到的异动数量
+
+### GET /api/radar/events
+获取最近的异动事件
+- **参数**：
+  - `hours`：时间范围（小时），默认2
+  - `limit`：最大返回数量，默认50
+
+### POST /api/radar/notify
+推送未通知的异动
+- **返回**：推送结果
+
+### GET /api/radar/stats
+获取异动统计
+- **参数**：
+  - `date`：统计日期，默认今天
+
+## 数据表结构
+
+### intraday_events
+```sql
+id              SERIAL PRIMARY KEY
+code            VARCHAR(12)         -- 股票代码
+name            VARCHAR(40)         -- 股票名称
+event_type      VARCHAR(20)         -- 事件类型
+price           FLOAT               -- 触发时价格
+pct             FLOAT               -- 涨跌幅
+volume_ratio    FLOAT               -- 量比
+amount          FLOAT               -- 金额（大单用）
+description     VARCHAR(200)        -- 描述
+detected_at     TIMESTAMP           -- 检测时间
+notified        BOOLEAN             -- 是否已推送
+```
+
+## 推送配置
+
+在 `backend/.env` 中配置以下任一渠道：
+
+```env
+# SMTP 邮件
+SMTP_HOST=smtp.example.com
+SMTP_PORT=465
+SMTP_USER=your@email.com
+SMTP_PASSWORD=your_password
+SMTP_TO=target@email.com
+
+# Server酱（微信）
+SERVERCHAN_KEY=your_key
+
+# 企业微信
+WECOM_WEBHOOK=https://qyapi.weixin.qq.com/...
+
+# PushPlus
+PUSHPLUS_TOKEN=your_token
+```
+
+## 注意事项
+
+1. **数据依赖**：
+   - 需要先执行"数据中台"的入库操作
+   - stock_metrics 表需有最新数据
+   - 连板检测依赖历史日线数据
+
+2. **性能优化**：
+   - 使用5分钟 TTL 缓存避免重复推送
+   - 非交易时间自动跳过检测
+
+3. **扩展方向**：
+   - 接入分钟线数据源提升检测精度
+   - 添加自定义监控规则
+   - 增加异动回测功能
+
+## 后续优化计划
+
+- [ ] 支持用户自定义监控条件
+- [ ] 异动发生后的历史表现统计
+- [ ] 结合AI分析给出操作建议
+- [ ] 移动端推送优化
+- [ ] 盘中异动回放功能
+</contents>

功能拓展/社区情绪监控使用说明.md

@@ -0,0 +1,546 @@
+# 社区情绪监控使用说明
+
+## 功能概述
+
+社区情绪监控模块通过爬取和分析东方财富、雪球等社区的热帖，量化散户情绪，提供反向投资指标。
+
+**核心理念**：散户情绪往往是反向指标，当市场情绪极度乐观时可能是顶部，极度悲观时可能是底部。
+
+---
+
+## 五大核心功能
+
+### 1. 情绪指数
+
+**功能说明**：
+统计社区帖子的情绪倾向（乐观/悲观/中性），计算情绪指数。
+
+**情绪分类**：
+
+| 情绪 | 关键词示例 | 判断逻辑 |
+|------|------------|----------|
+| **乐观（Bullish）** | 看多、买入、突破、暴涨、牛市 | 包含2个及以上乐观关键词 |
+| **悲观（Bearish）** | 看空、卖出、下跌、暴跌、熊市 | 包含2个及以上悲观关键词 |
+| **中性（Neutral）** | 其他 | 情绪关键词不明显 |
+
+**情绪指数定义**：
+```
+乐观比例 = 乐观帖子数 / 总帖子数 × 100%
+```
+
+**反向指标解读**：
+
+| 乐观比例 | 市场状态 | 投资建议 |
+|----------|----------|----------|
+| **≥ 80%** | 极度乐观 | ⚠️ 警惕顶部，考虑减仓 |
+| **60-80%** | 偏乐观 | 谨慎操作，不追高 |
+| **40-60%** | 中性 | 正常波动 |
+| **20-40%** | 偏悲观 | 关注机会，可适当建仓 |
+| **< 20%** | 极度悲观 | ✅ 可能是底部，积极布局 |
+
+**使用步骤**：
+1. 进入"社区情绪" → "情绪指数"
+2. 点击"采集数据"（爬取最新帖子）
+3. 点击"计算指数"
+4. 查看乐观比例和历史趋势
+
+**实战案例**：
+```
+案例1：2021年2月（牛市顶部）
+乐观比例：92%
+市场状态：极度乐观，到处都是"牛市来了""万点不是梦"
+实际走势：随后进入长达一年的调整
+
+案例2：2022年10月（熊市底部）
+乐观比例：18%
+市场状态：极度悲观，"A股药丸""永不回本"
+实际走势：随后开启反弹
+```
+
+---
+
+### 2. 热议股票排行
+
+**功能说明**：
+统计最近N天讨论量最高的股票，识别市场热点。
+
+**热度评分公式**：
+```
+热度 = 帖子数 × 10 + 评论数
+```
+
+**讨论量激增预警**：
+
+当某只股票的讨论量突然激增，往往意味着：
+
+✅ **正面信号**（早期）：
+- 新热点启动
+- 基本面改善引发关注
+- 可能是买入机会
+
+⚠️ **负面信号**（后期）：
+- 追高情绪蔓延
+- 可能接近短期顶部
+- 谨慎追高
+
+**使用技巧**：
+
+**技巧1：结合股价走势**
+```
+如果热议股票尚未大涨（涨幅 < 10%）：
+→ 可能是早期机会，值得关注
+
+如果热议股票已经暴涨（涨幅 > 30%）：
+→ 可能是追高情绪，谨慎介入
+```
+
+**技巧2：观察持续性**
+```
+连续3天以上热议 + 股价稳步上涨：
+→ 趋势较强，可跟踪
+
+突然冲上热议榜 + 股价暴涨：
+→ 情绪性炒作，风险较高
+```
+
+---
+
+### 3. 关键词云图
+
+**功能说明**：
+提取社区帖子的高频关键词，直观展示当前市场关注焦点。
+
+**关键词提取**：
+- 使用jieba分词
+- 过滤停用词
+- 统计词频
+- 生成词云可视化
+
+**市场风格识别**：
+
+通过关键词可以快速判断市场风格：
+
+**科技成长风格**：
+```
+高频词：芯片、半导体、人工智能、新能源、锂电池
+→ 市场偏好科技成长股
+```
+
+**价值防守风格**：
+```
+高频词：银行、地产、煤炭、分红、低估值
+→ 市场偏好价值股
+```
+
+**题材炒作风格**：
+```
+高频词：妖股、涨停、龙头、超短线、打板
+→ 市场投机氛围浓厚
+```
+
+**恐慌风格**：
+```
+高频词：暴跌、崩盘、止损、割肉、被套
+→ 市场恐慌，可能接近底部
+```
+
+**使用场景**：
+
+**场景1：识别热点板块**
+```
+观察到关键词："芯片" "半导体" "国产替代"
+→ 半导体板块成为焦点
+→ 可关注板块内龙头股
+```
+
+**场景2：判断市场情绪**
+```
+关键词大部分是负面词汇（暴跌、止损、割肉）
+→ 市场情绪悲观
+→ 可能是抄底机会
+```
+
+---
+
+### 4. 情绪与股价相关性
+
+**功能说明**：
+分析特定股票的社区情绪与股价涨跌的相关性，验证是否为反向指标。
+
+**相关系数解读**：
+
+| 相关系数 | 关系 | 投资启示 |
+|----------|------|----------|
+| **0.7 ~ 1.0** | 强正相关 | 情绪高涨时股价上涨，同步指标 |
+| **0.3 ~ 0.7** | 中度正相关 | 有一定同步性 |
+| **-0.3 ~ 0.3** | 弱相关 | 情绪与股价关系不明显 |
+| **-0.7 ~ -0.3** | 中度负相关 | **反向指标**，情绪越乐观越要警惕 |
+| **-1.0 ~ -0.7** | 强负相关 | **典型反向指标** |
+
+**典型案例**：
+
+**案例1：茅台（强负相关 -0.65）**
+```
+现象：
+- 股价在1800元时，社区讨论热烈，乐观情绪爆棚
+- 股价在1500元时，社区骂声一片，极度悲观
+
+结论：
+- 典型的反向指标
+- 情绪越乐观越要警惕顶部
+- 情绪越悲观越是买入机会
+
+策略：
+- 当乐观比例 > 80% 时减仓
+- 当乐观比例 < 30% 时加仓
+```
+
+**案例2：某妖股（强正相关 +0.78）**
+```
+现象：
+- 股价暴涨时，社区疯狂吹捧
+- 股价暴跌时，社区立刻转空
+
+结论：
+- 追涨杀跌的投机股
+- 情绪和股价同步
+- 不适合做反向指标
+
+策略：
+- 避免追高
+- 等待冷静后再介入
+```
+
+**使用步骤**：
+1. 进入"社区情绪" → "情绪相关性"
+2. 输入股票代码（如600519）
+3. 点击"分析"
+4. 查看相关系数和双曲线图
+5. 根据相关性制定策略
+
+---
+
+### 5. 数据采集
+
+**数据源**：
+- 东方财富股吧
+- 雪球
+- 其他社区（可扩展）
+
+**采集内容**：
+- 帖子标题
+- 帖子内容
+- 评论数
+- 浏览量
+- 发布时间
+
+**采集频率建议**：
+- **盘中**：每1-2小时采集一次
+- **盘后**：每天收盘后采集一次
+- **周末**：可暂停采集
+
+**数据处理流程**：
+```
+1. 爬取帖子
+   ↓
+2. 去重（避免重复采集）
+   ↓
+3. 情绪分析（乐观/悲观/中性）
+   ↓
+4. 关键词提取
+   ↓
+5. 股票代码提取
+   ↓
+6. 存入数据库
+   ↓
+7. 计算情绪指数
+```
+
+**注意事项**：
+
+1. **反爬限制**：
+   - 当前版本返回模拟数据
+   - 实际生产需要：
+     - 使用代理IP
+     - 模拟浏览器headers
+     - 控制请求频率
+     - 处理验证码
+
+2. **数据质量**：
+   - 过滤广告和垃圾帖
+   - 剔除机器人账号
+   - 去除重复内容
+
+3. **隐私合规**：
+   - 仅采集公开内容
+   - 不采集个人隐私信息
+   - 遵守网站robots.txt规则
+
+---
+
+## 反向投资策略
+
+### 策略1：情绪极值反转策略
+
+**核心逻辑**：
+当情绪达到极值时，往往是反转点。
+
+**操作规则**：
+
+**买入信号**：
+```
+条件：
+1. 乐观比例 < 20%（极度悲观）
+2. 关键词以负面词为主（暴跌、割肉、崩盘）
+3. 大盘或个股已经大跌（如 -20%以上）
+
+操作：
+- 分批建仓
+- 设置止损（如 -10%）
+- 耐心等待反弹
+```
+
+**卖出信号**：
+```
+条件：
+1. 乐观比例 > 80%（极度乐观）
+2. 关键词以正面词为主（暴涨、牛市、万点）
+3. 大盘或个股已经大涨
+
+操作：
+- 分批减仓
+- 落袋为安
+- 不追高
+```
+
+---
+
+### 策略2：热议股票淘金策略
+
+**核心逻辑**：
+热议股票早期可能是机会，后期可能是陷阱。
+
+**操作规则**：
+
+**早期介入**（机会）：
+```
+条件：
+1. 讨论量开始上升（首次进入前20）
+2. 涨幅尚小（< 10%）
+3. 基本面或题材有催化剂
+
+操作：
+- 小仓位试探
+- 设置止盈（如 +15%）
+- 密切跟踪
+```
+
+**后期避让**（陷阱）：
+```
+条件：
+1. 讨论量爆发（长时间霸榜前3）
+2. 涨幅已大（> 30%）
+3. 评论区一片乐观
+
+操作：
+- 不追高
+- 如有持仓考虑减仓
+- 等待回调
+```
+
+---
+
+### 策略3：关键词轮动策略
+
+**核心逻辑**：
+跟随市场关注焦点，捕捉板块轮动。
+
+**操作步骤**：
+
+1. **每周查看关键词云**
+   - 识别新出现的高频词
+   - 判断是否是新热点
+
+2. **对比上周关键词**
+   - 哪些词热度上升（新热点）
+   - 哪些词热度下降（退潮板块）
+
+3. **布局新热点**
+   - 在关键词刚开始高频时介入
+   - 选择相关板块的龙头股
+
+4. **退出退潮板块**
+   - 关键词热度下降时减仓
+   - 及时止盈
+
+---
+
+## 实战案例
+
+### 案例1：2022年4月底部（极度悲观）
+
+**情绪数据**：
+```
+乐观比例：15%
+悲观比例：68%
+热门关键词：暴跌、崩盘、割肉、套牢、熊市
+```
+
+**市场表现**：
+- 上证指数跌至2863点
+- 社区一片哀嚎
+- "永不回本"成为热词
+
+**反向操作**：
+- 分批买入指数基金
+- 买入超跌优质股
+
+**结果**：
+- 随后2个月反弹20%+
+- 情绪指标成功抄底
+
+---
+
+### 案例2：2023年9月某科技股（讨论量激增）
+
+**情绪数据**：
+```
+讨论量：从第50名冲到第3名
+涨幅：连续5天涨停
+评论区：全是"十倍股""抄底机会"
+```
+
+**反向判断**：
+- 讨论量爆发 + 已经暴涨
+- 典型的追高情绪
+- 短期风险较大
+
+**操作**：
+- 不追高
+- 等待回调后再观察
+
+**结果**：
+- 随后3天连续跌停
+- 成功避开风险
+
+---
+
+## API 接口
+
+### POST /api/sentiment/collect
+采集社区帖子
+
+**参数**：
+- `limit`：每个来源采集数量（10-200）
+
+**响应**：
+```json
+{
+  "ok": true,
+  "collected": 100,
+  "saved": 85
+}
+```
+
+### GET /api/sentiment/index
+获取情绪指数
+
+**参数**：
+- `date`：日期（可选，默认今天）
+
+**响应**：
+```json
+{
+  "ok": true,
+  "date": "2024-01-15",
+  "bullish_count": 320,
+  "bearish_count": 180,
+  "neutral_count": 150,
+  "bullish_ratio": 49.23,
+  "total_posts": 650,
+  "top_keywords": [...]
+}
+```
+
+### GET /api/sentiment/hot_stocks
+热议股票排行
+
+**参数**：
+- `days`：统计天数（1-7）
+- `limit`：返回数量（<=50）
+
+### GET /api/sentiment/wordcloud
+关键词云
+
+**参数**：
+- `days`：统计天数（1-30）
+- `top_n`：返回前N个关键词（<=100）
+
+### GET /api/sentiment/correlation
+情绪与股价相关性
+
+**参数**：
+- `code`：股票代码（必填）
+- `days`：分析天数（20-180）
+
+---
+
+## 注意事项
+
+1. **数据时效性**：
+   - 情绪数据需要每日更新
+   - 建议收盘后采集一次
+
+2. **反向指标的局限性**：
+   - 并非所有股票都是反向指标
+   - 需要结合基本面和技术面
+   - 极值信号出现后，反转可能需要时间
+
+3. **样本量要求**：
+   - 至少需要30天以上的数据
+   - 数据点越多，相关性分析越准确
+
+4. **隐私和合规**：
+   - 仅采集公开信息
+   - 不存储用户隐私
+   - 遵守网站使用条款
+
+5. **反爬应对**：
+   - 生产环境需要配置代理
+   - 控制请求频率
+   - 模拟真实用户行为
+
+---
+
+## 后续优化
+
+- [ ] 接入更多社区数据源
+- [ ] 改进情绪分析算法（使用NLP模型）
+- [ ] 增加舆情热度趋势预警
+- [ ] 支持自定义情绪关键词库
+- [ ] 增加大V影响力分析
+- [ ] 实时情绪监控（WebSocket推送）
+- [ ] 情绪异常检测（突然转向）
+- [ ] 历史情绪回测（验证有效性）
+
+---
+
+## 总结
+
+社区情绪监控是一个**反向投资利器**，通过量化散户情绪，帮助投资者：
+
+✅ **识别市场极值点**（极度乐观/悲观）
+✅ **发现热点和陷阱**（讨论量激增）
+✅ **把握板块轮动**（关键词变化）
+✅ **验证反向指标**（情绪与股价相关性）
+
+**核心理念**：
+当别人恐惧时我贪婪，当别人贪婪时我恐惧。
+
+**适合人群**：
+- 逆向思维投资者
+- 波段操作者
+- 价值投资者（择时参考）
+
+**开始使用**：
+进入"社区情绪" → 点击"采集数据" → 查看情绪指数 → 制定反向策略！

功能拓展/策略回测增强使用说明.md

@@ -0,0 +1,329 @@
+# 策略回测增强功能使用说明
+
+## 功能概述
+
+策略回测增强模块提供了完整的量化回测能力，支持多因子策略、仓位管理、参数优化和策略对比。
+
+## 四大功能模块
+
+### 1. 快速回测
+**适用场景**：简单均线交叉策略的快速验证
+
+**参数**：
+- 股票代码
+- 快线周期（如 5）
+- 慢线周期（如 20）
+
+**输出指标**：
+- 策略收益率
+- 基准收益率（买入持有）
+- 超额收益
+- 最大回撤
+- 交易次数
+- 胜率
+
+### 2. 高级回测
+**适用场景**：带仓位管理和风控的完整策略回测
+
+**策略类型**：
+- **均线交叉**：MA 金叉死叉
+- **多因子**：技术（MA5/MA20）+ 动量（RSI）+ 资金（量比）
+
+**高级参数**：
+- **仓位大小**（0-1）：每次买入占可用资金比例
+  - 1.0 = 满仓
+  - 0.5 = 半仓
+  - 0.3 = 三成仓位
+  
+- **止损比例**（%）：跌破该比例自动卖出
+  - 5 = 亏损 5% 止损
+  - 0 = 不止损
+  
+- **止盈比例**（%）：达到该比例自动卖出
+  - 10 = 盈利 10% 止盈
+  - 0 = 不止盈
+
+**完整指标**：
+- 总收益率
+- 最大回撤
+- **夏普比率**（风险调整后收益，越高越好）
+- **卡玛比率**（收益/最大回撤，越高越好）
+- 交易次数 / 已平仓次数
+- 胜率
+- **盈亏比**（平均盈利/平均亏损）
+- 平均持仓天数
+
+**交易明细**：
+- 每笔买入卖出记录
+- 持仓天数
+- 单笔盈亏和收益率
+- 买卖理由
+- 支持导出 CSV
+
+### 3. 参数优化
+**适用场景**：寻找最优参数组合
+
+**优化流程**：
+1. 定义参数网格
+   - 快线范围：如 3,5,10,15
+   - 慢线范围：如 20,30,60
+   
+2. 选择优化目标
+   - 夏普比率（推荐，平衡收益和风险）
+   - 总收益（追求最大收益）
+   - 卡玛比率（追求稳定）
+
+3. 一键优化
+   - 自动测试所有参数组合
+   - 按目标指标排序
+   - 显示前 20 个最优结果
+
+**结果展示**：
+- 参数组合排名
+- 目标指标值
+- 总收益、夏普比率、最大回撤、胜率
+
+**示例**：
+```
+输入：
+- 股票：600519
+- 快线范围：3,5,10
+- 慢线范围：20,30,60
+- 优化目标：夏普比率
+
+输出：
+排名1：快线5/慢线30，夏普2.15，收益45.2%，回撤12.3%
+排名2：快线10/慢线60，夏普1.98，收益38.7%，回撤9.8%
+...
+```
+
+### 4. 策略对比
+**适用场景**：多个策略并排对比，找出最优策略
+
+**预设对比**：
+1. MA5/20（无止损止盈）
+2. MA5/20（5% 止损，10% 止盈）
+3. MA10/30
+4. 多因子策略
+
+**对比维度**：
+- 净值曲线（多条曲线叠加）
+- 总收益率（卡片并排显示）
+- 最大回撤
+- 夏普比率
+
+## 使用示例
+
+### 示例 1：快速验证均线策略
+```
+1. 点击"快速回测"
+2. 输入代码：600519
+3. 快线：5，慢线：20
+4. 点击"回测"
+5. 查看收益率和净值曲线
+```
+
+### 示例 2：带止损止盈的策略
+```
+1. 点击"高级回测"
+2. 输入代码：600519
+3. 策略：均线交叉
+4. 快线：5，慢线：20
+5. 仓位：1.0（满仓）
+6. 止损：5%
+7. 止盈：10%
+8. 点击"高级回测"
+9. 查看完整指标和交易明细
+10. 点击"导出CSV"保存明细
+```
+
+### 示例 3：参数优化寻找最优组合
+```
+1. 点击"参数优化"
+2. 输入代码：600519
+3. 快线范围：3,5,10,15
+4. 慢线范围：20,30,60
+5. 优化目标：夏普比率
+6. 点击"开始优化"
+7. 等待 10-30 秒（取决于组合数）
+8. 查看排名前 20 的参数组合
+9. 选择最优参数重新回测验证
+```
+
+### 示例 4：策略对比
+```
+1. 点击"策略对比"
+2. 输入代码：600519
+3. 点击"对比策略"
+4. 查看 4 条净值曲线
+5. 对比各策略收益率
+6. 选择最优策略
+```
+
+## 指标说明
+
+### 夏普比率（Sharpe Ratio）
+- **含义**：风险调整后的收益
+- **公式**：(平均收益率 - 无风险利率) / 收益率标准差
+- **解读**：
+  - \> 2.0：优秀
+  - 1.0 - 2.0：良好
+  - 0.5 - 1.0：一般
+  - < 0.5：较差
+
+### 卡玛比率（Calmar Ratio）
+- **含义**：收益率 / 最大回撤
+- **解读**：
+  - \> 3.0：优秀
+  - 2.0 - 3.0：良好
+  - 1.0 - 2.0：一般
+  - < 1.0：较差
+
+### 最大回撤（Max Drawdown）
+- **含义**：从峰值到谷底的最大跌幅
+- **解读**：
+  - < 10%：低风险
+  - 10% - 20%：中等风险
+  - 20% - 30%：较高风险
+  - \> 30%：高风险
+
+### 盈亏比（Profit Factor）
+- **含义**：平均盈利 / 平均亏损
+- **解读**：
+  - \> 2.0：优秀
+  - 1.5 - 2.0：良好
+  - 1.0 - 1.5：一般
+  - < 1.0：策略无效
+
+## 策略说明
+
+### 均线交叉策略（MA）
+**原理**：
+- 快线上穿慢线 → 买入（金叉）
+- 快线下穿慢线 → 卖出（死叉）
+
+**适用市场**：趋势明确的单边市
+**不适用市场**：震荡市（易频繁止损）
+
+### 多因子策略
+**买入条件**（需同时满足）：
+- MA5 > MA20（趋势向上）
+- RSI < 70（未超买）
+- 量比 > 1.5（放量）
+
+**卖出条件**（满足任一）：
+- MA5 < MA20（趋势转弱）
+- RSI > 80（超买）
+
+**适用市场**：震荡偏多市场
+
+## API 接口
+
+### POST /api/backtest/advanced
+高级回测
+
+**请求体**：
+```json
+{
+  "symbol": "600519",
+  "strategy": "ma",
+  "fast": 5,
+  "slow": 20,
+  "position_size": 1.0,
+  "stop_loss": 5.0,
+  "take_profit": 10.0,
+  "initial_capital": 100000.0,
+  "commission": 0.0005
+}
+```
+
+**响应**：
+```json
+{
+  "ok": true,
+  "symbol": "600519",
+  "strategy": "MA5/20",
+  "dates": ["2023-01-01", ...],
+  "equity": [100000, 101200, ...],
+  "bench": [100000, 100800, ...],
+  "metrics": {
+    "total_return": 45.23,
+    "max_drawdown": 12.34,
+    "sharpe_ratio": 2.15,
+    "calmar_ratio": 3.67,
+    "trades": 15,
+    "win_rate": 66.7,
+    "profit_factor": 2.3,
+    "avg_hold_days": 12.5
+  },
+  "trades": [...]
+}
+```
+
+### POST /api/backtest/optimize
+参数优化
+
+**请求体**：
+```json
+{
+  "symbol": "600519",
+  "strategy": "ma",
+  "fast_range": [3, 5, 10, 15],
+  "slow_range": [20, 30, 60],
+  "metric": "sharpe_ratio"
+}
+```
+
+### POST /api/backtest/compare
+策略对比
+
+**请求体**：
+```json
+{
+  "symbol": "600519",
+  "strategies": [
+    {"type": "ma", "fast": 5, "slow": 20},
+    {"type": "ma", "fast": 5, "slow": 20, "stop_loss": 5, "take_profit": 10},
+    {"type": "multi_factor"}
+  ]
+}
+```
+
+## 注意事项
+
+1. **数据要求**：
+   - 需要先在"数据中台"入库历史日线数据
+   - 建议至少 1 年数据（250 个交易日）
+   - 数据越多，回测越准确
+
+2. **性能**：
+   - 快速回测：1-2 秒
+   - 高级回测：2-5 秒
+   - 参数优化：10-60 秒（取决于组合数）
+   - 策略对比：5-10 秒
+
+3. **手续费**：
+   - 默认 0.05%（双边 0.1%）
+   - 可在高级参数中调整
+
+4. **回测准确性**：
+   - 基于收盘价成交（实际会有滑点）
+   - 未考虑流动性限制
+   - 未考虑冲击成本
+   - 适合个人投资者小资金回测
+
+5. **过拟合风险**：
+   - 参数优化可能导致过拟合
+   - 建议在不同市场环境下验证
+   - 样本外测试很重要
+
+## 后续扩展
+
+- [ ] 支持分钟线回测
+- [ ] 增加更多策略（MACD、KDJ、布林带）
+- [ ] 支持组合回测（多股票）
+- [ ] 仓位管理策略（凯利公式、风险平价）
+- [ ] 滚动回测（时间窗口滑动）
+- [ ] 蒙特卡洛模拟
+- [ ] 回测报告 PDF 导出
+</contents>

功能拓展/财报深度解读使用说明.md

@@ -0,0 +1,434 @@
+# 财报深度解读使用说明
+
+## 功能概述
+
+财报深度解读模块为技术分析提供基本面支持，通过关键指标趋势、AI摘要、同行对比、异常预警等功能，帮助投资者快速理解财报质量。
+
+**核心理念**：技术分析看趋势，基本面分析看质量。两者结合，提高投资胜率。
+
+---
+
+## 五大核心功能
+
+### 1. 财报关键指标趋势
+
+**功能说明**：
+展示公司最近8个季度的核心财务指标变化趋势。
+
+**核心指标**：
+
+#### ROE（净资产收益率）
+- **定义**：净利润 / 净资产 × 100%
+- **意义**：衡量股东投资回报率
+- **优秀标准**：
+  - ≥ 20%：优秀
+  - 15-20%：良好
+  - 10-15%：一般
+  - < 10%：较差
+
+**巴菲特标准**：长期ROE ≥ 15%是优质公司的重要标准。
+
+#### 毛利率
+- **定义**：(营收 - 成本) / 营收 × 100%
+- **意义**：产品竞争力和定价权
+- **行业差异**：
+  - 软件/医药：50%+
+  - 消费品：30-50%
+  - 制造业：20-30%
+  - 零售业：10-20%
+
+**趋势判断**：
+- 毛利率上升 → 竞争力增强
+- 毛利率下降 → 竞争加剧或成本上升
+
+#### 营收增速
+- **定义**：(本期营收 - 去年同期营收) / 去年同期营收 × 100%
+- **意义**：公司成长性
+- **评判标准**：
+  - ≥ 30%：高成长
+  - 15-30%：稳健成长
+  - 0-15%：低速成长
+  - < 0%：负增长
+
+#### 净利润增速
+- **定义**：(本期净利润 - 去年同期净利润) / 去年同期净利润 × 100%
+- **意义**：盈利能力变化
+- **与营收对比**：
+  - 利润增速 > 营收增速 → 盈利能力提升
+  - 利润增速 < 营收增速 → 盈利能力下降（警惕）
+
+**使用步骤**：
+1. 进入"财报分析" → "指标趋势"
+2. 输入股票代码
+3. 点击"分析"
+4. 查看8个季度的指标变化
+5. 查看AI生成的一句话摘要
+
+**实战案例**：
+```
+贵州茅台（600519）
+
+ROE：25% → 稳定趋势
+毛利率：91% → 上升趋势
+营收增速：18% → 平稳趋势
+利润增速：19% → 上升趋势
+
+AI摘要：业绩稳步增长，ROE保持25%高位，盈利能力优秀。
+
+结论：优质公司，财务指标健康。
+```
+
+---
+
+### 2. AI财报摘要
+
+**功能说明**：
+使用AI大模型自动生成一句话财报摘要（40字以内）。
+
+**摘要要素**：
+- 业绩增长/下降趋势
+- 最亮眼或最担忧的指标
+- 简短评价（优秀/良好/一般/较差）
+
+**示例摘要**：
+
+```
+示例1（优秀）：
+业绩大幅增长，ROE达30%创新高，毛利率稳定，盈利能力优秀。
+
+示例2（一般）：
+营收增长15%，但净利润下降5%，毛利率下滑，盈利质量下降。
+
+示例3（较差）：
+营收净利双降，ROE跌至8%，费用率上升，业绩承压明显。
+```
+
+**价值**：
+- 快速了解财报核心信息
+- 节省阅读完整财报的时间
+- 适合快速筛选股票
+
+**注意**：
+- 需要配置LLM_API_KEY
+- 未配置时显示简化版摘要
+
+---
+
+### 3. 同行对比
+
+**功能说明**：
+将目标公司的财务指标与行业平均水平对比，识别优势和劣势。
+
+**对比维度**：
+
+| 指标 | 说明 | 优于行业的意义 |
+|------|------|----------------|
+| **ROE** | 盈利能力 | 投资回报更高 |
+| **毛利率** | 产品竞争力 | 定价权更强 |
+| **营收增速** | 成长性 | 市场份额扩大 |
+| **利润增速** | 盈利成长 | 利润增长更快 |
+| **资产负债率** | 财务风险 | 负债更低越好 |
+
+**评分规则**：
+- 优于行业指标 ≥ 3个 → 优于行业
+- 优于行业指标 = 2个 → 持平行业
+- 优于行业指标 ≤ 1个 → 弱于行业
+
+**实战案例**：
+
+```
+茅台 vs 白酒行业
+
+✓ ROE：25% vs 18%（+7%）
+✓ 毛利率：91% vs 75%（+16%）
+✓ 营收增速：18% vs 12%（+6%）
+✓ 利润增速：19% vs 10%（+9%）
+✗ 资产负债率：35% vs 32%（+3%）
+
+优于行业指标：4/5
+综合结论：优于行业
+
+解读：茅台在盈利能力、成长性方面显著优于行业，是白酒板块的绝对龙头。
+```
+
+**使用技巧**：
+1. 先看综合结论
+2. 重点关注优于/弱于的具体指标
+3. 结合行业特点判断（如高负债率在金融业是正常的）
+
+---
+
+### 4. 财报异常预警
+
+**功能说明**：
+自动检测财报中的5类常见异常，提前预警财务风险。
+
+**5类异常**：
+
+#### 异常1：存货激增
+- **判断标准**：存货增长 > 50%
+- **风险**：产品滞销，可能计提减值
+- **案例**：某消费股存货激增80%，半年后计提减值10亿
+
+#### 异常2：应收账款占比过高
+- **判断标准**：应收账款 / 营收 > 50%
+- **风险**：回款压力大，可能出现坏账
+- **案例**：某科技股应收占比65%，次年确认坏账5亿
+
+#### 异常3：毛利率大幅下降
+- **判断标准**：毛利率下降 > 5个百分点
+- **风险**：竞争力下降，盈利能力恶化
+- **案例**：某手机厂商毛利率从35%降至28%，股价腰斩
+
+#### 异常4：资产负债率过高
+- **判断标准**：资产负债率 > 70%
+- **风险**：财务杠杆高，偿债风险大
+- **案例**：某地产股负债率85%，爆雷后退市
+
+#### 异常5：增收不增利
+- **判断标准**：营收增长 > 10%，但净利润下降
+- **风险**：盈利质量差，成本失控
+- **案例**：某零售股营收增15%，净利润降20%，管理层被问责
+
+**风险等级**：
+- **高风险**：有高严重度异常
+- **中风险**：有中严重度异常
+- **低风险**：无异常
+
+**使用流程**：
+```
+1. 输入股票代码
+2. 点击"检测"
+3. 查看预警数量和风险等级
+4. 阅读具体异常描述
+5. 结合其他信息综合判断
+```
+
+**应对策略**：
+
+**高风险**：
+- 如有持仓，考虑减仓或清仓
+- 避免新进入
+- 等待公司解释或改善
+
+**中风险**：
+- 密切关注后续财报
+- 适当降低仓位
+- 设置止损
+
+**低风险**：
+- 财报质量良好
+- 可放心持有
+
+---
+
+### 5. 财报发布日历
+
+**功能说明**：
+展示未来30天即将发布财报的股票，提前做好准备。
+
+**使用场景**：
+
+**场景1：持仓股票财报前准备**
+```
+如果持有的股票即将发布财报：
+- 业绩确定性高 → 继续持有
+- 业绩不确定 → 减仓避险
+- 业绩预期差 → 提前清仓
+```
+
+**场景2：财报发布后介入**
+```
+关注即将发布财报的股票：
+- 业绩超预期 → 财报后1-3天买入
+- 业绩不及预期 → 避免
+```
+
+**场景3：财报密集期策略**
+```
+财报密集发布期（1月、4月、7月、10月）：
+- 整体风险偏好下降
+- 避免重仓单一股票
+- 等待业绩明朗后再操作
+```
+
+**财报时间表**：
+- **一季报**：4月1日 - 4月30日
+- **半年报**：7月1日 - 8月31日
+- **三季报**：10月1日 - 10月31日
+- **年报**：1月1日 - 4月30日
+
+---
+
+## 财报排行榜
+
+**功能说明**：
+按ROE、毛利率、营收增速等指标排名，快速找到财务优秀的公司。
+
+**排行维度**：
+
+**ROE排行**：
+- 找到最会赚钱的公司
+- 长期ROE > 20%的公司值得关注
+
+**毛利率排行**：
+- 找到最有定价权的公司
+- 高毛利率公司抗风险能力强
+
+**营收增速排行**：
+- 找到成长最快的公司
+- 高增速公司适合成长投资
+
+**使用技巧**：
+1. 先看排行榜找到候选股票
+2. 再看指标趋势确认持续性
+3. 再看同行对比确认优势
+4. 最后看异常预警确认风险
+
+---
+
+## 综合使用流程
+
+### 流程1：选股阶段
+
+```
+1. 进入"财报排行" → 按ROE排序
+   → 找到ROE > 20%的股票（20只）
+
+2. 逐个查看"指标趋势"
+   → 筛选ROE稳定或上升的股票（10只）
+
+3. 查看"同行对比"
+   → 筛选优于行业的股票（5只）
+
+4. 查看"异常预警"
+   → 排除有高风险预警的股票（3只）
+
+5. 结合技术面分析
+   → 最终选定买入标的（1-2只）
+```
+
+### 流程2：持仓检查
+
+```
+每季度财报发布后：
+
+1. 查看"指标趋势"
+   → ROE/毛利率是否下降？
+
+2. 查看"AI摘要"
+   → 业绩是否符合预期？
+
+3. 查看"异常预警"
+   → 是否出现新的风险？
+
+4. 决策：
+   - 指标恶化 + 异常预警 → 卖出
+   - 指标平稳 + 无预警 → 继续持有
+   - 指标改善 → 加仓
+```
+
+---
+
+## API 接口
+
+### POST /api/financial/seed
+生成示例财报数据
+
+### GET /api/financial/trend
+财报关键指标趋势
+
+**参数**：
+- `code`：股票代码（必填）
+- `periods`：期数（4-16，默认8）
+
+### GET /api/financial/summary
+AI财报摘要
+
+**参数**：
+- `code`：股票代码（必填）
+
+### GET /api/financial/compare
+同行对比
+
+**参数**：
+- `code`：股票代码（必填）
+- `sector`：行业（可选）
+
+### GET /api/financial/warnings
+财报异常预警
+
+**参数**：
+- `code`：股票代码（必填）
+
+### GET /api/financial/calendar
+财报发布日历
+
+**参数**：
+- `days`：未来N天（7-90，默认30）
+
+### GET /api/financial/rankings
+财报排行榜
+
+**参数**：
+- `metric`：排序指标（roe/gross_margin/revenue_growth）
+- `limit`：返回数量（<=50，默认20）
+
+---
+
+## 注意事项
+
+1. **数据来源**：
+   - 当前版本使用模拟数据演示
+   - 实际生产需要接入Wind、同花顺等财报数据源
+
+2. **财报时效性**：
+   - 财报有滞后性（季报滞后1-2个月）
+   - 结合最新公告和业绩预告
+
+3. **行业差异**：
+   - 不同行业指标标准不同
+   - 同行对比更有参考价值
+
+4. **综合判断**：
+   - 财报分析只是一个维度
+   - 需结合技术面、估值、政策等综合判断
+
+5. **AI摘要限制**：
+   - 需要配置LLM_API_KEY
+   - AI摘要仅供参考，不构成投资建议
+
+---
+
+## 后续优化
+
+- [ ] 接入真实财报数据源
+- [ ] 增加更多财务指标（现金流、ROA、ROIC等）
+- [ ] 财报对比（本期 vs 去年同期）
+- [ ] 财报预测（基于历史趋势）
+- [ ] 杜邦分析（ROE拆解）
+- [ ] 财报异常历史追踪
+- [ ] 财报发布前后股价统计
+- [ ] 支持批量筛选（按指标组合）
+
+---
+
+## 总结
+
+财报深度解读是**技术分析的重要补充**，通过基本面分析：
+
+✅ **提高选股质量**（找到优质公司）
+✅ **降低投资风险**（识别财务陷阱）
+✅ **增强持股信心**（业绩支撑）
+✅ **把握买卖时机**（财报前后策略）
+
+**核心价值**：
+让技术分析派也能快速理解财报，提高投资胜率。
+
+**适合人群**：
+- 技术分析为主的投资者（补充基本面）
+- 价值投资者（快速筛选优质股）
+- 所有投资者（规避财务风险）
+
+**开始使用**：
+进入"财报分析" → 点击"生成示例数据" → 输入股票代码 → 开始分析！