akshare-risk-trigger

# AKShare A股风险舆情触发 Skill

## 1. Skill 概述

这个 Skill 基于 **AKShare** 的 A 股行情、新闻、热度与风险专题数据，构建一个可执行的 **风险舆情触发机制**。它不是预测未来收益的黑盒模型，而是一个面向研究、预警和盘前/盘后巡检的规则型引擎：

- 识别 **价格风险**：大跌、波动放大、换手异常。
- 识别 **舆情风险**：个股相关新闻中的负面关键词聚集。
- 识别 **热度失衡**：热度冲高但排名恶化，或舆情过热。
- 识别 **结构性风险**：高股权质押、商誉减值预期。
- 输出 **触发等级**、**触发原因** 与 **综合风险分数**。

## 2. 数据来源

本 Skill 默认使用以下 AKShare 接口：

1. **A股历史行情**：`stock_zh_a_hist`
   - 用途：计算收益率、波动率、回撤、换手异常等。
   - 来源说明：东方财富沪深京 A 股日频历史行情。

2. **个股新闻**：`stock_news_em`
   - 用途：抓取指定股票或关键词的最近新闻，进行负面关键词计数。
   - 来源说明：东方财富指定个股新闻资讯。

3. **A股人气榜**：`stock_hot_rank_em`
   - 用途：获取当前人气排名，用作过热/拥挤度参考。

4. **个股热度历史趋势**：`stock_hot_rank_detail_em`
   - 用途：获取近期排名、新晋粉丝、铁杆粉丝等热度变化。

5. **上市公司质押比例**：`stock_gpzy_pledge_ratio_em`
   - 用途：识别高质押风险。

6. **商誉减值预期明细**：`stock_sy_yq_em`
   - 用途：识别商誉减值预期带来的财务/舆情共振风险。

7. **千股千评**：`stock_comment_em`
   - 用途：读取机构参与度、综合得分、关注指数等辅助特征。

> 建议安装 AKShare 最新版本后使用，因为 `stock_news_em`、`stock_hot_rank_detail_em` 等接口在近几个版本有过修复记录。AKShare 官方文档当前展示的版本为 **1.18.39**，官方安装建议为 `pip install akshare --upgrade`，GitHub 仓库采用 **MIT License**。

## 3. 功能

### 3.1 核心触发维度

Skill 会从 4 个维度构造风险触发项：

#### A. 行情风险触发
- **单日大跌触发**：最近一个交易日跌幅 <= 阈值（默认 -7%）
- **5日累计下跌触发**：最近 5 个交易日累计收益 <= 阈值（默认 -12%）
- **20日波动放大触发**：近 20 日波动率 / 近 60 日波动率 >= 阈值（默认 1.5）
- **换手异常触发**：最新换手率 / 过去 20 日平均换手率 >= 阈值（默认 2.0）
- **回撤触发**：最近收盘价相对 60 日最高收盘回撤 >= 阈值（默认 20%）

#### B. 舆情风险触发
- 统计最近新闻标题和摘要中的 **负面关键词**，如：
  - 立案
  - 处罚
  - 违规
  - 违约
  - 减值
  - 商誉
  - 质押
  - 暴跌
  - 亏损
  - ST
  - 问询函
  - 诉讼
  - 终止
  - 下修
- 若负面新闻占比超过阈值（默认 30%），触发 **舆情风险**。

#### C. 热度过热触发
- 当前处于人气榜前列，同时：
  - 近期排名恶化，或
  - 近几次热度波动异常，或
  - 新闻负面占比不低
- 用来识别 **“高关注 + 风险事件”** 的拥挤交易场景。

#### D. 结构性风险触发
- **高质押触发**：上市公司质押比例 >= 阈值（默认 20%）
- **商誉减值预期触发**：在对应报告期的商誉减值预期明细中出现
- **千股千评低分辅助触发**：综合得分过低，作为弱辅助信号

### 3.2 输出结果

输出字段示例：

