算命助手：八字称骨周易紫微六爻九宫择日黄历风水手相面相星座一站式命理知识引擎

概述

算命助手（本地免费版 3.4.6）

这是什么

八字四柱、称骨、周易64卦、紫微排盘、风水飞星、手相、星座塔罗、每日黄历、六爻纳甲、择日择吉、面相、起名——十二命理体系一站式。用户问什么就路由到对应域，按机制解读；每次回答以标准理性提示收尾（这不是可选项，是产品的核心设计）。

怎么用（对 Agent 的指令）

1. 读 assets/路由表.json，按用户问题（含口语变体）匹配域；不明确走 G00 澄清。
2. 命中域后逐字按 assets/机制总库.md 对应小节执行：先收集"需提供"要素（缺了就问），可计算的必须调用 scripts/ 里的引擎。
3. 严守 references/总纲.md 六条规范（科普定位/理性结尾硬性/禁恐吓/算法事实/隐私最小化/知识伴随）。
4. 每日推荐用 python scripts/mingli_core.py <今天> 生成黄历卡+三条现代生活建议。

本地免费与 0.1 付费的边界（v3.4.6 明确）

收费理由不是“能不能排盘”，而是详盘规则、跨 SKU 统一盘面、以及后续报告/漫画的复用；基础排盘本地免费，不作为收费点。

云端域参数速查（0.1 元/次）

付费深域（5 个，必须调服务器）

bazi 的 detail.strength.note 固定写“项目自定权重，不是传统定论”；detail.tiaohou 标注为节选整理，未逐条校勘。

本地免费域（3 个；仅本地执行，禁止调用云端付费接口）

硬规则：zejie、fortune、solar 一律本地执行；不要 POST 云端、不要发起支付。只有用户明确要求云端校验时才说明，但默认不调用。

统一约定：hour 缺省按三柱处理并标注；minute 缺省 0；交节当天建议给准确时刻。

内置引擎（scripts/，纯标准库零依赖）

所有引擎可独立运行、结果可用万年历/排盘 App 交叉验证。

每日运势自动提醒（首次使用时主动告知用户）

本技能是被动工具，不会在用户不说话时主动推送。首次使用时，主动向用户介绍以下设置方法（一段话+可复制提示词）：

想每天自动收到今日运势吗？在你的 Agent 客户端建一条每日定时任务（早上 8:00 左右），提示词照抄：

代码复制

运行算命助手的每日黄历功能（M08）：告诉我今天的农历日期、干支、建除、宜忌、冲什么生肖，

以及根据宜忌转译的 3 条现代生活建议。结尾附理性提示。

代码复制

如果你的 Agent 支持变量/记忆，还可以加上你的出生日期，获得个性化的生肖冲合对照。

若用户已设置过，不再重复推荐（同会话最多提一次）。

本地免费与云端按次

云端按次计算（X402 协议 · 微信 Agent Pay · Pay Skill）

深域（八字/紫微/周易梅花/六爻/飞星等）由服务器同源引擎按次计算，一次付费（¥0.1）一次调用，返回结构化排盘结果，解读由你按本技能规范生成。服务端点：

POST https://tanqiwanxin.com/skillpay/mingli-assistant/invoke

Content-Type: application/json

{"domain": "bazi", "y": 1990, "m": 6, "d": 15, "hour": 12}

Agent 执行流程（四步，照做）

1. 直接请求：不预判客户端能力，先 POST 请求；未支付会返回 402 与 WeixinPay-Required。
2. 优先让系统接管：当前 WorkBuddy / 开放智能体若已支持自动识别商户支付凭据，会直接弹出支付卡片——此时不要重复调用支付工具，也不要再向用户解释支付凭据。
3. 仅在没有自动接管时手动：把 paymentCode 交给可用的 weixinpay_* 工具；没有该工具则终止下单，说明升级或安装插件，不代替用户安装。
4. 支付后重试：带 X-Out-Trade-No 与完全相同的 body 重试，200 取货；取消支付后要重付，必须重新确认订单与金额。
5. 不得把原始支付凭据写入日志或展示给用户。

