# ziwei-skill

Adopt this skill: https://proskills.md/skills/other/dglijin-oss-ziwei-skill

Page: https://proskills.md/skills/other/dglijin-oss-ziwei-skill
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: SKILL.md
size: 3031
upstream: https://github.com/dglijin-oss/ziwei-skill/blob/HEAD/SKILL.md

```text
---
name: ziwei-skill
description: 紫微斗数排盘技能。支持十四主星、十二宫位、四化飞星排盘、宫位关系分析（三方四正）、趋吉避凶建议、大限流年详解、辅星系统、星曜庙旺平陷、格局判断、流月流日推算、合盘比较、占验反馈。
version: 5.0.0
author: 天工长老
---

# 紫微斗数排盘技能 v5.0.0

> "紫微斗数，星命之宗。"

## ⚠️ 铁律：先核对时间，再排盘！

> "差之毫厘，谬以千里。" —— 时间一错，全盘皆废。

**每次排盘前必须：**
1. **校正当前时间** — 以系统实时时间为准
2. **核实公历日期** — 年、月、日、时
3. **核对农历转换** — 紫微排盘依赖准确的年月日时
4. **验证五行局数** — 局数以月令定
5. **独立校验脚本输出** — 脚本若有 bug，人工复核

---

## 功能 v5.0.0（新增！）

- ✅ **流月流日推算模块**（新增！）
  - 12流月宫位轮转
  - 流月四化推算
  - 365流日宫位轮转（关键日标记）
  - 流月/流日与本命盘叠加分析
- ✅ **合盘比较模块**（新增！）
  - 两人命盘宫位对照
  - 夫妻宫/交友宫互动分析
  - 双方四化飞星互入判断
  - 合盘吉凶评分
- ✅ **大限四化叠加分析**（新增！）
  - 本命四化 + 大限四化 + 流年四化三层叠加
  - 四化重叠宫位重点分析
  - 化禄/化权/化科/化忌叠加效应
- ✅ **108辅星完整系统**（增强！）
  - 六吉星：左辅、右弼、文昌、文曲、天魁、天钺
  - 六煞星：擎羊、陀罗、火星、铃星、地空、地劫
  - 杂曜扩充：天刑、天姚、红鸾、天喜、孤辰、寡宿等50+
  - 年系/月系/日系/时系辅星分类排布
- ✅ **占验反馈系统**（新增！）
  - 记录断语与应验情况
  - 准确度统计
  - 经验积累优化

**功能 v4.0.0（保留）：**
- ✅ 趋吉避凶建议模块
- ✅ 大限流年详解模块
- ✅ 宫位关系分析模块（三方四正、对宫冲合）
- ✅ 辅星系统、星曜庙旺平陷
- ✅ 格局判断（紫府同宫格等10+格局）
- ✅ 十四主星排布、十二宫位定位
- ✅ 四化飞星推算、五行局计算

---

## 变更

v5.0.0 (2026-06-01): 新增流月流日推算、合盘比较、大限四化叠加、108辅星完整系统、占验反馈
v4.0.0 (2026-05-02): 新增趋吉避凶建议、大限流年详解
v3.2.0 (2026-04-14): 新增宫位关系分析模块
v3.1.0 (2026-04-11): 统一断语风格、技能联动接口

---

## 后续迭代计划

### v6.0.0（预计 2026-09-30）
- [ ] 紫微命盘可视化输出（图形化十二宫）
- [ ] 紫微+八字合参（星命+干支双重验证）
- [ ] 流时推算模块
- [ ] AI辅助格局判断优化

---

> **天工长老按：** 紫微斗数以星辰布命盘，十二宫位包罗万象。v5.0 新增流月流日与合盘比较，使紫微从"看一生"细化到"看当下"，从"看自己"扩展到"看关系"。

🏮 天工长老 敬撰 v5.0.0
2026-06-01
```

## File: README.md
upstream: https://github.com/dglijin-oss/ziwei-skill/blob/HEAD/README.md

````text
# 紫微斗数技能

