生辰八字宝典

概述

技能概述

本 Skill 提供 生辰八字 & 五行属性 综合查询服务。当用户询问某个公历出生日期与出生时辰对应的八字、五行、干支、农历等信息时，使用此技能。

该服务是基于微信支付 Agent Pay（X402 / HTTP 402）协议的付费资源。买家（消费者 Agent）通过本 Skill 向卖家服务端发起资源请求，服务端将返回 402 响应（含 WeixinPay-Required、X-Out-Trade-No），买家需通过 weixinpay 插件完成付款后重新请求获取资源。

涵盖内容：

1. 公历与农历对照：公历年月日、农历年月日、农历中文月日、星期、是否闰月
2. 干支纪年体系：年柱、月柱、日柱干支，节气信息
3. 属相与星座：生肖属相、对应星座
4. 生辰八字：四柱八字（年月日时）、日主五行属性
5. 五行分析：四柱对应五行、五行缺失情况

适用场景：

1. 用户查询指定公历出生日期与出生时辰的完整生辰八字
2. 用户查询出生日期的五行属性、五行旺缺
3. 用户查询出生日期的农历、干支、属相、星座等基础命理信息

付费前置检查

调用本 Skill 前，检查当前 Agent 是否已安装 weixinpay 插件：

• 已安装：可继续提供付费服务
• 未安装：提示"当前 Agent 暂不支持微信支付付费能力"，终止流程

依赖安全管控

1. 第三方接口依赖：聚合数据生辰八字接口，仅允许文档指定域名 apis.juhe.cn，禁止转发请求至其他第三方域名。

二、用户意图安全触发规则

2.1 正向触发双条件（必须同时满足）

条件1：意图关键词命中（任意一条）

生辰八字类：生辰八字、八字查询、八字测算、五行属性、五行旺缺、五行缺什么、生辰宝典、出生时辰、四柱八字、干支纪年、农历八字。

条件2：具备有效查询参数

用户输入包含明确的公历出生年月日；出生时辰 hour 为接口必填项，用户未提供时需引导补充（0~23 点），禁止在未获用户确认的情况下默认填充时辰。

2.2 强制拦截黑名单（命中任意一条，直接阻断技能触发，拒绝调用付费接口）

1. 纯科普无查询诉求：八字起源、五行学说科普、命理文化常识类问答
2. 模糊无参数提问：只说「算八字」「查五行」但不提供具体出生年月日
3. 跨品类命理诉求：星座运势、生日书/生日密码/生日花语、星盘、塔罗、奇门、风水等非生辰八字业务
4. 纯闲聊无查询：命理趣味玩梗闲聊，无八字/五行查询需求
5. 仅基础换算提问：单纯询问「某月某日是什么星座」「某日是星期几」，无八字/五行查询需求

2.3 触发示例区分

✅ 合法触发（允许进入付费流程）

1. 帮我查 2021 年 1 月 15 日 15 点出生的生辰八字
2. 1990 年 5 月 20 日早上 8 点的五行缺什么
3. 查一下 2000 年 8 月 8 日午时（12 点）的八字四柱
4. 生辰宝典：1988 年 3 月 3 日 23 点出生五行属性

❌ 拦截不触发（直接终止流程）

1. 什么是生辰八字
2. 帮我算一下八字（无具体出生日期）
3. 7 月 25 日的生日书是什么
4. 狮子座今日运势怎么样
5. 8 月 20 日是什么星座

三、用户数据安全规范

3.1 采集数据清单（仅采集以下字段，禁止额外抓取用户信息）

仅临时内存读取用户输入的四类查询参数（均为 string）：

1. year：公历年份（1900~2100）
2. month：公历月份（1~12）
3. day：公历日期（1~31）
4. hour：出生时辰（0~23）

本技能全程不采集、不读取、不存储手机号、身份证号、姓名、住址、银行卡、人脸、设备标识、地理位置等其他敏感个人信息；仅采集完成八字查询所必需的公历出生年月日与出生时辰。

3.2 数据传输安全规则

1. 传输协议：使用 HTTPS 加密传输
2. 数据最小化：仅把 year + month + day + hour 四个业务参数上传至聚合服务端，不附加用户会话、设备、身份附加字段
3. 单次临时传输：参数仅本次接口请求使用，请求结束后内存立即销毁，无本地磁盘持久化存储、无日志落地完整查询参数、无缓存留存
4. 禁止数据共享：查询参数不得转发至 weixinpay 插件以外任何第三方服务

3.3 数据生命周期管控

1. 采集阶段：仅用户确认付费后读取输入参数，未确认前不解析、不缓存任何用户输入
2. 使用阶段：仅用于聚合生辰八字接口入参，不可用于统计、营销、用户画像等其他用途
3. 销毁阶段：接口请求完成/支付失败/用户取消三种场景下，立即清空内存参数，无延时留存
4. 留存禁止：不写入本地文件、数据库、日志完整出生查询内容；日志仅记录匿名请求计数，不含用户原始查询文本

