# `season-context-v1` 季节环境事实

`season-context-v1` 输出出生时间所处的节气环境，不生成吉凶断语，也不修改 `ziping-strength-v1` 的旺衰决策量。

## 节气距离

- `solarTerms.previous`、`solarTerms.next`：前后相邻的二十四节气；
- `previousMonthBoundary`、`nextMonthBoundary`：前后相邻的十二节，月柱以“节”为边界；
- `at` 使用中国标准时间并显式携带 `+08:00`；
- `distanceSeconds` 是出生时刻与节气时刻的绝对秒数。

节气时刻来自 `lunar-typescript`。距离只是可复核的时间事实，v1 不把它线性换算成所谓“五行能量”。

## 十二长生

以日主天干为主体，分别计算日主在年、月、日、时四个地支上的十二长生：

`长生、沐浴、冠带、临官、帝旺、衰、病、死、墓、绝、胎、养`。

采用十干起长生、阳干顺排、阴干逆排的明确口径。输出同时提供稳定的拼音阶段标识和中文标签。例如：

```ts
{
  pillar: 'day',
  branch: '子',
  stage: 'diwang',
  stageLabel: '帝旺',
}
```

“病、死、墓、绝”只是规则表中的阶段名称，不表示人的疾病、死亡或吉凶。

## 旺相休囚死

按月支所属四季输出五行状态：

| 季节 | 旺 | 相 | 休 | 囚 | 死 |
| --- | --- | --- | --- | --- | --- |
| 春 | 木 | 火 | 水 | 金 | 土 |
| 夏 | 火 | 土 | 木 | 水 | 金 |
| 秋 | 金 | 水 | 土 | 火 | 木 |
| 冬 | 水 | 木 | 金 | 土 | 火 |

四季按月支划分：

- 寅、卯、辰：春；
- 巳、午、未：夏；
- 申、酉、戌：秋；
- 亥、子、丑：冬。

辰、未、戌、丑月另行采用“季末土旺”分段的口径尚未纳入 v1，因此通过 `earthTransition: "not-modeled"` 和 `warnings` 明确披露。

## 与旺衰模型的关系

`season-context-v1` 和 `ziping-strength-v1` 当前并行输出。前者不会自动：

- 根据离节气远近增减决策量；
- 把“帝旺”等十二长生标签直接换算成分数；
- 用旺相休囚死覆盖月令、通根和藏干证据；
- 静默改变既有旺衰结论。

`ziping-strength-v2` 已显式消费日主的旺相休囚死，以及月令和日坐的十二长生；节气距离仍只记录、不线性计分。完整规则见 [algorithm-v2.md](./algorithm-v2.md)。