紫微斗数算命 (Zi Wei Fortune Telling)
Overview
本 Skill 实现完整的紫微斗数算命流程：用户输入公历出生年月日和时辰，系统自动转换为农历，推算生辰八字（四柱），根据紫微斗数排盘法计算命盘（含命宫、身宫、五行局、十四主星分布于十二宫位），最终生成命格分析报告。
Workflow
Step 1: 收集出生信息
向用户询问以下必要信息。若用户已提供则跳过对应询问：
- 出生年份（公历，如 1990）
- 出生月份（公历，如 5）
- 出生日期（公历，如 15）
- 出生时辰（以下任一格式均可）：
- 具体时间：如"上午8点"、"8:30"、"20:00"
- 时辰名称：如"辰时"、"子时"
- 大致描述：如"天亮时"、"中午" - 性别（男/女）
若用户提供的是农历日期，直接记录并在 Step 3 中标注。
时辰解析规则（若用户提供时辰名称而非具体时间）：
| 时辰 | 时间范围 |
|---|---|
| 子时 | 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 |
若用户只提供时辰名称，取该时辰的中间时间作为输入（如"辰时"→ hour=8）。
Step 2: 安装依赖
首次使用时，需安装 lunar-python 库。执行以下命令：
C:\Users\admin\.workbuddy\binaries\python\versions\3.13.12\python.exe -m pip install lunar-python
若已安装则跳过。可通过以下命令检查：
C:\Users\admin\.workbuddy\binaries\python\versions\3.13.12\python.exe -c "import lunar_python; print('OK')"
Step 3: 执行算命脚本
运行核心脚本，传入用户的出生信息：
C:\Users\admin\.workbuddy\binaries\python\versions\3.13.12\python.exe C:\Users\admin\.workbuddy\skills\ziwei-fortune\scripts\ziwei_fortune.py \
--year <出生年> \
--month <出生月> \
--day <出生日> \
--hour <出生时(0-23)> \
--gender <male|female> \
--format text
若需要 JSON 格式结果（便于程序处理），将 --format text 改为 --format json。
Step 4: 解读与呈现结果
脚本输出包含以下部分：
- 出生信息：公历与农历对照、时辰、性别
- 生辰八字：年柱、月柱、日柱、时柱（天干地支）
- 命盘基础：命宫位置、身宫位置、五行局、紫微星位置
- 紫微斗数命盘：十二宫位与十四主星排布
- 命格详细分析：
- 日主分析（命主五行特质）
- 五行分布（旺衰判断）
- 命宫主星解析（性格、事业、财运、感情、注意事项）
- 身宫分析（后天发展方向）
- 重要宫位速览（财帛、官禄、夫妻、迁移等）
- 特殊格局检测（紫府同宫、杀破狼、机月同梁等）
- 大运方向
呈现结果时，应：
- 将脚本输出完整展示给用户
- 用通俗易懂的语言补充解释关键概念
- 若用户有具体问题（如事业运、感情运），结合对应宫位主星深入分析
- 参考 references/ziwei_stars.md 获取更详细的星情解读
- 参考 references/ziwei_palaces.md 了解宫位含义和三方四正关系
- 参考 references/bazi_interpretation.md 了解八字五行基础知识
Step 5: 互动答疑
用户看到结果后可能提出进一步问题，常见方向：
- 事业运：重点看官禄宫主星 + 命宫主星的事业特质
- 财运：重点看财帛宫主星 + 命宫主星的财运特质
- 感情婚姻：重点看夫妻宫主星 + 命宫主星的感情特质
- 健康：重点看疾厄宫
- 人际关系：重点看奴仆宫 + 兄弟宫
- 外出发展：重点看迁移宫
- 大运走势：根据大运方向分析未来十年运势
回答时引用对应的宫位主星和参考文件中的详细描述。
Important Notes
- 紫微斗数排盘使用农历日期，脚本内部已自动完成公历转农历
- 子时跨日问题：23:00-00:00 为夜子时，部分流派将其归入次日。脚本中统一按当日处理
- 闰月处理：若出生在农历闰月，排盘时以闰月前一个月计算（即闰五月按五月算）。lunar-python 库会自动处理
- 命宫无主星时，借对宫（迁移宫）主星论命，脚本已自动处理
- 结果末尾附带免责声明，提醒用户命理仅供参考娱乐