3.4 隐私告知强制规范

付费确认弹窗必须完整公示隐私条款，缺失则不允许收集参数发起请求：

🎨 本服务为生辰八字宝典技能，由聚合数据提供技术支持。

• 费用：XX 元/次（以实际支付为准，禁止预估费用）
• 支付方式：微信支付（通过 weixinpay 插件完成）
• 隐私说明：仅将你本次查询的公历出生年、月、日、时四个参数临时加密发送至聚合数据服务端用于生辰八字、五行信息查询，请求结束后数据立即销毁，无长期存储；本技能全程不会采集、存储你的身份证、手机号、姓名、住址、银行卡等其他个人隐私信息

如您同意以上条款，请回复「确认」「好的」「可以」「继续」「同意」「下一步」等肯定词或补充需要查询的出生年月日与出生时辰。

如您不需要付费服务，请回复「取消」，本次查询立即终止，不记录任何查询信息。

四、付费与微信 Agent Pay X402 收单安全流程

4.1 标准化七步安全工作流（不可调整步骤顺序）

第一步：付费告知与确认（必须执行）

在收集任何参数之前，必须先向用户明确以下信息：

🎨 本服务为付费生辰宝典查询，由聚合数据提供技术支持。

• 费用：XX元/次（以实际支付为准，禁止预估价格）
• 支付方式：微信支付（通过 weixinpay 插件完成）
• 您本次查询的公历出生年、月、日、时四个参数将被发送至聚合数据服务端用于生辰八字、五行信息查询，请求结束后数据立即销毁，无长期存储；本技能全程不会采集、存储你的身份证、手机号、姓名、住址、银行卡等其他个人隐私信息

如您同意以上条款，请回复 “确认” 或继续提供出生年月日与出生时辰。

如您不需要付费服务，请回复 “取消”，我将停止本次操作。

只有用户明确表示同意（如回复“确认”“好的”“可以”“同意”“继续”“下一步”等肯定词）后，才能进入第二步收集参数。 未获取用户明确同意前，禁止解析、提取、缓存任何出生参数；用户回复「取消」直接销毁所有临时输入缓存，结束流程。

第二步：收集用户参数

1. 如果用户需要查询生辰八字，向用户询问以下参数：

1. 发起请求前，对用户提交的参数进行校验：

• 任一必填参数缺失时，引导补充，禁止发起网络请求；禁止在未获用户确认的情况下默认填充时辰
• 用户说「子时」「午时」等时辰时，转换为对应小时数（如子时→0，或按用户确认的时辰范围取代表小时）
• 四个字段均以 string 传递，如 "2021"、"1"、"15"、"15"
• 过滤特殊注入字符（&、$、反引号、转义符、SQL 注入、XSS、HTML 脚本标签），清洗非法字符后再组装请求体
• 校验不通过时：拒绝发起请求，提示「出生参数格式非法，请提供合法的公历年月日与时辰」，不向服务端发送任何数据
• 校验通过后才允许构造请求体发起 402 请求

第三步：请求约束（⚠️ 必须严格执行执行）

• 请求方法：POST
• 请求头HEADER：Content-Type: application/json
• 请求体Body：json字符串，请严格按照以下格式填写：'{"resourceId":"120","data":{"year":"<公历年份>","month":"<公历月份>","day":"<公历日期>","hour":"<出生时辰>"}}'
• 固定 resourceId 不可修改：120
• 注意请求参数中如果出现引号，需要进行转义，自动将英文引号替换为中文引号，避免json字符串异常
• 禁止追加自定义字段、用户会话 ID、设备信息至请求 data 内部

第四步：请求资源

向用户展示待查询的出生参数，严格遵守请求约束，向以下 URL 发起请求：

curl -X POST https://apis.juhe.cn/a2a/wechat 
  -d '{"resourceId":"120","data":{"year":"<公历年份>","month":"<公历月份>","day":"<公历日期>","hour":"<出生时辰>"}}' 
  -H "Content-Type: application/json"

第五步：处理 402 响应

服务端会返回 HTTP 402，响应中同时包含支付码和订单号，必须两者都保存，同时agent必须向用户展示下面的订单信息：

• 支付码：从 Header.WeixinPay-Required 或 Body.WeixinPay.WeixinPay-Required 中提取
• 订单号：从 Header.X-Out-Trade-No 或 Body.out_trade_no 中提取
• 订单信息：从 Body中提取 description(商品详情)、amount(订单金额)、out_trade_no(订单号)，展示给用户
• 必须展示：agent 必须向用户展示订单信息

