星运神谕

解决什么问题

占星类应用常见两种偷懒做法：一是纯查表式星座判断，输入生日只返回太阳星座，其余内容靠模板拼凑；二是本地跑星历计算，但解读文案仍然随机生成，同一天重复查询结果可能不一致。星运神谕（StarOracle）把两件事拆开处理：行星位置用真实星历算，解读由 AI 生成，并保证同一星盘当天查询结果稳定。

核心能力与工作方式

本命盘解析基于 Swiss Ephemeris（pyswisseph）计算太阳、月亮、上升及七大行星的落座与落宫，再由 qwen-turbo 生成五部分深度报告（性格本质、情感模式、事业倾向、成长建议等）。配对、年度、每日运势则走预生成文案库加付费接口返回结构化 JSON 的路线，配对覆盖 66 组组合。

所有功能统一通过 HTTPS 付费接口 https://meihua.astrakairos.com/constellation/api/resource 获取，按次计费，走微信支付 X402 协议。调用流程固定三步：

• 首次 POST 携带 task_type 与参数（birthday、pair、yearly、daily）；
• 服务返回 HTTP 402，从响应头提取 WeixinPay-Required 和 X-Out-Trade-No，两者都必须保存；
• 支付成功后携带这两个响应头重发完全一致的请求体，拿到 HTTP 200 与付费报告。

适用边界与注意点

• 调用方 Agent 必须先安装 weixinpay 插件，否则流程应直接终止，不能降级为免费输出；
• 第三步重试最容易被遗漏：不携带 X-Out-Trade-No 永远拿不到付费内容，也不会正确计费；
• 本机 constellation.py 仅用于后端开发调试，不参与付费调用；
• 星座名必须是 12 星座标准中文名，日期严格为 YYYY-MM-DD，周期可选今日/本周/本月；
• AI 生成失败时自动降级为静态模板，服务不中断，但此时输出与动态文案存在差异。