🏮 天枢黄道库

传统历法·命理运势·姓名起名。支持两种模式：

在线 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