dvcrn 极速数据八字排盘（Jisu Bazi）
基于 八字排盘 API 的 OpenClaw 技能，根据出生的年月日、时辰、分钟和性别，排出生辰八字、乾/坤造、纳音、旬空、大运、流年等信息。
适合在对话中回答「帮我排个八字」「看一下 2009 年 10 月 18 日 凌晨 2:05 的八字」「哪一年大运、流年更有利于事业或感情」等问题。
使用技能前需要申请数据，申请地址：https://www.jisuapi.com/api/bazi/
重要说明：此接口仅用于娱乐和学习参考，不构成任何现实决策依据。
环境变量配置
# Linux / macOS
export JISU_API_KEY="your_appkey_here"
# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"
脚本路径
脚本文件：skills/bazi/bazi.py
使用方式
八字排盘
python3 skills/bazi/bazi.py '{\
"name":"张三",\
"city":"杭州",\
"year":2009,\
"month":10,\
"day":18,\
"hour":2,\
"minute":5,\
"sex":1,\
"islunar":0,\
"istaiyang":0,\
"islunarmonth":2\
}'
常用参数说明：
name：姓名（用于展示，可留空，但建议填写便于区分）city：城市，用于更精确地定位节气与太阳时（可为空字符串）year/month/day/hour/minute：公历时间，year支持 1901–2099 年sex：性别，1男，0女islunar：是否为农历时间，0为阳历（默认），1为阴历istaiyang：是否使用太阳时，0默认不使用，1使用太阳时islunarmonth：是否为农历闰月，仅在islunar=1时有效，1闰月，2否
请求参数（JSON）
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | 姓名 |
| city | string | 是 | 城市（可传空字符串） |
| year | int | 是 | 年（1901–2099） |
| month | int | 是 | 月 |
| day | int | 是 | 日 |
| hour | int | 是 | 时（0–23） |
| minute | int | 是 | 分（0–59） |
| sex | int | 是 | 性别：1 男，0 女 |
| islunar | int | 是 | 是否为农历：0 阳历（默认），1 阴历 |
| istaiyang | int | 是 | 是否使用太阳时：0 不使用（默认），1 使用 |
| islunarmonth | int | 是 | 是否闰月：1 是，2 否（仅在农历时有效） |
脚本会将上述字段原样传给 https://api.jisuapi.com/bazi/paipan，并直接输出 result 字段内容。
返回结果概览
返回结果字段较多，这里只列出主要结构（具体字段以 极速数据文档 为准）：
顶层主要字段：
| 字段名 | 说明 |
|---|---|
| year/month/day/hour/minute | 出生公历时间 |
| name/city | 姓名和城市 |
| istaiyang | 是否太阳时 |
| lunaryear/lunarmonth/lunarday/lunarhour | 农历时间 |
| animal | 生肖 |
| yearganzhi | 年干支 |
| jieqiprev | 出生的上一个节气（名称 + 日期） |
| jieqinext | 出生的下一个节气（名称 + 日期） |
| bazi | 生辰八字（年、月、日、时四柱） |
| taiyuan | 胎元 |
| minggong | 命宫 |
| xunkong | 旬空 |
| qiyun | 起运时间（年、月、日、时） |
| jiaoyun | 交运时间（年、月、日、时） |
| qiankunzao | 乾造/坤造（天干、地支、藏干等） |
| nayin | 四柱纳音 |
| shensha | 神煞（数组，竖排） |
| dayun | 大运（纳音、食神、干支、岁数、年份） |
| liunian | 流年列表 |
典型返回（节选）：
{
"year": "2009",
"month": "10",
"day": "18",
"hour": "02",
"minute": "05",
"name": "",
"city": "",
"istaiyang": "0",
"lunaryear": "2009",
"lunarmonth": "九月",
"lunarday": "初一",
"lunarhour": "丑时",
"animal": "牛",
"yearganzhi": "己丑",
"bazi": ["己丑", "甲戌", "丙申", "己丑"],
"taiyuan": "乙丑",
"minggong": "庚午",
"xunkong": ["午未", "申酉", "辰巳", "午未"],
"qiyun": { "year": "3", "month": "2", "day": "12", "hour": "2" },
"jiaoyun": { "year": "2012", "month": "12", "day": "30", "hour": "04" },
"dayun": {
"nayin": ["山头火", "剑锋金"],
"shishen": ["偏印", "正官"],
"ganzhi": ["甲戌", "癸酉", "壬申"],
"sui": ["1-2岁", "3岁", "13岁"],
"year": ["2009", "2012", "2022"]
},
"liunian": [
["己丑", "壬辰", "壬寅"]
]
}
错误返回示例
{
"error": "api_error",
"code": 201,
"message": "日期不正确"
}
常见错误码
来源于 极速数据八字排盘文档：
| 代号 | 说明 |
|---|---|
| 201 | 日期不正确 |
| 202 | 时间不正确 |
| 210 | 没有信息 |
系统错误码：101 APPKEY 为空或不存在、102 已过期、103 无请求此数据权限、104 请求超过次数限制、105 IP 被禁止、106 IP 请求超过限制、107 接口维护中、108 接口已停用。
在 OpenClaw 中的推荐用法
- 用户：「帮我排一下 2009-10-18 凌晨 2:05（男）的八字」→ 将自然语言解析为年月日时分和性别，调用
bazi.py，再根据返回的bazi、qiankunzao、dayun、liunian做摘要说明。 \n - 用户：「看未来几年运势大概如何」→ 结合
dayun与近期的liunian信息，以「偏印/正官/比肩」等十神和干支变化为线索，输出自然语言总结。 \n - 用户：「只知道农历时间」→ 将
islunar设为 1，并按阴历年月日时传入（必要时结合万年历接口先转换），再使用本技能排盘。 \n - 用户：「是否要考虑太阳时」→ 当用户提供城市且对精准性有额外要求时，可将
istaiyang设为 1，告诉用户这是基于太阳时修正后的排盘结果。 \n