# `luck-analysis-v1` 大运与原局关系事实

`luck-analysis-v1` 逐步分析 `luck-cycle-v1` 排出的大运干支，输出它与出生原局的结构化关系事实。它不判断某步大运是好运还是坏运，也不生成事件断语。

## 调用方式

```ts
import { analyzeLuckCycles } from 'bazi-core';

const result = analyzeLuckCycles({
  civilTime: {
    year: 1995,
    month: 1,
    day: 21,
    hour: 11,
    minute: 30,
  },
}, {
  sexForRule: 'male',
  cycleCount: 8,
});

console.log(result.cycles[0]);
```

输入选项与 `calculateLuckCycles` 相同：可以直接指定 `direction`，或提供 `sexForRule` 并使用年干阴阳与性别定顺逆的传统规则。性别只参与大运顺逆，不改变十神或干支关系规则。

## 每步大运的事实

`cycles` 中每一项包含：

- `cycle`：来自 `luck-cycle-v1` 的干支、起止时间和起止年龄；
- `stem`：大运天干的五行、阴阳和相对日主的十神；
- `branch.hiddenStems`：大运地支藏干的本气、中气、余气与十神；
- `branch.twelveGrowth`：日主在大运地支的十二长生阶段；
- `branch.root`：大运地支藏干中是否出现日主同五行，并保留藏干和层级；
- `relations.stems`：大运天干与原局年、月、日、时干的五合与相克；
- `relations.branches`：大运地支参与的六合、完整三合、六冲、六害、子卯刑、自刑和完整三刑。

`relations` 只输出当前大运干支新参与的关系。原局四柱内部已有的关系由 `calculateBazi().relations` 输出，本模型不重复复制。

## 三合与三刑

首版延续 `relations-v1` 的保守口径：

- 大运地支加上原局地支，三支全部齐全时才输出完整三合；
- 寅巳申或丑戌未三支全部齐全时才输出完整三刑；
- 不把半合、拱合或“两支半刑”默认为已成立的事实。

如果原局有多个位置可参与同一组合，结果会按实际柱位分别输出，不丢失来源。

## 合与合化分离

天干五合、地支六合和三合会输出：

```ts
{
  candidateElement: 'fire',
  transformationStatus: 'candidate-only',
}
```

这只证明传统关系表中存在候选化行，不表示已经合化成功。`luck-analysis-v1` 不会因此改写原局干支、删除某个根，或修改原局旺衰结果。

## 能力边界

以下不属于 `luck-analysis-v1`：

- 判断大运吉凶、喜忌或用神；
- 为合、冲、刑、害设置不透明的影响分数；
- 判断“某支被完全冲掉”或合化必然成功；
- 输出升职、婚恋、财运、疾病等事件断语；
- 叠加流年干支进行三层分析。

如果未来需要吉凶或事件解释，应当建立新的可版本化解释模型，并显式声明所选流派、权重和冲突规则。