# `ziping-strength-v2` 旺衰规则

`ziping-strength-v2` 在 `season-context-v1`、`relations-v1` 和 `roots-v1` 的事实之上重新计算旺衰。它是一套公开、确定性、可测试的工程模型，不宣称统一所有子平流派，也不输出五行百分比。

`ziping-strength-v1` 保持不变。标准结果同时返回 `analysis`（v1）和 `analysisV2`（v2），调用方可以直接对照两套模型的证据与结论。

## 1. 证据结构

每条 v2 证据都会输出：

- `ruleId`：采用的具体规则；
- `sourceModels`：事实来自四柱、季节、关系或根气中的哪一层；
- `sources`：事实的来源路径；
- `side`：`supporting`、`opposing` 或 `neutral`；
- `applied`：是否进入本次旺衰决策量；
- `decisionUnits`：确定性分档使用的决策量；
- `description`：本条事实为何采用或为何只记录。

`decisionUnits` 只用于让规则边界公开、稳定和可回归测试，不表示五行含量、能量百分比或命理准确率。

## 2. 季节环境

### 旺相休囚死

取 `season-context-v1` 中日主五行在出生月的状态：

| 日主季节状态 | 方向 | 决策量 |
| --- | --- | ---: |
| 旺 | 生扶 | 4 |
| 相 | 生扶 | 2 |
| 休 | 中性 | 0 |
| 囚 | 泄耗克 | 2 |
| 死 | 泄耗克 | 4 |

### 十二长生

只采用月令和日坐两个核心位置：

| 十二长生阶段 | 方向 | 每处决策量 |
| --- | --- | ---: |
| 临官、帝旺 | 生扶 | 2 |
| 长生、冠带 | 生扶 | 1 |
| 病、死、墓、绝 | 泄耗克 | 1 |
| 沐浴、衰、胎、养 | 中性 | 0 |

年支和时支的十二长生仍保留在 `season-context-v1`，v2 不重复计入，避免季节与地支证据过度叠加。

### 节气距离

前后节气和月柱边界距离会作为 `applied: false` 的证据进入 v2 trace。当前没有采用“离节越近力量越大/越小”的线性规则，因此不换算决策量。

## 3. 明透与藏干

| 基础事实 | 方向 | 决策量 |
| --- | --- | ---: |
| 年、月、时干明透 | 按与日主的五行关系 | 2 |
| 地支非根本气 | 按与日主的五行关系 | 2 |
| 地支非根中气、余气 | 按与日主的五行关系 | 1 |

同五行藏干不在这一层重复计算，统一交由 `roots-v1` 的根气证据处理。

## 4. 根气

根的基础决策量由本中余气决定：

| 根气层级 | 生扶决策量 |
| --- | ---: |
| 本气 `main` | 3 |
| 中气 `middle` | 2 |
| 余气 `residual` | 1 |

再按位置增加：

| 根的位置 | 额外决策量 |
| --- | ---: |
| 月支（月令位置） | 2 |
| 日支（日坐位置） | 1 |
| 年支、时支 | 0 |

因此，“月支本气根”计 5 单位，“日支本气根”计 4 单位。它们仍是两条可追溯的规则组合，不会被包装成不透明的“强根”。

## 5. 干支关系

v2 只采用可以在现有事实范围内保守确定的两类作用：

- 天干相克直接涉及日主：增加 1 单位泄耗克；
- 地支六冲涉及一处根：每处增加 1 单位减力证据，但不会删除原始根。

以下事实会进入 evidence，但保持 `applied: false`、`decisionUnits: 0`：

- 天干五合和地支六合、三合的候选化行；
- 不直接涉及日主的天干相克；
- 没有冲到根的地支六冲；
- 六害、刑和自刑。

原因是 `relations-v1` 当前只证明关系存在，尚不足以证明合化成功、某一五行已经改变，或某支已经完全失去作用。

## 6. 五档分级

令 `delta = 生扶决策量 - 泄耗克决策量`：

| delta | 结果 |
| ---: | --- |
| `>= 8` | 极强 `extremely-strong` |
| `3 .. 7` | 偏强 `strong` |
| `-2 .. 2` | 相对中和 `balanced` |
| `-7 .. -3` | 偏弱 `weak` |
| `<= -8` | 极弱 `extremely-weak` |

## 7. 特殊格局保护

v2 仍不自动完成从格、专旺、化气或假从定格，只标记复核候选：

- 无根、生扶不超过 4、泄耗克不少于 10：候选从弱；
- 生扶不少于 14、泄耗克不超过 3：候选从强。

触发后返回 `needs-special-pattern-review`，置信度强制为 `low`。

## 8. 当前边界

- 辰、未、戌、丑月的季末土旺分段尚未建模；
- 不根据节气距离做连续权重；
- 不判断合化成功、半合、拱合、三会或暗合；
- 不把刑害直接换算成旺衰减力；
- 不自动取用神、调候或生成吉凶断语。

新增规则时应继续增加可追溯证据或升级模型版本，不能静默修改 `ziping-strength-v2` 的既有结果。