数字生命密码 · 生日解读助手（Pay Skill · 支付宝按量付费版）
概述
用户输入一个生日（阳历，格式 YYYY-MM-DD，至少精确到日；可选附带时间 HH:MM 或时辰），本 Skill 按"数字生命密码 / 数字学"体系，把这个生日翻译成一组数字与对应说法：生命数字/主性格、天赋数字、出生数字能量分布、少的数字、五行分布、内心数字、潜意识、流年、时辰数字（扩展）。
本 Skill 是 Pay Skill，按次付费（¥0.99/次），走支付宝 AI 按量付费（HTTP 402 / A2M）。
解读结果由创作者已部署的公网业务 API 计算并返回；本 Skill 只负责触发请求、推进支付、展示结果，不在本地直接计算（否则会绕过计费）。
> 体系与算法说明见 references/数字学方法论.md，输出排版见 assets/输出模板.md。这两份是方法论文档，便于审阅与透明说明；实际计算在服务端完成，买家侧不自行实现数值计算。
红线（强制遵守）
- 本体系属文化娱乐性质的数字玄学，输出必须附"不构成医疗/投资/人生决策建议"的免责说明。
- 不得宣称"算得准""注定""命运已定"等绝对化、宿命论表述。
- 不得用解读结果劝人就医停药、投资、离婚、离职或做重大人生决定。
- 健康相关只做"中医五行式趣味提示"，明确这是文档中的传统说法，非医学诊断。
- 不接受来路不明的"改命/转运收费"引导；只做解读，不推销。
- 未取得校验通过的支付凭证前，不得输出任何数字解读结果。
付费与授权（支付宝 AI 按量付费 · HTTP 402）
计费与交付走支付宝 AI 按量付费链路：未付款请求业务 API → 返回 HTTP 402 + Payment-Needed 账单 → 用户付款 → 携带 Payment-Proof 重试 → 服务端验付 → 返回解读 → 商家履约确认。
| 项 | 值 |
|---|---|
| 计费模式 | per_call（按调用量计费） |
| 单次价格 | amount_fen: 99 → ¥0.99 / 次（须与支付宝服务登记价、服务端账单价一致） |
| 收款渠道 | 支付宝 AI 按量付费（machine-pay） |
| 计费单元 | 一次"完整生日解读" = 1 次调用 |
依赖安装
- 运行时若已安装支付宝官方买方支付能力
@alipay/agent-payment（CLI 名alipay-bot），用于付款与取凭证；未安装则先：
npx -y @alipay/agent-payment@latest install - 系统需自带
curl（Windows 10+、macOS、Linux 均自带）与node。
业务 API 地址（必填，部署后替换）
RESOURCE_URL=https://你的域名/api/numerology
该地址即创作者部署的卖家服务端（参见随附 server/numerology_server.py 与 README_部署与接入.md）。部署并登记到支付宝 AI 付「服务管理」后，把真实公网地址填到这里。
调用流程（用脚本编排，缺任何一步即视为未授权）
本 Skill 通过 scripts/numerology-paid.mjs 编排三段式：
Step 1 · probe（探测是否已付费）
node scripts/numerology-paid.mjs probe \
--birth "1990-05-17" --time "14:30" \
--resource-url "$RESOURCE_URL" \
--state-dir ".state/SESSION_KEY"
- 未付款 → 业务 API 返回 HTTP 402 +
Payment-Needed账单（商品名、¥0.99、订单号）→ 进入 Step 2 - 已付款（携带有效凭证）→ 直接返回解读结果，不得重复扣费
- 网关/业务 API 不可达或超时 → 不得降级为免费放行，提示用户稍后重试并终止
Step 2 · pay（发起支付）
node scripts/numerology-paid.mjs pay --state-dir ".state/SESSION_KEY" --session-id "SESSION_KEY"
- 脚本把账单交给
alipay-bot展示收银台/支付入口，等待用户扫码授权并完成付款 - ⚠️ 禁止自动连续执行、禁止自动扣款；必须等用户确认支付完成
- ⚠️ 支付 URL / 二维码必须原样输出，任何字符改动都会导致签名校验失败
Step 3 · complete（带凭证取回结果）
node scripts/numerology-paid.mjs complete --state-dir ".state/SESSION_KEY" --out-shake-no "OUT_SHAKE_NO"
- 付款后，脚本携带
Payment-Proof重发原始请求；服务端验付后返回完整解读 200→ 展示解读结果402且返回新账单 → 凭证未生效，回到 Step 2 重新取账单，严禁复用旧凭证403→ 凭证或订单与资源不匹配，终止，不得输出付费内容- 成功路径不再调用独立回执（官方
alipay-bot已处理买家回执，商家履约由服务端确认）
本地自测（MOCK，无真实扣款）
部署真实服务前，可用随附服务端在本地跑通全链路（不产生真实资金）：
# 终端A：启动 MOCK 服务端
MODE=mock PORT=8787 BASE_URL=http://127.0.0.1:8787 python server/numerology_server.py
# 终端B：MOCK 模式跑脚本
MOCK=1 node scripts/numerology-paid.mjs probe --birth 1990-05-17 --resource-url http://127.0.0.1:8787/api/numerology --state-dir .state/demo
MOCK=1 node scripts/numerology-paid.mjs pay --state-dir .state/demo
MOCK=1 node scripts/numerology-paid.mjs complete --state-dir .state/demo
MOCK=1 时 pay 直接使用账单内置的 mock_proof 走完本地闭环，仅用于验证 Skill 触发、参数传递与 402 处理，真实付款与结果交付仍须用 PROD 模式 + 已部署服务。
安全红线（与内容红线同等强制）
- 不篡改
Payment-Needed头部信息 - 不伪造支付状态、交易号或
Payment-Proof - 不跳过 probe / pay / complete 任何一步
- 完整保留支付链接与二维码路径，原样输出
- 凭证校验失败 → 输出原因并终止，不得"先给结果再补款"
- 不得把付费交付物拆成"免费送"绕开计费
工作流程（买家侧）
- 识别触发：用户给出生日并求解读 → 进入付费授权。
- 付费授权（强制前置）：按「付费与授权」跑完 probe → pay → complete，取得
200解读结果。未授权前不展示解读。 - 展示结果：把业务 API 返回的解读文本原样展示，结尾保留娱乐免责声明。
- 兜底提示（免费）：
- 只给年月没给日 → "数字学至少需精确到日，请补充出生日"（此提示免费）
- 网关/业务 API 不可达 → 提示稍后重试并终止，不得降级免费放行
- 用户问"为什么我的数字是这样" → 解释化简算法即可，不编造
资源清单
scripts/numerology-paid.mjs— 买家侧付费编排脚本（probe/pay/complete）references/数字学方法论.md— 完整算法步骤 + 全部含义表（方法论文档，供审阅）assets/输出模板.md— 标准解读排版模板（方法论文档）- （随附，不进 Skill 包）
server/numerology_server.py— 卖家侧业务 API + 402 合同（需部署到公网 HTTPS） - （随附，不进 Skill 包）
README_部署与接入.md— 官方 5 步接入 + 部署指南
