# qmen_caiguan

Adopt this skill: https://proskills.md/skills/other/skyfiredao-qmenpowers-skills-qmen-caiguan

Page: https://proskills.md/skills/other/skyfiredao-qmenpowers-skills-qmen-caiguan
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/qmen_caiguan/SKILL.md
size: 15171
sha: a22791e8df2a673d33e799800ee01d7e60eb9860
upstream: https://github.com/skyfiredao/qmenpowers/blob/main/skills/qmen_caiguan/SKILL.md

````text
---
name: qmen_caiguan
description: "财运/事业/工作/赚钱/财富/升职/行业 - Diagnose wealth and career: 六害 analysis on birth plate, monthly decree, industry mapping"
---

# 财官诊断 — 财富事业双维度深度分析

> 基于奇门遁甲起局，从财富和事业两个维度进行七要害诊断，定位六害（刑墓庚虎迫空），给出化解方向和"踩一捧一"建议。

## Trigger

仅当用户**明确**要求"财运 + 事业双维度深度诊断 / 七要害 / 财官分析"时激活本技能。

**不要在以下情况激活本技能**：
- 用户只说"奇门遁甲"未明确方向 → 使用 `qmen_dunjia` 路由 skill
- 用户用纯起局动词（"排局"、"起一卦"、"算一卦"、"起个奇门"）但未明确分析方向 → **必须**让位给 `qmen_dunjia` 路由 skill，由它做时间分流和起局
- 用户需要婚恋分析 → `qmen_hunlian`
- 用户需要性格分析 → `qmen_xingge`
- 用户需要布阵/灭象/风水化解 → `qmen_huaqizhen`
- 在意图模糊时 → 使用 `qmen_dunjia` 路由 skill

---

## 🔒 核心契约：脚本输出完整性

执行 `bin/qimen*.sh` 脚本时：

**强制规则：**
1. 脚本必须实际执行，禁止凭记忆模拟输出
2. stdout 一字不漏原样输出，放在代码块内
3. 完整输出在前，分析文字在后，顺序不可颠倒
4. 多个脚本各自独立输出，不合并

**禁止行为（出现即违约）：**
- 省略："..."、"（省略N行）"、"（其余类似）"、"（以下省略）"
- 概括："输出如下"、"主要内容"、"关键部分"、"摘要"
- 借口："为节省篇幅"、"由于输出较长"
- 包装：折叠标签、翻译代替原文、只展示首尾
- 抢跑：输出前插入任何分析性文字

**自检：** 每次脚本执行后，确认"输出是否完整无遗漏"。如有遗漏，立即补贴，不重新执行。
**后果：** 截断或概括的输出视为无效，整个分析必须基于完整数据重来。

---

## 🔒 万物类象数据约束（不可越过）

所有万物类象（天干、九星、八门、八神的类象描述）**只能来自**以下两个数据源：
1. **本地数据文件** `data/wanwu_*.dat` 中的实际字段值
2. **脚本输出 JSON** 中 `wanwu` 字段的内容

**严禁**：
- 编造数据文件中不存在的类象内容
- 将某个天干/星/门/神的类象张冠李戴到另一个上
- 为了"符合现实情况"而凭空建立干门星神与具体事物的关联
- 使用"根据XXX推测"、"可以联想为"等话术绕过数据约束

**验证方法**：如果你要说"X代表Y"，必须能在 `data/wanwu_*.dat` 或 JSON `wanwu` 字段中找到这条对应关系。找不到就不说。

---

## 对话流程

### Step 1: 收集信息

向用户询问信息：

**必填：**
1. **出生时间** — 格式 `YYYY-MM-DD HH:MM`，完整的年月日时。必须提供完整出生时间，无默认值。需要提取出生年的天干（用于计算生年财）。如果用户只提供年份，由年份尾数推算天干（4甲5乙6丙7丁8戊9己0庚1辛2壬3癸）。

示例对话：
```
AI: 财官诊断需要以下信息：
    1. 出生时间（完整的年月日时，例如：1973-04-24 19:30）
```

### Step 2: 起局

**JSON 复用判断（按优先级）：**
1. 用户要求重新起局（"重新/再算/换时间/不对"等） → `rm -f ./qmen_birth.json`，重新起局
2. `./qmen_birth.json` 存在 → 用 Read 工具读取其顶层 `"datetime"` 值，与用户给的时间逐字符比对：
   - 一致 → 跳过，进入 Step 3
   - 不一致或损坏 → 删除，重新起局
   - 用户未给时间 → 问"检测到命盘 datetime=X，继续？"