> "紫微斗数，星命之宗。" —— 传统命理学

紫微斗数是中国传统命理学中最精密的星命术数，以出生年月日时排布十四主星于十二宫位，推算命运、性格、事业、婚姻、财运等。本技能提供完整的紫微斗数排盘和命盘分析功能。

## ✨ 核心功能

- ✨ 十四主星排布（紫微、天机、太阳、武曲、天同、廉贞、天府、太阴、贪狼、巨门、天相、天梁、七杀、破军）
- ✨ 十二宫位定位（命宫、兄弟、夫妻、子女、财帛、疾厄、迁移、交友、官禄、田宅、福德、父母）
- ✨ 四化飞星推算（化禄、化权、化科、化忌）
- ✨ 五行局计算（水二局、木三局、金四局、土五局）
- ✨ 大限流年推算
- ✨ 命盘分析（性格、事业、婚姻、财运）
- ✨ 辅星排布（左辅、右弼、文昌、文曲、天魁、天钺等）
- ✨ 纯 Python 实现，无外部依赖

## 🔧 技术特点

- 🔧 精确农历转换（1900-2100 年）
- 🔧 精确节气计算
- 🔧 安星算法完整（14 主星 + 辅星 + 四化）
- 🔧 纯 Python 实现，无外部依赖
- 🔧 支持 JSON 格式输出
- 🔧 命令行界面友好

## 📖 快速开始

### 安装

```bash
# 克隆仓库
git clone https://github.com/dglijin-oss/ziwei-skill.git
cd ziwei-skill

# 确保 Python 3.8+ 已安装
python3 --version

# 赋予执行权限
chmod +x index.js
```

### 基本使用

```bash
# 基础排盘
node index.js --date "1990-05-15" --hour 8

# 指定性别
node index.js --date "1990-05-15" --hour 8 --gender 女

# 输出 JSON 格式
node index.js --date "1990-05-15" --hour 8 --json
```

### 命令行参数

| 参数 | 简写 | 说明 | 默认值 |
|------|------|------|--------|
| --date | -d | 出生日期 (YYYY-MM-DD) | 必填 |
| --hour | -H | 出生时辰 (0-23) | 必填 |
| --gender | -g | 性别 (男/女) | 男 |
| --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 | 亥 |

## 📋 输出示例

### 文本输出

```
【紫微斗数排盘】v2.0.0
• 出生时间：1990-05-15 08:00
• 性别：男
• 五行局：水二局
• 命主：破军
• 身主：天相

【十二宫位】
┌─────────┬─────────┬─────────┬─────────┐
│ 父母宫 │ 福德宫 │ 田宅宫 │ 官禄宫 │
│ 天机   │ 紫微   │ 天府   │ 太阴   │
│ 化禄   │ 化权   │       │ 化科   │
├─────────┼─────────┴─────────┼─────────┤
│ 交友宫 │                 │ 迁移宫 │
│ 巨门   │    命宫         │ 廉贞   │
│ 化忌   │    武曲         │       │
├─────────┤    七杀         ├─────────┤
│ 迁移宫 │                 │ 疾厄宫 │
│       │                 │ 天同   │
├─────────┼─────────┬─────────┼─────────┤
│ 夫妻宫 │ 子女宫 │ 财帛宫 │ 兄弟宫 │
│ 天相   │ 天梁   │ 贪狼   │ 天魁   │
│       │       │       │       │
└─────────┴─────────┴─────────┴─────────┘

【四化飞星】
• 化禄：天机（父母宫）
• 化权：紫微（福德宫）
• 化科：太阴（官禄宫）
• 化忌：巨门（交友宫）

【命盘分析】
• 【命宫主星】武曲七杀：刚毅果断，执行力强，适合军警、金融、管理
• 【财帛宫】贪狼：财运波动大，宜投机、娱乐、餐饮行业
• 【官禄宫】太阴化科：事业稳定，利文职、财务、房地产
• 【夫妻宫】天相：配偶温和，婚姻稳定
```

### JSON 输出

