八字排盘

概述

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

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

如何购买接口

前往八字排盘接口购买页购买，套餐如下：

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

获取与配置 API Key

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

CHINAZ_BAZI_API_KEY

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

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

macOS/Linux 当前终端会话：

export CHINAZ_BAZI_API_KEY='你的专属APIKey'

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

运行要求

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

需要收集的信息

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

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

查询流程

1. 按上表收集用户信息，将性别转换为：男=1，女=0；是否类问题转换为：是=1，否=0（闰月否=2）。
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。

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

结果解读

查询成功时，结果包含：

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

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

推荐答复格式：

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

错误处理

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

使用边界

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