| name | bazi-pan-skill |
| description | 八字命理排盘技能。支持四柱八字排盘、十神计算、大运排法、五行统计、格局判断、用神选取、流年推算、详细断语、神煞系统（33+神煞）、刑冲合害分析、流月推算、综合评分、趋吉避凶建议。 |
| version | 4.0.0 |
| author | 天工长老 |
八字排盘技能 v4.0.0
"不知命，无以为君子也。" ——《论语》
⚠️ 铁律：先核对时间，再排盘！
"差之毫厘，谬以千里。" —— 时间一错，全盘皆废。
每次排盘前必须：
- 校正当前时间 — 以系统实时时间为准，不可用缓存或旧时间
- 核实公历日期 — 年、月、日、时，一一确认
- 核对农历转换 — 月份、日期不可想当然，需验证
- 验证节气月令 — 月柱以节气为准（如清明后为辰月）
- 独立校验脚本输出 — 脚本若有 bug，人工复核
1. Description
八字命理，又称四柱命理，是以出生年月日时的天干地支推算命运的术数。
核心功能 v4.0.0：
- ✅ 刑冲合害分析模块（新增！）
- 地支六合、六冲、三合、半三合、三刑、六害、相破
- 流年与四柱的刑冲合害关系
- 综合判断与建议
- ✅ 流月推算模块（新增！）
- 12个月流月干支计算
- 每月运势评分（0-100）
- 事业/财运/感情/健康分类建议
- 最佳/最差月份标记
- ✅ 综合评分模块（新增！）
- 六维度评分：五行平衡、格局优劣、用神有力、神煞吉凶、刑冲合害、日主强弱
- 总分0-100，七级评定（上上/上吉/中上/中平/中下/下平/下下）
- ✅ 趋吉避凶建议模块（新增！）
- 吉利方位、颜色、行业、数字
- 吉祥物、吉利食物
- 五行补救建议、注意事项
- ✅ 神煞系统（33+神煞，识别率100%）
- 贵人吉神：天乙贵人、太极贵人、天德贵人、月德贵人、三奇贵人、天赦
- 文星学业：文昌、学堂、词馆
- 禄财：禄神、金舆
- 婚姻感情：桃花、红艳、红鸾、天喜
- 动迁出行：驿马
- 特殊格局：华盖、魁罡、金神、羊刃、飞刃、将星、国印贵人、六秀
- 凶煞：空亡、孤辰、寡宿、十恶大败、披头、吊客、病符、丧门、八专
- ✅ 统一断语风格（古风简洁，切中要害）
- ✅ 技能联动接口（可调用紫微/奇门/六爻综合推断）
- ✅ 四柱排盘（年柱/月柱/日柱/时柱）
- ✅ 十神计算（比肩/劫财/食神/伤官等）
- ✅ 大运排法（8 步大运）
- ✅ 五行统计（木火土金水数量）
- ✅ 格局判断（正官格/七杀格/食神格等 10 种格局）
- ✅ 用神选取（日主旺衰、喜用神、忌神）
- ✅ 流年推算（当年运势、冲克分析）
- ✅ 详细断语（事业/婚姻/财运/健康）
- ✅ 五行缺失检测
核心功能 v2.0.0：
- ✅ 四柱排盘（年柱/月柱/日柱/时柱）
- ✅ 十神计算（比肩/劫财/食神/伤官等）
- ✅ 大运排法（8 步大运）
- ✅ 五行统计（木火土金水数量）
- ✅ 格局判断（正官格/七杀格/食神格等 10 种格局）
- ✅ 用神选取（日主旺衰、喜用神、忌神）
- ✅ 流年推算（当年运势、冲克分析）
- ✅ 详细断语（事业/婚姻/财运/健康）
- ✅ 五行缺失检测
v1.0.0 基础功能：
2. When to use
| 场景 | 示例 |
|---|
| 排八字请求 | "帮我排一下八字" |
| 指定时间排盘 | "1990 年 5 月 15 日早上 8 点的八字" |
| 问命理 | "看看我的命格怎么样" |
| 五行查询 | "我五行缺什么" |
| 大运查询 | "我的大运怎么样" |
3. How to use
调用方式
python3 ~/.openclaw/skills/bazi-pan-skill/scripts/bazi_pan.py --date "1990-05-15" --hour 8
python3 ~/.openclaw/skills/bazi-pan-skill/scripts/bazi_pan.py --date "1990-05-15" --hour 8 --gender 女
python3 ~/.openclaw/skills/bazi-pan-skill/scripts/bazi_pan.py --date "1990-05-15" --hour 8 --liu-nian 2026
python3 ~/.openclaw/skills/bazi-pan-skill/scripts/bazi_pan.py --date "1990-05-15" --hour 8 --liu-nian 2026 --liu-yue
python3 ~/.openclaw/skills/bazi-pan-skill/scripts/bazi_pan.py --date "1990-05-15" --hour 8 --json
命令行参数
| 参数 | 简写 | 说明 |
|---|
| --date | -d | 出生日期 (YYYY-MM-DD) |
| --hour | -H | 出生时辰 (0-23) |
| --gender | -g | 性别 (男/女，默认男) |
| --liu-nian | -l | 流年年份（可选，如 2026） |
| --liu-yue | -m | 显示流月运势（需配合--liu-nian） |
| --json | -j | 输出 JSON 格式 |
时辰对照表
| 时辰 | 时间 | 地支 |
|---|
| 子时 | 23:00-01:00 | 子 |
| 丑时 | 01:00-03:00 | 丑 |
| 寅时 | 03:00-05:00 | 寅 |
| 卯时 | 05:00-07:00 | 卯 |
| 辰时 | 07:00-09:00 | 辰 |
| 巳时 | 09:00-11:00 | 巳 |
| 午时 | 11:00-13:00 | 午 |
| 未时 | 13:00-15:00 | 未 |
| 申时 | 15:00-17:00 | 申 |
| 酉时 | 17:00-19:00 | 酉 |
| 戌时 | 19:00-21:00 | 戌 |
| 亥时 | 21:00-23:00 | 亥 |
4. Output Format
【八字排盘】v1.0.0
• 出生时间：1990-05-15 08:00
• 性别：男
【四柱】
年柱 月柱 日柱 时柱
庚午 辛巳 壬辰 甲辰
【十神】
偏印 正印 日主 食神
【五行统计】
木：2 火：2 土：2 金：2 水：0
⚠️ 五行缺：水
【大运】
13 岁：壬午
23 岁：癸未
33 岁：甲申
43 岁：乙酉
53 岁：丙戌
63 岁：丁亥
73 岁：戊子
83 岁：己丑
【基础断语】
• 【日主】壬水江河，聪明灵活，适应力强
• 【五行】金最旺（2 个），水最弱（0 个）
• 【注意】五行缺水，需后天补救
5. 八字基础知识
十天干
| 天干 | 甲 | 乙 | 丙 | 丁 | 戊 | 己 | 庚 | 辛 | 壬 | 癸 |
|---|
| 五行 | 木 | 木 | 火 | 火 | 土 | 土 | 金 | 金 | 水 | 水 |
| 阴阳 | 阳 | 阴 | 阳 | 阴 | 阳 | 阴 | 阳 | 阴 | 阳 | 阴 |
十二地支
| 地支 | 子 | 丑 | 寅 | 卯 | 辰 | 巳 | 午 | 未 | 申 | 酉 | 戌 | 亥 |
|---|
| 生肖 | 鼠 | 牛 | 虎 | 兔 | 龙 | 蛇 | 马 | 羊 | 猴 | 鸡 | 狗 | 猪 |
| 五行 | 水 | 土 | 木 | 木 | 土 | 火 | 火 | 土 | 金 | 金 | 土 | 水 |
十神关系
| 十神 | 关系 | 含义 |
|---|
| 比肩 | 同我者，阴阳同 | 兄弟、朋友、竞争 |
| 劫财 | 同我者，阴阳异 | 姐妹、破财、冲动 |
| 食神 | 我生者，阴阳同 | 子女、才华、享受 |
| 伤官 | 我生者，阴阳异 | 子女、创意、叛逆 |
| 偏财 | 我克者，阴阳同 | 父亲、偏财、投机 |
| 正财 | 我克者，阴阳异 | 妻子、正财、稳定 |
| 七杀 | 克我者，阴阳同 | 情人、压力、权威 |
| 正官 | 克我者，阴阳异 | 丈夫、事业、名誉 |
| 偏印 | 生我者，阴阳同 | 继母、特殊才能 |
| 正印 | 生我者，阴阳异 | 母亲、学历、贵人 |
大运排法
规则：
- 阳男阴女顺排，阴男阳女逆排
- 每运 10 年
- 简化：3 岁起运
6. 日主性格断语
| 日主 | 断语 |
|---|
| 甲木 | 甲木参天，正直仁慈，有上进心 |
| 乙木 | 乙木柔顺，温和善良，适应力强 |
| 丙火 | 丙火太阳，热情开朗，表现欲强 |
| 丁火 | 丁火灯烛，温和内敛，心思细腻 |
| 戊土 | 戊土大地，厚重诚实，包容力强 |
| 己土 | 己土田园，细腻谨慎，善于谋划 |
| 庚金 | 庚金刀剑，刚毅果断，执行力强 |
| 辛金 | 辛金珠玉，温润秀气，重面子 |
| 壬水 | 壬水江河，聪明灵活，适应力强 |
| 癸水 | 癸水雨露，温柔内敛，直觉敏锐 |
7. 示例
示例 1：基础排盘
用户输入：
"帮我排一下 1990 年 5 月 15 日早上 8 点的八字"
命令：
python3 scripts/bazi_pan.py --date "1990-05-15" --hour 8
输出：
【八字排盘】v2.0.0
• 出生时间：1990-05-15 08:00
• 性别：男
【四柱】
年柱 月柱 日柱 时柱
庚午 辛巳 壬辰 甲辰
【十神】
偏印 正印 日主 食神
【五行统计】
木：2 火：2 土：2 金：2 水：0
⚠️ 五行缺：水
【大运】
13 岁：壬午
23 岁：癸未
...
【格局】
正印格
【用神】
日主水弱，喜金,水，忌土,火
【详细断语】
• 【日主】壬水江河，聪明灵活，适应力强
• 【格局】正印格：聪明智慧，利学业文化
• 【五行】五行缺水，需后天补救
示例 2：女性排盘
用户输入：
"1995 年 8 月 20 日下午 3 点，女"
命令：
python3 scripts/bazi_pan.py --date "1995-08-20" --hour 15 --gender 女
示例 3：流年推算
用户输入：
"看看 2026 年的流年运势"
命令：
python3 scripts/bazi_pan.py --date "1990-05-15" --hour 8 --liu-nian 2026
输出新增：
【丙午流年】
流年十神：七杀
冲克：无重大冲克
断语：事业有冲劲，宜创业或开拓性工作
示例 4：JSON 输出
用户输入：
"要 JSON 格式的八字"
命令：
python3 scripts/bazi_pan.py --date "1990-05-15" --hour 8 --json
8. GitHub 仓库
仓库地址： https://github.com/dglijin-oss/bazi-pan-skill
版本历史：
| 版本 | 日期 | 变更内容 |
|---|
| v4.0.0 | 2026-04-25 | 新增刑冲合害分析、流月推算、综合评分、趋吉避凶建议四大模块 |
| v3.3.0 | 2026-04-14 | 新增神煞增强模块（33+神煞，识别率100%） |
| v3.1.0 | 2026-04-11 | 统一断语风格、技能联动接口、十大技能协同 |
| v2.0.0 | 2026-03-24 | 格局判断、用神选取、流年推算、增强断语库 |
| v1.0.0 | 2026-03-22 | 基础四柱排盘、十神、大运、五行统计 |
安装方式：
git clone https://github.com/dglijin-oss/bazi-pan-skill.git
cd bazi-pan-skill
python3 scripts/bazi_pan.py --help
9. 后续迭代计划
v2.0.0（✅ 已完成 2026-03-24）
- ✅ 流年推算（当年运势、冲克分析）
- ✅ 格局判断（正官格/七杀格/食神格等 10 种格局）
- ✅ 用神选取（日主旺衰、喜用神、忌神）
- ✅ 详细断语（事业/婚姻/财运/健康）
- ✅ 增强断语库（分类断语：事业/婚姻/财运/健康）
v3.0.0（✅ 已完成 2026-04-14）
- ✅ 神煞系统（33+神煞）
- ✅ 刑冲合害分析（地支六冲/六合/三合等）
v4.0.0（✅ 已完成 2026-04-25）
- ✅ 刑冲合害分析完整模块（六合/六冲/三合/三刑/六害/相破）
- ✅ 流月推算（12个月运势，事业/财运/感情/健康）
- ✅ 综合评分（六维度，0-100分）
- ✅ 趋吉避凶建议（方位/颜色/行业/数字/吉祥物/食物）
v5.0.0（预计 2026-09-30）
天工长老按： 八字命理，乃人生之地图。知命者不忧，知理者不惑。v4.0 已具备完整排盘分析能力，后续将向精确化和可视化方向精进。
🏮 天工长老 敬撰 v1.0.0
2026-03-22