3. 文件不存在 → 起局

> 本 skill 只需 `./qmen_birth.json`。

---

**起局（入局仪轨已由路由完成）：**

```bash
# workdir: {SKILL_DIR}
bin/qimen_qiju.sh --type=birth "1973-04-24 19:30"
```

**⚠️ 遵守核心契约：一字不漏原样输出。**

### Step 3: 财官分析

**必须执行**财官分析脚本（自动从 `./qmen_birth.json` 读取出生年天干，行业从局上自动推算）：

```bash
# workdir: {SKILL_DIR}
bin/qimen_caiguan.sh
```

**⚠️ 遵守核心契约：一字不漏原样输出。** 脚本只读取 `./qmen_birth.json`（命盘），写入 `./qmen_caiguan.json`。

### Step 4: 解读

**必须先完成 Step 2 和 Step 3 的脚本执行**，然后用 Read 工具读取 `./qmen_caiguan.json`，逐字段确认数据后，按照「解读框架」生成中文叙事分析。

```
Read: {SKILL_DIR}/qmen_caiguan.json
```

**强制约束：生成解读前，必须先读取 `qmen_caiguan.json` 并逐字段确认所有数据。禁止凭记忆或推测解读，所有分析内容必须来自 JSON 中的实际字段值。**

### Step 5: 追问处理

解读完成后告诉用户可以继续提问。如果用户需要布阵化解，引导到 `qmen_huaqizhen` 技能。

---

## 核心概念

### 六害

六害是局中对符号的六种危害因素：

| 六害 | JSON 标记 | 含义 |
|------|----------|------|
| 刑 | 刑 | 六仪击刑，受刑伤、纷争 |
| 墓 | 干墓/星墓/门墓 | 入墓，被困、陷入泥沼 |
| 庚 | 庚 | 天盘见庚，大阻力大障碍 |
| 庚(对宫) | 庚(对宫) | 对宫有庚，间接阻力 |
| 虎 | 虎 | 白虎同宫，凶猛压力 |
| 虎(对宫) | 虎(对宫) | 对宫有白虎，间接压力 |
| 玄武(对宫) | 玄武(对宫) | 对宫有玄武，暗中影响 |
| 迫 | 迫 | 门迫，通道不畅 |
| 空 | 空 | 空亡，落空虚幻 |

**六害叠加越多越严重。** 单个六害是警告，两个以上是危险信号。

### 财富与事业的关系

- **财富**：掌控的资源，货币化为金钱。优先考虑自己。钱从多渠道来，也要到多渠道中去。灵活创造财富。在既定规则下牟取利益。
- **事业**：社会角色和伴生权利。优先考虑别人。拥有改造规则的力量。
- **二者不可兼得**：需要"踩一捧一"，即在某一维度让步以保全另一维度。强行两手抓必出问题。

### 月令五行关系

月令是起局时月支的五行，代表大环境和天时。难以完全逆转。能成功，但代价不同，入局时的定数，月令压制决定了采取不同态度，反抗或者顺从天时，但不一定要对抗天时，看性价比。选择被月令生助的会事半功倍。JSON 中 `yuegling.palaces[].relation` 字段已计算好，`yuegling_relation_cn` 字段提供中文含义：

| relation 值 | yuegling_relation_cn | 含义 | 对财富/事业的影响 |
|------------|---------------------|------|-----------------|
| sheng | 扩张量大 | 月令生此宫 | 扩张，量大，事半功倍 |
| tong | 稳健量大 | 月令同此宫 | 稳健，量大，根基牢固 |
| ke_target | 大亏量小 | 月令克此宫 | 大亏，量小，最差 |
| sheng_target | 损耗量小 | 此宫生月令（泄耗） | 损耗，量小 |
| bei_ke | 努力可成 | 此宫克月令 | 努力可成，量小 |

### 天干五合

局中找不到需要的天干时，找其所合的天干替代。JSON 中 `gan_cai.stems[].wuhe_alt` 已标注替代天干。

**特殊规则：缺甲找值符。** 甲虽然与己合（甲己合），但缺甲时不找己，而是找值符宫的天干（值符宫干代替甲）。脚本已自动处理此规则，JSON 中已体现。

---

## 解读框架

读取 `qmen_caiguan.json` 后，按以下步骤生成解读。所有数据已由脚本计算完成，SKILL 只负责用自然语言组织和解读数据，不做额外推算。

### 第一步：月令总论

**读取**：`yuegling` 对象

