CHANGELOG.md

# CHANGELOG

## v3.1.0 (2026-05-23)

### AI舆情深度分析 + 高级技术指标(10种) + 自选股增强

**新增 3 个核心模块，2468 行代码，16 个 CLI 参数。**

#### 1. AI 舆情深度分析 — `analysis/ai_sentiment.py`（750+ 行）

- 🆕 **大模型事件解读** — 集成 DeepSeek API，自动分析事件本质、影响路径、受益/受损板块
- 🆕 **事件→板块→个股影响链** — 7种事件类型自动映射：
  - AI芯片 / 新能源 / 政策利好 / 业绩公告 / 制裁 / 降息 / 地缘政治
  - 每种类型包含：关联板块、影响方向、典型持续时间、风险因素、相关个股
- 🆕 **热搜热度预测** — EWMA 指数加权移动平均 + 趋势外推 + 自然衰减
  - 扩散路径分析：上升期 / 高峰期 / 衰退期判定
  - 峰值日期、衰退速度、未来3天预测
- 🆕 **水军识别与脱水** — 5种检测维度：
  - 关键词异常模式（纯数字/纯英文/含URL/重复字符）
  - 热度异常（超过同排名5倍）
  - 多平台一致性（多平台出现但热度极低）
  - 关键词长度异常
  - 广告/营销词汇
- 🆕 **多模态舆情分析** — 视频字幕情绪分析 + 股票代码/板块实体识别
- 🆕 **综合舆情报告** — 脱水→事件分析→板块影响汇总→整体情绪评分
- 🆕 **增强情绪词典** — 强度修饰词乘数效应（大/巨/暴/狂/猛/急/新/创/连/持续/罕见/史无前例）
- 🆕 CLI: `--ai-sentiment` 舆情全景分析
- 🆕 CLI: `--ai-predict KEYWORD` 热搜热度预测
- 🆕 CLI: `--ai-video TEXT` 视频字幕舆情分析

#### 2. 高级技术指标体系 — `analysis/advanced_technical.py`（700+ 行）

- 🆕 **STC 趋势加速器** — MACD + 随机指标组合，0-100，>75超买 / <25超卖
- 🆕 **CHOP 震荡探测器** — 趋势 vs 震荡判断，>61.8震荡市 / <38.2趋势市
- 🆕 **VZO 量能透视仪** — 方向性成交量分析，>40充沛 / <-40枯竭
- 🆕 **CMF 资金扫描仪** — Chaikin Money Flow，>0.05流入 / <-0.05流出
- 🆕 **OBV 能量潮** — 累积成交量方向 + 顶底背离检测（价跌量升/价升量降）
- 🆕 **布林带** — 上中下轨 + 带宽 + %B + 收窄变盘信号检测
- 🆕 **ATR 平均真实波幅** — 波动率等级（低/中/高/极高） + 1倍/2倍止损参考价
- 🆕 **多指标组合信号** — 10指标综合多空评分 + 置信度 + 关键信号列表
- 🆕 **趋势质量评估** — 20日线性回归斜率 + 上涨天数一致性 + 量价配合度 + MACD柱状图加速度 → 0-100分
- 🆕 **筹码分布分析** — 成交量加权均价(VWAP) + 主力成本估算 + 集中度 + 5档价格分布
- 🆕 CLI: `--technical CODE` 全套分析
- 🆕 CLI: `--stc/--chop/--vzo/--cmf/--obv/--bollinger/--atr CODE` 单指标查询
- 🆕 CLI: `--trend-quality CODE` 趋势质量评估
- 🆕 CLI: `--chips CODE` 筹码分布分析
- 🆕 CLI: `--combo-signal CODE` 多指标组合信号

#### 3. 自选股功能增强 — `analysis/watchlist_pro.py`（550+ 行）

- 🆕 **分组收益计算** — 每个分组的：
  - 平均收益 / 最高收益 / 最低收益
  - 年化收益率（假设N天收益外推全年）
  - 最大回撤（峰值到谷底）
  - 夏普比率（风险调整后收益）
- 🆕 **持仓风险评估** —
  - 行业集中度 HHI 指数（>0.35高度集中 / <0.2分散）
  - 个股风险评分（0-100，基于波动率+回撤+量能异常）
  - 风险等级：高风险/中等风险/低风险
  - 风险摘要自动生成
- 🆕 **智能预警升级** — 4种预警类型：
  - 价格突破：20日新高/新低
  - 放量异常：5日均量 > 3倍20日均量
  - 缩量异常：5日均量 < 0.3倍20日均量
  - 涨跌停临近：涨跌幅 >= 8%
  - 按严重度排序：critical > warning > info
- 🆕 **多股对比分析** — 横向对比排名：
  - 总收益 / 波动率 / 最大回撤 / 量能变化
  - 区间最高价 / 区间最低价
  - 最佳/最差股票标注
- 🆕 CLI: `--compare CODES` 多股对比（逗号分隔）
- 🆕 CLI: `--risk CODES` 持仓风险评估（逗号分隔）
- 🆕 CLI: `--group-returns` 自选股分组收益计算
- 🆕 CLI: `--advanced-alerts` 智能预警检查

#### 4. 版本与文档
- 🔧 版本升级至 v3.1.0（config.py / _meta.json）
- 📝 更新 README.md / SKILL.md / CHANGELOG.md

---

## v3.0.0 (2026-05-23)

