天枢黄道库

要解决什么问题

在对话里查黄历宜忌、生肖运势、起名建议或六十四卦，往往需要翻专用 App 或零散网页，结果格式也不适合 Agent 直接引用。天枢黄道库把传统历法与命理相关能力收敛成可调用的接口，并附带一套可离线读取的 JSON 数据集，方便在「要联网付费」和「完全本地」之间做选择。

技能如何工作

技能提供两条路径：

• 在线 API（付费）：命理运势、姓名起名、64 卦查询每次 1.68 元，须先走支付宝创单，拿到 payUrl 与 orderId；后续请求携带 alipay_trade_no（ORDER_ 开头，约 30 分钟有效），否则付费接口返回 402 Payment Required。黄历择吉接口按日期 YYYY-MM-DD 查询，文档中列为可免费使用。
• 本地数据（免费）：Agent 直接读取包内 data/*.json，例如 huangli_rules.json（建除、28 宿、宜忌、彭祖百忌等）、yijing.json（卦辞爻辞）、zodiac.json、fortune_crossref.json、naming.json、wuxing.json，在无外网或不想付费时做规则化查询与说明。

典型付费调用链：创单 → 用户付款 → 带订单号调运势 / 起名 / 卦序；本地模式则按文件名与字段含义拼装回答，不经过支付网关。

适用边界与注意点

• 付费能力以 SKILL 文档为准；不要把「黄历免费」误当成所有接口都免费。
• 本地 JSON 覆盖的是嵌入规则与名库规模（如起名名库约 223 字），复杂八字排盘或个性化命理仍以在线返回或你方补充逻辑为准。
• 触发场景包括择吉、今日黄历、生肖财运、取名测名、huangli / chinese almanac 等中英文关键词。