```json
{
  "出生时间": "1990-05-15 08:00",
  "性别": "男",
  "五行局": "水二局",
  "命主": "破军",
  "身主": "天相",
  "十二宫位": {
    "命宫": {"主星": ["武曲", "七杀"], "辅星": []},
    "夫妻宫": {"主星": ["天相"], "辅星": []},
    ...
  },
  "四化飞星": {
    "化禄": {"星": "天机", "宫位": "父母宫"},
    "化权": {"星": "紫微", "宫位": "福德宫"},
    "化科": {"星": "太阴", "宫位": "官禄宫"},
    "化忌": {"星": "巨门", "宫位": "交友宫"}
  },
  "命盘分析": {...}
}
```

## 📚 紫微斗数基础知识

### 十四主星

| 主星 | 五行 | 特性 |
|------|------|------|
| 紫微 | 土 | 帝王之星，尊贵、领导力 |
| 天机 | 木 | 智慧之星，聪明、善谋略 |
| 太阳 | 火 | 光明之星，热情、博爱 |
| 武曲 | 金 | 财星，刚毅、执行力 |
| 天同 | 水 | 福星，温和、享受 |
| 廉贞 | 火 | 囚星，复杂、多变化 |
| 天府 | 土 | 库星，稳重、保守 |
| 太阴 | 水 | 月星，温柔、内敛 |
| 贪狼 | 木 | 桃花星，欲望、多才 |
| 巨门 | 土 | 暗星，口才、是非 |
| 天相 | 水 | 印星，辅助、公正 |
| 天梁 | 土 | 荫星，长寿、贵人 |
| 七杀 | 金 | 将星，果断、冲动 |
| 破军 | 水 | 耗星，变革、破坏 |

### 十二宫位

| 宫位 | 含义 |
|------|------|
| 命宫 | 性格、命运、外貌 |
| 兄弟宫 | 兄弟姐妹、朋友 |
| 夫妻宫 | 婚姻、配偶 |
| 子女宫 | 子女、晚辈 |
| 财帛宫 | 财运、收入 |
| 疾厄宫 | 健康、疾病 |
| 迁移宫 | 外出、迁移、社交 |
| 交友宫 | 朋友、同事、下属 |
| 官禄宫 | 事业、工作、地位 |
| 田宅宫 | 房产、家庭、不动产 |
| 福德宫 | 福气、精神享受 |
| 父母宫 | 父母、长辈、遗传 |

### 四化飞星

| 四化 | 含义 |
|------|------|
| 化禄 | 财富、顺利、增益 |
| 化权 | 权力、掌控、责任 |
| 化科 | 名声、学历、贵人 |
| 化忌 | 阻碍、是非、损失 |

### 五行局

| 五行局 | 起大限年龄 |
|--------|------------|
| 水二局 | 2 岁 |
| 木三局 | 3 岁 |
| 金四局 | 4 岁 |
| 土五局 | 5 岁 |

## 🐍 Python API 调用

```javascript
const ziwei = require('./index.js');

// 排盘
const result = ziwei.ziwei_pan({
    date: "1990-05-15",
    hour: 8,
    gender: "男"
});

// 格式化输出
console.log(ziwei.format_output(result));

// 或直接获取字典数据
console.log(result.十二宫位);
console.log(result.四化飞星);
```

## 📅 版本历史

### v2.0.0 (2026-03-24)
- ✨ 四化飞星推算
- ✨ 大限流年推算
- ✨ 命盘分析规则完善
- ✨ 五行局计算

### v1.0.0 (2026-03-22)
- ✨ 基础十四主星排布
- ✨ 十二宫位定位

## 🤝 致谢

- 感谢古代先贤传承紫微斗数智慧
- 感谢现代研究者对传统术数的整理

## 📄 许可证

MIT License

## 👤 作者

- **作者：** 天工长老
- **法号由来：** 取自《天工开物》，寓意巧夺天工、匠心独运
- **签名：** "善易者不卜，重在趋吉避凶之智慧。"

---

🏮 天工长老 敬撰

"紫微斗数，星命之宗。"
````
