ziwei-skill

紫微斗数技能

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

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

✨ 核心功能

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

🔧 技术特点

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

📖 快速开始

安装

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

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

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

基本使用

# 基础排盘
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

命令行参数

时辰对照表

📋 输出示例

文本输出

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

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

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

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

JSON 输出

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

📚 紫微斗数基础知识

十四主星

十二宫位

四化飞星

五行局

🐍 Python API 调用

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

👤 作者

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

---

🏮 天工长老 敬撰

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