核心用法
该技能提供中国农历黄历查询服务，主要功能模块包括：
1. 黄历查询：查询单日或区间日期的黄历信息，包括每日宜忌、吉神凶煞、冲煞、时辰吉凶等。支持今日黄历快速查询和任意历史/未来日期查询。
2. 农历转换：公历日期与中国农历（阴历）双向转换，返回干支纪年、生肖、节气等详细信息。
3. 择日功能：针对特定活动（搬家、结婚、开业、开工）筛选黄道吉日，支持批量日期区间筛选和关键词搜索（如"甲子日"）。
4. 吉凶判断：单日吉凶查询、区间吉日凶日批量筛选。
使用方法分为命令行调用（toolkit.py）和Agent自主认证两种模式。前者需配置HUANGLI_TOKEN环境变量，后者支持自动注册登录。
显著优点
- 功能覆盖全面：整合黄历、农历、吉凶、择日四大传统历法需求，支持从单日查询到批量筛选的完整场景。
- 使用门槛低：提供免费额度（10个唯一日期/天），支持429手动重置不限次数，对个人轻量使用友好。
- 自动化认证：Agent可自主完成注册登录流程，减少人工配置成本。
- MIT开源许可：代码公开透明，允许自由修改和二次开发。
- 多场景触发词：内置丰富的自然语言触发词，便于AI Agent理解用户意图。
潜在缺点与局限性
- 依赖外部API：核心功能依赖
api.nongli.skill.4glz.com，服务稳定性、数据准确性和长期可用性由第三方控制，存在单点故障风险。 - 数据权威性存疑：黄历吉凶判断基于传统民俗算法，缺乏统一标准，不同来源可能存在差异，不适合作为重要决策的唯一依据。
- 免费额度有限：10个日期/天的配额对高频使用或商业场景不足，超额后需手动重置，自动化程度受限。
- Python 3.9+依赖：对旧系统兼容性有一定要求。
- 安全报告缺失：提供的"安全认证报告"为系统自动生成的占位文本，未执行实际安全扫描，无法验证代码安全性。
适合人群
- 传统文化爱好者：需要查询农历、节气、干支等信息的个人用户。
- 民俗活动参考者：搬家、结婚、开业等择日需求，作为参考工具而非决策依据。
- 开发者：需要在应用中集成黄历功能的开发者，可通过MIT许可进行二次开发。
- AI Agent场景：需要通过自然语言交互提供历法查询服务的对话系统。
常规风险
1. 隐私风险：自动认证需提交用户名密码，API通信涉及日期查询行为数据，建议审查隐私政策。
2. 服务中断风险：外部API不可用时功能完全失效，建议生产环境准备降级方案。
3. 决策误导风险：吉凶判断属于民俗范畴，过度依赖可能导致重要事务安排不当。
4. 配额耗尽风险：高频场景下429错误需人工干预，影响自动化流程连续性。