紫微斗数排盘 Skill

功能

根据用户的出生信息（公历年月日时），自动计算紫微斗数命盘，包括：

• ✅ 公历 → 农历转换
• ✅ 安命宫、身宫、十二宫
• ✅ 定十二宫天干、五行局
• ✅ 安十四主星 + 辅星（左辅右弼、文昌文曲、天魁天钺、禄存擎羊陀罗、火星铃星、天马等）
• ✅ 四化（化禄化权化科化忌）
• ✅ 起大限
• ✅ 三方四正标注
• ✅ 节气修正（立春换年柱、节气换月柱）
• ✅ 特殊格局检测（紫府朝垣、日月并明、三奇嘉会等15+种）
• ✅ 流年分析（流年四化、流年命宫）
• ✅ 小限分析（根据虚岁查看小限落宫）
• ✅ 农历/公历双输入支持
• ✅ 输出完整的 Markdown 命盘文件

使用方法

方式一：对话式调用（推荐）

直接对我说：

"帮张三排盘，1990年5月15日下午2点，男"

或：

"排一下我的盘，1995年8月20日晚上8点，女，叫李四"

如果输入的是农历，请说明：

"农历1990年5月15日下午2点，男，叫张三"

我会自动调用引擎，生成 Markdown 命盘文件，保存在 outputs/zwei/ 目录。

注意：输入默认为公历。如需输入农历，请明确

方式二：启动 API 服务

# 启动网页 + API 服务（默认端口 8686）
python skills/zwei/run_api.py

# 自定义端口
python skills/zwei/run_api.py --port 8888

启动后：

• 🌐 网页端：http://localhost:8686/web
• 📖 API 文档：http://localhost:8686/docs
• 🔌 API 接口：POST /api/zipai/calculate

方式三：Python 直接调用

from engine.core import calculate_chart
from engine.formatter import format_chart, save_chart_to_markdown

chart = calculate_chart(year=1990, month=5, day=15, hour=14, name="张三", gender="男")
md = format_chart(chart)
save_chart_to_markdown(chart, "outputs/zwei/张三.md")

API 接口

POST /api/zipai/calculate

请求体：

{
    "year": 1990,
    "month": 5,
    "day": 15,
    "hour": 14,
    "name": "张三",
    "gender": "男"
}

响应：

{
    "chart_md": "...Markdown内容...",
    "download_url": "/api/zipai/download/19900515_张三.md",
    "filepath": "...outputs/zwei/19900515_张三.md"
}

目录结构

skills/zwei/
├── SKILL.md              ← 技能描述（本文件）
├── requirements.txt      ← 依赖
├── run_api.py            ← API 启动入口
├── engine/               ← Python 排盘引擎
│   ├── __init__.py
│   ├── constants.py      ← 常量定义
│   ├── tables.py         ← 查表数据
│   ├── lunar.py          ← 公历→农历转换
│   ├── core.py           ← 主排盘引擎
│   └── formatter.py      ← Markdown 格式化
└── api/                  ← API 服务
    ├── __init__.py
    ├── server.py         ← FastAPI 服务器
    └── web/
        └── index.html    ← 网页前端

outputs/zwei/             ← 命盘 Markdown 输出目录

注意事项

• 农历数据覆盖范围：1900-2100年
• 时辰处理：23:00-00:59 为子时，归入次日
• 五行局通过命宫干支的纳音五行确定
• 四化根据生年天干确定
• 大限起运：阳男阴女顺行，阴男阳女逆行
• 本命盘为初级版本，特殊格局判断、流年、小限等功能后续迭代