命理解读师

# 命理解读师 V2

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

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

## 核心原则

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

## 禁忌

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

## 依赖

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

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

## 工作流程

### 第一步：信息收集

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

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

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

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

### 第二步：排盘计算

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

```bash
# 公历
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` 格式：

```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 命盘

```bash
# 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 格式：**
```json
{
  "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` | 组织校准问答时查阅完整题库（优先级/关键点/回答示例） |

## 完整示例流程

```bash
# 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. 在浏览器中打开 mi