八字命理解盘

这是一个八字命理免费排盘、付费解盘的 Skill，调用公网 API 即可工作，无需本地任何代码。付费报告走标准 402 验付协议，买家侧配合「支付宝 AI 付」付款技能即可完成支付。

使用说明

功能

免费排盘：按出生年/月/日/时/性别，返回完整盘面数据（四柱、日主、旺衰、格局、用神、忌神、五行、神煞、大运、流年）。
付费详解报告：返回命理师级完整解读（9.9 元/份），分「专业版 / 通俗版」两档，交付形态为图文网页版 HTML（带购买者水印）。
解释报告：对已购买的报告内容逐段解读，回答八字命理业务问题。

输入

| 参数 | 必填 | 说明 | |:--|:--|:--| | year | ✅ | 出生年（1900–2100） | | month | ✅ | 出生月（1–12） | | day | ✅ | 出生日（真实日期，服务自动校验） | | gender | 建议 | 男 / 女（缺省默认男） | | hour | ✅ | 时刻，取值见 mode | | mode | 选填 | clock=北京时间小时 0–23（默认）；shichen=十二时辰序号 0–11（0=子…11=亥） | | lon | 选填 | 出生地东经 -180~180，真太阳时换算用（仅 mode=clock 生效） | | token | 选填 | 网页端生成的「报告口令」，已压入整套出生参数+报告档位；一旦传入，其它参数全部忽略 | | level | 选填 | 专业（默认）/ 通俗（人话版，普通用户易读） |

输出

免费排盘返回：

{ "resource_id": "paipan", "content": "…JSON字符串…", "free": true }

⚠️ content 是一段 JSON 格式的字符串，需再 JSON.parse 一次才得到盘面：

{ "四柱": { "year":"己卯", "month":"丙子", "day":"戊午", "hour":"戊午" },
  "日主": "戊",
  "盘面": { "旺衰":"身旺", "格局":"普通", "用神":["财星","官杀","食伤"], "忌神":["印星","比劫"],
            "五行数":{…}, "缺五行":["金"], "神煞":{…}, "大运":["乙亥",…], "流年":"丙午" } }

免费排盘返回的是结构化盘面字段（供 AI / 前端自行做自然语言解读），不含现成断语文字；现成命理师级断语在付费报告里。

付费报告（走 402）返回：验签通过后 HTTP 200，content 字段为一整份网页版 HTML 报告（<!DOCTYPE html> 开头），尾部带购买者水印。

示例

免费排盘（方式一：Agent 直接调）

curl -G "https://mingli-402-306135-11-1461156657.sh.run.tcloudbase.com/api/paipan" \
  --data-urlencode "year=2000" --data-urlencode "month=1" \
  --data-urlencode "day=1"   --data-urlencode "hour=12" \
  --data-urlencode "gender=男"

免费排盘（方式二：把网页给用户） 把首页 URL https://mingli-402-306135-11-1461156657.sh.run.tcloudbase.com/ 发给用户，用户自行排盘、拿到报告口令 token；Agent 拿到 token 后可免填参数排同一份盘：

curl -G "https://mingli-402-306135-11-1461156657.sh.run.tcloudbase.com/api/paipan" \
  --data-urlencode "token=<用户在网页拿到的口令>"

付费详解报告（402 三步）

1) 请求 /api/report（无凭证）→ HTTP 402 + Payment-Needed 头（含订单号、amount=9.90、seller_signature 等）
2) 引导用户用「支付宝AI付」付 9.9 元 → 得到 payment-proof
3) 带 Payment-Proof 头重请求 /api/report → 验签通过 → HTTP 200 + 网页版 HTML 报告

curl -G "https://mingli-402-306135-11-1461156657.sh.run.tcloudbase.com/api/report" \
  -H "Payment-Proof: <支付平台给的 payment-proof>" \
  --data-urlencode "year=2000" --data-urlencode "month=1" \
  --data-urlencode "day=1"  --data-urlencode "hour=12" --data-urlencode "gender=男"

（已验付订单可幂等重取，不重复扣款。）

使用规范

本 Skill 报告是付费商品（9.9 元/份），免费=排盘，不给「报告免费」的错觉。
所有断语 / 判断只来自接口返回，接口没输出的绝不虚构结论；避免生成不当预测。
生辰是敏感个人数据，只用于本次排盘与报告，不回显、不跨用户拼接。

安装配套（支付能力）

付费报告走 402 协议，买家侧需「支付宝 AI 付」付款技能（@alipay/agent-payment）：

npx -y @alipay/agent-payment@latest install-experience

装完重启框架，并完成「开通钱包」（apply-wallet 出码 → 手机支付宝扫码授权 → check-wallet 返回 200）即可付款。若报「安全环境装载失败」，第一件事查 PayGuard 安全守护进程是否常驻。