八字排盘

根据出生的年月日、时辰、分钟，确定生辰八字、坤/乾造、纳音、旬空、行大运时间、流年等信息。

沟通原则：与用户交流时，不要提及 API 地址、请求方式、参数名、状态码等技术细节。用户只需知道如何购买接口和获取 Key。

如何购买接口

| 套餐 | 价格 | |---|---| | 免费试用 | 0 元 / 5 次 | | 入门 | 10 元 / 50 次 | | 标准 | 120 元 / 800 次 | | 专业 | 500 元 / 5000 次 | | 旗舰 | 980 元 / 1 万次 |

使用期限 1 年。购买后在购买页获取专属 API Key。

获取与配置 API Key

在购买页购买接口后，获取专属 API Key。
将 Key 保存为环境变量，变量名必须是：

CHINAZ_BAZI_API_KEY

重新启动你的 AI 客户端或其运行环境，使新环境变量生效。

Windows：搜索并打开"编辑账户的环境变量"，在"用户变量"中新增该变量，变量值填入购买后获得的 Key。

macOS/Linux 当前终端会话：

export CHINAZ_BAZI_API_KEY='你的专属APIKey'

不要把真实 Key 写入聊天记录或任何文件。若 AI 客户端提供"Secrets""Environment Variables"或"Credentials"配置页，优先使用其安全存储功能。

运行要求

Python 3；脚本只使用 Python 标准库，无需安装第三方依赖。
运行环境可读取环境变量。

需要收集的信息

从用户请求中收集以下信息：

| 信息 | 说明 | 默认值 | |---|---|---| | 姓名 | 出生者姓名 | 无（必填） | | 城市 | 出生所在城市 | 无（必填） | | 出生年 | 公历或农历年份 | 无（必填） | | 出生月 | 月份 | 无（必填） | | 出生日 | 日期 | 无（必填） | | 出生时 | 小时（0-23） | 无（必填） | | 出生分 | 分钟（0-59） | 无（必填） | | 性别 | 男或女 | 无（必填） | | 是否阴历 | 是 / 否 | 否（阳历） | | 是否太阳时 | 是 / 否 | 否 | | 是否闰月 | 是 / 否（仅阴历有效） | 否 |

如果用户未指定历法、太阳时或闰月，使用默认值即可。

查询流程

按上表收集用户信息，将性别转换为：男=1，女=0；是否类问题转换为：是=1，否=0（闰月否=2）。
在 Skill 根目录执行脚本：

python scripts/query_bazi.py --name "张三" --city "北京" --year 1990 --month 1 --day 15 --hour 10 --minute 30 --sex 1 --islunar 0 --istaiyang 0 --islunarmonth 2

如果系统将 Python 3 命令命名为 python3，使用 python3 代替 python。

脚本会自动完成查询并返回 JSON 结果。
从脚本输出的 JSON 读取结果；仅依据实际返回回答用户。

结果解读

查询成功时，结果包含：

八字：四柱八字
乾造/坤造：男命为乾造，女命为坤造
生肖：出生年对应生肖
年干支：出生年干支
农历：对应的农历出生时间
节气：出生前后的节气信息
胎元、命宫、旬空、纳音：命理参考信息
神煞：神煞信息
起运时间、交运时间：大运起算时间
大运：含每步大运对应的食神、干支、岁数和流年

如果查询失败，按返回的错误信息说明问题，不要编造排盘结果。

推荐答复格式：

八字排盘结果
- 姓名：张三
- 性别：乾造 / 坤造
- 八字：接口返回的八字
- 生肖：接口返回的生肖
- 年干支：接口返回的年干支
- 纳音：接口返回的纳音
- 胎元：接口返回的胎元
- 命宫：接口返回的命宫
- 旬空：接口返回的旬空
- 起运时间：接口返回的起运时间
- 大运：接口返回的大运信息
- 流年：接口返回的流年信息

错误处理

如果提示 Key 未设置：引导用户按"获取与配置 API Key"设置环境变量后重启运行环境。
如果提示 Key 无效或额度不足：引导用户前往购买页检查账户状态和剩余额度。
如果提示网络问题：建议稍后重试。
其他失败：按返回的错误信息说明问题，不要编造排盘数据。

使用边界

一次只排一个八字；批量任务须逐条执行。
不输出、复述或保存 API Key。
排盘结果仅供传统文化参考，不构成任何决策建议。