中国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 覆盖该地址，避免硬编码。
通用响应格式（所有接口一致）
CODEBLOCK0
- -
code = 0 表示成功 - INLINECODE3 表示错误（缺参、未找到、服务端错误）
- 错误时
data 通常为 INLINECODE5
港股分红 API（/api/v1/hk-stock）
- 说明：港股分红列表（每只股票仅保留最新一条记录）
- 查询参数：
page、
limit、
keyword、
sort_by、
sort_order
- 默认排序：
sort_by=announce_date，
sort_order=desc
- 返回：
data.list、
data.total
- 说明：某只港股完整分红历史（按公告日降序）
- 参数：
:code（如
0700）
- 返回：
data.code、 INLINECODE21
港股分红字段说明（models/hk_dividend_detail.go）
- -
code：股票代码 - INLINECODE24 ：股票名称（由
hk_stock_code 关联补充） - INLINECODE26 ：财年
- INLINECODE27 ：公告日期
- INLINECODE28 ：除权除息日
- INLINECODE29 ：分红方案文本
- INLINECODE30 ：派息类型
- INLINECODE31 ：过户截止日
- INLINECODE32 ：派息日
A 股分红配股 API（/api/v1/cn-stock）
- 说明：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
- 说明：某只 A 股分红配股详情（按最新公告日期降序）
- 参数：
:code（如
600519）
- 返回：
data.code、
data.name、 INLINECODE58
A 股分红配股列表字段说明（models/stock_fhps_em.go）
- -
code：股票代码 - INLINECODE61 ：股票名称
- INLINECODE62 ：最新公告日期（列表每只股票只保留一条）
- INLINECODE63 ：报告期
- INLINECODE64 ：方案进度（如预案/已实施/已通过）
- INLINECODE65 ：送转类型
- INLINECODE66 ：派息文本
- INLINECODE67 ：送股文本
- INLINECODE68 ：配股文本
- INLINECODE69 ：股息率（小数）
- INLINECODE70 ：除权除息日
- INLINECODE71 ：净利润同比（可能为空）
- 其他字段（如
eps、navps、transfer_ratio 等）保留但一般不作为首要摘要
A 股分红配股详情字段说明（models/stock_fhps_detail_em.go）
- -
latest_announcement_date：最新公告日期（排序与图表横轴） - INLINECODE77 ：报告期末日期
- INLINECODE78 ：方案进度
- INLINECODE79 ：送转类型
- INLINECODE80 ：派息
- INLINECODE81 ：送股
- INLINECODE82 ：配股
- INLINECODE83 ：股息率（小数）
- INLINECODE84 ：详情正文（可能较长）
- INLINECODE85 ：分析文本（可能较长）
- INLINECODE86 ：图片/图表 URL 或 JSON
操作流程
1. 解析用户意图
从用户问题中抽取：
- 若用户说 “600519”“贵州茅台”，默认 A股（CN）
- 若说 “0700.HK”“腾讯控股”，默认 港股（HK）
- 可在项目内实现名称到代码的映射：如
resolve_symbol(name_or_code)
- 若未指定，默认
近 3~5 年分红记录
- A 股列表可用
announcement_year 限定公告年
- 分红：历史分红记录、股息率、分红稳定性等
- 配股/送转：送股、转增、配股信息
2. 调用数据接口
按意图调用对应 HTTP API，例如（伪代码）：
CODEBLOCK1
要求：输出时说明股息率字段是 小数（如 0.04 表示 4%）。
进行分析与总结
在生成自然语言回答时，建议按以下结构组织：
- 1. 总体概览（1 段）
- 分红是否连续、是否集中在特定年份
- 股息率区间是否稳定
- 是否存在一次性大额分红/送转
- 2. 关键指标列表
- 近 3~5 年的分红/配股记录（按公告日期或年份简表）
- 指标示例：分红方案、股息率、除权除息日、送股/转增/配股
- 3. 分红情况
- 是否持续分红（几年中有缺分红年份）
- 近几年平均股息率区间（例如 2%–4%）
- 特殊一次性大额分红需要单独说明
- 4. 风险与限制说明（必选）
- 数据为历史数据，不代表未来表现
- 分红政策可能会根据经营情况变化
- 若数据存在缺失或不完整，需要明确指出
- 本仓库
不提供财报口径数据，如用户请求财报，需提示范围限制
输出格式建议
回答时优先使用 中文，并尽量结构化：
- - 文字 + 项目符号列表
- 简表形式（可用 Markdown 表格，但要简洁）
示例输出结构（示意）：
CODEBLOCK2
示例对话用法
示例 1：查看港股公司分红历史
用户：
“帮我看看 0700.HK 这家公司最近几年的分红情况，股息率大概多少？”
- - 解析：市场=HK，代码=0700.HK，需求=分红历史 + 股息率
- 调用： INLINECODE90
- 输出：总结近几年是否分红、分红方案、股息率区间、是否稳定
示例 2：对比A股公司财务与分红
用户：
“把贵州茅台最近 5 年的盈利情况和分红情况总结一下。”
- - 解析：市场=CN，symbol=600519（通过名称解析）
- 调用： INLINECODE91
- 输出：总结分红/配股频率与股息率
开发者检查清单
在项目里真正启用本 Skill 前，请确认：
- - [ ] 已实现 分红数据接口（含分红金额、股息率等关键字段）
- [ ] 函数、结构体、字段均有清晰中文注释，说明 单位/币种/比例含义
- [ ] 若使用外部数据源（聚宽、TuShare、券商 API 等），已处理好：
- [ ] 鉴权/Token 管理
- [ ] 调用频率限制
- [ ] 网络错误与数据缺失的容错
- - [ ] 本 SKILL.md 内容已根据真实实现的函数名/字段名进行同步调整
中国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/（需确认是否为实际对外地址；如未确认，调用方必须先核验协议/端口）
建议通过环境变量 STOCKAPIBASE_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、sortorder
- 默认排序：sort
by=announcedate，sort_order=desc
- 返回：data.list、data.total
- - GET /api/v1/hk-stock/dividend/detail/:code
- 说明：某只港股完整分红历史（按公告日降序）
- 参数：:code（如 0700）
- 返回：data.code、data.list
港股分红字段说明（models/hkdividenddetail.go）
- - code：股票代码
- name：股票名称（由 hkstockcode 关联补充）
- fiscalyear：财年
- announcedate：公告日期
- exdate：除权除息日
- dividendplan：分红方案文本
- distributiontype：派息类型
- transferdeadline：过户截止日
- payout_date：派息日
A 股分红配股 API（/api/v1/cn-stock）
- - GET /api/v1/cn-stock/fhpg
- 说明：A 股分红配股列表（分页 + 联合搜索）
- 查询参数：page、limit、code、name、plan
progress、bonustype、cash
div、sharediv、allotment、dividend
yieldmin、dividend
yieldmax、announcement
year、sortby、sort_order
- 默认排序：sort
by=dividendyield，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/stockfhpsem.go）
- - code：股票代码
- name：股票名称
- latestannouncementdate：最新公告日期（列表每只股票只保留一条）
- reportdate：报告期
- planprogress：方案进度（如预案/已实施/已通过）
- bonustype：送转类型
- cashdiv：派息文本
- sharediv：送股文本
- allotment：配股文本
- dividendyield：股息率（小数）
- exdividenddate：除权除息日
- netprofityoy：净利润同比（可能为空）
- 其他字段（如 eps、navps、transfer_ratio 等）保留但一般不作为首要摘要
A 股分红配股详情字段说明（models/stockfhpsdetail_em.go）
- - latestannouncementdate：最新公告日期（排序与图表横轴）
- reportdate：报告期末日期
- planprogress：方案进度
- bonustype：送转类型
- cashdiv：派息
- sharediv：送股
- allotment：配股
- dividendyield：股息率（小数）
- content：详情正文（可能较长）
- analysis：分析文本（可能较长）
- images_json：图片/图表 URL 或 JSON
操作流程
1. 解析用户意图
从用户问题中抽取：
- 若用户说 “600519”“贵州茅台”，默认 A股（CN）
- 若说 “0700.HK”“腾讯控股”，默认 港股（HK）
- 可在项目内实现名称到代码的映射：如 resolve
symbol(nameor_code)
- 若未指定，默认
近 3~5 年分红记录
- A 股列表可用 announcement_year 限定公告年
- 分红：历史分红记录、股息率、分红稳定性等
- 配股/送转：送股、转增、配股信息
2. 调用数据接口
按意图调用对应 HTTP API，例如（伪代码）：
text
港股：分红列表
GET /api/v1/hk-stock/dividend?page=1&limit=20&keyword=腾讯&sort
by=announcedate&sort_order=desc
港股：分红详情
GET /api/v1/hk-stock/dividend/detail/0700
A股：分红配股列表（按股息率过滤）
GET /api/v1/cn-stock/fhpg?page=1&limit=20÷nd
yieldmin=0.02÷nd
yieldmax=0.08&sort
by=dividendyield&sort_order=desc
A股：分红配股详情
GET /api/v1/cn-stock/fhpg/detail/600519
要求：输出时说明股息率字段是 小数（如 0.04 表示 4%）。
进行分析与总结
在生成自然语言回答时，建议按以下结构组织：
- 1. 总体概览（1 段）
- 分红是否连续、是否集中在特定年份
- 股息率区间是否稳定
- 是否存在一次性大额分红/送转
- 2. 关键指标列表
- 近 3~5 年的分红/配股记录（按公告日期或年份简表）
- 指标