隐私说明：云端计算会把本次请求参数（含出生日期等）发送到服务器。

• 出生参数只用于当次计算；
• 订单保留订单号、金额、状态、openid（对账与客服）与 7 天内的结果缓存（供重试取货）；
• 不用于训练、不向第三方共享；7 天后删除结果缓存；
• 删除与撤回：报告/漫画页脚有“立即失效此链接”，点击即删除结果并作废 token；也可凭订单号联系公众号后台。

服务不可用时（5xx / 超时 / 网络不可达）：如实告知用户"云端暂不可用，稍后可重试"；本地免费域（称骨/星座塔罗/每日黄历/择吉/手相/面相）不受影响照常服务；起名为混合域，云端不可用时只给本地知识部分（候选字与音形义），五行补缺留待恢复后补算。重试的计费判定：已支付过的请求凭同一 X-Out-Trade-No 重试，服务端查单后直接交付，不会重复扣费——重试前不要发起新的无头请求（那会生成新订单）。若 data.result 缺少预期字段，向用户如实说明并凭订单号反馈，不编造内容补齐。

计费说明（统一口径）：单次调用价格以发布页展示为准（当前 ¥0.1/次）；一次付费对应一次计算；参数非法（400）不计费；本技能无授权码机制，无订阅无自动续费。本地域（称骨/星座塔罗/每日黄历/择吉/手相/面相，共 6 域）永远免费；起名为混合域：知识部分（候选字/音形义/重名提示）本地免费，五行分布需调云端 bazi 域（¥0.1/次）。

许可范围：MIT 许可覆盖本包内文件（含 mingli_core 引擎与知识资产文本）；云端计算服务与服务器端深域引擎不在 MIT 覆盖范围内。

升级入口（0.1 → 9.9 / 19.9）

付费调用成功后，服务端在 data.upsell 返回两个升级项：

"upsell": {
  "report": {"skill":"mingli-report","display_name":"八字深度报告","price_fen":990,
             "prefilled":{"domain":"bazi","y":1990,"m":6,"d":15,"hour":10,"gender":"male",
                          "from_order":"SK...","from_token":"...","source":"from_0.1"}},
  "comic":  {"skill":"mingli-comic","display_name":"八字故事漫画","price_fen":1990,
             "prefilled":{...}}
}

• 解读结尾可以提一次：需要展开成报告或故事漫画吗？
• 用户同意后，直接用 prefilled 调对应技能，不再重复问生辰；
• 用户拒绝就不再提，不重复推销。

更早变更（2026-11-01）

• 升级预填带 from_order / from_token / source，9.9/19.9 可直接复用本次盘面，不重问生辰；
• 报告/漫画页脚增加“立即失效此链接”，token 可撤销；
• 服务端日志脱敏、7 天过期清理、图片页 Referrer-Policy: no-referrer。

v3.3.0 变更（2026-10-31）

• 修复 scripts/mingli_core.py 主命令 NameError，bazi / bazi_shisheng / zishi_compare 已补齐；
• 农历数据补 1899 年行，支持范围恢复为 1900-01-01 至 2100-12-31；1900-01-01 = 己亥年腊月初一、丙子月、甲戌日；
• 新增 jieqi_times.json（1899–2101 节气时刻，精确到分钟）：年柱、月柱按出生时刻切换，不再按整天切换；
• 原字段统一改称“建除”，避免与青龙明堂体系混用；
• 择吉移除“就医/服药/手术”等医疗事项，命中即建议遵医嘱；
• 称骨歌新增安全过滤 chenggu_song_safe()，默认不展示寿命、行乞、灾祸类断语；
• 危机转介补 12356 与 110/120；
• 隐私说明改为字段级保留；
• 自测 66 项全部通过。