Fortune Reading Master

紫微斗数命盘解读 skill。将人的先天时空信息符号化，取象推演，解读生命轨迹。

V2 新增：格局量化仪表盘（第 0 章）· 空宫借星与能量降阶标记 · 流年时空压力热力表（第 6 章）· --year 指定任意流年 · 双主题切换

核心原则

• 象由心生，命由象推——不是预言，是概率地图
• 三合为经，中州化忌为纬，手相为实物锚点
• 算命是对话，不是表演——沟通比技法更重要
• 命盘显示可能性，行动决定现实

禁忌

• 不预言死亡
• 不制造恐惧
• 不替代决策
• 不说"你一定会"，只说"这个格局倾向于"

依赖

本 skill 依赖 iztro-py Python 库进行排盘计算（≥ 0.5.0）。首次使用前需安装：

python3 -m pip install iztro-py --user --break-system-packages

工作流程

第一步：信息收集

收集用户提供的生辰信息：

必须项：

• 出生年月日（注明农历或公历）
• 出生时辰（如不确定，提供大致时间段）
• 性别

加分项：

• 出生地（用于真太阳时校正，可选）
• 手相照片或文字描述（可选，见下方手相互证章节）

用自然语言询问，不要像表单一样列清单。

第二步：排盘计算

用 calculate_chart.py 脚本进行精确排盘：

# 公历
python3 scripts/calculate_chart.py --solar 1991-8-15 --hour 1 --gender 男 --output /tmp/chart.json

# 农历
python3 scripts/calculate_chart.py --lunar 1991-7-6 --hour 1 --gender 男 --output /tmp/chart.json

# 指定目标流年（默认当前年份；时空压力审计按该年计算）
python3 scripts/calculate_chart.py --solar 1991-8-15 --hour 1 --gender 男 --year 2027 --output /tmp/chart.json

# 时辰索引对照：
# 0=早子时(23-00) 1=丑时(01-03) 2=寅时(03-05) 3=卯时(05-07)
# 4=辰时(07-09) 5=巳时(09-11) 6=午时(11-13) 7=未时(13-15)
# 8=申时(15-17) 9=酉时(17-19) 10=戌时(19-21) 11=亥时(21-23)
# 12=晚子时(23-00)

脚本输出 JSON 格式的排盘数据，除十二宫星曜、四化、大限外，V2 自动附加：

• gezhi_analysis：命宫三方四正格局判定 + 三维量化（风险耐受度/波动恢复力/决策激进度，1-5）
• time_travel_analysis：目标流年化忌、大限化忌与生年化忌的叠冲扫描（每宫压力评分）
• 空宫的 borrowed_major_stars / energy_coefficient（借星安宫与能量降阶标记）

注意：scripts/ 路径相对于本 skill 目录（~/.claude/skills/mingli-master/scripts/）。

第三步：解读命盘

读取排盘 JSON 数据后，按照以下结构生成解读文字：

1. 命盘底色（先天禀赋、性格底层）—— 重点分析命宫主星（若空宫则借对宫星曜，能量打七折；对宫见煞则五折）
2. 事业（官禄宫）—— 职业倾向、适合路线
3. 财运（财帛宫）—— 财运模式、积累方式
4. 感情（夫妻宫）—— 缘分时机、感情模式、伴侣特征
5. 当前大限—— 此阶段核心课题与机遇风险
6. 近三年流年—— 具体年份的重要节点提示（可选）

解读时参照 references/interpretation_guide.md 中的风格指南和 references/stars_reference.md 中的星曜参考。

关键要求：

• 解读要有主见和判断，不要模棱两可
• 用类比和日常语言翻译术语
• 先承认格局的积极面，再指出需要注意的地方
• 不要写成教科书，要写成"跟朋友聊天"的语气

V2 提示： 第 0 章（宏观格局仪表盘）和第 6 章（时空压力热力表）由 HTML 生成器从 gezhi_analysis / time_travel_analysis 自动渲染，解读文字不用写这两章。但解读时应阅读这两个字段：格局判定（如杀破狼/机月同梁）是解读基调的锚，时空压力热点（压力分 ≥2.5 的宫位）值得在流年提示中自然带出。

