紫微斗数命盘解读台（Pay Skill）
每次成功调用 ¥0.05（支付宝 AI 按量付费 / A2M 协议自动收款）。
功能说明
输入紫微斗数主星或宫位关键词（支持一次多个，空格/逗号分隔），返回对应星曜/宫位的含义速查表，输出 JSON 格式。服务端为纯本地对照库（十四主星 + 十二宫），不外联第三方、不读取用户本地文件。
服务端为纯本地数据/模板库（紫微斗数命盘解读），不外联第三方、不读取用户本地文件、不访问用户隐私。
付费采用支付宝 AI 按量付费（A2M 协议）：402 报价 → 用户支付 → 服务端验付 → 履约确认 → 返回结果。
适用场景
- 看盘时记不住某主星含义，快速查紫微/七杀/贪狼等解读
- 断宫位时想不起夫妻宫/财帛宫/官禄宫主什么
- 写命理内容、做直播讲解时即时调取星曜与宫位释义
不适用 / 能力边界
- 本工具不适用：只做「星曜/宫位 → 含义」速查，不排完整命盘、不推大运流年
- 本工具不适用：结果仅为常用整理，命理判断以师承与综合盘局为准，本工具不替代专业命理师
- 本工具不适用：只覆盖十四主星与十二宫基础含义，特殊格局与四化飞星不在库内
使用方法（A2M 四步完整流程）
第一步：请求资源（无凭证首调，预期返回 402）
GET https://viral-hook-pro-pay-308980-8-1461759720.sh.run.tcloudbase.com/api/ziwei-life-read?q={关键词}
q：关键词，必填；多关键词用空格/逗号分隔。- 也可用打包脚本一键走完整流程：
python scripts/ziwei-life-read_client.py --q "示例"
第二步：处理 402 账单
无有效凭证时返回 HTTP 402，响应头 Payment-Needed 为 Base64url 编码的账单（含订单号、金额、卖方 RSA2 签名）。把该头原样保存到仅当前用户可访问的安全文件，不得解码改写账单内容。
第三步：发起支付
读取 alipay-payment-skill，按其 402-buyer-pay 流程将账单交给支付宝收银：
alipay-bot 402-buyer-pay --session-id '<当前会话ID>' --file '<账单安全文件>' \
--resource-url '<第一步的完整URL>' \
--intent-summary '原始请求：紫微斗数命盘解读' --method GET
向用户展示收银二维码/链接，由用户在支付宝 App 内授权付款（首次使用需开通 Agent 支付）。
第四步：付款后取回结果（必须执行）
用户付款后按 alipay-payment-skill 取得 Payment-Proof，带 Payment-Proof 头重放第一步的同一 URL。服务端验付并履约后返回结果，响应头 Payment-Validation 即履约确认凭证（请留存备查）。
触发示例
- 「紫微是什么意思」→ 调用
q=紫微是什么意思 - 「夫妻宫主什么」→ 调用
q=夫妻宫主什么 - 「七杀坐命怎么样」→ 调用
q=七杀坐命怎么样 - 「命宫太阴」→ 调用
q=命宫太阴
参数说明
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
q |
query | ✅ | q 关键词，必填 |
Payment-Proof |
请求头 | 付款后重放时必带 | 支付宝返回的支付凭证（Base64url），原样携带 |
Payment-Needed（响应） |
响应头 | — | 402 时返回的账单（Base64url），交给 alipay-bot 402-buyer-pay |
Payment-Validation（响应） |
响应头 | — | 履约确认凭证，付款重放成功时返回 |
示例输出
返回 JSON 结构如下：
{
"query": "夫妻宫 七杀",
"matched": 2,
"results": [
{"key": "夫妻宫", "desc": "夫妻宫：配偶性情、婚姻质量与感情走势，桃花与缘份所系。"},
{"key": "七杀", "desc": "七杀：南斗将星，主果决、变动与开创；庙旺成事，落陷孤克。"}
]
}
履约确认与订单持久化幂等（服务端保证）
- 订单持久化：每次 402 生成全局唯一
out_trade_no（前缀 GK + 毫秒时间戳 + 随机串），订单即时写入服务端 SQLite orders 表（out_trade_no主键 +trade_no唯一索引），含金额、商品名与 30 分钟支付时限。 - 服务端验付：收到 Payment-Proof 后，服务端先调支付宝「AI 按量付费验付接口」核验凭证真伪，并比对订单号、金额、商品一致性，任一不符按未支付处理。
- 履约确认：验付通过后执行支付宝「履约确认」接口，并以响应头
Payment-Validation回传确认结果。 - 幂等：同一订单只履约一次——重放同一 Payment-Proof 直接复用已生成结果，不会重复扣费、不会重复计价；订单状态 UNFULFILLED → PENDING_CONFIRM → FULFILLED 全程留痕可对账。
测试验证
- 2026-09-19 线上实测：GET /api/ziwei-life-read?q=示例 → HTTP 402 报价，返回账单与订单号；付费重放后返回结果并携带 Payment-Validation 履约确认头 ✅
异常处理
q缺失 → 422（参数校验），补q重试- 账单过期（30 分钟）或验付失败 → 再次返回 402 新订单，重新走支付流程即可
- 重放时未带
Payment-Proof→ 按 402 处理，不会误判为已支付
版本更新
- v1.0.0（2026-09-19）：首发，按 plc-term-map-pay v1.0.1 模板生成；含 A2M 四步流程、一键付费脚本、TRACE≥90 质量闸通过。
说明
- 结果为常用整理，具体以权威来源为准
- 服务端纯本地数据/模板库，不外联、不读取用户文件
- 内容由 AI 整理生成
与免费版的区别（请如实告知用户）
我们同时提供永久免费的 ziwei-life-read。两者分工如下：
> 这两版是互补关系，不是升级关系 —— 解决的问题不同，按场景选用。
免费版 ziwei-life-read |
本版 ziwei-life-read-pay |
|
|---|---|---|
| 给什么 | 完整命盘解读：命宫主星格局、三方四正、四化飞星、大限流年 | 十四主星/十二宫速查：查单个星曜或宫位含义，随手查词 |
| 技术实现 | 纯提示词推理（本地，通用模板） | 调服务端模板库 API |
| 适合场景 | 偶尔用一次、先试试效果 | 经常用、要批量产出、要稳定风格 |
| 价格 | ¥0 永久免费 | ¥0.05/次 |
> 两版定位互补，不是升级：先用免费版做整盘解读，读盘时遇到不认识的星曜/宫位，用本版速查。
建议路径：免费版排盘/整盘解读 → 遇到不懂的术语/星曜 → 用本版速查。
