中国A股分红配股与港股分红数据 Skill（基于服务端 API）#

适用场景#

在以下场景下优先使用本 Skill：

• 用户提到 中国A股或港股 的公司，例如 “腾讯”、“中国平安”、“600519”、“0700.HK”

• 用户需要 分红/配股相关数据：

  • A股分红配股列表与详情
  • 港股分红列表与详情

• 用户需要 分红/派息相关数据：

  • 历史分红记录（每股派息、送股、转增）
  • 分红频率（年度/中期/季度）
  • 股息率、近几年分红稳定性

• 用户提到： “看某只股票的财务情况 / 分红历史 / 分红率 / 分红政策” 等类似描述

重要：本仓库 已实现分红/配股相关的 HTTP API，但 未实现财务报表接口。因此本 Skill 仅处理分红/配股与股息率相关问题；若用户要求财报数据，应明确当前仓库不支持并建议补充数据源。

---

使用总原则#

1. 统一入口，清晰步骤
   • 先把用户自然语言需求转成 结构化查询条件（市场、代码/名称、时间区间、报表类型等）
   • 再调用项目中 已实现的 HTTP API 获取数据
   • 最后对数据进行 摘要 + 解释 + 风险提示
2. 强制说明数据范围与滞后性
   • 例如：财报通常是 按季/按年披露，存在滞后
   • 分红为 历史行为，不等同于未来承诺
3. 输出时，先结论、再细节
   • 第一段先说清：盈利是否稳定、负债情况、高/低分红等
   • 后面再给出关键指标表格或列表

---

数据访问约定（以服务端实现为准）#

该服务提供 无需登录 的 REST API，用于获取港股分红与 A 股分红配股数据。所有接口均为 只读。

Base URL： http://vi-money.com/（需确认是否为实际对外地址；如未确认，调用方必须先核验协议/端口） 建议通过环境变量 STOCK_API_BASE_URL 覆盖该地址，避免硬编码。

通用响应格式（所有接口一致）#

json

{
  "code": 0,
  "message": "ok",
  "data": {}
}

• code = 0 表示成功
• code = 400/404/500 表示错误（缺参、未找到、服务端错误）
• 错误时 data 通常为 null

港股分红 API（ /api/v1/hk-stock）#

• GET /api/v1/hk-stock/dividend
  • 说明：港股分红列表（每只股票仅保留最新一条记录）
  • 查询参数： page、 limit、 keyword、 sort_by、 sort_order
  • 默认排序： sort_by=announce_date， sort_order=desc
  • 返回： data.list、 data.total
• GET /api/v1/hk-stock/dividend/detail/:code
  • 说明：某只港股完整分红历史（按公告日降序）
  • 参数： :code（如 0700）
  • 返回： data.code、 data.list

港股分红字段说明（ models/hk_dividend_detail.go）

• code：股票代码
• name：股票名称（由 hk_stock_code 关联补充）
• fiscal_year：财年
• announce_date：公告日期
• ex_date：除权除息日
• dividend_plan：分红方案文本
• distribution_type：派息类型
• transfer_deadline：过户截止日
• payout_date：派息日

A 股分红配股 API（ /api/v1/cn-stock）#

• GET /api/v1/cn-stock/fhpg
  • 说明：A 股分红配股列表（分页 + 联合搜索）
  • 查询参数： page、 limit、 code、 name、 plan_progress、 bonus_type、 cash_div、 share_div、 allotment、 dividend_yield_min、 dividend_yield_max、 announcement_year、 sort_by、 sort_order
  • 默认排序： sort_by=dividend_yield， sort_order=desc
  • 返回： data.list、 data.total
• GET /api/v1/cn-stock/fhpg/detail/:code
  • 说明：某只 A 股分红配股详情（按最新公告日期降序）
  • 参数： :code（如 600519）
  • 返回： data.code、 data.name、 data.list

A 股分红配股列表字段说明（ models/stock_fhps_em.go）

• code：股票代码
• name：股票名称
• latest_announcement_date：最新公告日期（列表每只股票只保留一条）
• report_date：报告期
• plan_progress：方案进度（如预案/已实施/已通过）
• bonus_type：送转类型
• cash_div：派息文本
• share_div：送股文本
• allotment：配股文本
• dividend_yield：股息率（小数）
• ex_dividend_date：除权除息日
• net_profit_yoy：净利润同比（可能为空）
• 其他字段（如 eps、 navps、 transfer_ratio 等）保留但一般不作为首要摘要

A 股分红配股详情字段说明（ models/stock_fhps_detail_em.go）

• latest_announcement_date：最新公告日期（排序与图表横轴）
• report_date：报告期末日期
• plan_progress：方案进度
• bonus_type：送转类型
• cash_div：派息
• share_div：送股
• allotment：配股
• dividend_yield：股息率（小数）
• content：详情正文（可能较长）
• analysis：分析文本（可能较长）
• images_json：图片/图表 URL 或 JSON

