核心用法
jisu-calendar 是一款基于极速数据万年历 API 的日历查询技能，支持两大核心功能：
1. 万年历查询（/calendar/query）
- 输入指定日期（
YYYY-MM-DD格式），可查询该日的公历信息（年、月、日、星期）、农历转换（年月日、干支纪年、生肖）、星座，以及详细的黄历数据 - 支持阴阳历双向转换，可显式指定
islunar=1按农历日期查询 - 黄历数据包含：当日宜忌事项、吉神凶煞、冲煞方位、五行、胎神、岁次、财神/喜神/福神方位等传统历法信息
2. 节假日查询（/calendar/holiday）
- 返回法定节假日安排，包含放假日期、调休说明及补班安排
- 适用于快速了解年度假期规划
显著优点
- 信息维度丰富：单次日历查询覆盖公历、农历、星座、生肖、干支、黄历六大维度，满足日常查询与传统文化需求
- API 稳定成熟：极速数据为专业数据服务商，万年历接口运行多年，数据准确性和更新及时性有保障
- 使用门槛低：仅需配置单一环境变量
JISU_API_KEY，调用方式简单直接 - 场景适配性强：既支持精确的日期查询，也支持模糊的节假日概览，适合对话式 AI 场景
潜在缺点与局限性
- 依赖外部 API：所有数据实时从极速数据服务器获取，存在网络延迟和第三方服务可用性风险
- API 调用成本：极速数据为商业 API，免费额度有限，高频调用可能产生费用
- 黄历内容局限性：传统黄历信息（宜忌、吉凶神煞）属于民俗文化范畴，无科学依据，不宜作为决策依据
- 节假日数据覆盖：仅包含中国法定节假日，不含地方性假日或海外节假日
- 农历闰月处理：需显式标记
islunarmonth=1，否则可能返回错误日期
适合人群
- 需要快速进行公历农历转换的用户
- 关注传统黄历宜忌、择吉文化的群体
- 需要查询年度节假日安排的职场人士
- 开发日程管理、提醒类应用的开发者
常规风险
- API 密钥泄露风险：
JISU_API_KEY若硬编码或日志泄露，可能导致配额被恶意消耗 - 数据准确性争议：黄历信息属于传统文化内容，不同流派算法可能存在差异
- 服务中断风险：极速数据接口维护、停用或策略变更将直接影响技能可用性
- 隐私合规：日期查询本身不涉及敏感隐私，但 API 调用日志可能暴露用户查询习惯
> 使用建议：黄历内容仅供参考娱乐，重要决策请勿依赖；生产环境建议配置 API 调用频率限制与降级方案。