🏮 天枢黄道库
传统历法·命理运势·姓名起名。支持两种模式：
- 在线 API（付费）：1.68 元/次，支付宝付款
- 本地数据（免费）：使用嵌入的数据文件本地计算
💰 支付流程（核心！每次必走）
所有付费接口（命理运势、姓名起名、64卦查询）每次调用必须先走支付流程。
支付宝支付步骤：
1. Agent 调 GET https://sinodata.io/v1/alipay/create?plan=huangdao
返回：{ "success": true, "orderId": "ORDER_xxx", "shortUrl": "/v1/alipay/pay?p=...", "amount": 1.68 }
2. Agent 组装短链接：https://sinodata.io + shortUrl
向用户展示可点击的支付按钮：
「[打开支付宝支付 1.68 元](https://sinodata.io/v1/alipay/pay?p=...)」
3. 用户点击链接 → sinodata.io 302 跳转 → 支付宝支付页面
4. 用户完成支付后，支付宝回跳 sinodata.io 展示支付成功页面
5. Agent 调 API 获取数据时带上 alipay_trade_no=ORDER_xxx 参数
返回数据即表示支付已通过验证
> 注意： alipay_trade_no 参数格式为 ORDER_ 开头 + 随机字符，有效期 30 分钟。
> 不带该参数调用付费接口会返回 402 Payment Required。
模式一：在线 API（付费，每次 1.68 元）
所有付费接口需带 alipay_trade_no 参数（由支付宝创单接口生成）。
支付宝创单（先走这步）
GET https://sinodata.io/v1/alipay/create?plan=huangdao
返回 payUrl（支付链接）+ orderId（订单号），付款后带回。
黄历择吉（免费）
GET https://sinodata.io/v1/huangdao/huangli?date=YYYY-MM-DD
| 参数 | 必填 | 说明 |
|---|---|---|
| date | 是 | 查询日期，格式 YYYY-MM-DD |
返回： 农历、宜忌、建除12神、28宿、64卦、纳音五行、彭祖百忌
命理运势（付费）
GET https://sinodata.io/v1/huangdao/fortune?birth=YYYY-MM-DD&zodiac=生肖&alipay_trade_no=ORDER_xxx
| 参数 | 必填 | 说明 |
|---|---|---|
| birth | 是 | 出生日期 |
| zodiac | 否 | 生肖名（如"虎"），不传则按出生年份自动推算 |
| alipay_trade_no | 付费必填 | 支付宝订单号（ORDER_开头） |
返回： 生肖属性 + 五行 + 综合/财运/事业/爱情运势 + 幸运色/数字/方位
姓名起名（付费）
GET https://sinodata.io/v1/huangdao/naming?last=姓氏&gender=男|女&alipay_trade_no=ORDER_xxx
| 参数 | 必填 | 说明 |
|---|---|---|
| last | 是 | 姓氏 |
| gender | 是 | 男 / 女 |
| alipay_trade_no | 付费必填 | 支付宝订单号（ORDER_开头） |
返回： 姓氏五行 + 3个推荐名（含笔画、五行、寓意）+ 起名贴士
64卦查询（付费）
GET https://sinodata.io/v1/huangdao/hexagram?number=卦序&alipay_trade_no=ORDER_xxx
| 参数 | 必填 | 说明 |
|---|---|---|
| number | 是 | 卦序（1-64），不传则按当天日期推算 |
| alipay_trade_no | 付费必填 | 支付宝订单号（ORDER_开头） |
模式二：本地数据查询（免费，无需网络）
技能包自带完整命理数据集，Agent 可直接读取本地 JSON 文件进行计算：
数据文件结构
| 文件 | 大小 | 用途 |
|---|---|---|
data/huangli_rules.json |
31KB | 建除12神规则、28宿、64卦、宜忌活动(29项)、吉神凶神、彭祖百忌、节气 |
data/yijing.json |
56KB | 64卦完整卦辞、象辞、爻辞，用于起卦解卦 |
data/zodiac.json |
16KB | 12生肖属性、五行、六合三合相冲、幸运色数字 |
data/fortune_crossref.json |
18KB | 五行生克、干支组合、综合运势交叉表 |
data/naming.json |
41KB | 223字名库（笔画/五行/寓意）+ 五格数理 + 三才配置 |
data/wuxing.json |
2KB | 五行属性速查（颜色/方位/季节/生克关系） |
本地查询示例
// 查黄历
const rules = JSON.parse(fs.readFileSync('data/huangli_rules.json'));
const shenSha = rules.shen_sha;
const yiJi = rules.yi_ji_activities;
const xiu = rules.twenty_eight_xiu;
// 查生肖运势
const zodiac = JSON.parse(fs.readFileSync('data/zodiac.json'));
const tiger = zodiac.animals.find(a => a.name === '虎');
// → { name: '虎', element: '木', liu_he: '猪', liu_chong: '猴', san_he: ['马', '狗'] }
// 查五行
const wuxing = JSON.parse(fs.readFileSync('data/wuxing.json'));
const wood = wuxing.elements['木'];
// → { color: '青/绿', direction: '东', season: '春', generates: '火', ... }
// 取名
const names = JSON.parse(fs.readFileSync('data/naming.json'));
// → 223字名库，按性别筛选，五行互补排序
触发词
黄历、黄道吉日、良辰吉日、结婚吉日、搬家吉日、宜忌、今日黄历、择日、择吉、运势、今日运势、本月运势、今年运势、生肖运势、财运、事业运、感情运、取名、起名、测名、名字评分、姓名测试、五行、八字、命理、卦、易经、64卦、爻、huangli、chinese almanac、auspicious date、fortune、chinese zodiac、name meaning
