核心功能与使用场景
该技能提供中国农历、黄历、吉凶三位一体的传统历法查询服务，主要解决三类问题：
- 农历查询：公历日期转农历（含年月日、生肖、干支），如"今天农历几号"、"2027-08-08对应什么农历日期"
- 黄历查询：每日宜忌、神煞、冲煞等老黄历信息，如"今天黄历怎么样"、"今日宜忌是什么"
- 吉凶择日：判断某日吉凶，筛选搬家、结婚、开业、开工等适宜日期
核心能力
| 功能 | 说明 |
|------|------|
| `by-date` | 单日查询，获取特定日期的农历、黄历、吉凶信息 |
| `batch` | 区间批量查询，支持按关键词筛选（如"搬家"） |
| `search` | 跨日期关键词检索（如"甲子日"、"初一"、"吉日"） |
显著优点
1. 功能全面：覆盖农历转换、黄历宜忌、神煞冲煞、择日建议四大场景
2. 查询灵活：支持单日、批量区间、关键词三种查询模式
3. 传统历法专业：包含干支纪年、生肖、神煞等专业黄历要素
4. 免费额度可用：每日10次唯一日期查询，基本满足日常需求
5. 开源透明：MIT协议开源，代码可审计
潜在局限与风险
| 风险点 | 说明 |
|--------|------|
| **配额限制** | 每日仅10次免费额度，超额需手动重置，高频使用体验受限 |
| **需外部Token** | 必须注册获取HUANGLI_TOKEN，依赖第三方服务可用性 |
| **网络依赖** | 需HTTPS访问`api.nongli.skill.4glz.com`，离线不可用 |
| **文化属性** | 黄历吉凶属传统民俗，非科学依据，不宜作为决策唯一依据 |
| **环境配置** | 需Python 3.9+或bash+curl，有一定技术门槛 |
适合人群
- 需要查询传统农历日期的普通用户
- 关注黄历宜忌、择日文化的民俗爱好者
- 搬家、结婚、开业等需参考吉日的场景需求者
- 开发者集成农历功能到自有应用
安全建议
- Token妥善保管，避免硬编码提交至代码仓库
- 注意API配额消耗，生产环境建议监控429状态码
- 理性看待吉凶结果，重大决策应结合实际情况
---
来源：MIT开源项目，由Leocdchina发布，依赖自托管API服务。