**字段**：
- `yuegling.branch` — 月令地支
- `yuegling.wuxing` — 月令五行
- `yuegling.palaces[]` — 每个宫位的月令关系，含 `relation`（英文标记）和 `relation_cn`（中文含义，如"月令克，大亏，量小。最差"）

**解读要求**：
- 说明月令地支和五行代表的大环境能量方向
- 遍历 `palaces[]`，按 relation 分组归纳：哪些宫被月令生助（sheng/tong），哪些宫被月令克制（ke_target）
- 给出"顺天时"的总体方向——优先选择被月令生助的宫位方向

### 第二步：财富七要害逐项诊断

**读取**：`caifu_yaohai` 数组

**每项字段**：
- `name` — 要害名称
- `desc` — 含义描述
- `type` — `stem`/`gate`/`deity`/`special`（special 类型引用对应专题数据）
- `palace` — 所在宫位号
- `palace_info` — 宫中星门神天盘地盘详情
- `liuhai` — 六害列表（逗号分隔）
- `liuhai_count` — 六害数量
- `yuegling_relation_cn` — 月令关系中文描述

**解读要求**：
- 逐项报告：名称、所在宫位、六害状态、月令关系
- 六害越多越严重，两个以上是危险信号
- `type=special` 的要害（月令、行业、干财）引用对应专题数据（`yuegling`、`hangye`、`gan_cai`）解读

**七要害解读要点**：

| 要害 | name | 正面含义 | 六害影响 |
|------|------|---------|---------|
| 戊 | 戊 | 本钱安稳 | 降薪、资产贬值、亏本 |
| 生门 | 生门 | 利润增长 | 回报不及预期、盈利有问题、生产环境问题、实体店被电商打压 |
| 六合 | 六合 | 合作顺利 | 人际关系网有麻烦、融资不顺 |
| 月令 | 月令 | 天时有利 | （special，从yuegling总论中解读） |
| 行业 | 行业 | 渠道适配 | （special，从hangye中解读） |
| 时干 | 时干 | 时机正确，正确的时间做正确的事 | 客户支持弱、员工支持弱、市场需求差、前景预期不好 |
| 干财 | 干财 | 资源可控。局中状态好又能被控制和利用的东西，使用这个资源就能驱动干财，普通人保护好干财即可。 | （special，从gan_cai中解读） |

**注意**：局中有很多创造财富的渠道，不是唯一。

### 第三步：事业七要害逐项诊断

**读取**：`shiye_yaohai` 数组

与财富同样的字段结构和解读方法：

| 要害 | name | 正面含义 | 六害影响 |
|------|------|---------|---------|
| 开门 | 开门 | 公司运行好 | 氛围差、人际复杂、君子不立危墙 |
| 景门 | 景门 | 形象好业绩好 | 形象受损、成果不被认可、自恋，表现自己。一定要保护好。 |
| 玄武 | 玄武 | 无小人 | 有阴险小人暗算，六害叠加尤为严重 |
| 庚/白虎 | 庚 | 无大压力 | 指标高、强敌、精神紧张 |
| 行业 | 行业 | 岗位适配 | （special，从hangye中解读） |
| 符使 | 符使 | 上级支持 | （special，从fushi中解读） |
| 诸天干 | 诸天干 | 人事关系好 | （special，从tiangan_roles中解读。天干有问题就是阻碍的根源。年干=大老板(最有权，不直接参与工作)，月干=同事，时干=下属） |

**玄武特别说明**：
- 玄武代表暗中力量，影响本宫和对宫
- 暗中针对，各种陷阱，谎言，虚假承诺，表面一套背后一套，任何人都有可能
- 六害同宫时必须提醒用户警惕
- 玄武空亡或入墓尤其要小心
- 如果用户不从事玄学/哲学，玄武基本代表小人

**庚/白虎特别说明**：
- 庚和白虎本身就是问题来源
- 它们影响本宫和对宫
- 六害叠加（如击刑+门迫）情况更糟
- 不留情的敌人，只能硬着头皮做
- 但也可以是搏斗致富的渠道（笔记原文："唯一的求财渠道是拼命斗争"）

### 第四步：干财分析

**读取**：`gan_cai` 对象

**字段**：
- `ri_gan` / `nian_gan` — 日干/年干
- `ri_gan_cai` / `nian_gan_cai` — 对应的财干
- `stems[]` — 每个财干的状态：`stem`（天干）、`palace`（宫位）、`palace_info`（含 `state` 十二长生状态）、`liuhai`、`wuhe_alt`（五合替代）

