---
name: dividend-stability-score
description: "5 维综合分红稳定性评分 0-100 (派息年数/CAGR/波动/最近/连续) + 5 星等级. 用于 A 股 — 港美股可扩展 (占位)"
version: 1.0.0
type: reference
---

# 分红稳定性评分 (Stability Score)

**用户原话** (2026-07-22): 推送要加**分红稳定性**,综合评分。

## 设计 (5 维, 100 分总分)

| 维度 | 分值 | 说明 |
|------|------|------|
| **派息年数** | 30 | 派过 15 年满分 |
| **派息 CAGR** | 20 | 最新/最早比, 复合年增长 ≥10% 满分 |
| **波动率**(CV) | 25 | 派息标准差/均值, ≤0.2 满分 |
| **最近 ≥ 上次** | 15 | `latest_div >= prev_div` |
| **连续性** | 10 | 最近 3 年都派 |

## 等级 (0-100 → 1-5 星)

| 分数 | 等级 | 标签 |
|------|------|------|
| 80-100 | 5★ | 长期稳定 |
| 60-79 | 4★ | 基本稳定 |
| 40-59 | 3★ | 不稳定 |
| 20-39 | 2★ | 风险大 |
| 0-19 | 1★ | 不推荐 |

## 实现 (`dividend_alert.py` 已部署)

```python
def score_dividend_stability(symbol: str, market: str) -> dict:
    """返回: {"score": 75, "level": 4, "label": "基本稳定", "years": 10, "cagr": 5.2, "cv": 0.3, "latest_div": 3.5}"""
    try:
        if market != "CN":
            return None  # 暂时只 A 股 (akshare)

        import akshare as ak
        code = symbol.replace(".SH", "").replace(".SZ", "").replace(".BJ", "")
        df = ak.stock_history_dividend_detail(symbol=code, indicator="分红")
        if df is None or len(df) < 3:
            return None

        df = df[df["进度"] == "实施"].copy()
        df["派息"] = pd.to_numeric(df["派息"], errors="coerce")
        df = df.dropna(subset=["派息"])
        df = df[df["派息"] > 0]
        if len(df) < 3:
            return None

        df["年份"] = pd.to_datetime(df["公告日期"]).dt.year
        df = df.sort_values("年份", ascending=False).reset_index(drop=True)
        years_count = df["年份"].nunique()
        latest_div = df["派息"].iloc[0]
        oldest_div = df["派息"].iloc[-1]

        years_score = min(30, years_count * 2)  # 15 年满分

        if years_count >= 2 and oldest_div > 0:
            cagr = (latest_div / oldest_div) ** (1 / (years_count - 1)) - 1
            if cagr >= 0.10: cagr_score = 20
            elif cagr >= 0.05: cagr_score = 15
            elif cagr >= 0.02: cagr_score = 10
            elif cagr >= 0: cagr_score = 5
            else: cagr_score = 0
        else:
            cagr = 0
            cagr_score = 0

        if len(df) >= 3:
            mean_div = df["派息"].mean()
            std_div = df["派息"].std()
            cv = std_div / mean_div if mean_div > 0 else 1
            if cv <= 0.2: vol_score = 25
            elif cv <= 0.4: vol_score = 20
            elif cv <= 0.6: vol_score = 15
            elif cv <= 0.8: vol_score = 10
            else: vol_score = 5
        else:
            cv = 1
            vol_score = 5

        recent_score = 15 if (len(df) >= 2 and df["派息"].iloc[0] >= df["派息"].iloc[1]) else 5
        consecutive_score = 10 if (years_count >= 3 and len(df["年份"].head(3).unique()) >= 3) else 0

        total = years_score + cagr_score + vol_score + recent_score + consecutive_score
        if total >= 80: level, label = 5, "长期稳定"
        elif total >= 60: level, label = 4, "基本稳定"
        elif total >= 40: level, label = 3, "不稳定"
        elif total >= 20: level, label = 2, "风险大"
        else: level, label = 1, "不推荐"

        return {"score": total, "level": level, "label": label, "years": years_count, "cagr": cagr * 100, "cv": cv, "latest_div": latest_div}
    except Exception as e:
        print(f"  [WARN] score_dividend_stability {symbol} failed: {e}", file=sys.stderr)
        return None
```

## 推送格式

集成到 `dividend_alert.py` fmt():

```
600033 福建高速 [3★不稳定 25年CAGR-2%]
    💰每10股派0.71元 | 📊3.53 | 股息率 2.01%
```

格式: `[<level>★<label> <years>年CAGR<cagr:+int>%]` 在股票名后, 派息行前。

## 缓存 (避免重复 akshare 调用)

```python
_stability_cache = {}

def score_dividend_stability(symbol, market):
    cache_key = f"{market}:{symbol}"
    if cache_key in _stability_cache:
        return _stability_cache[cache_key]
    ...
    _stability_cache[cache_key] = result
    return result
```

**为什么**:dividend_alert.py 跑 1 次 12 只 A 股, 每次 23 秒。AKShare 历史派息 API 1 只 1-2 秒。**12 只 × 1.5s = 18 秒纯 akshare 调用**。用 cache 减少到 0 (单次 cron 内重复)。

## 限制

- **A 股只**(akshare 历史数据完整, HK/US 缺)
- **要 ≥ 3 年派息** 才评分 (样本不足跳过, 显示没标签)
- **CAGR 受疫情/异常影响大**(2020+ 多数公司派息都降, CAGR 全负)。**以后经济恢复, 这部分会变好**。

## 实际效果 (2026-07-22 测试)

| 股票 | 分数 | 等级 | 年数 | CAGR |
|------|------|------|------|------|
| 河钢股份 | 4★ | 基本稳定 | 22年 | -12% |
| 福建高速 | 3★ | 不稳定 | 25年 | -2% |
| 南玻 A | 3★ | 不稳定 | 31年 | -4% |

**注意**:CAGR 全负是因为疫情后多数公司派息下降——**4★ 河钢 22 年 CAGR -12% 还是"基本稳定"**, 当前阈值偏松。等经济恢复后再调严。

## 调参选项

如果觉得阈值不对:
- **调严** 改分数区间(比如 `total >= 90 → 5★`)
- **调 CAGR 权重** 改 `cagr >= 0.10` 等条件
- **加新维度**: 派息比率(payout ratio)= `派息/净利润`, 现金流覆盖 = `经营现金流/派息`

如果要扩到港美股, 需要单独 API:
- **港股**: AKShare 没历史, 用 `ccxt` 或 `yfinance` 替代
- **美股**: `yfinance` 的 `.dividends` 列 (但只含过去 5 年)