用途:查询中国国家法定节假日放假调休安排,数据来自中国政府网(www.gov.cn)发布的国务院办公厅通知,具有官方效力。
主要能力:查询指定年份或默认当年的元旦、春节、清明节、劳动节、端午节、中秋节、国庆节放假天数与调休上班日期;支持按用户要求输出标准格式、JSON、表格或列表;支持跨年份对比;已有缓存年份可离线查询。
使用方式:先确认查询年份,未指定则默认当前年份;运行脚本 python scripts/fetch_holidays.py --year {年份} 获取通知;需要忽略缓存强制联网时加参数:python scripts/fetch_holidays.py --year {年份} --force。脚本采用缓存优先策略,命中 assets/{年份}.md 时直接返回,未命中则联网获取并自动缓存。Agent 需从返回的通知原文中提取信息并整理输出,输出应包含调休上班日期。
适用场景:查询某年放假安排、了解调休补班日期、获取长假天数、对比不同年份安排、按自定义格式整理节假日数据。
限制:仅能查询官方已发布的年份,下一年度通知通常在上一年度11至12月发布,未来年份可能暂无数据;依赖网络获取时可能因网络或政府网接口变更失败,此时可改用缓存或建议用户稍后重试,也可直接访问政府网查看;本地无缓存且在线获取失败时该年份数据无法提供。具体缓存目录、脚本完整实现细节暂未提供。