**解读要求**：
- 列出日干财和生年财的天干
- 逐个报告在局中的宫位和六害状态
- 如果 `palace_info.state` 是"墓"，说明资源被困难以调动
- 如果 `wuhe_alt` 非空，说明该天干不在局上，用五合替代
- 给出干财安全与否的判断

### 第五步：行业分析

**读取**：`hangye` 对象

**字段**：
- `palace` — 戊所在宫位
- `star` / `gate` / `deity` / `tian_gan` — 宫内符号
- `matched[]` — 脚本匹配到的行业列表
- `star_career` — 星的化气阵行业方向

**解读要求**：
- 说明戊落在哪个宫位，列出宫内符号
- 报告脚本匹配到的行业方向
- 如有 `star_career`，一并解读
- 结合月令关系说明行业难易程度

### 第六步："踩一捧一"综合建议

**读取**：`summary` 对象

**字段**：
- `caifu_total_liuhai` — 财富总六害数
- `shiye_total_liuhai` — 事业总六害数
- `caiyipengyi` — 脚本给出的踩捧建议

**解读要求**：
- 报告财富和事业的总六害数对比
- 引用 `caiyipengyi` 建议
- 结合前面各要害的具体情况，用日常语言展开踩捧建议
- 给出化解方向（参考各要害的六害类型）：
   - 入墓 → 资源被困，换时机或方位
   - 空亡 → 事情不实，不宜投入过多
   - 庚/白虎 → 正面硬刚或绕开
   - 门迫 → 换通道
   - 击刑 → 法律纠纷风险
- 参考月令生助的宫位方向给出时机和方位建议

**原则**：再糟糕的局，也有出路和解法。例如：新闻行业是惊门，驿马，腾蛇。军人是庚。全都同宫。值使遇白虎，冲开门。

---

## 追问处理

### 追问某个要害
用户问"戊的问题怎么解决"或"生门六害这么多怎么办"：
- 找到该要害在 JSON 中的完整数据（`palace_info`、`liuhai`、`yuegling_relation_cn`）
- 结合同宫的星门神组合解读具体状况
- 化解方向参考六害类型：换方位、换时间、换渠道

### 追问行业方向
用户问"我适合做什么行业"或"这个行业怎么样"：
- 行业已由脚本从戊所在宫自动推算，参考 `hangye` 数据中的匹配结果
- 结合月令关系分析该行业方向在当前大环境下的难易程度

### 需要布阵化解
如果用户想要灭象+布阵，引导使用 `qmen_huaqizhen` 技能：
> 如果你需要具体的布阵方案（在哪个方位摆什么物品来化解六害），可以使用化气阵技能。需要额外提供家人出生年份（可选，用于布阵保护）。

---

## 工作目录

**所有 Bash 命令必须使用 `workdir` 参数**，指向项目根目录。

**获取 `{SKILL_DIR}`**：本 SKILL.md 所在目录下 `bin` 是指向项目 `bin/` 的相对软链接。通过以下方式解析项目根目录：
```bash
cd -P <本SKILL.md所在目录>/bin && cd .. && pwd
```
将输出赋值给 `{SKILL_DIR}`，后续所有命令使用 `workdir: {SKILL_DIR}`。

技能目录下的相关文件：
```
skill_qmenpowers/
├── bin/qimen_qiju.sh              # 起局脚本
├── bin/qimen_caiguan.sh      # 财官分析脚本
├── qmen_birth.json           # 命盘输出（运行后生成）
├── qmen_caiguan.json         # 财官分析输出（运行后生成）
├── lib/                      # 引擎库（不需要直接调用）
└── data/                     # 数据文件（不需要直接调用）
```
````

## File: skills/qmen_caiguan/bin
size: 15
sha: c03b80e709bb8f44301d513dece8cd172482ed7a
upstream: https://github.com/skyfiredao/qmenpowers/blob/main/skills/qmen_caiguan/bin

Content is not inlined in the catalog. Read the upstream file: https://github.com/skyfiredao/qmenpowers/blob/main/skills/qmen_caiguan/bin

## File: skills/qmen_caiguan/data
size: 16
sha: ea72cefe02e6a8404dfebed50f9d63ccfb4d23ca
upstream: https://github.com/skyfiredao/qmenpowers/blob/main/skills/qmen_caiguan/data

Content is not inlined in the catalog. Read the upstream file: https://github.com/skyfiredao/qmenpowers/blob/main/skills/qmen_caiguan/data

