SuperAPI AI 工具集

china-holidays

办公与效率

查看项目

更新于 10-16 10:17

技能介绍

国家法定节假日查询

【用途】 该技能用于获取中国国家法定节假日安排,数据从中国政府网(www.gov.cn)获取国务院办公厅发布的国家法定节假日安排通知。适用于查询某年的节假日放假安排、了解法定假日调休日期、获取春节与国庆等长假具体天数、确认是否需要补班调休等场景。支持查询任意年份的元旦、春节、清明节、劳动节、端午节、中秋节、国庆节放假调休安排,未指定年份时默认查询当年。

【主要能力】 支持按年份查询国务院办公厅发布的节假日安排通知全文;支持提取元旦、春节、清明节、劳动节、端午节、中秋节、国庆节的放假与调休信息;支持查询特定节日、跨年度对比;支持按用户要求输出 JSON、表格、列表、简短回复等不同格式。

【使用方式】 第 1 步:确认查询年份,用户未指定时默认使用当前年份。 第 2 步:运行脚本获取节假日安排通知:

python scripts/fetch_holidays.py --year {年份}

脚本采用缓存优先策略:优先读取本地缓存,检查 assets/{年份}.md 是否存在;缓存命中直接返回缓存数据(毫秒级响应);缓存未命中则联网从政府网获取数据,并自动缓存到本地。

强制刷新(可选):如需强制从网络获取最新数据(忽略缓存),添加 --force 参数:

python scripts/fetch_holidays.py --year {年份} --force

当用户提到“重新从网络获取”“强制更新缓存”“刷新一下数据”“重新下载”“更新一下{年份}的缓存”等意图时使用 --force 参数。

第 3 步:解析并输出节假日信息。根据获取到的通知内容,按用户要求整理输出。默认标准输出格式示例:

【{年份}年国家法定节假日安排】 一、元旦:{具体日期}放假调休,共{天数}天。{调休说明} 二、春节:{具体日期}放假调休,共{天数}天。{调休说明} 三、清明节:{具体日期}放假调休,共{天数}天。{调休说明} 四、劳动节:{具体日期}放假调休,共{天数}天。{调休说明} 五、端午节:{具体日期}放假调休,共{天数}天。{调休说明} 六、中秋节:{具体日期}放假调休,共{天数}天。{调休说明} 七、国庆节:{具体日期}放假调休,共{天数}天。{调休说明}

如果用户主动提供了输出格式要求或指定了输出模板,按用户给定的要求整理输出(如 JSON、表格、列表、简短回复等)。

【适用场景】 查询某年节假日安排、查询当年节假日安排、查询特定节日放假天数、比较两年节假日安排差异、按指定格式(如 JSON)输出节假日数据等。

【限制与故障处理】 数据时效性:只能查询已发布的年份,未来年份的通知需等待官方发布(国务院办公厅通常在每年 11-12 月发布下一年度节假日安排)。 搜索无结果:可能因该年份通知尚未发布或网络连接问题;查询未来年份时应提示用户该年度通知尚未发布,建议查询已发布年份,网络问题建议稍后重试。 在线获取失败:可能因网络连接不稳定或政府网接口参数变更;可检查网络后重试一次,仍失败则说明政府网数据暂时无法获取,建议使用缓存数据或稍后重试,或告知用户直接访问政府网查看。 内容解析失败:向用户说明解析失败,将原始 URL 提供给用户手动访问,建议稍后重试。 缓存数据不存在:说明该年份数据暂时无法获取,建议查询其他年份或稍后重试。 通用处理原则:任何错误都应向用户清晰说明原因和建议,优先尝试使用缓存数据,网络问题建议稍后重试,并提供替代方案。

【技术说明】 数据来源:中国政府网(www.gov.cn)官方发布的国务院办公厅通知。数据权威性:来源于国务院公报,具有官方效力。更新频率:通常每年 11-12 月发布下一年度安排。缓存策略:本地缓存优先,减少网络请求,提升响应速度;缓存文件位于 assets/{年份}.md,每年新数据发布后会自动更新;已有缓存的年份可以完全离线查询。