天问·紫微斗数：输入公历出生年月日时与性别，排出完整紫微命盘——十二宫全星曜、庙旺利平陷、生年四化、三方四正、大限流年小限，附 AI 命理师深度解读
天问·紫微斗数：输入公历出生年月日时与性别，排出完整紫微命盘——十二宫全星曜、庙旺利平陷、生年四化、三方四正、大限流年小限，附 AI 命理师深度解读。单次 ¥1.99。
请求参数
POST /api/resource 请求体：
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
year |
int | 是 | 出生年（公历，1900-当前年） |
month |
int | 是 | 出生月（公历，1-12） |
day |
int | 是 | 出生日（公历，1-31） |
hour |
int | 是 | 出生小时（0-23，24 小时制；不确定时辰请先问用户） |
gender |
string | 是 | 性别：男 / 女（也接受 male/female） |
收集信息时：若用户未提供时辰，先询问（时辰影响命宫定位）；若用户给的是农历，请先确认并换算为公历再传参。
支付与交付
付费前置检查
调用本技能前，确认当前 Agent 已具备支付宝官方买家支付能力（alipay-payment-skill / alipay-bot）。
- 已具备：继续提供付费服务
- 未具备：提示用户「需先安装支付宝官方支付能力（npx -y @alipay/agent-payment@latest install）」并终止，不要自行实现付款或伪造凭证
工作流程（支付宝 A2M / HTTP 402 协议）
第一步：请求资源
向业务接口发起原始请求：
POST https://meihua.astrakairos.com/twziwei/api/resource
Content-Type: application/json
<业务请求体，见下方「请求参数」>
第二步：处理 402 响应（支付触发）
未付款时服务返回 HTTP 402，并在响应头 Payment-Needed 携带 base64url 账单，响应体含 preview（免费真数据预览）与 out_trade_no。
- 先向用户展示 preview 内容（这是用户自己的真实测算结果片段），再说明「支付 ¥X 解锁完整报告」，引导付费——不要只甩一句"请支付"。
- 将 Payment-Needed 头的值和原始请求（URL、method、body）交给官方支付能力发起收银：
alipay-bot 402-buyer-pay \
--session-id <会话ID> \
--file <保存 Payment-Needed 的文件> \
--resource-url https://meihua.astrakairos.com/twziwei/api/resource \
--method POST \
--intent-summary "<原始请求摘要>"
用户扫码/免密完成支付授权。你只负责编排，绝不接触支付私钥，也不自行实现签名。
第三步：支付成功后获取资源（必须执行）
付款后复用同一原始请求重试，通过请求头 Payment-Proof 携带官方返回的支付凭证：
POST https://meihua.astrakairos.com/twziwei/api/resource
Content-Type: application/json
Payment-Proof: <官方 402-buyer-pay 返回的凭证>
<与第一步完全相同的业务请求体>
服务端验付通过后返回 HTTP 200，响应体 content 即完整付费结果，响应头 Payment-Validation 为验付回执。
- content 中若含 report_url，请把该链接完整展示给用户（精美报告页）。
- 同一订单重试幂等：已履约会返回 already_fulfilled: true 并给出缓存结果，不会重复扣费或重复交付。
第四步：处理特殊响应（异常处理）
| code / HTTP | 含义 | 处理方式 |
|---|---|---|
Payment-Needed (402) |
需要支付 / 凭证无效需重新发起 | 展示 preview 引导支付；若为凭证过期，重新走第一步 |
SUCCESS (200) |
成功 | 完整展示 content，附上 report_url |
NOT_PAID / 402 rebill |
尚未完成支付 | 提示用户完成支付后携原凭证重试，勿重复下单 |
VERIFY_FAILED (502) |
验付查询失败 | 稍后携原 Payment-Proof 重试，不要让用户重复付款 |
FULFILLMENT_CONFIRM_FAILED (502) |
结果已生成但履约回执失败 | 稍后携同一 Payment-Proof 重试（不会重复扣费） |
FULFILL_FAILED (500) |
业务生成失败 | 告知用户款项未履约可联系卖家退回，勿重复付款 |
状态不明时：先查询原订单状态，绝不重复付款或追加独立回执。
响应示例
402（未付款，含免费真预览）：
{
"code": "Payment-Needed",
"out_trade_no": "TZ1010144800abcd1234",
"amount": "1.99",
"preview": {
"lunar_date": "农历乙亥年五月初一",
"year_stem_branch": "乙亥",
"ming_gong_branch": "寅", "shen_gong_branch": "戌",
"ming_main_stars": "武曲、天相",
"preview_text": "已排定命盘骨架：乙亥年生，命宫在寅（武曲、天相），身宫在戌。",
"preview_note": "支付后解锁完整命盘…"
}
}
200（已付款）：content 含 palaces(十二宫)、main_stars、star_brightness、sihua、sanfang_sizheng、daxian、liunian、xiaoxian、scores、interpretation(AI 解读)、report_url（交互式十二宫命盘报告页，务必展示给用户）。
展示要求
- 402 时先展示 preview 的命盘骨架（命宫/身宫/命宫主星），强调「这是您本人的真排盘结果」。
- 200 后首推 report_url（交互式命盘页含十二宫格、星曜亮度、四化标记），正文再给 AI 解读摘要。
声明：本服务基于中国传统易学文化，结果仅供文化参考与娱乐，不构成任何医疗、投资、法律或重大决策建议。