---

操作流程#

1. 解析用户意图#

从用户问题中抽取：

• 市场：A股 / 港股

  • 若用户说 “600519”“贵州茅台”，默认 A股（CN）
  • 若说 “0700.HK”“腾讯控股”，默认 港股（HK）

• 标的：股票代码或公司名称

  • 可在项目内实现名称到代码的映射：如 resolve_symbol(name_or_code)

• 时间范围：

  • 若未指定，默认 近 3~5 年分红记录
  • A 股列表可用 announcement_year 限定公告年

• 数据类型：

  • 分红：历史分红记录、股息率、分红稳定性等
  • 配股/送转：送股、转增、配股信息

2. 调用数据接口#

按意图调用对应 HTTP API，例如（伪代码）：

text

# 港股：分红列表
GET /api/v1/hk-stock/dividend?page=1&limit=20&keyword=腾讯&sort_by=announce_date&sort_order=desc

# 港股：分红详情
GET /api/v1/hk-stock/dividend/detail/0700

# A股：分红配股列表（按股息率过滤）
GET /api/v1/cn-stock/fhpg?page=1&limit=20&dividend_yield_min=0.02&dividend_yield_max=0.08&sort_by=dividend_yield&sort_order=desc

# A股：分红配股详情
GET /api/v1/cn-stock/fhpg/detail/600519

要求：输出时说明股息率字段是 小数（如 0.04 表示 4%）。

---

进行分析与总结#

在生成自然语言回答时，建议按以下结构组织：

1. 总体概览（1 段）
   • 分红是否连续、是否集中在特定年份
   • 股息率区间是否稳定
   • 是否存在一次性大额分红/送转
2. 关键指标列表
   • 近 3~5 年的分红/配股记录（按公告日期或年份简表）
   • 指标示例：分红方案、股息率、除权除息日、送股/转增/配股
3. 分红情况
   • 是否持续分红（几年中有缺分红年份）
   • 近几年平均股息率区间（例如 2%–4%）
   • 特殊一次性大额分红需要单独说明
4. 风险与限制说明（必选）
   • 数据为历史数据，不代表未来表现
   • 分红政策可能会根据经营情况变化
   • 若数据存在缺失或不完整，需要明确指出
   • 本仓库 不提供财报口径数据，如用户请求财报，需提示范围限制

---

输出格式建议#

回答时优先使用 中文，并尽量结构化：

• 文字 + 项目符号列表
• 简表形式（可用 Markdown 表格，但要简洁）

示例输出结构（示意）：

markdown

**结论概览**

- 公司近 5 年收入和净利润整体呈上升趋势，盈利能力较为稳定。
- 净利率保持在 20% 左右，ROE 在 15%–18% 区间，盈利质量较好。
- 资产负债率约 40%–45%，杠杆水平适中。

**近 5 年分红/配股记录（示意）**

| 公告日 | 分红方案 | 股息率 | 除权除息日 | 送股 | 转增 | 配股 |
| ------ | -------- | ------ | ---------- | ---- | ---- | ---- |
| 2024-xx-xx | ... | ... | ... | ... | ... | ... |
| 2023-xx-xx | ... | ... | ... | ... | ... | ... |

**分红情况（近 5 年）**

- 共实施现金分红 X 次，其中 Y 年连续分红。
- 近 5 年平均股息率约 Z%，最高年份约 W%。
- 分红较为稳定 / 存在停牌或暂停分红年份，需要注意。

**风险提示**

- 以上数据均为历史披露数据，不构成投资建议。
- 分红政策可能随公司经营环境和董事会决策调整。
- 本仓库不提供财报与预测，请结合其他数据源单独分析。

---

示例对话用法#

示例 1：查看港股公司分红历史

用户： “帮我看看 0700.HK 这家公司最近几年的分红情况，股息率大概多少？”

• 解析：市场=HK，代码=0700.HK，需求=分红历史 + 股息率
• 调用： GET /api/v1/hk-stock/dividend/detail/0700
• 输出：总结近几年是否分红、分红方案、股息率区间、是否稳定

示例 2：对比A股公司财务与分红

用户： “把贵州茅台最近 5 年的盈利情况和分红情况总结一下。”

• 解析：市场=CN，symbol=600519（通过名称解析）
• 调用： GET /api/v1/cn-stock/fhpg/detail/600519
• 输出：总结分红/配股频率与股息率

---

开发者检查清单#

在项目里真正启用本 Skill 前，请确认：

• 已实现 分红数据接口（含分红金额、股息率等关键字段）

• 函数、结构体、字段均有清晰中文注释，说明 单位/币种/比例含义

• 若使用外部数据源（聚宽、TuShare、券商 API 等），已处理好：

  • 鉴权/Token 管理
  • 调用频率限制
  • 网络错误与数据缺失的容错

• 本 SKILL.md 内容已根据真实实现的函数名/字段名进行同步调整