## File: skills/qmen_caiguan/lib
size: 15
sha: 4597760323676fa3f63deba050cbc3c438f2b132
upstream: https://github.com/skyfiredao/qmenpowers/blob/main/skills/qmen_caiguan/lib

Content is not inlined in the catalog. Read the upstream file: https://github.com/skyfiredao/qmenpowers/blob/main/skills/qmen_caiguan/lib

## File: README.md
upstream: https://github.com/skyfiredao/qmenpowers/blob/main/README.md

````text
**[中文版](README_zh.md)**

> Establish the heart of heaven and earth,
> Secure the livelihood of the people,
> Continue the lost teachings of past sages,
> Open an era of peace for all generations.
>
> — Zhang Zai, *Hengqu Four Maxims* (横渠四句)

# Qi Men Dun Jia — Eight Gates Huaqi Array
# 奇门遁甲 八门化气阵

A pure-Bash Qi Men Dun Jia plate-setting engine with zero external dependencies.

## What Is Qi Men Dun Jia?

Qi Men Dun Jia (奇门遁甲) is one of the "Three Styles" (三式) of classical Chinese cosmological forecasting, alongside Tai Yi (太乙) and Liu Ren (六壬). Dating back over two thousand years, it maps time and space onto a nine-palace grid derived from the Luoshu (洛书) magic square, then layers multiple symbol systems on top: heavenly stems, stars, gates, and deities. Each layer interacts through the five-phase (五行, wuxing) cycle of generation and overcoming, producing a rich symbolic picture of a given moment's energetic landscape.

The system was historically used for military strategy, site selection, and timing decisions. Today it remains a living tradition in Chinese metaphysics, studied for both its cultural depth and its internal structural elegance.

## Design Choices

**Zhi-Run intercalary method only.** Two major schools exist for handling the boundary between solar terms: Zhi-Run (置闰法) and Chai-Bu (拆补法). This project implements Zhi-Run exclusively. In Zhi-Run, when the current time falls between the Jieqi (节气) boundary and the start of a new Yuan (元), the previous Ju number is carried forward ("intercalated"). Chai-Bu instead splits and patches across both Ju numbers. Zhi-Run produces a single clean Ju per moment, which simplifies the computation pipeline and aligns with the dominant mainland Chinese tradition.

**Hourly Qi Men with rotating plate.** This is Shi Jia Qi Men (时家奇门), the hourly variant, not the daily or monthly variants. The plate uses the rotating-plate (转盘) method, where stars and gates physically rotate around the nine palaces. The alternative flying-star (飞盘) method assigns symbols by flight path rather than rotation. Rotating plate preserves the spatial relationship between symbols and palaces, making it more intuitive for reading directional significance.

**Tianqin palace assignment.** The star Tianqin (天禽, Heavenly Bird) sits in the center palace (5-palace), which has no gate and therefore needs a hosting palace. Three modes are available via `--tianqin=MODE`:

- **`follow-tiannei`** (default): Tianqin follows wherever Tiannei (天内) goes. When the heaven plate rotates, Tiannei and Tianqin share the same palace. This preserves Tianqin's yin-earth affinity with Tiannei's yin-earth nature.
- **`jikun`**: Tianqin lodges permanently in the Kun 2-palace (寄坤二宫), regardless of plate rotation. This is the most traditional convention.
- **`follow-zhifu`**: Tianqin follows the Zhifu (值符) duty star to its rotated palace.

In all modes, the hosting palace displays Tianqin with a `[寄]` (lodging) marker alongside the palace's own rotated star.

**Pure Bash, no external tools.** The entire engine runs in Bash 3.2+ with no calls to Python, bc, awk, or any other external program. All arithmetic uses Bash integer math. Calendar calculations (Gregorian to Julian Day Number, Ganzhi cycle indexing) are implemented from scratch in shell arithmetic. This makes the tool portable to any system with a POSIX-compatible Bash, including stock macOS.

**Script and data fully separated.** Every domain constant lives in `tools/data/*.dat` files, using a simple `key=value` format. The scripts contain zero hardcoded domain knowledge. You could, in theory, swap the data files to model a different Qi Men variant without touching a line of code.

## Architecture

The engine is split into library files, CLI entry points, and a data directory.

