天问·六爻装卦:一事一占
天问·六爻装卦:一事一占。支持用户自报三枚铜钱摇卦结果(6 个 6/7/8/9)或由服务代摇(订单号种子、结果恒定),输出京房八宫纳甲完整盘面——六亲、六神、世应、旬空、动爻、变卦,附 AI 断卦解读。单次 ¥1.99。
请求参数
POST /api/resource 请求体:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
question |
string | 是 | 所测之事(一事一占,1-200 字),如「下周面试能否通过」 |
tosses |
int[6] | 否 | 用户自摇结果:6 个数字(6=老阴 7=少阳 8=少阴 9=老阳),自初爻至上爻顺序。不传则服务代摇 |
引导用户:可先问「您要自己摇卦(报 6 次铜钱结果)还是由服务代摇?」。自摇时说明每次抛三枚铜钱:正面数 0→6(老阴)、1→7(少阳)、2→8(少阴)、3→9(老阳),按初爻到上爻顺序报 6 个数。代摇则直接发起请求。
支付与交付
付费前置检查
调用本技能前,确认当前 Agent 已具备支付宝官方买家支付能力(alipay-payment-skill / alipay-bot)。
- 已具备:继续提供付费服务
- 未具备:提示用户「需先安装支付宝官方支付能力(npx -y @alipay/agent-payment@latest install)」并终止,不要自行实现付款或伪造凭证
工作流程(支付宝 A2M / HTTP 402 协议)
第一步:请求资源
向业务接口发起原始请求:
POST https://meihua.astrakairos.com/twliuyao/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/twliuyao/api/resource \
--method POST \
--intent-summary "<原始请求摘要>"
用户扫码/免密完成支付授权。你只负责编排,绝不接触支付私钥,也不自行实现签名。
第三步:支付成功后获取资源(必须执行)
付款后复用同一原始请求重试,通过请求头 Payment-Proof 携带官方返回的支付凭证:
POST https://meihua.astrakairos.com/twliuyao/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": "TL1010144800abcd1234",
"amount": "1.99",
"preview": {
"question": "近期跳槽是否顺利",
"gua_name": "火风鼎", "palace": "离宫",
"lines": "——-----", "moving": "第1爻", "biangua": "火天大有",
"date": "乙巳日 丙戌月",
"preview_note": "支付后解锁完整盘面:六爻纳甲、六亲、六神、世应、旬空 + AI 断卦解读"
}
}
200(已付款):content 含 gua(卦名/卦宫/世应)、yao6、biangua(变卦)、date(干支/旬空)、reading(AI 断卦)、disclaimer。
代摇确定性:代摇 tosses 在建单时以订单号为种子锁定,预览的卦与付款后交付的卦完全一致;同一输入重试复用同一订单,不会重复摇卦。
展示要求
- 402 时先展示 preview 的真装卦结果(卦名+卦宫+动爻+变卦),再引导解锁完整纳甲盘。
- 200 后按「初爻→上爻」顺序呈现六爻盘面(爻位/纳甲/六亲/六神/世应/旬空/动变),最后给 AI 断卦解读与变卦。
声明:本服务基于中国传统易学文化,结果仅供文化参考与娱乐,不构成任何医疗、投资、法律或重大决策建议。