预期响应示例：

{
  "code": "PAYMENT_REQUIRED",
  "message": "需要支付后才能获取内容",
  "WeixinPay": {
    "WeixinPay-Required": "d5c0bb6f-e040-4e53-9e68-9b235c565563",
    "prompt": "本次使用微信支付，请将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay，以向用户申请支付授权。"
  },
  "out_trade_no": "WX402_1753891234_a1b2c3d4e5f6",
  "description": "订单商品详情",
  "amount": "1.00",
  "currency": "CNY"
}

第六步：发起支付

将 WeixinPay-Required 值作为 paymentCode，调用 weixinpay_pay，引导用户完成微信支付。

第七步：支付成功后获取资源（⚠️ 必须执行）

支付成功后，必须重新发起请求获取付费内容，并且严格遵循下要求：

• 1.请求地址：与首次请求相同（https://apis.juhe.cn/a2a/wechat）
• 2.JSON body 不变：与首次请求完全一致，禁止更改
• 3.通过 Header 携带支付信息：将 402 响应中保存的 WeixinPay-Required 与 X-Out-Trade-No 原样带上
• 4.禁止篡改请求参数：严格禁止Agent以任何形式修改用户提交的原始请求参数（即JSON字符串），必须原样透传至下游技能。

curl -X POST https://apis.juhe.cn/a2a/wechat 
  -H "Content-Type: application/json" 
  -H "WeixinPay-Required: <402响应中保存的支付码>" 
  -H "X-Out-Trade-No: <402响应中保存的订单号>" 
  -d '{"resourceId":"120","data":{"year":"<公历年份>","month":"<公历月份>","day":"<公历日期>","hour":"<出生时辰>"}}'

注意：body 与首次请求完全一致，不要修改任何字段。支付信息通过 Header 传递。

第八步：格式化数据输出

1. 读取同目录下的 OUT_FORMAT.md
2. 按模板填充接口返回字段
3. 以清晰、美观的 Markdown 呈现给用户

4.2 异常情况处理

• 用户拒绝付款：尊重用户选择，告知用户该内容为付费资源，如需获取请完成支付。
• 请求返回非 402 状态码：如返回 200，直接展示内容；如返回 4xx/5xx 错误，告知用户服务暂时不可用，建议稍后重试。
• 其余异常情况按微信支付流程处理（支付失败/取消/退款等）。

五、Agent 运行强制约束

1. 参数缺失阻断：year/month/day/hour 任一必填参数为空，禁止发起任何网络接口请求
2. 支付凭证不可篡改：完整保存并原样回传 WeixinPay-Required 与 X-Out-Trade-No，禁止修改订单、价格、资源 ID 等核心收单字段
3. 数据来源真实性约束：所有八字、五行、干支、农历内容仅使用聚合接口返回数据，禁止本地虚构、编造命理内容
4. 输出格式约束：统一使用 Markdown 结构化输出，禁止原始 JSON、HTML 直接返回用户
5. 脚本过滤约束：接口返回富文本自动清除 script、iframe、a 跳转标签，仅保留纯文本段落
6. 参数用途约束：采集的出生年月日时参数仅用于本次接口查询，禁止用于统计、推送、缓存复用
7. 无缓存约束：不实现本地、内存、磁盘多级缓存，每次用户查询必须重新发起接口请求

六、日志安全审计规范

1. 禁止日志落地用户原始查询文本、出生年月日时等业务参数
2. 可记录匿名审计字段（无用户关联）：请求时间、请求状态码、订单创建计数、接口响应耗时、异常类型
3. 日志留存周期：本地审计日志自动 7 天滚动清理，不永久留存
4. 禁止日志输出完整 402 支付报文、订单明文信息，仅记录匿名订单计数

重要提示： 查询结果仅供参考娱乐，不具备科学依据。

七、合规与风险免责声明

7.1 内容合规说明

1. 本技能生辰八字、五行解读均为民俗娱乐类内容，无科学预测效力，不得作为婚恋、职业、财务、健康重大决策依据
2. 本技能不生成、不传播封建迷信、违法违规、涉黄涉暴、侵权肖像 / 名誉内容
3. 禁止基于接口数据输出医疗诊断、金融投资指导、法律判定类确定性结论

7.2 隐私合规声明

1. 本技能严格遵循《个人信息保护法》最小必要采集原则，仅采集八字查询必需的公历出生年月日与出生时辰
2. 第三方聚合数据接口传输全程 TLS 加密，无明文数据泄露风险
3. 无用户数据持久化存储行为，不存在用户信息泄露、倒卖、共享风险

7.3 风险免责提示

所有生辰八字、五行解读内容仅供休闲娱乐，用户需理性辨别，因轻信解读内容做出决策产生的一切后果由用户自行承担。