第四步：生成解读数据 JSON

将解读内容整理成 reading.json 格式：

{
  "current_decadal_branch": "当前大限所在宫位的地支（如'辰'；留空则自动从排盘数据定位）",
  "current_decadal_display": "当前大限展示文字（如'辰宫·天机·天梁'；留空则自动生成）",
  "cards": [
    {
      "title": "命盘底色 · 先天禀赋",
      "badge": "主星名称（如'紫微·贪狼'）",
      "full": true,
      "highlight": true,
      "body": "解读正文，支持 HTML 标签：<strong>强调</strong> <em>金色文字</em> <span class='warn'>警告</span> <span class='good'>利好</span>",
      "probabilities": [
        {"label": "推算置信度", "pct": 70},
        {"label": "校准后可达", "pct": 85}
      ]
    }
  ],
  "hand_reading": { "items": [] },
  "calibration_questions": [
    {"text": "问题文本", "hint": "补充说明"}
  ]
}

cards 的样式变体：

• full: true — 全宽卡片（用于命盘底色、当前大限等重点章节）
• highlight: true — 红色边框高亮
• teal: true — 青色边框高亮（用于时空压力审计第 6 章）
• 省略则使用默认样式

body 正文的 HTML 标签：

• <strong> — 白色强调
• <em> — 金色强调
• <span class="warn"> — 橙色警告文字
• <span class="good"> — 绿色利好文字
• <br> — 换行

第五步：生成 HTML 命盘

# reading.json 为空结构也可以运行（第 0/6 章自动注入，出"骨架盘"）
echo '{"cards": [], "hand_reading": {"items": []}, "calibration_questions": []}' > /tmp/reading.json

python3 scripts/generate_html.py --chart /tmp/chart.json --reading /tmp/reading.json --output /tmp/mingpan.html

生成的 HTML 文件是完整的可视化命盘，浏览器直接打开。页面右上角可切换「典藏」（金黑古典）/「赛博」（发光卡片）双主题，选择会记住。

第六步：手相互证（可选）

如果用户提供了手相照片或文字描述，在解读中增加手相互证部分。

多模态模式（用户提供照片）：

1. 分析手相照片中的主要掌纹特征
2. 提取生命线、智慧线、感情线的走向和深浅
3. 与命盘进行交叉比对

描述模式（用户用文字描述）： 引导用户描述以下特征：

• 生命线：弧度大小、长度、清晰度
• 智慧线：起点位置、走向（平直/下弯）、长度
• 感情线：深浅、终点位置（食指/中指/无名指下方）
• 掌纹：整体是粗线简洁还是细纹多
• 掌型：手掌偏长还是偏宽，手指粗细

纯命盘模式（不提供手相）： 跳过手相部分，不生成手相互证章节（reading.json 中省略 hand_reading 字段）。

hand_reading items 格式：

{
  "title": "生命线",
  "body": "描述内容",
  "status": "match" 或 "conflict",
  "status_text": "与命盘XX共振 ✓" 或 "与XX有表面矛盾",
  "resolution": "仅 conflict 时需要：解释取舍逻辑"
}

校准机制

解读完毕后，在命盘末尾加入校准问答。用户回答后，可以修正取象偏差，将准确度从 65-75% 推向 85% 以上。完整题库见 scripts/calibration.py（含优先级、对应命盘关键点与回答示例）。

标准校准问题（按优先级选用 3-5 个）：

1. 感情/婚姻（必问）
   • 你的感情/婚姻状态属于哪种？（稳定/波折/单身/其他）
   • 如果已婚/有伴侣，有没有重大感情事件？（如：结婚年份、近年有无变动）
2. 财务状况（必问）
   • 最近1-2年财务状况如何？（如：收入变化、投资损益、负债、理财收益等）
