中国A股分红配股与港股分红数据 Skill（基于服务端 API）
适用场景
在以下场景下优先使用本 Skill：
- 用户提到 中国A股或港股 的公司，例如 “腾讯”、“中国平安”、“600519”、“0700.HK”
- 用户需要 分红/配股相关数据：
- 用户需要 分红/派息相关数据：
- 历史分红记录（每股派息、送股、转增）
- 分红频率（年度/中期/季度）
- 股息率、近几年分红稳定性
- 用户提到：“看某只股票的财务情况 / 分红历史 / 分红率 / 分红政策” 等类似描述
重要：本仓库 已实现分红/配股相关的 HTTP API，但 未实现财务报表接口。因此本 Skill 仅处理分红/配股与股息率相关问题；若用户要求财报数据，应明确当前仓库不支持并建议补充数据源。
使用总原则
-
统一入口，清晰步骤
- 先把用户自然语言需求转成 结构化查询条件（市场、代码/名称、时间区间、报表类型等）
- 再调用项目中 已实现的 HTTP API 获取数据
- 最后对数据进行 摘要 + 解释 + 风险提示
-
强制说明数据范围与滞后性
- 例如：财报通常是 按季/按年披露，存在滞后
- 分红为 历史行为，不等同于未来承诺
-
输出时，先结论、再细节
- 第一段先说清：盈利是否稳定、负债情况、高/低分红等
- 后面再给出关键指标表格或列表
数据访问约定（以服务端实现为准）
该服务提供 无需登录 的 REST API，用于获取港股分红与 A 股分红配股数据。所有接口均为 只读。
Base URL：http://vi-money.com/（需确认是否为实际对外地址；如未确认，调用方必须先核验协议/端口）
建议通过环境变量 STOCK_API_BASE_URL 覆盖该地址，避免硬编码。
通用响应格式（所有接口一致）
{
"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，例如（伪代码）：
# 港股：分红列表
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÷nd_yield_min=0.02÷nd_yield_max=0.08&sort_by=dividend_yield&sort_order=desc
# A股：分红配股详情
GET /api/v1/cn-stock/fhpg/detail/600519
要求：输出时说明股息率字段是 小数（如 0.04 表示 4%）。
进行分析与总结
在生成自然语言回答时，建议按以下结构组织：
-
总体概览（1 段）
- 分红是否连续、是否集中在特定年份
- 股息率区间是否稳定
- 是否存在一次性大额分红/送转
-
关键指标列表
- 近 3~5 年的分红/配股记录（按公告日期或年份简表）
- 指标示例：分红方案、股息率、除权除息日、送股/转增/配股
-
分红情况
- 是否持续分红（几年中有缺分红年份）
- 近几年平均股息率区间（例如 2%–4%）
- 特殊一次性大额分红需要单独说明
-
风险与限制说明（必选）
- 数据为历史数据，不代表未来表现
- 分红政策可能会根据经营情况变化
- 若数据存在缺失或不完整，需要明确指出
- 本仓库 不提供财报口径数据，如用户请求财报，需提示范围限制
输出格式建议
回答时优先使用 中文，并尽量结构化：
- 文字 + 项目符号列表
- 简表形式（可用 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 前，请确认：