### 重大架构重构：实时监控 + Web Dashboard + 缓存加速 + 交易日历

**新增 6 个核心模块，架构从单文件重构为模块化。**

#### 1. 实时监控
- 🆕 `--watch N` 实时监控模式，每 N 秒自动刷新终端
- 🆕 终端清屏重绘，支持 Ctrl+C 退出
- 🆕 最小 5 秒间隔保护

#### 2. Web Dashboard
- 🆕 `--web` 启动 Flask Web 大屏（默认端口 8502）
- 🆕 `--web-port` 自定义端口
- 🆕 暗色主题 Dashboard，Chart.js 图表
- 🆕 股票搜索框，实时查询个股
- 🆕 11 个 RESTful API 端点
- 🆕 自动刷新交易状态

#### 3. 数据管道（缓存 + 速率限制）
- 🆕 会话级 LRU 缓存（TTL 5分钟，最大 128 条）
- 🆕 `@cached` 装饰器自动缓存函数返回值
- 🆕 `ak_call_with_cache()` 包装 AKShare 调用，全市场数据只拉一次
- 🆕 滑动窗口速率限制器（10次/秒），防止 AKShare 被封
- 🆕 `@rate_limited` 装饰器
- 🆕 HTTP 客户端：连接复用 + 指数退避重试 + 429 限流处理

#### 4. 交易日历
- 🆕 内置 2024-2027 年 A 股休市日（含法定节假日调休）
- 🆕 `is_trading_day()` 精确判断（不再只看周末）
- 🆕 `get_last_trading_day()` / `get_next_trading_day()`
- 🆕 `market_is_open()` 判断当前是否在交易时间
- 🆕 `get_market_phase()` 返回 pre_market/morning/lunch_break/afternoon/post_market/closed
- 🆕 `format_trading_status()` 可读交易状态

#### 5. 架构重构
- 🆕 `config.py` — 全局配置单一源（版本号/权重/阈值/端口）
- 🆕 `engine.py` — 数据编排引擎（12线程并行采集 + 缓存去重）
- 🆕 `cli.py` — CLI 入口（从 analyzer.py 900 行拆出）
- 🆕 `renderers/text.py` — 文本渲染器
- 🆕 `renderers/markdown.py` — Markdown 渲染器
- 🆕 `data_pipeline.py` — 缓存 + HTTP + 速率限制
- 🆕 `holiday.py` — 交易日历
- 🆕 `web/` — Flask Dashboard + API
- 🔧 `analyzer.py` 改为薄包装，向后兼容
- 🔧 `utils/common.py` 精简

#### 6. 系统状态
- 🆕 `--status` 显示交易状态 + 缓存统计 + 速率限制状态

#### 7. 格式化工具
- 🆕 `format_pct()` / `format_mv()` 百分比/市值格式化

---

## v2.5.0 (2026-05-19)

### 全面升级：多平台热搜 + 资金深度 + 个股画像 + HTML报告 + 自动化

#### 数据源与热搜
- 🆕 5大平台热搜（微博/东方财富股吧/雪球/抖音/知乎）
- 🆕 `--platforms` 按平台筛选
- 🆕 热搜情绪分析 + 关联事件提取
- 🆕 黑名单过滤 + 模糊/精确匹配组合
- 🆕 代理池支持

#### 资金与行情
- 🆕 北向资金增强：十大成交股 + 行业流向 + 持仓变动
- 🆕 主力/游资/散户拆分 + 大单/中单/小单
- 🆕 龙虎榜集成
- 🆕 恐慌贪婪指数 + 两融余额 + 涨跌停分位

#### 自选股
- 🆕 批量导入导出（TXT/CSV）+ 分组管理
- 🆕 实时预警 + 每日简报

#### 个股画像
- 🆕 基本面 + 技术面 + 资金面 + 消息面
- 🆕 MACD/KDJ/RSI/MA 技术指标
- 🆕 异常检测（成交量/换手率/振幅/连涨连跌）

#### 板块分析
- 🆕 板块强度评分（满分100）
- 🆕 多周期轮动（7/14/30天）
- 🆕 板块内部分化（龙头/跟风/掉队）
- 🆕 概念细分（9大概念 50+ 细分赛道）
- 🆕 行业基本面（PE/PB）

#### 输出与自动化
- 🆕 交互式 HTML 报告（Chart.js 图表）
- 🆕 Webhook 推送（钉钉/企微/飞书）
- 🆕 定时任务 + 本地归档
- 🆕 AKShare 适配层

---

## v2.0.0 (2026-05-12)

- 🆕 `--stock` 单只股票查询
- 🆕 `--watchlist` 自选股模式
- 🆕 `--md` Markdown 格式导出
- 🆕 市场情绪指标（涨跌比、涨跌家数）
- 🆕 板块轮动分析（近3天对比）
- 🆕 非交易日/盘前自动提示
- 🆕 ThreadPoolExecutor 并行数据抓取
- 🔧 北向资金列名兼容容错
- 🔧 板块领涨数据容错

## v1.1.0 (2026-05-01)

- 🌊 北向资金数据（沪股通/深股通净买入）
- 📉 `--trend` 大盘5日趋势
- 🔍 关键词匹配增强（50+ 行业/板块关键词）
- 📅 本地快照缓存 + 历史对比

## v1.0.0 (2026-05-01)

- 🚀 首发：微博热搜抓取 + A股行情 + 关联分析