3. 事业/工作模式（选问）
   • 目前从事的行业或工作性质？（打工/创业/自由职业/投资理财为主）
4. 生活变化（选问）
   • 最近1-2年有没有明显的生活变化或压力来源？（换城市、生活节奏变化、经济压力、家庭成员变动等）
5. 健康/困扰（选问）
   • 有没有明显的身体不适或反复出现的健康问题？
   • 你最困扰的事情是什么领域？
   • 父母中哪一方影响你更深？

校准后的解读调整：

命盘关键点	用户回答	解读调整方向
夫妻宫/大限转换	感情变动年份	确认感情解读准确度↑
财帛宫+铃星/擎羊	投资亏损/收入锐减	财务解读确认准确度↑
官禄宫组合	创业/打工模式	事业解读校准
整体格局	大运时间节点	验证时间节点预测

输出格式

双轨输出

1. 专业层：术语 + 星曜 + 宫位 + 四化路径（给懂行的看）
2. 白话层：类比日常语言翻译，避免术语堆砌

手相互证标注

• 标注与星盘吻合/矛盾之处
• 矛盾处说明取舍逻辑

V2 自动增强组件

以下组件由脚本从排盘数据确定性计算并自动渲染，不依赖解读文案：

组件	位置	数据来源	内容
宏观格局仪表盘	cards 头部	gezhi_analysis	格局判定 + 技术别名 + 描述 + 三维量化进度条（1-5）
空宫借星标记	十二宫格	空宫 borrowed_* 字段	虚线边框 + 借星斜体"(借)" + 能量系数标签（0.5红/0.7橙/1.0绿）
时空压力热力表	cards 尾部	time_travel_analysis	流年干支 + 流年/大限/生年化忌叠冲，每宫压力分（≥2.5 高危热点，≥1.5 预警）

判定规则的单一事实来源是 scripts/gezhi_rules.py：格局分类器（杀破狼/紫府武相/机月同梁/阳梁昌禄/巨日同宫/马头带剑/杂格）、空宫能量降阶（0.7/0.5）、四化忌星表（已按标准生年四化校验修正）。

参考文件

文件	何时读取
references/stars_reference.md	解读命宫、事业、财运、感情时，查阅相关星曜的解读参考
references/four_hua_reference.md	分析四化飞星时查阅
references/interpretation_guide.md	首次使用本 skill 时读取，了解解读风格和语气要求
scripts/gezhi_rules.py	需要解释格局判定或量化指标的计算规则时查阅
scripts/calibration.py	组织校准问答时查阅完整题库（优先级/关键点/回答示例）

完整示例流程

# 1. 排盘（含格局扫描 + 流年压力审计）
python3 scripts/calculate_chart.py --solar 1991-8-15 --hour 1 --gender 男 --output /tmp/chart.json

# 2. 读取 chart.json，分析命盘，生成 reading.json（由 LLM 完成）

# 3. 生成 HTML（即使 reading.json 为空，也会自动注入第 0/6 章组件）
python3 scripts/generate_html.py --chart /tmp/chart.json --reading /tmp/reading.json --output /tmp/mingpan.html

# 4. 在浏览器中打开 mingpan.html 查看命盘，右上角切换主题

文件结构

mingli-master/
├── SKILL.md                          # 本文件 V2
├── README.md
├── scripts/
│   ├── calculate_chart.py            # 排盘引擎（iztro-py + V2 后处理管线）
│   ├── generate_html.py              # HTML 生成引擎（空宫渲染/第0/6章注入/主题变量）
│   ├── gezhi_rules.py                # 格局判定与量化规则（判定规则单一事实来源）
│   └── calibration.py                # 校准问题库（优先级/关键点/回答示例）
├── templates/
│   └── chart_template.html           # HTML 模板（典藏主题 + 赛博增强层 + 切换器）
└── references/
    ├── stars_reference.md             # 星曜解读参考
    ├── four_hua_reference.md          # 四化参考
    └── interpretation_guide.md        # 解读风格指南