- `symbol`：股票代码
- `as_of_date`：计算日期
- `risk_score`：0~100 的综合风险分数
- `risk_level`：`LOW` / `MEDIUM` / `HIGH` / `CRITICAL`
- `triggers`：触发项列表
- `headline_negative_ratio`：负面新闻占比
- `pledge_ratio`：质押比例（如可获取）
- `goodwill_warning`：是否存在商誉减值预期
- `latest_rank`：最新热度排名（如可获取）
- `comment_score`：千股千评综合得分（如可获取）

## 4. 目录结构

```text
akshare-a-share-risk-sentiment-trigger/
├─ skill.md
├─ LICENSE
├─ requirements.txt
└─ script/
   ├─ config.py
   ├─ utils.py
   ├─ data_loader.py
   ├─ risk_engine.py
   └─ run_skill.py
```

## 5. 使用示例

### 5.1 安装依赖

```bash
pip install -r requirements.txt
```

### 5.2 运行单只股票预警

```bash
python script/run_skill.py --symbol 603777
```

### 5.3 指定日期区间与报告期

```bash
python script/run_skill.py \
  --symbol 300750 \
  --start-date 20240101 \
  --end-date 20260313 \
  --report-date 20241231
```

### 5.4 输出为 JSON

```bash
python script/run_skill.py --symbol 002594 --output json
```

### 5.5 自定义负面关键词

```bash
python script/run_skill.py \
  --symbol 600519 \
  --negative-keywords 立案,处罚,问询函,暴雷,违约,减值
```

## 6. 触发逻辑说明

Skill 内置一个规则分值系统，默认做法如下：

- 单日大跌：+18 分
- 5日累计大跌：+16 分
- 波动放大：+12 分
- 换手异常：+10 分
- 60日大回撤：+12 分
- 负面新闻占比 >= 30%：+12 分
- 负面新闻占比 >= 50%：额外 +8 分
- 人气榜前 100 且排名恶化：+6 分
- 质押比例 >= 20%：+10 分
- 质押比例 >= 35%：额外 +8 分
- 商誉减值预期：+14 分
- 千股千评综合得分偏低：+4 分

风险等级映射：

- `0 ~ 19`：LOW
- `20 ~ 39`：MEDIUM
- `40 ~ 59`：HIGH
- `60+`：CRITICAL

你可以在 `script/config.py` 中调整阈值与打分权重。

## 7. 交易说明

1. **本 Skill 仅用于研究、监控、教学与策略辅助，不构成任何投资建议。**
2. 风险触发并不等于必然下跌，也可能对应利空兑现后的反弹阶段。
3. AKShare 的部分数据来自第三方站点，存在：
   - 接口临时失效
   - 字段变更
   - 数据延迟
   - 历史口径修正
4. 建议将本 Skill 用作 **预警系统**，而不是独立下单系统。
5. 在真实交易中，至少结合以下信息复核：
   - 公司公告
   - 交易所问询/处罚
   - 财报与预告
   - 板块环境
   - 市场整体风险偏好
6. 若用于量化回测，请先固定样本期、字段口径与接口版本，避免未来函数与幸存者偏差。
7. 热度与新闻类信号很容易放大短线噪声，建议与流动性、财务质量、事件验证机制配合使用。

## 8. 可扩展方向

- 新增公告文本解析
- 接入板块热度与资金流
- 多股票批量扫描
- 企业级消息推送（飞书 / 钉钉 / 企业微信）
- 回测模块：检验触发后 1/3/5/10 日收益分布
- LLM 摘要模块：自动生成风险说明

## 9. License

### 本 Skill 代码 License

本压缩包内除第三方依赖外的自编代码采用 **MIT License**，详见根目录 `LICENSE`。

### 第三方依赖说明

- **AKShare** 官方仓库采用 **MIT License**。
- 通过 AKShare 获取的数据，仍需遵守 AKShare 与其上游数据源的使用约束。
- 使用者应自行确认对第三方数据源的合规使用边界，尤其是在商业环境、再分发、缓存和高频采集场景下。