```
skill_qmenpowers/
├── skills/
│   ├── qmen_dunjia/
│   │   └── SKILL.md                    # Router skill: time-type triage + plate setting + sub-skill dispatch
│   ├── qmen_event/
│   │   └── SKILL.md                    # AI interpretation skill
│   ├── qmen_caiguan/
│   │   └── SKILL.md                    # Wealth & career diagnosis skill
│   ├── qmen_huaqizhen/
│   │   └── SKILL.md                    # Huaqizhen array placement skill
│   ├── qmen_yishenhuanjiang/
│   │   └── SKILL.md                    # Yishenhuanjiang (transformation resolution) skill
│   ├── qmen_hunlian/
│   │   └── SKILL.md                    # Hunlian (marriage/romance) analysis skill
│   ├── qmen_wanwu/
│   │   └── SKILL.md                    # Wanwu imagery portrait skill
│   ├── qmen_xingge/
│   │   └── SKILL.md                    # Personality analysis skill
│   ├── qmen_xunshijieyun/
│   │   └── SKILL.md                    # Xunshijieyun (寻时借运) skill
│   ├── qmen_zhanduan/
│   │   └── SKILL.md                    # Zhanduan (古籍占断) divination judgment skill
│   └── qmen_yaoce/
│       └── SKILL.md                    # Yaoce (cross-plate array-breaking) analysis skill
├── tools/
│   ├── bin/
│   │   ├── qimen_qiju.sh               # Plate setting CLI
│   │   ├── qimen_event.sh              # Event analysis CLI
│   │   ├── qimen_caiguan.sh            # Caiguan (wealth/career) diagnosis CLI
│   │   ├── qimen_huaqizhen.sh          # Huaqizhen (array placement) CLI
│   │   ├── qimen_yishenhuanjiang.sh    # Yishenhuanjiang (transformation resolution) CLI
│   │   ├── qimen_zhentaiyangshi.sh     # True solar time calculator
│   │   ├── qimen_hunlian.sh            # Hunlian (marriage/romance) analysis CLI
│   │   ├── qimen_wanwu.sh              # Wanwu imagery extraction CLI
│   │   ├── qimen_xingge.sh             # Personality analysis CLI
│   │   ├── qimen_xunshijieyun.sh       # Xunshijieyun (寻时借运) CLI
│   │   ├── qimen_show.sh               # Plate JSON viewer (read & display)
│   │   ├── qimen_luming.sh             # Six-relation (六亲) destiny analysis
│   │   ├── qimen_zhanduan.sh           # Zhanduan (古籍占断) divination CLI
│   │   └── qimen_yaoce.sh              # Yaoce (cross-plate array-breaking) CLI
│   ├── lib/
│   │   ├── data_loader.sh              # Generic data file loader
│   │   ├── qimen_engine.sh             # Core computation engine
│   │   ├── qimen_output.sh             # Output formatting (text + JSON)
│   │   ├── qimen_json.sh               # Shared JSON parsing and utility library
│   │   ├── qimen_event.sh              # Event analysis library
│   │   ├── qimen_banmenhuaqizhen.sh    # Core huaqizhen library
│   │   ├── qimen_yishenhuanjiang.sh    # Yishenhuanjiang (transformation resolution) library
│   │   ├── qimen_caiguan.sh            # Caiguan analysis library
│   │   ├── qimen_hunlian.sh            # Hunlian (marriage/romance) analysis library
│   │   ├── qimen_xingge.sh             # Personality analysis library
│   │   ├── qimen_zhanduan.sh           # Zhanduan (古籍占断) DSL evaluator library
│   │   └── qimen_yaoce.sh              # Yaoce (cross-plate array-breaking) library
│   └── data/
│       ├── tiangan_dizhi.dat           # Engine: stems & branches
│       ├── jieqi_table.dat             # Engine: solar term timestamps
│       ├── meta_jieqi.dat              # Engine: solar term metadata
│       ├── ju_map.dat                  # Engine: ju number mapping
│       ├── nine_stars.dat              # Engine: nine stars basics
│       ├── eight_gates.dat             # Engine: eight gates basics
│       ├── eight_deities.dat           # Engine: eight deities ordering
│       ├── sanqi_liuyi.dat             # Engine: three wonders & six yi
│       ├── luoshu.dat                  # Engine: luoshu traversal order
│       ├── meta_palace.dat             # Engine: palace metadata
│       ├── twelve_states.dat           # Engine: twelve growth stages
│       ├── wanwu_bagua.dat             # Reference: eight trigrams correspondences
│       ├── wanwu_tiangan.dat           # Reference: heavenly stems correspondences
│       ├── wanwu_dizhi.dat             # Reference: earthly branches correspondences
│       ├── wanwu_wuxing.dat     
````
