SKILL.md
中国节假日查询#
查询中国法定节假日安排，数据来自 timor.tech 免费接口（无需 Key，数据每年更新）。
用法#
python3 holidays.py # 今年节假日总览 + 距下个假期倒计时
python3 holidays.py 2026-05-01 # 某天是否放假/调休
python3 holidays.py --year 2027 # 指定年份节假日总览
python3 holidays.py --next # 下个节假日详情 + 倒计时
python3 holidays.py --today # 今天是什么日子
输出示例#
2026 年节假日总览：
01-01 元旦 放假
01-01 元旦 放假
02-17 春节 放假（除夕前一日调休上班 02-16）
...
距下个节假日：11-27 感恩节?（无）→ 最近为 10-01 国庆节已过，下一个 2027-01-01 元旦 还剩 62 天
机制#
- 数据源：
https://timor.tech/api/holiday/year/<年份>（官方节假日数据，含 date / holiday / name / wage / after / target 字段）。 wage==1表示调休上班日；holiday==true表示放假；after表示调休补班日期。- 纯 Python 标准库（urllib），无第三方依赖。
隐私与安全#
- 不收集任何个人信息；仅向 timor.tech 公共接口发起查询。
- 不含任何密钥或账号凭据。
用途与依赖
作者没写，这些是平台读文件后整理的，以文件为准。
使用示例
请求：帮我看看 2026 年 5 月 1 日放假吗？顺便算一下离下一个假期还有多久。
预期
运行 `python3 holidays.py 2026-05-01`，返回该日期对应的节日名称以及是“放假”“调休上班”还是“普通工作日”（调休时会附上补班日期）；再运行 `python3 holidays.py --next`，输出下一个节假日的名称、日期和剩余天数。
- 适用场景
- 想知道某个日期（如 2026-05-01）是否放假、是否调休上班
- 查看某一年全年法定节假日列表
- 计算距离下一个节假日还有多少天
- 查询今天或明天是不是节假日、是什么节日
- 规划行程或安排工作前确认调休补班日
- 输入
- 要查询的日期，格式为 YYYY-MM-DD，也可以写“今天”或“明天”
- 要总览的年份，通过 --year 传入
- 想查询的是下个节假日，还是今天的情况，分别用 --next、--today 指定
- 输出
- 指定日期的状态：放假、调休上班或普通工作日，附节日名称
- 某一年全年节假日列表（日期和名称）
- 下一个节假日的名称、日期与倒计时天数
- 今天是否为节假日的判断结果
- 运行环境
- Python 3
- 依赖
- 无
