# Heluo Lifetime

> 河洛理数 · 一卦定终身。根据出生年月日时，推算本命卦、后天卦、大运、流年，逐岁批断运势。 触发场景：(1) 用户提供八字或出生日期要求算河洛命卦 (2) 用户问"一卦定终身""河洛理数""本命卦怎么算" (3) 用户要求排大运/流年/岁运断语。 加载后第一件事：主动追问八字、出生时间、出生地点、性别四项信息，缺什么问什么，直到齐全才进入计算。 关键词：河洛理数、本命卦、元堂、大运流年、岁运逢之、陈抟、邵雍、一卦定终身。

- Skill: `cslawyer1985/heluo-lifetime` (Agent Skill, multi-file: 10 files)
- Install (CLI): `npx get-skill add cslawyer1985/heluo-lifetime`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cslawyer1985/heluo-lifetime/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: cslawyer1985 (https://skillmd.com/u/cslawyer1985)
- Updated: 2026-11-15
- Page: https://skillmd.com/skills/cslawyer1985/heluo-lifetime

---


# 河洛理数 · 一卦定终身

根据《河洛理数》（陈抟著/邵雍述）的完整算法，从出生时间推算本命卦、排大运、推流年，逐岁引用卷二爻辞断语做运势批断。

---

## 前置步骤：收集出生信息

在一切计算开始之前，必须先拿到准确的四项信息：**出生时间（公历/农历）、出生地点、性别**。时辰关乎元堂取法和真太阳时换算，地点不能省。

### 信息收集流程

**必须先主动追问**——加载此技能后，如果有任何求测请求，第一件事不是算卦，而是确认信息是否齐全。按以下顺序逐个追问，缺什么问什么：

#### ① 八字（四柱）

先问：「请提供你的出生年月日时八字，即 **年柱、月柱、日柱、时柱** 四柱全称（如：戊辰 乙丑 乙酉 丙子）。」

如果对方**有八字** → 直接进入下一步。

如果对方**没有八字** → 继续追问：

#### ② 农历或公历出生时间

「请提供你的出生日期和时辰，以及**出生地点（省市县）**。可以是农历也可以是公历，但请注明是哪一种。如果知道具体几点几分最好（如：1989 年正月初八 子时，或 1989 年 1 月 25 日 0:05）。」

拿到后，执行以下换算：
- **真太阳时**：根据出生地点经度换算。公式：`真太阳时 = 北京时间 + (当地经度 − 120°) × 4 分钟`。偏离超过 ±30 分钟则必须校正，用校正后的时间排时柱。
- **公历⇄农历转换**：如果给的是公历，用万年历反查农历日期；如果给的是农历，保持农历
- **排八字**：禁止 AI 手推——必须调用脚本，传入**真太阳时调整后**的分：
  ```bash
  python3 scripts/baizi.py <公历年> <月> <日> <时> <分>
  ```
  ```
  输出格式：`年柱 月柱 日柱 时柱`（如 `戊申 壬戌 庚申 壬午`）。算法依据卷七「年上起月」「日上起时」口诀（五虎遁/五鼠遁），日柱以 1900-01-01 甲戌为基准。
- **确定性别**：必须追问「男命还是女命？」

### 信息齐全后的确认

在拿到 {八字, 时辰地支, 性别, 出生年} 后，回显确认：

> 已确认：**{八字}**，{性别}，出生年 {YYYY}，时辰 {地支}。开始计算。

---

## 第二步：排盘推算 — 运行脚本

> ⚠️ **核心规则：所有算法计算必须通过 `_heluo_core.py` 脚本执行，不得手动推理。脚本只管算法；爻辞从 `references/yaoci.json` 读取，卷四行号定位用 `references/juan4_index.json`。**

### 运行命令

```bash
python3 scripts/_heluo_core.py "{八字}" {性别} {出生年} {时辰地支}
```

脚本输出 JSON，包含：本命卦、元堂、后天卦、大运结构、流年框架。

### 脚本计算步骤（内嵌规则，不得手动重算）

| 步骤 | 脚本函数 | 原书行号 |
|------|---------|---------|
| 干支→12 个数 | `compute_bazi_nums()` | 922–936 |
| 天数/地数 | 奇数和/偶数和 | 962–966 |
| 余数起卦 | `yushu_qigua()` | 964–974 |
| 遇十不用 | 10→1, 20→2, 30→3 | 1050 |
| 五数寄宫 | `wushu_jigong()` | 1018–1028 |
| 八卦相荡 | 阳男/阴女天数在上；阴男/阳女天数在下 | **990** |
| 洛书配卦 | 1坎2坤3震4巽6乾7兑8艮9离 | 970–972 |
| 取元堂 | `get_yuantang()`，起元堂诗 | 1056–1166 |
| 换后天卦 | 翻元堂爻 + 内外易位 | 1167–1185 |
| 大运 | 阳爻 9 年 / 阴爻 6 年，从元堂顺行 | 1345–1373 |
| 阴爻流年 | toggle，不分阳阴年 | 8225 |
| 阳爻流年 | `liunian_yang()`，卷一算法，两实例验证全中 | 1349 |

**阴爻**: 每年从大象卦 toggle 一爻，`(pos+i)%6`，共6年，不分阳阴年。
**阳爻**: 运首年定阴阳 → Y1坐明堂/Y2取应爻/Y3复还本爻/Y4-9每年只翻一爻。同人九三+同人九四9年全中，无需查卷四。

---

## 第三步：补充爻辞 + 生成命书

### 3a. 读取爻辞

从 `references/yaoci.json` 按「卦名 + 爻名」读取爻辞原文（452 条、64 卦齐全，无需回退原书）；原书卷二行号区间（约 2550–5450）见 `references/raw-index.md`。

爻辞索引需处理字符归一化（传统字 `訟卦`、OCR 错字 `壺坎卦`→坎卦 等）。详见本文「经验教训 §1」。

### 3b. 卷四流年表（验证用）

卷四（约行 8207 开始）为各卦阳爻列出九年流年预计算结果。`liunian_yang()` 已直接计算，无需查表。卷四可用于交叉验证计算结果。

### 3c. 生成命书

命书输出为单个 Markdown 文件，严格遵守以下格式模板，不得增删层级。

#### 模板结构

```
# 河洛理数 · 一生命书

**命主**: {出生日期} {时间} · {出生地} · {性别}
**八字**: {四柱全称}
**本命卦**: {卦符号} {卦名} · 元堂 {爻名}
**后天卦**: {卦符号} {卦名} · 元堂 {爻名}

> 天数 N→余N={卦}☰ | 地数 N→余N={卦}☷ | {性别}→天数在上/下 | {上卦下卦 = 卦名}

---

## 元堂底色 — {卦符号} {卦名} · {爻名}

> **爻辞**：{爻辞原文}

> {断语原文 — "此爻是..."到段尾}

## 后天元堂 — {卦符号} {卦名} · {爻名}

> **爻辞**：{爻辞原文}

> {断语原文}

---

## 十二大运爻辞

### 先天 {卦符号} {卦名}

#### ① {爻名} {岁数起止} · {起止年份}
> **爻辞**：...
> {断语}

#### ② {爻名} {岁数起止} · {起止年份}
...

### ↻ 后天 {卦符号} {卦名}

#### ⑦ {爻名} {岁数起止}
...

---

## 逐岁流年爻辞全文

#### {岁}岁 · {年}年{天干} · {卦符号} {卦名} · 值{爻名}

> **爻辞**：{爻辞原文}

> {断语原文}
```

#### 各板块说明

| 板块 | 标题级别 | 内容 | 数据来源 |
|------|:---:|------|------|
| 头部 | h1 + 紧凑行 | 命主信息、八字、两个卦 + 元堂、算法溯源 | `_heluo_core.py` JSON |
| 元堂底色 | h2 | 本命卦元堂爻辞 + 断语（一生基调） | `yaoci.json` |
| 后天元堂 | h2 | 后天卦元堂爻辞 + 断语（后半生转变） | `yaoci.json` |
| 十二大运 | h2 → h3(先天/后天) → h4(每段) | 每段大运的爻辞 + 断语 | `yaoci.json` |
| 逐岁流年 | h2 → h4(每岁) | 每岁：`岁 · 年· 卦符号 卦名 · 值爻名` → 爻辞 + 断语 | `yaoci.json` + `_heluo_core.py` |

#### 格式硬规则

1. **每岁标题格式**：`#### {岁}岁 · {年}年{天干} · {卦符号} {卦名} · 值{爻名}`。卦符号为 Unicode（如䷣䷋䷊），不可省略。
2. **爻辞**：`> **爻辞**：{原文}`，引用块。
3. **断语**：`> {原文}`，引用块，保留原文"此爻是…叶者…不叶者…岁运逢之…"的完整结构体，不做删节。
4. **大运标题**：序号用①②③…⑫，先天标"先天"，后天标"↻ 后天"。必须包含公历年份区间，格式：`#### ① 六二 0–5岁 · 1968–1973年`。
5. **算法溯源行**：一行小字，列出天数地数→余数→上下卦→元堂→后天卦的关键节点，放在头部信息下方。
6. **不包含白话解读**——爻辞原文 + 断语原文即是完整命书。白话解读只在用户追问具体某一年时口述。
7. **不包含卷三诗诀**。
8. **不追加任何引导语**（如"以上是完整命书，如有疑问…"）。命书以最后一行逐岁流年结束。

---

## 第四步：后续解读服务

**(a) 引导提问**：在命书末尾附上——

> 「以上是你的完整命书。如果想了解某一年或某几年的具体运势，告诉我要看哪一年，我来用白话帮你解读。」

**(b) 逐年解读**：命书只提供爻辞原文 + 断语原文，不包含白话解读。用户问到哪一年就口头解读哪一年。

**(c) 白话解读格式**：每一年四句话——
1. 列出：`{岁}岁 {年}年 — {卦符号} {卦名} · 值{爻名}` + 爻辞原文
2. 断语「岁运逢之」段→白话概括（结合普通人视角，不得搬运文言官场话术）
3. 结合年龄阶段（求学/事业/壮年/晚年）的现实含义
4. 元堂底色与这年的关系（托底 / 放大 / 缓冲 / 提供出路）

**每次回复末尾必须附免责声明**：`> ⚠️ 本段内容由 AI 生成，仅供娱乐参考。`

---

## 爻辞分段与用途

卷二每根爻辞天然分为两段：

| 段落 | 对象 | 时间维度 | 用途 |
|------|------|---------|------|
| **叶者/不叶者** | 元堂爻 + 大运爻 | 一生基调 / 6–9 年阶段 | 定底色 |
| **岁运逢之** | 流年值爻 | 就那一年 | 定当年事件 |

「叶」和「不叶」是一个区间，不是二选一。元堂把你放进这个区间，大运推一个方向，流年微调落点。**永远不需要回答"此人叶还是不叶"。**

---

## 重要原则

- **一切排盘通过 `_heluo_core.py` 执行，不得手动推理**
- **一切断语源于卷二爻辞原文**，不得编造
- **每岁看爻辞不看卦辞**，流年看「岁运逢之」段
- **叶者/不叶者定底色（元堂+大运），岁运逢之定当年**
- **换运时回到大象卦重新开始**，不续上一运终卦
- **每次列卦必须带 Unicode 卦象符号**
- **每次回复末尾必须加免责声明**：`> ⚠️ 本段内容由 AI 生成，仅供娱乐参考。`

### 🔴 两条铁律（所有解读必须遵守）

**铁律一：普通人视角。** 一切爻辞解读必须从**普通人的现代生活**出发。爻辞原文中「人臣伐暴」「仕途超迁」「阃帅之任」「牧民之职」等古代官场/朝廷用语，**必须转化为现代普通人的现实含义**——事业发展、人际关系、健康、家庭、心境成长。绝对禁止直接搬运文言官场话术套在普通人身上。

**铁律二：辩证向上，不让人心灰意冷。** 遇到负面爻辞或悲观评价时，必须做到两条：
1. **如实展示**——爻辞说了什么凶险、什么困难，不粉饰、不隐瞒
2. **给出向上的路**——这件事有没有转机？从这个坎里能学到什么？哪股力量可以托底？用辩证思维指出正面可能

反面典型：说「岁运逢之，在仕有阃帅之任」→ 对一个普通人等于什么都没说。正确做法：「这一年你在你的领域里有机会扛大旗、当主角，但前提是你得先准备好。」

核心信念：**河洛理数是让人看清自己、活得更好用的，不是让人心灰意冷认命用的。**

---

## 原始资料依赖

| 资料 | 位置 | 内容 |
|------|------|------|
| 排盘脚本 | `scripts/_heluo_core.py` | 纯算法引擎（本命卦/后天卦/元堂/大运/流年框架） |
| 八字排盘 | `scripts/baizi.py` | 公历 → 四柱干支（五虎遁/五鼠遁） |
| 爻辞知识库 | `references/yaoci.json` | 452 条爻辞，64 卦齐全。格式：`{"卦名":{"爻名":{"yaoci":"...","duanyu":"..."}}}` |
| 卷四索引 | `references/juan4_index.json` | 64 卦名 → 原书行号映射，用于定位卷四流年表 |
| 本命卦算法 | `references/heluo-algorithm.md` | 真太阳时 → 排八字 → 天地数 → 元堂全流程详解，带验证示例 |
| 大运流年算法 | `references/dayun-liunian.md` | 阳爻 9 年/阴爻 6 年、流年 toggle、卷四表读法 |
| 换后天卦法 | `references/xiantian-houtian.md` | 元堂翻爻 + 内外易位变换法与示例 |
| 原书行号索引 | `references/raw-index.md` | 卷二爻辞、卷四原表、关键算法行号速查 |
| 原书全文 | 本地私有资料（含版权，**不随 skill 分发**） | 卷一算法 + 卷二爻辞 + 卷三诗诀 + 卷四流年表 + 卷五月卦 + 卷六参评 + 卷七附录 |

### 爻辞读取

直接从 `references/yaoci.json` 查：`yaoci["讼卦"]["初六"]["duanyu"]`。64 卦齐全，无需回退原文。

### 卷四

卷四流年表仅作验证用。`liunian_yang()` 已直接计算，无需查表。

---

## 实战经验教训

### ⚠️ 1. 卷二爻辞索引需字符归一化

**传统字**：`## 訟卦(六)` → `讼卦`
**OCR 错字**：`壺坎卦`→坎卦、`爲离卦`→离卦、`贾卦`→贲卦、`央卦`→夬卦、`垂旅卦`→旅卦、`彐损卦`→损卦、`彐渙卦`→涣卦
64 卦全齐，乾卦亦为标准「此爻是」格式。

### ⚠️ 2. 白话解读不可模板化

逐条解析爻辞「岁运逢之」段，按年龄调适：
- ≤26 岁：「告休」→「不可冒进」
- 27–41 岁：「告休」→「宜低调守成」
- 42–59 岁：「退职」→「可退居幕后」
- 60+：保留原文

### ⚠️ 3. 论六爻七条分类不可跨位套用

元堂在几爻套对应爻位规则，五位最好、二位次之、三四又次之、初上最末。**绝不跨位。**

### ⚠️ 4. 「二数足」看原始值

天数标准 = 25，地数标准 = 30。判断在取余之前，不是取余后。

<!-- © 2024-2026 陆凌燕（北京德恒（无锡）律师事务所）. Licensed under MIT. -->

<!-- AUTHOR_SIGNATURE: 法律科技实务工具 · 维护者陆凌燕律师（北京德恒·无锡）· 关注公众号「鹿鸣于野 UMU」获取更多内容 -->

